pixiCreateDirectInv

Legt eine Direktrechnung für einen Auftrag an, entweder für alle offenen Auftragspositionen oder für eine kommagetrennte Liste von Positionsschlüsseln.

Der Aufruf ist ein schlanker Wrapper um die interne Prozedur Pixi_CreateDirectInvInvoices. Übergeben werden LocID, CreateEmp, OrderNr und OrderlineRefs; alle anderen Werte sind fest: keine Prüfung "alle Artikel auf Lager", keine Lagerplatz-Einschränkung, kein 1SS-Modus (One-Step-Shipping), Ergebniszeile aktiv, eigene Transaktion, Erstellungsmodus Manual, Sprache 1.

Vorprüfungen (keine Ergebnismenge, keine Rechnung):

• Hat der Auftrag keine Position in einem der offenen Status RAS, OPA, NAO, ANG, BES, BOR, NAS, OPH, NAD, endet der Aufruf ohne Meldung.
• Ist OrderlineRefs leer und liegt eine Position des Auftrags auf einer aktiven (nicht abgelaufenen) Pickliste, endet der Aufruf ohne Meldung.

Auswahl der Positionen:

• OrderlineRefs wird an Kommas getrennt; nur numerische Schlüssel > 0 werden verwendet. Bei leerem Wert werden alle Positionen des Auftrags verwendet.
• Berechnet werden nur Positionen von OrderNr in den oben genannten offenen Status sowie MIN, und nur, wenn sie noch nicht auf einer Rechnungsposition stehen.
• Der Kunde darf nicht gesperrt sein (SLocked) und die Lieferadresse nicht gesperrt (ASlocked); sonst wird nichts angelegt.

Rechnungserstellung:

1. Abhängig von der Einstellung DoNotReleaseStockOnDirectInvoiceScanOut (Wert 0) wird intern eine Pickliste für die gewählten Positionen erzeugt (Teillieferung und Teilmengen erlaubt) und mit dem Kommentar DirectInvStockRelease markiert.
2. In einer Transaktion wird der Rechnungskopf angelegt (MwSt-Typ I, oder N, wenn die Rechnungsadresse eine USt-IdNr. hat oder der Kunde TaxOnInvoice = 'N' hat), Wechselkurs und Retouren-Tracking-ID werden ermittelt und SEPA-Daten ergänzt.
3. Rechnungspositionen werden aus den Auftragspositionen übernommen (Menge, Preis, Rabatt, MwSt, Versandkosten, Währung, Seriennummer).
4. Die Rechnung erhält die nächste Rechnungsnummer des Shops und ein Paket-Bruttogewicht (Einstellung DefaultShippingWeight oder aus Artikelgewichten berechnet, wenn CalculateWeightFromItems = 1).
5. Berechnete offene Positionen erhalten Status EIN und die Rechnungsreferenz; MIN-Positionen erhalten nur die Rechnungsreferenz.
6. Bei Invoice_CancelPartialDelivery = 1 werden verbleibende ANG/HAL/BOR-Positionen von Aufträgen mit erzwungener Teillieferung und Stornierung auf STO gesetzt.
7. Verlangt der Versanddienstleister (DoScanOutOnInvoiceCreate) oder die Zahlungsart (AutoScanOutInvoice) es, wird eine Kiste angelegt und ausgescannt sowie ein Job zur Bestandsfreigabe eingereiht.
8. Das Ereignis InvoiceCreated wird veröffentlicht.

Am Ende wird eine Statuszeile zurückgegeben (siehe Ergebnismengen).

Parameter

Antwort

Result-Set 1 · Am Ende der Verarbeitung, sofern keine Vorprüfung den Aufruf beendet hat und kein Fehler in der Rechnungstransaktion auftrat.

Abschließende Statuszeile der Direktrechnungserstellung.

Result-Set 2 · Bei einem Fehler in der Rechnungstransaktion; danach folgt der erneut ausgelöste SQL-Fehler.

Fehlerzeile, die vor dem erneuten Auslösen des Fehlers geliefert wird.

<SqlRowSet1>
  <row>
    <Success>1</Success>
    <InvoiceKey>48213</InvoiceKey>
    <ScanOutDone>0</ScanOutDone>
    <CreatedInv>48213</CreatedInv>
    <InvoicePackageId>51007</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:pixiCreateDirectInv>
      <!-- <LocID>001</LocID> -->
      <!-- <CreateEmp>API</CreateEmp> -->
      <OrderNr>100245</OrderNr>
      <OrderlineRefs>,1234,1235,</OrderlineRefs>
    </ns1:pixiCreateDirectInv>
  </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:pixiCreateDirectInv>
      <!-- <LocID>001</LocID> -->
      <!-- <CreateEmp>API</CreateEmp> -->
      <OrderNr>100245</OrderNr>
      <OrderlineRefs>,1234,1235,</OrderlineRefs>
    </ns1:pixiCreateDirectInv>
  </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 = [
    // 'LocID' => '001',
    // 'CreateEmp' => 'API',
    'OrderNr' => '100245',
    'OrderlineRefs' => ',1234,1235,',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateDirectInv

Prozedur zuletzt geändert am 2026-10-05

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