pixiCreateDirectInvoice

Legt eine Direktrechnung für einen Auftrag an, für ausgewählte oder alle offenen Auftragspositionen, und liefert das Ergebnis als Statuszeile.

Wrapper um die interne Prozedur Pixi_CreateDirectInvInvoices. Es werden immer CreationMode = 'Direct' und Sprache 1 verwendet. Die Optionen der internen Prozedur für 1SS, Lagerplatz und Mindesthaltbarkeit werden nicht genutzt.

Ablauf

1. Prüfung auf offene Positionen. Hat der Auftrag keine Auftragsposition in einem der Status RAS, OPA, NAO, ANG, BES, BOR, NAS, OPH, NAD (z. B. nur MIN-Positionen), endet der Aufruf ohne Ergebnismenge.
2. Positionsauswahl. OrderlineRefs wird an Kommas in Positionsschlüssel zerlegt. Ein leerer Wert oder NULL bedeutet alle zulässigen Positionen des Auftrags.
3. Prüfung auf aktive Pickliste. Ist OrderlineRefs leer und liegt eine Position des Auftrags auf einer aktiven Pickliste (PLitem.Expired = 0), endet der Aufruf ohne Ergebnismenge.
4. Prüfung von Kunde und Adressen. Kunde, Rechnungsadresse, Lieferadresse, Versanddienstleister und Währung werden aus OrderHeader gelesen. Ist der Kunde (SLocked) oder die Lieferadresse (ASlocked) gesperrt, wird keine Rechnung erstellt.
5. Pickliste zur Bestandsfreigabe. Ist die Einstellung DoNotReleaseStockOnDirectInvoiceScanOut gleich '0' oder AllInvoiceItemsInStock = 'Y', wird eine Pickliste für die ausgewählten Positionen erstellt (Teilaufträge und Teilmengen erlaubt).
   • Bei AllInvoiceItemsInStock = 'Y' wird die Pickliste gelöscht und keine Rechnung erstellt, wenn sie leer ist oder die gepickte Menge von der Summe der bestellten Mengen abweicht.
   • Ist die Einstellung '1', wird die Pickliste nach der Prüfung wieder gelöscht.
6. Rechnungserstellung (in einer Transaktion).
   • Der Rechnungskopf wird angelegt. Die MwSt-Art ist N, wenn die Rechnungsadresse eine USt-IdNr. (UsStID) hat oder der Kunde TaxOnInvoice = 'N' hat, sonst I.
   • Wechselkurs, Retouren-Tracking-ID und SEPA-Daten werden ermittelt.
   • Rechnungspositionen werden für die ausgewählten, noch nicht berechneten Positionen in den obigen Status sowie MIN eingefügt.
   • Die nächste Rechnungsnummer des Shops wird vergeben. Das Paketgewicht ist die Einstellung DefaultShippingWeight, bei CalculateWeightFromItems = 1 die Summe der Artikelgewichte, begrenzt auf 999999.999.
7. Aktualisierung der Auftragspositionen. Berechnete Nicht-MIN-Positionen erhalten InvRef und Status EIN. MIN-Positionen erhalten nur InvRef.
8. Stornierung verbleibender Positionen. Bei Einstellung Invoice_CancelPartialDelivery = '1' werden verbleibende ANG/HAL/BOR-Positionen von Aufträgen mit ForceToPickListIfNotFULL = 1 und OHCancelAfterForcedShipOut = 1 auf STO gesetzt.
9. Automatischer Scan-Out. Verlangt dies der Versanddienstleister (DoScanOutOnInvoiceCreate) oder die Zahlungsart (AutoScanOutInvoice):
   • eine Kiste wird angelegt und ausgescannt;
   • ein Job zur Bestandsfreigabe wird in ExecQueries eingereiht;
   • bei Einstellung 1SS_ForceAutoScanOut = 1 wird die Kiste gelöscht und ScanOutDone wird 1.
10. Event. Das MQ-Event InvoiceCreated wird veröffentlicht und die Transaktion bestätigt.

Abschließend wird eine Statuszeile mit Success, InvoiceKey, CreatedInv und InvoicePackageId geliefert.

Parameter

Antwort

Result-Set 1 · Nur bei einem Fehler während der Rechnungserstellung; danach folgt der erneut ausgelöste SQL-Fehler.

Fehlerzeile der fehlgeschlagenen Rechnungserstellung.

Result-Set 2 · Wenn die Verarbeitung normal endet oder ein Picklistenschritt fehlschlägt; nicht bei vorzeitigem Abbruch ohne Ergebnismenge.

Abschließende Statuszeile der Direktrechnungserstellung.

<SqlRowSet1>
  <row>
    <Success>1</Success>
    <InvoiceKey>512345</InvoiceKey>
    <ScanOutDone>false</ScanOutDone>
    <CreatedInv>512345</CreatedInv>
    <InvoicePackageId>498761</InvoicePackageId>
  </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:pixiCreateDirectInvoice>
      <OrderNr>93867</OrderNr>
      <OrderlineRefs>,280671,280672,</OrderlineRefs>
      <!-- <AllInvoiceItemsInStock>Y</AllInvoiceItemsInStock> -->
      <!-- <LocID>001</LocID> -->
      <!-- <CreateEmp>API</CreateEmp> -->
    </ns1:pixiCreateDirectInvoice>
  </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:pixiCreateDirectInvoice>
      <OrderNr>93867</OrderNr>
      <OrderlineRefs>,280671,280672,</OrderlineRefs>
      <!-- <AllInvoiceItemsInStock>Y</AllInvoiceItemsInStock> -->
      <!-- <LocID>001</LocID> -->
      <!-- <CreateEmp>API</CreateEmp> -->
    </ns1:pixiCreateDirectInvoice>
  </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 = [
    'OrderNr' => '93867',
    'OrderlineRefs' => ',280671,280672,',
    // 'AllInvoiceItemsInStock' => 'Y',
    // 'LocID' => '001',
    // 'CreateEmp' => 'API',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateDirectInvoice

Prozedur zuletzt geändert am 2026-10-05

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