Shipping Lesen

pixiCheckPickListNr

Prüft, ob eine Picklistennummer existiert und nicht abgelaufen ist, und liefert Kistenbereich, 1SS-Kennzeichen, Scanstatus und Anzahl offener Aufträge.

Prüft eine Pickliste (PLHeader) anhand ihres Schlüssels PickListNr. Der Aufruf übergibt die gesamte Verarbeitung an die interne Prozedur Pixi_CheckPickListNr und liefert immer genau eine Zeile.

Ablauf:

Scanstatus: Es wird geprüft, ob mindestens eine Position der Pickliste (PLitem) auf eine Auftragsposition mit Status EIN verweist. Ist das der Fall, ist PicklistNotScannedYet gleich 0. Gibt es keine solche Position, ist der Wert 1.
Anzahl Aufträge: Gezählt werden die unterschiedlichen Auftragsnummern der Pickliste, deren Auftragspositionen nicht abgelaufen sind (Expired = 0). Aufträge, für die in boxes bereits eine Kiste mit WaitForSend = 'N' existiert, werden nicht mitgezählt.
Gültigkeit: Eine Pickliste ist gültig, wenn eine PLHeader-Zeile mit PLHkey = PickListNr existiert und ihr PLHexpiryDate nach der aktuellen Serverzeit liegt.
- Ungültige oder abgelaufene Pickliste: Die Zeile enthält ReturnValue = 0, alle anderen Spalten sind 0.
- Gültige Pickliste: Die Zeile enthält ReturnValue = 1, den Kistenbereich PLHfromBox/PLHtoBox, das Kennzeichen 1SS (NULL wird zu 0) sowie die Werte aus Schritt 1 und 2.

Hinweise

Alle Lesezugriffe erfolgen mit NOLOCK. Die Werte können gleichzeitig laufende, noch nicht bestätigte Änderungen enthalten.
Im ungültigen Zweig heißen die Kistenspalten PLHFromBox/PLHToBox. Im gültigen Zweig heißen sie PLHfromBox/PLHtoBox. XML-Elementnamen unterscheiden Groß- und Kleinschreibung, daher sollten Clients sie ohne Beachtung der Schreibweise auslesen.
Der Spaltenname 1SS beginnt mit einer Ziffer. Im SOAP/DataSet-XML wird er üblicherweise als _x0031_SS kodiert.
Eine nicht vorhandene Pickliste lässt sich nicht von einer abgelaufenen unterscheiden; beide liefern ReturnValue = 0.
Der Ablauf wird mit der Uhrzeit des Datenbankservers (GETDATE()) verglichen.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`PickListNr` Pflicht	int	–	Schlüssel der zu prüfenden Pickliste (`PLHeader.PLHkey`). Beispiel: `104523`

Antwort

Result-Set 1 · Immer; genau eine Zeile. Fehlt die Pickliste oder ist sie abgelaufen, sind alle Werte 0.

Prüfergebnis für die Pickliste.

Spalte	Typ	Beschreibung
`ReturnValue`	int	`1`, wenn die Pickliste existiert und nicht abgelaufen ist, sonst `0`.
`PLHfromBox` Kann leer sein	int	Erste Kistennummer der Pickliste (`PLHeader.PLHfromBox`). Bei ungültiger Pickliste `0`, die Spalte heißt dann `PLHFromBox`.
`PLHtoBox` Kann leer sein	int	Letzte Kistennummer der Pickliste (`PLHeader.PLHtoBox`). Bei ungültiger Pickliste `0`, die Spalte heißt dann `PLHToBox`.
`1SS`	bit boolean	Wert des Kennzeichens `1SS` aus dem Picklistenkopf; `NULL` wird als `0` geliefert.
`PicklistNotScannedYet`	bit boolean	`0`, wenn mindestens eine Auftragsposition der Pickliste den Status `EIN` hat, sonst `1`. Bei ungültiger Pickliste immer `0`.
`NumberOfOrders`	int	Anzahl unterschiedlicher Aufträge der Pickliste mit nicht abgelaufenen Auftragspositionen und ohne Kiste mit `WaitForSend = 'N'`.

Beispielantwort

<SqlRowSet1>
  <row>
    <ReturnValue>1</ReturnValue>
    <PLHfromBox>1</PLHfromBox>
    <PLHtoBox>24</PLHtoBox>
    <_x0031_SS>false</_x0031_SS>
    <PicklistNotScannedYet>true</PicklistNotScannedYet>
    <NumberOfOrders>18</NumberOfOrders>
  </row>
</SqlRowSet1>

Fehlermeldungen

Status	Meldung	Ursache
0	ReturnValue = 0	Es existiert keine `PLHeader`-Zeile mit diesem Schlüssel, oder ihr `PLHexpiryDate` liegt nicht nach der aktuellen Zeit. Den Schlüssel einer vorhandenen, nicht abgelaufenen Pickliste übergeben.

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:pixiCheckPickListNr>
      <PickListNr>104523</PickListNr>
    </ns1:pixiCheckPickListNr>
  </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:pixiCheckPickListNr>
      <PickListNr>104523</PickListNr>
    </ns1:pixiCheckPickListNr>
  </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 = [
    'PickListNr' => '104523',
];

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

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

Verwendete Tabellen

PLitem · Lesen Orderlines · Lesen boxes · Lesen PLHeader · Lesen

SQL-Objekt:: dbo.pipiCheckPickListNr