Orderlines Lesen

pixiCanCancelOrderline

Prüft, ob eine Auftragsposition noch storniert werden kann, und liefert 1 (ja) oder 0 (nein).

Skalarfunktion, die eine einzelne Auftragsposition anhand von OrderlineKey prüft.

Die Auftragsposition wird über ihren Status mit OrderStates verknüpft. Die Funktion liefert nur dann 1, wenn alle folgenden Bedingungen erfüllt sind:

der Status der Auftragsposition ist kein Endstatus (OrderStates.FinalState ist N oder NULL),
der Status der Auftragsposition ist nicht EIN,
die Auftragsposition ist nicht in BoxItems referenziert (nicht in eine Kiste gepackt),
die Auftragsposition ist nicht in InvLines referenziert (nicht berechnet).

Ist eine dieser Bedingungen nicht erfüllt, liefert die Funktion 0.

Die Funktion prüft nur und ändert keine Daten.

Hinweise

Das Ergebnis ist NULL, wenn keine Auftragsposition mit dem angegebenen Schlüssel existiert oder ihr Status keinen passenden Eintrag in OrderStates hat (Inner Join).
Alle Tabellen werden mit NOLOCK gelesen; das Ergebnis kann daher nicht festgeschriebene Daten widerspiegeln.
Die Prüfungen gegen BoxItems und InvLines verwenden NOT IN. Enthält BoxItems.OrderLineRef oder InvLines.OrderlineRef NULL-Werte, wird die Bedingung nie wahr und die Funktion liefert für jede Auftragsposition 0.
Die Funktion storniert nichts, sondern zeigt nur an, ob eine Stornierung zulässig ist.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`OrderlineKey` Pflicht	int	–	Schlüssel der zu prüfenden Auftragsposition (`Orderlines.OrderlineKey`). Beispiel: `123456`

Antwort

Result-Set 1 · Immer

Einzelwert, den die Skalarfunktion zurückgibt.

Spalte	Typ	Beschreibung
`Result` Kann leer sein	int	`1`, wenn die Auftragsposition storniert werden kann, `0`, wenn nicht, NULL, wenn die Auftragsposition oder ihr Status nicht gefunden wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <Result>1</Result>
  </row>
</SqlRowSet1>

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiCanCancelOrderline>
      <OrderlineKey>123456</OrderlineKey>
    </ns1:pixiCanCancelOrderline>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiCanCancelOrderline>
      <OrderlineKey>123456</OrderlineKey>
    </ns1:pixiCanCancelOrderline>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    'OrderlineKey' => '123456',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiCanCancelOrderline', $soapArguments);

Verwendete Tabellen

Orderlines · Lesen OrderStates · Lesen BoxItems · Lesen InvLines · Lesen

SQL-Objekt:: dbo.pipiCanCancelOrderline