Direct-Fulfillment Schreiben

pixiDFSetSupplierNotifiedFlag

Setzt oder entfernt das Benachrichtigt-Kennzeichen (`ClientNotified`) am letzten `FUT`-Historieneintrag der Auftragspositionen eines Auftrags oder einer einzelnen Position.

Kennzeichnet Auftragspositionen im Direct-Fulfillment-Prozess (Streckengeschäft) als an den Lieferanten gemeldet bzw. nicht gemeldet.

Kandidaten werden aus Orderlines ermittelt, bei denen OrderlineKey = @OrderlineKey oder OrderNr = @OrderNr gilt. Positionen mit Status HAL werden ausgeschlossen.
Für jeden Kandidaten wird geprüft, ob er bearbeitbar ist: Eine Position ist nur bearbeitbar, wenn sie keinen Eintrag in OrderHistory mit einem Status außerhalb von HAL, ANG, BES, FUT, NEW besitzt. Positionen mit einem anderen Historienstatus werden übersprungen.
Für jede bearbeitbare Position wird der OrderHistory-Eintrag mit dem höchsten OrderHistKey unter ihren Einträgen mit Status FUT aktualisiert: ClientNotified wird auf Y gesetzt, wenn @IsNotified = 1, sonst auf N.

Positionen ohne FUT-Historieneintrag bleiben unverändert. Der Aufruf liefert keine Ergebnismenge und keine Statuszeile.

Hinweise

Die beiden Filterparameter werden mit OR verknüpft: Werden beide übergeben, werden Positionen verarbeitet, die entweder zum Positionsschlüssel oder zur Auftragsnummer passen. Wird keiner übergeben, wird nichts aktualisiert.
Die Prüfung IF @IsNotified = NULL ist bei Standardeinstellung von ANSI_NULLS nie wahr. Wird IsNotified explizit als NULL übergeben, greift daher nicht der Wert 1; das Kennzeichen wird auf N gesetzt. Für den Standardwert 1 den Parameter weglassen.
Trotz des Aufrufnamens wird die Spalte OrderHistory.ClientNotified geschrieben.
Es gibt keine Rückmeldung über die Anzahl aktualisierter Zeilen (SET NOCOUNT ON, keine Ergebnismenge); ob eine Position als nicht bearbeitbar übersprungen wurde, ist für den Aufrufer nicht erkennbar.
Die Kandidatenermittlung liest mit NOLOCK; das Update verwendet ROWLOCK. Keine explizite Transaktion.

Parameter

Parameter Typ Standardwert Beschreibung

Parameter	Typ	Standardwert	Beschreibung
`OrderlineKey`	int	NULL	Schlüssel einer einzelnen zu verarbeitenden Auftragsposition. Mit `OrderNr` per ODER verknüpft. Beispiel: `123456`
`OrderNr`	int	NULL	Auftragsnummer; alle Positionen dieses Auftrags (außer Status `HAL`) werden verarbeitet. Mit `OrderlineKey` per ODER verknüpft. Beispiel: `98765`
`IsNotified`	bit boolean	1	Zu setzender Wert des Benachrichtigt-Kennzeichens. Erlaubte Werte `1` – `ClientNotified` auf `Y` setzen (benachrichtigt). `0` – `ClientNotified` auf `N` setzen (nicht benachrichtigt). Beispiel: `1`

OrderlineKey

int

NULL

Schlüssel einer einzelnen zu verarbeitenden Auftragsposition. Mit OrderNr per ODER verknüpft.

Beispiel: 123456

OrderNr

int

NULL

Auftragsnummer; alle Positionen dieses Auftrags (außer Status HAL) werden verarbeitet. Mit OrderlineKey per ODER verknüpft.

Beispiel: 98765

IsNotified

bit
boolean

Zu setzender Wert des Benachrichtigt-Kennzeichens.

Erlaubte Werte

1 – `ClientNotified` auf `Y` setzen (benachrichtigt).
0 – `ClientNotified` auf `N` setzen (nicht benachrichtigt).

Beispiel: 1

Antwort

Dieser Call liefert kein Result-Set.

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:pixiDFSetSupplierNotifiedFlag>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <OrderNr>98765</OrderNr> -->
      <!-- <IsNotified>1</IsNotified> -->
    </ns1:pixiDFSetSupplierNotifiedFlag>
  </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:pixiDFSetSupplierNotifiedFlag>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <OrderNr>98765</OrderNr> -->
      <!-- <IsNotified>1</IsNotified> -->
    </ns1:pixiDFSetSupplierNotifiedFlag>
  </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 = [
    // 'OrderlineKey' => '123456',
    // 'OrderNr' => '98765',
    // 'IsNotified' => '1',
];

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

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

Verwendete Tabellen

Orderlines · Lesen OrderHistory · Schreiben

SQL-Objekt:: dbo.pipiDFSetSupplierNotifiedFlag