pixiPutIntoBox

Scannt eine einzelne Auftragsposition in eine Box ein (Scan-In mit Pickliste), teilt die Position bei Bedarf und prüft Charge und MHD.

Führt den Scan-In einer Auftragsposition in eine Versandbox durch, so wie es der Pixi-Versandclient beim Scan-In mit Pickliste tut. Der Aufruf arbeitet mit genau der Auftragsposition aus OrderlineKey.

Ablauf:

1. Prüft, ob die Einstellung Premium_API aktiv ist. Andernfalls wird eine Fehlerzeile geliefert.
2. Liest Artikel und Lager der Auftragsposition. Ist die Einstellung BatchManagement gleich 1, wird geprüft, ob der Artikel das Chargen-Tag (TagId -6) oder das MHD-Tag (TagId -7) trägt. Ohne eines dieser Tags gilt die Chargenverwaltung für diesen Artikel als deaktiviert.
3. Ist die Chargenverwaltung deaktiviert, aber BatchNumber oder BestBeforeDate werden übergeben, endet der Aufruf mit Wrong Batch Management data.
4. Ist die Chargenverwaltung aktiv, werden die aktiven Picklistenpositionen (PLitem, Expired = 0) der Auftragsposition gezählt, deren Lagerplatz-Artikel genau die übergebene Charge und das übergebene MHD haben. Gibt es keine, endet der Aufruf mit einem Fehler.
5. Ist PickListNr gleich 0, die Auftragsposition liegt aber auf einer aktiven Pickliste, endet der Aufruf mit Item is part of picklist: ….
6. Sucht die Auftragsposition über die Scan-In-Suchlogik, eingeschränkt auf diese Position und die übergebene Pickliste. Die Position muss einen Status haben, der Scan-In erlaubt, darf nicht zu einem gesperrten Kunden oder einer gesperrten Adresse gehören (außer der Benutzer hat die Berechtigung SHILC) und muss bei Angabe einer Pickliste auf dieser liegen. Wird nichts gefunden: No order found!.
7. Ermittelt die Menge, die in die Box gelegt wird:
   • die Picklistenmenge der Position, bei aktiver Chargenverwaltung begrenzt auf die Anzahl passender Chargen-Positionen;
   • ist ScannedQty ungleich 0, darf sie diese Menge nicht überschreiten und ersetzt sie.
8. Ist die Positionsmenge größer als diese Menge, wird die Auftragsposition geteilt, sodass der gescannte Teil die ermittelte Menge behält (GOSBreakOrderline).
9. Ruft die interne Logik zum Einlegen in die Box auf (Pixi_PutIntoBox). Sie verwendet die Lagerbewegungsoperation ScanInWithPicklist der Anwendung ShippingClient_A und den Log-Grund API - ScanIn with picklist. Die Logik:
   • übernimmt FromBox/ToBox aus dem Picklistenkopf, falls dort ein Boxbereich hinterlegt ist;
   • sucht eine Box für den Kunden oder führt eine interne Umlagerung durch, wenn das Auftragslager vom letzten Auftragslager abweicht;
   • prüft, dass die Box keine Artikel eines anderen Kunden enthält und der Auftrag nicht bereits in einer anderen offenen Box liegt;
   • aktualisiert die Auftragsposition für den Scan-In und gibt die Picklistenpositionen vom Lagerplatz frei;
   • veröffentlicht das Message-Queue-Ereignis ScanInPutIntoBox und ScanInBoxFull, wenn die Box nun voll ist.

Ergebnis ist eine Zeile mit der Box und einem Wert in Action. IN BOX LEGEN bedeutet Erfolg; andere Werte beschreiben, warum der Artikel nicht in eine Box gelegt wurde.

Parameter

Antwort

Result-Set 1 · Wenn eine Prüfung vor dem Einlegen in die Box fehlschlägt (Einstellung, Chargendaten, Pickliste, Positionssuche, Menge).

Fehlerstatuszeile. In diesem Fall werden keine Daten geändert.

Result-Set 2 · Wenn alle Prüfungen bestanden sind (geliefert von der internen Logik zum Einlegen in die Box).

Eine Zeile mit der Box und dem Ergebnis des Einlegens in die Box.

<SqlRowSet1>
  <row>
    <Status>ERROR</Status>
    <StatusMessage>Item is part of picklist: 4711</StatusMessage>
  </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:pixiPutIntoBox>
      <OrderlineKey>123456</OrderlineKey>
      <SupplGroup>?</SupplGroup>
      <Username>api_user</Username>
      <!-- <SupplOrderNr>0</SupplOrderNr> -->
      <FromBox>1</FromBox>
      <ToBox>200</ToBox>
      <SerialNr>?</SerialNr>
      <!-- <PickListNr>4711</PickListNr> -->
      <!-- <IsPersonalizedScanIn>0</IsPersonalizedScanIn> -->
      <!-- <BinRef>0</BinRef> -->
      <!-- <BatchNumber>CH-2024-001</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
      <!-- <ScannedQty>2</ScannedQty> -->
    </ns1:pixiPutIntoBox>
  </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:pixiPutIntoBox>
      <OrderlineKey>123456</OrderlineKey>
      <SupplGroup>?</SupplGroup>
      <Username>api_user</Username>
      <!-- <SupplOrderNr>0</SupplOrderNr> -->
      <FromBox>1</FromBox>
      <ToBox>200</ToBox>
      <SerialNr>?</SerialNr>
      <!-- <PickListNr>4711</PickListNr> -->
      <!-- <IsPersonalizedScanIn>0</IsPersonalizedScanIn> -->
      <!-- <BinRef>0</BinRef> -->
      <!-- <BatchNumber>CH-2024-001</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
      <!-- <ScannedQty>2</ScannedQty> -->
    </ns1:pixiPutIntoBox>
  </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',
    'SupplGroup' => '?',
    'Username' => 'api_user',
    // 'SupplOrderNr' => '0',
    'FromBox' => '1',
    'ToBox' => '200',
    'SerialNr' => '?',
    // 'PickListNr' => '4711',
    // 'IsPersonalizedScanIn' => '0',
    // 'BinRef' => '0',
    // 'BatchNumber' => 'CH-2024-001',
    // 'BestBeforeDate' => '2025-12-31T00:00:00',
    // 'ScannedQty' => '2',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiPutIntoBox

Prozedur zuletzt geändert am 2026-10-05

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