Orders Lesen

pixiGetOrderNrExternalByBoxNr

Liefert die Pixi-Auftragsnummern und externen Auftragsnummern aller Aufträge, deren Auftragspositionen in einer bestimmten Box enthalten sind.

Sucht eine Box anhand ihrer Nummer und liefert die Aufträge, deren Auftragspositionen in dieser Box enthalten sind.

Die Box wird über BoxNr aus der Tabelle boxes ermittelt.
Die Boxpositionen (boxitems) werden mit den Auftragspositionen (Orderlines) und diese mit dem Auftragskopf (OrderHeader) verknüpft.
Ist LocId angegeben, werden nur Boxen dieses Standorts (LocationID) berücksichtigt. Ein leerer String wird wie NULL behandelt, dann wird über alle Standorte gesucht.
Das Ergebnis ist DISTINCT: Jeder Auftrag erscheint nur einmal, auch wenn mehrere seiner Positionen in der Box liegen. Eine Box kann Positionen mehrerer Aufträge enthalten, daher sind mehrere Zeilen möglich.
Es wird keine explizite Sortierung vorgenommen.

Hinweise

Alle Tabellen werden mit NOLOCK gelesen, daher können nicht festgeschriebene Daten geliefert werden.
Existiert keine Box mit der angegebenen Nummer (oder gehört sie zu einem anderen Standort) oder enthält die Box keine Auftragspositionen, wird eine leere Ergebnismenge geliefert; es gibt keine Fehlerzeile.
OrderNrExternal wird als leerer String geliefert, wenn der Auftrag keine externe Auftragsnummer hat. Das ISNULL auf OrderNr hat wegen der Inner Joins praktisch keine Wirkung.
Ohne LocId werden Boxen mit gleicher Nummer an verschiedenen Standorten gemeinsam berücksichtigt.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`BoxNr` Pflicht	int	–	Nummer der Box (`boxes.BoxNr`), deren Aufträge geliefert werden sollen. Beispiel: `100245`
`LocId`	varchar(3) string	NULL	Optionale Standort-ID, um die Suche nach der Box auf einen Standort einzuschränken (`boxes.LocationID`). `NULL` oder leerer String durchsucht alle Standorte. Beispiel: `001`

Antwort

Result-Set 1 · Immer; leer, wenn keine passende Box mit Auftragspositionen gefunden wird.

Eine Zeile je unterschiedlichem Auftrag, der in der Box enthalten ist.

Spalte	Typ	Beschreibung
`OrderNr`	int	Pixi-Auftragsnummer (`OrderHeader.OrderNr`).
`OrderNrExternal`	string	Externe Auftragsnummer des Auftrags (`OrderHeader.OrderNrExternal`), leerer String, wenn nicht gesetzt.

Beispielantwort

<SqlRowSet1>
  <row>
    <OrderNr>458712</OrderNr>
    <OrderNrExternal>SHOP-2024-00981</OrderNrExternal>
  </row>
  <row>
    <OrderNr>458730</OrderNr>
    <OrderNrExternal>SHOP-2024-01002</OrderNrExternal>
  </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:pixiGetOrderNrExternalByBoxNr>
      <BoxNr>100245</BoxNr>
      <!-- <LocId>001</LocId> -->
    </ns1:pixiGetOrderNrExternalByBoxNr>
  </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:pixiGetOrderNrExternalByBoxNr>
      <BoxNr>100245</BoxNr>
      <!-- <LocId>001</LocId> -->
    </ns1:pixiGetOrderNrExternalByBoxNr>
  </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 = [
    'BoxNr' => '100245',
    // 'LocId' => '001',
];

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

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

Verwendete Tabellen

boxitems · Lesen boxes · Lesen Orderlines · Lesen OrderHeader · Lesen

SQL-Objekt:: dbo.pipiGetOrderNrExternalByBoxNr