pixiInvoiceSetTrackingID

Setzt oder ergänzt Sendungsverfolgungsnummern (Tracking-IDs) einer Rechnung und ihrer Pakete, optional mit Überschreiben und Zurücksetzen des Kundenbenachrichtigungs-Flags.

Ordnet einer Rechnung (Invoices.ShipmentTrackingID) und ihren Paketen (pixi.InvoicePackage) eine oder mehrere Tracking-IDs zu.

1. Rechnungssuche: InvoiceNR wird mit Invoices.InvoiceNr abgeglichen. Enthält die Nummer -, werden die Suffixe nach dem letzten - schrittweise entfernt und auch alle gekürzten Varianten geprüft (z. B. RE1000-2-1 → RE1000-2 → RE1000). Verwendet werden nur tatsächlich vorhandene Rechnungsnummern.
2. Trennzeichen: Ist Separator weder ; noch leer, wird jedes Vorkommen in TrackingID durch ; ersetzt. Intern dient immer ; als Trennzeichen.
3. Wird keine Rechnung gefunden, wird die Zeile InvoiceNR is not existing geliefert und nichts geändert.
4. Wird die Rechnung gefunden, wird zuerst die Zeile InvoiceNR found and Updated geliefert. Danach:
   • Overwrite = 1: Invoices.ShipmentTrackingID wird geleert. Alle Pakete der Rechnung ohne Paketpositionen werden von InvoicePolling gelöst (InvoicePackageId = NULL). Pakete ohne Paketpositionen werden gelöscht, mit Ausnahme des Pakets mit der kleinsten Id.
   • Die interne Prozedur Pixi_SetTrackingId wird ausgeführt. Sie zerlegt die Tracking-IDs, ignoriert bereits an der Rechnung gespeicherte IDs und verteilt die neuen IDs auf Pakete:
     • Hat kein Paket Paketpositionen aus einer Packstation, erhält ein einzelnes vorhandenes Paket mit leerer Tracking-ID die erste neue ID. Alle weiteren neuen IDs werden als neue Pakete angelegt; existiert kein solches Paket, gilt das für alle neuen IDs. ShipmentTrackingID der Rechnung wird anschließend aus allen eindeutigen Paket-Tracking-IDs neu gebildet, sortiert und mit ; getrennt.
     • Gibt es Pakete mit Paketpositionen und genau ein Paket, erhält dieses Paket die letzte neue ID. Bei mehreren Paketen bleiben die Pakete unverändert. ShipmentTrackingID wird zur Vereinigung aus vorhandenen und neuen IDs.
     • Invoices.Packages wird auf die Anzahl der Pakete gesetzt, UpdateDate und UpdateEmp (TrackingID Import) werden aktualisiert. Ein Ereignis InvoiceChanged wird veröffentlicht.
   • ResetClientNotifiedFlag = 1: Für alle Auftragspositionen der Rechnung erhält der jeweils jüngste OrderHistory-Eintrag mit Status AUS den Wert ClientNotified = 'N'. Der Versand wird damit samt Tracking-ID erneut an Kunde bzw. Shop gemeldet.

Parameter

Antwort

Result-Set 1 · Immer, eine Zeile (sofern vor der Suche kein Fehler auftritt)

Statusmeldung, ob die Rechnung gefunden wurde.

<SqlRowSet1>
  <row>
    <ReturnMessage>InvoiceNR found and Updated</ReturnMessage>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiInvoiceSetTrackingID>
      <InvoiceNR>RE1004711</InvoiceNR>
      <TrackingID>00340434161094042557;00340434161094042564</TrackingID>
      <!-- <Overwrite>0</Overwrite> -->
      <!-- <ResetClientNotifiedFlag>1</ResetClientNotifiedFlag> -->
      <!-- <Separator>,</Separator> -->
    </ns1:pixiInvoiceSetTrackingID>
  </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:pixiInvoiceSetTrackingID>
      <InvoiceNR>RE1004711</InvoiceNR>
      <TrackingID>00340434161094042557;00340434161094042564</TrackingID>
      <!-- <Overwrite>0</Overwrite> -->
      <!-- <ResetClientNotifiedFlag>1</ResetClientNotifiedFlag> -->
      <!-- <Separator>,</Separator> -->
    </ns1:pixiInvoiceSetTrackingID>
  </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 = [
    'InvoiceNR' => 'RE1004711',
    'TrackingID' => '00340434161094042557;00340434161094042564',
    // 'Overwrite' => '0',
    // 'ResetClientNotifiedFlag' => '1',
    // 'Separator' => ',',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiInvoiceSetTrackingID

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben