Orders Schreiben

pixiRequestPartialDelivery

Aktiviert oder deaktiviert die Teillieferung für einen Auftrag und setzt die zugehörigen Storno- und Mehrfach-Teillieferungs-Flags, sofern der Auftrag nicht abgeschlossen oder gesperrt ist.

Ändert die Teillieferungs-Einstellungen im Kopf eines Auftrags.

Der Gesamtstatus des Auftrags wird aus seinen Auftragspositionen ermittelt:
- CLOSED – alle Positionen befinden sich in einem Endstatus, oder der Auftrag hat gar keine Positionen (das gilt auch für nicht existierende Auftragsnummern).
- HOLD – jede Position ist im Status HAL, im Status MIN oder in einem Endstatus.
- OPEN – in allen anderen Fällen.
Nur wenn der Status weder CLOSED noch HOLD ist, wird der Auftragskopf mit OrderNr = @OrderNr aktualisiert:
- ForceToPicklistIfNotFULL wird auf 1 gesetzt, wenn @PartialDeliveryActive gleich 1 ist; bei 0 oder NULL wird das Feld auf NULL gesetzt (Teillieferung aus). Dieser Wert wird immer geschrieben.
- OHCancelAfterForcedShipOut wird auf @CancelUnavailableItems gesetzt; fehlt der Parameter oder ist er NULL, bleibt der bisherige Wert erhalten.
- OHMultiForceToPicklist wird auf @PartialDeliveryForRemaining gesetzt; fehlt der Parameter oder ist er NULL, bleibt der bisherige Wert erhalten.
Die Anzahl der betroffenen Zeilen wird in der Spalte RowsUpdated zurückgegeben (1, wenn der Auftragskopf aktualisiert wurde).

Hinweise

Ist der Auftrag abgeschlossen, gesperrt oder nicht vorhanden, wird kein Fehler gemeldet; es erfolgt lediglich keine Aktualisierung. Über RowsUpdated lässt sich prüfen, ob die Änderung übernommen wurde.
RowsUpdated wird nach dem bedingten Update aus @@ROWCOUNT gelesen. Wird das Update übersprungen, wird der Wert nicht explizit auf 0 gesetzt, sondern ergibt sich aus der Zeilenzählung von SQL Server für die vorherigen Anweisungen; zur sicheren Unterscheidung sollte der Auftragsstatus bei Bedarf separat abgefragt werden.
Anders als bei den beiden anderen Flags gibt es für @PartialDeliveryActive keine Beibehaltung des bisherigen Werts: NULL schaltet die Teillieferung aus.
Der Auftragsstatus wird mit NOLOCK aus den Auftragspositionen gelesen; bei gleichzeitigen Änderungen kann die Statusprüfung leicht veraltet sein.
Es wird keine explizite Transaktion verwendet.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`OrderNr` Pflicht	int	–	Interne Pixi-Auftragsnummer (`OrderHeader.OrderNr`) des zu ändernden Auftrags. Beispiel: `123456`
`PartialDeliveryActive` Pflicht	bit boolean	–	Schaltet die Teillieferung ein oder aus (`ForceToPicklistIfNotFULL`). `1` setzt das Flag, `0` oder `NULL` setzt es auf `NULL`. Erlaubte Werte `1` – Teillieferung aktiv: Auftrag darf auch ohne vollständige Verfügbarkeit auf eine Pickliste. `0` – Teillieferung aus (Feld wird auf NULL gesetzt). Beispiel: `1`
`CancelUnavailableItems`	bit boolean	NULL	Wert für `OHCancelAfterForcedShipOut` (nicht verfügbare Artikel nach der erzwungenen Teillieferung stornieren). `NULL` behält den bisherigen Wert bei. Beispiel: `0`
`PartialDeliveryForRemaining`	bit boolean	NULL	Wert für `OHMultiForceToPicklist` (weitere Teillieferungen für die Restmenge erlauben). `NULL` behält den bisherigen Wert bei. Beispiel: `1`

Antwort

Result-Set 1 · Immer

Anzahl der aktualisierten Auftragskopf-Zeilen.

Spalte	Typ	Beschreibung
`RowsUpdated`	int	Wert von `@@ROWCOUNT`; `1`, wenn der Auftragskopf aktualisiert wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <RowsUpdated>1</RowsUpdated>
  </row>
</SqlRowSet1>

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:pixiRequestPartialDelivery>
      <OrderNr>123456</OrderNr>
      <PartialDeliveryActive>1</PartialDeliveryActive>
      <!-- <CancelUnavailableItems>0</CancelUnavailableItems> -->
      <!-- <PartialDeliveryForRemaining>1</PartialDeliveryForRemaining> -->
    </ns1:pixiRequestPartialDelivery>
  </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:pixiRequestPartialDelivery>
      <OrderNr>123456</OrderNr>
      <PartialDeliveryActive>1</PartialDeliveryActive>
      <!-- <CancelUnavailableItems>0</CancelUnavailableItems> -->
      <!-- <PartialDeliveryForRemaining>1</PartialDeliveryForRemaining> -->
    </ns1:pixiRequestPartialDelivery>
  </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' => '123456',
    'PartialDeliveryActive' => '1',
    // 'CancelUnavailableItems' => '0',
    // 'PartialDeliveryForRemaining' => '1',
];

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

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

Verwendete Tabellen

OrderHeader · Schreiben Orderlines · Lesen OrderStates · Lesen

SQL-Objekt:: dbo.pipiRequestPartialDelivery