pixi_CreateSDeliveryByTemplate

Legt aus einer oder mehreren bestätigten Lieferantenbestellungen eine neue Lieferantenlieferung (Status NEW) an und führt anschließend eine Abfrage der Lieferungsköpfe aus.

Veralteter Wrapper, der anhand von Lieferantenbestellungen als Vorlage einen Lieferantenlieferschein (SDelHeader / SDelDetail) anlegt. Anschließend ruft er eine seitenweise Liste der Lieferungsköpfe auf.

Schritt 1 – Lieferung anlegen (über Pixi_CreateSDeliveryByTemplate):

1. OrderNr wird an ; getrennt. Jedes Element wird mit der internen Nummer (InternalNumber) einer Lieferantenbestellung abgeglichen.
2. Es werden nur Lieferantenbestellungen in einem passenden Status verwendet. Das hängt von der Einstellung ConfirmOrderedDocumentOnDelivery ab:
   • 0: Bestellungen, deren Status als bestätigt markiert ist (IsConfirmed = 1).
   • 1: Bestellungen, deren Status als bestellt-bestätigt markiert ist (IsOrderedConfirmed = 1). Diese Bestellungen werden danach auf den ersten bestätigten Status gesetzt. Zusätzlich werden Bestätigungsdatum, bestätigender Benutzer, Änderungsdatum und ändernder Benutzer gesetzt.
3. Qualifiziert sich keine Bestellung, wird nichts angelegt.
4. Andernfalls wird ein Lieferungskopf mit folgenden Werten eingefügt:
   • Status NEW und Lager LocID
   • die Lieferantennummer einer der gefundenen Bestellungen
   • der vollständige OrderNr-String als externe Bestellnummer
   • UserName als anlegender und ändernder Mitarbeiter sowie das aktuelle Datum
5. Für jede Bestellposition mit offener Menge > 0 wird eine Lieferposition angelegt. Die offene Menge ist Qty - DeliveredQty - UndeliveredQty.
   • Die gelieferte Menge ist 0, die bestellte Menge ist die offene Menge.
   • Lieferantenpreis und Rabatt stammen aus der Bestellposition. Ein Prozentrabatt wird direkt übernommen; ein Betragsrabatt wird pro Stück in einen Prozentwert umgerechnet.
   • End- und Mittelpreis sind Preis minus Rabattbetrag.

Schritt 2 – Listenabfrage (über Pixi_GetSDelHeaderByPage): Der Code fragt Lieferungsköpfe des Lagers LocID mit Status NEW oder INV ab (das Argument ShowInv = NULL wird zu 1). Der Aufruf übergibt Seitennummer 0, daher lautet das Zeilenfenster RowNum BETWEEN -PerPage+1 AND 0. Die zurückgegebene Ergebnismenge enthält deshalb nie Zeilen.

Die ID der neuen Lieferung wird nicht zurückgegeben.

Parameter

Antwort

Result-Set 1 · Immer; enthält nie Zeilen, weil der Code Seite 0 anfordert.

Liste der Lieferungsköpfe des Lagers (Status NEW oder INV), erzeugt von der inneren Listenprozedur.

<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:pixi_CreateSDeliveryByTemplate>
      <OrderNr>100234;100235</OrderNr>
      <LocID>001</LocID>
      <UserName>jdoe</UserName>
    </ns1:pixi_CreateSDeliveryByTemplate>
  </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:pixi_CreateSDeliveryByTemplate>
      <OrderNr>100234;100235</OrderNr>
      <LocID>001</LocID>
      <UserName>jdoe</UserName>
    </ns1:pixi_CreateSDeliveryByTemplate>
  </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' => '100234;100235',
    'LocID' => '001',
    'UserName' => 'jdoe',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipi_CreateSDeliveryByTemplate

Prozedur zuletzt geändert am 2026-10-05

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