Orders Lesen

pixiGetOrderNrByOrderNrExternal

Liefert die Pixi-Auftragsnummer (OrderNr) zu einer externen Auftragsnummer oder 0, wenn kein passender Auftrag existiert.

Skalare Funktion, die eine externe Auftragsnummer (z. B. die Bestellnummer eines Onlineshops) in die interne Pixi-Auftragsnummer übersetzt.

Durchsucht die Auftragspositionen (Orderlines), deren OrderNrExternal exakt dem Parameter OrderNrExternal entspricht.
Verknüpft jede gefundene Position über OrderNr mit dem Auftragskopf (OrderHeader), sodass nur Aufträge mit vorhandenem Kopf berücksichtigt werden.
Passen mehrere Aufträge, wird die höchste OrderNr geliefert.
Wird nichts gefunden, ist das Ergebnis 0 statt NULL.

Hinweise

Die externe Auftragsnummer wird aus den Auftragspositionen gelesen, nicht aus dem Auftragskopf. Ein Auftrag ohne Positionen wird nicht gefunden.
Beide Tabellen werden WITH(NOLOCK) gelesen; nicht festgeschriebene Daten können sichtbar sein.
Wurde dieselbe externe Nummer für mehrere Aufträge verwendet, wird nur die höchste OrderNr geliefert; weitere Treffer werden ohne Hinweis ignoriert.
Bei Übergabe von NULL gibt es keinen Treffer, das Ergebnis ist 0.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`OrderNrExternal` Pflicht	varchar(50) string	–	Externe Auftragsnummer, wie sie in `Orderlines.OrderNrExternal` gespeichert ist; Vergleich auf exakte Gleichheit. Beispiel: `SHOP-100234`

Antwort

Result-Set 1 · Immer

Einzelwert mit der gefundenen Auftragsnummer.

Spalte	Typ	Beschreibung
`Result`	int	Höchste Pixi-`OrderNr` mit einer Position, die die angegebene externe Auftragsnummer trägt; `0`, wenn keine gefunden wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <Result>458921</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:pixiGetOrderNrByOrderNrExternal>
      <OrderNrExternal>SHOP-100234</OrderNrExternal>
    </ns1:pixiGetOrderNrByOrderNrExternal>
  </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:pixiGetOrderNrByOrderNrExternal>
      <OrderNrExternal>SHOP-100234</OrderNrExternal>
    </ns1:pixiGetOrderNrByOrderNrExternal>
  </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 = [
    'OrderNrExternal' => 'SHOP-100234',
];

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

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

Verwendete Tabellen

Orderlines · Lesen OrderHeader · Lesen

SQL-Objekt:: dbo.pipiGetOrderNrByOrderNrExternal