pixiCreateInvoice

Legt eine Rechnung für eine gepackte Kiste (BoxNr an einem Lager) an und liefert die neue Rechnungs-ID und Rechnungsnummer mit einer Statuszeile.

Legt die Rechnung für den Inhalt einer Kiste an und liefert immer genau eine Statuszeile.

1. Ist BoxNr oder LocId NULL, wird eine Fehlerzeile geliefert. Ein leerer UserName wird durch API ersetzt.
2. Die Kiste wird mit der internen Prozedur GOS_BoxesRange (Bereich BoxNr..BoxNr am Lager LocId) auf Fakturierbarkeit geprüft. Die Kiste ist fakturierbar, wenn alle folgenden Bedingungen gelten:
   • sie ist noch nicht als versendet markiert (WaitForSend <> Y) oder sie ist physisch voll und enthält Positionen ohne Rechnungspositionen;
   • der Kunde hat keine Versandsperre (SLocked nicht Y/1);
   • keine Lieferadresse der Auftragspositionen in der Kiste hat eine Versandsperre (ASlocked);
   • die Kistennummer ist nicht die eigene Kistennummer des Lagers (LocBoxNumber);
   • haben Auftragspositionen der Kiste ein Bestätigungsdatum (ConfDate), liegt mindestens eines davon auf dem heutigen Tag.
3. Ist die Kiste nicht fakturierbar, wird der Grund ermittelt und als Fehlerzeile geliefert: Kiste an diesem Lager nicht gefunden, Kiste leer, Rechnung existiert bereits, Versandsperre auf einer Auftragsadresse, Versandsperre beim Kunden; sonst ein allgemeines "Invoice creation failed." (deckt auch die Regeln zu ConfDate und Lager-Kistennummer ab).
4. Ist die Kiste fakturierbar, legt die interne Prozedur Pixi_CreateInv die Rechnung mit Erstellungsmodus API und Sprach-ID 1 an. Dabei wird:
   • die Kiste als versendet markiert (WaitForSend = 'Y') und gegen Doppelfakturierung gesperrt;
   • der Rechnungskopf (Invoices) und je Kistenposition eine Rechnungsposition (Invlines) angelegt; zusätzlich noch nicht fakturierte Auftragspositionen desselben Auftrags mit Status MIN oder einem Status aus der Einstellung PutThisStatusesOnInvoice;
   • Orderlines.InvRef gesetzt, die endgültige Rechnungsnummer je Shop vergeben, Bruttogewicht, Retouren-Tracking-ID und ein InvoicePackage-Datensatz gespeichert;
   • optional die Kiste ausgescannt, offene Teillieferungen storniert, die Rechnung auf das Kundenkonto gebucht und das Ereignis InvoiceCreated veröffentlicht. Existiert für die Kiste bereits eine Entwurfsrechnung (InvoiceStatusId = 0), wird stattdessen dieser Entwurf finalisiert (Erstellungsmodus MobileShipOut).
5. Ergebnis: bei Erfolg eine Zeile mit InvoiceId, InvoiceNr und Status = 'SUCCESS'; bei Fehler sind InvoiceId/InvoiceNr NULL und Status/Message enthalten den Fehler.

Parameter

Antwort

Result-Set 1 · Immer (genau eine Zeile, Erfolg oder Fehler)

Statuszeile mit der angelegten Rechnung oder dem Fehler.

<SqlRowSet1>
  <row>
    <InvoiceId>184532</InvoiceId>
    <InvoiceNr>RE2024104871</InvoiceNr>
    <Status>SUCCESS</Status>
    <Message/>
  </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:pixiCreateInvoice>
      <BoxNr>1042</BoxNr>
      <LocId>001</LocId>
      <!-- <UserName>shopconnector</UserName> -->
    </ns1:pixiCreateInvoice>
  </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:pixiCreateInvoice>
      <BoxNr>1042</BoxNr>
      <LocId>001</LocId>
      <!-- <UserName>shopconnector</UserName> -->
    </ns1:pixiCreateInvoice>
  </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' => '1042',
    'LocId' => '001',
    // 'UserName' => 'shopconnector',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateInvoice

Prozedur zuletzt geändert am 2026-10-05

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