pixiInvoiceSetTrackingIDforPolling

Setzt eine oder mehrere Sendungsverfolgungsnummern auf einer Rechnung und deren Paketen, optional mit Ersetzen bestehender Pakete und erneuter Markierung des Auftrags für den Export.

Speichert Sendungsverfolgungsnummern zu einer Rechnung. Der Aufruf liefert keine Ergebnismenge.

1. Ermitteln der Rechnung

• Die Rechnung wird in Invoices über InvoiceNR gesucht.
• Zusätzlich werden verkürzte Nummern geprüft. Dazu werden Suffixe nach dem letzten - schrittweise entfernt: R1001-2-1, dann R1001-2, dann R1001. Alle passenden Nummern werden geprüft.
• Wird keine Rechnung gefunden, wird nichts geändert und der Aufruf endet ohne Fehler.

2. Trennzeichen

• Ist Separator nicht ; und nicht leer, wird jedes Vorkommen in TrackingID durch ; ersetzt.
• TrackingID kann daher mehrere Sendungsverfolgungsnummern enthalten, z. B. getrennt durch , oder |.

3. Überschreiben (Overwrite = 1)

• Alle Rechnungspakete (pixi.InvoicePackage) der Rechnung werden gelöscht, zusammen mit ihren Paketpositionen (pixi.InvoicePackageLines).
• Verweise auf diese Pakete in InvoicePolling werden auf NULL gesetzt.

4. Setzen der Sendungsverfolgungsnummern

Die interne Prozedur Pixi_SetTrackingId wird aufgerufen. Sie zerlegt die Liste und ignoriert Nummern, die bereits in Invoices.ShipmentTrackingID stehen.

Hat die Rechnung keine Pakete mit Artikeln aus einer Packstation:

• Hat die Rechnung genau ein Paket ohne Sendungsverfolgungsnummer, erhält dieses Paket die erste neue Nummer.
• Jede weitere neue Nummer legt ein neues Paket an.
• ShipmentTrackingID der Rechnung wird aus den eindeutigen Nummern aller Pakete neu aufgebaut, sortiert und mit ; getrennt.

Hat die Rechnung Pakete mit Artikeln:

• Bei genau einem Paket erhält dieses Paket die letzte neue Nummer.
• Bei mehreren Paketen bleiben die Pakete unverändert.
• ShipmentTrackingID wird zur Vereinigung aus bestehenden und neuen Nummern.

In beiden Fällen gilt für die Rechnung außerdem:

• Packages wird auf die Paketanzahl gesetzt.
• UpdateDate und UpdateEmp (TrackingID Import) werden gesetzt.
• Ein Ereignis InvoiceChanged wird veröffentlicht.

5. Erneuter Export (ResetClientNotifiedFlag = 1)

• Für jede Auftragsposition der Rechnung wird der jüngste OrderHistory-Eintrag mit Status AUS ermittelt.
• Dessen Kennzeichen ClientNotified wird auf N gesetzt.
• Der Versandstatus wird dadurch erneut exportiert, nun mit Sendungsverfolgungsnummer.

Parameter

Antwort

Dieser Call liefert kein Result-Set.

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:pixiInvoiceSetTrackingIDforPolling>
      <InvoiceNR>RE100234</InvoiceNR>
      <TrackingID>00340434161094042557;00340434161094042558</TrackingID>
      <!-- <Overwrite>0</Overwrite> -->
      <!-- <ResetClientNotifiedFlag>1</ResetClientNotifiedFlag> -->
      <!-- <Separator>;</Separator> -->
    </ns1:pixiInvoiceSetTrackingIDforPolling>
  </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:pixiInvoiceSetTrackingIDforPolling>
      <InvoiceNR>RE100234</InvoiceNR>
      <TrackingID>00340434161094042557;00340434161094042558</TrackingID>
      <!-- <Overwrite>0</Overwrite> -->
      <!-- <ResetClientNotifiedFlag>1</ResetClientNotifiedFlag> -->
      <!-- <Separator>;</Separator> -->
    </ns1:pixiInvoiceSetTrackingIDforPolling>
  </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' => 'RE100234',
    'TrackingID' => '00340434161094042557;00340434161094042558',
    // 'Overwrite' => '0',
    // 'ResetClientNotifiedFlag' => '1',
    // 'Separator' => ';',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiInvoiceSetTrackingIDforPolling

Prozedur zuletzt geändert am 2026-10-05

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