Orders Lesen

pixiGetOrderNrByAddress

Liefert eine Auftragsnummer, deren Auftragspositionen den angegebenen Adressschlüssel als Rechnungs- oder Lieferadresse referenzieren.

Ermittelt eine Auftragsnummer zu einem Adressschlüssel. Laut Kommentar im Code wird der Aufruf für Desktop-Benachrichtigungen benötigt.

Durchsucht die Tabelle Orderlines nach Zeilen, bei denen AddrRef (Rechnungsadresse) oder ShipAdrRef (Lieferadresse) gleich @AddrKey ist.
Es werden nur Zeilen mit OrderNr > 0 berücksichtigt.
Es wird höchstens eine Zeile (TOP 1) mit der Spalte OrderNr zurückgegeben.

Gibt es keine passende Auftragsposition, ist die Ergebnismenge leer.

Hinweise

TOP 1 wird ohne ORDER BY verwendet. Referenzieren mehrere Aufträge dieselbe Adresse, ist nicht festgelegt, welche Auftragsnummer zurückgegeben wird. Das Ergebnis kann sich zwischen Aufrufen ändern.
Die Tabelle wird WITH (NOLOCK) gelesen, daher können nicht festgeschriebene Daten sichtbar sein.
Die Suche erfolgt über Auftragspositionen, nicht über eine Auftragskopftabelle. Aufträge ohne Positionen werden nicht gefunden.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`AddrKey` Pflicht	int	–	Adressschlüssel. Er wird mit der Rechnungsadressreferenz `AddrRef` und der Lieferadressreferenz `ShipAdrRef` der Auftragspositionen verglichen. Beispiel: `104523`

Antwort

Result-Set 1 · Immer; enthält null oder eine Zeile.

Die zum Adressschlüssel gefundene Auftragsnummer.

Spalte	Typ	Beschreibung
`OrderNr`	int	Auftragsnummer (immer größer als 0).

Beispielantwort

<SqlRowSet1>
  <row>
    <OrderNr>250117</OrderNr>
  </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:pixiGetOrderNrByAddress>
      <AddrKey>104523</AddrKey>
    </ns1:pixiGetOrderNrByAddress>
  </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:pixiGetOrderNrByAddress>
      <AddrKey>104523</AddrKey>
    </ns1:pixiGetOrderNrByAddress>
  </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 = [
    'AddrKey' => '104523',
];

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

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

Verwendete Tabellen

Orderlines · Lesen

SQL-Objekt:: dbo.pipiGetOrderNrByAddress