pixiCreateSDeliveryByTemplate

Legt aus einer oder mehreren bestätigten Lieferantenbestellungen eine neue Lieferantenlieferung (Status NEW) an einem Lager an und liefert deren Kopfdaten.

Legt einen Lieferantenlieferschein (SDelHeader mit Positionen in SDelDetail) auf Basis einer oder mehrerer Lieferantenbestellungen als Vorlage an.

1. OrderNr wird an ; in einzelne Bestellnummern zerlegt (die InternalNumber der Lieferantenbestellung, z. B. eine BES-Nummer). Führende und abschließende Leerzeichen werden entfernt.
2. Existiert am Lager LocID bereits eine Lieferung mit Status NEW, deren SDelHextOrderNr eine der übergebenen Nummern enthält, bricht der Aufruf ab und liefert eine Zeile mit der Spalte ERROR.
3. Andernfalls wird die interne Prozedur Pixi_CreateSDeliveryByTemplate ausgeführt:
   • Es werden nur Lieferantenbestellungen verwendet, deren Status als bestätigt gilt. Welches Statuskennzeichen geprüft wird, hängt von der Einstellung ConfirmOrderedDocumentOnDelivery ab: 0 verlangt IsConfirmed = 1, 1 verlangt IsOrderedConfirmed = 1.
   • Qualifiziert sich keine Bestellung, wird nichts angelegt.
   • Bei Einstellung 1 werden die betroffenen, noch nicht bestätigten Lieferantenbestellungen auf den bestätigten Status gesetzt (Bestätigungsdatum und -benutzer werden gesetzt).
   • Es wird ein Lieferungskopf mit Status NEW, dem angegebenen Lager, dem Lieferanten einer der Bestellungen, SDelHextOrderNr = vollständiger OrderNr-String und UserName als anlegender/ändernder Benutzer angelegt (Standard TemplateFromBuying, falls NULL).
   • Für jede Bestellposition mit offener Menge (Qty - DeliveredQty - UndeliveredQty > 0) wird eine Lieferposition mit gelieferter Menge 0, der offenen Menge als bestellter Menge, dem Lieferantenpreis sowie dem in Prozent und Endpreis umgerechneten Rabatt angelegt.
4. Abschließend werden die Kopfdaten der angelegten Lieferung geliefert (SDelHKey, Datum, Lager, Nummer, Status, externe Bestellnummer, Lieferant).

Parameter

Antwort

Result-Set 1 · Wenn am Lager bereits eine offene Lieferung (Status NEW) eine der Bestellnummern referenziert

Fehlerzeile; der Aufruf endet, ohne etwas anzulegen.

Result-Set 2 · Andernfalls; leer, wenn keine passende Lieferantenbestellung gefunden wurde

Kopfdaten der neu angelegten Lieferantenlieferung.

<SqlRowSet1>
  <row>
    <SDelHKey>4711</SDelHKey>
    <SDelHDate>2024-05-14T10:23:45.123+02:00</SDelHDate>
    <SDelHLocationID>001</SDelHLocationID>
    <SDelHNr>4711</SDelHNr>
    <SDelHStatus>NEW</SDelHStatus>
    <SDelHextOrderNr>BES0001234;BES0001235</SDelHextOrderNr>
    <SDelHSupplNr>L001</SDelHSupplNr>
  </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:pixiCreateSDeliveryByTemplate>
      <OrderNr>BES0001234;BES0001235</OrderNr>
      <LocID>001</LocID>
      <UserName>jdoe</UserName>
    </ns1:pixiCreateSDeliveryByTemplate>
  </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:pixiCreateSDeliveryByTemplate>
      <OrderNr>BES0001234;BES0001235</OrderNr>
      <LocID>001</LocID>
      <UserName>jdoe</UserName>
    </ns1:pixiCreateSDeliveryByTemplate>
  </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' => 'BES0001234;BES0001235',
    'LocID' => '001',
    'UserName' => 'jdoe',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateSDeliveryByTemplate

Prozedur zuletzt geändert am 2026-10-05

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