pixiBinCreate

Legt einen oder mehrere Lagerplätze aus einer XML-Liste an, prüft jeden Eintrag und liefert pro Lagerplatz eine Statuszeile.

Legt neue Lagerplätze in der Tabelle InvBin aus dem in BinsXML übergebenen XML an. Jedes Element /Bins/Bin beschreibt einen Lagerplatz.

Prüfungen für die gesamte Anfrage

• Ist BinsXML NULL oder leer oder enthält es kein Element /Bins/Bin, wird eine einzelne Statuszeile ERROR / XML contains no data. geliefert.
• Kann der Text nicht in XML umgewandelt werden, wird ERROR / Cannot parse XML geliefert.

Prüfung je Lagerplatz (ein Lagerplatz, der eine Prüfung nicht besteht, erhält Status = ERROR und wird nicht angelegt):

1. Duplikate innerhalb der Anfrage: Bei Einstellung FilterStockOperationsWithLocation = 0 muss der Lagerplatzname in der Anfrage eindeutig sein, bei Einstellung = 1 die Kombination aus Name und Lager. Transportlagerplätze (TransportBin = 1) mit gleichem Namen gelten unabhängig vom Lager immer als Duplikat.
2. Name darf nicht leer sein.
3. LocId darf nicht leer sein.
4. SortNr muss eine ganze Zahl ≥ 0 sein (Pflicht).
5. MaxItems muss eine ganze Zahl ≥ 0 sein (Pflicht).
6. Duplikate in der Datenbank: Bei Einstellung = 0 darf kein vorhandener Lagerplatz in irgendeinem Lager denselben Namen haben, bei Einstellung = 1 kein vorhandener Lagerplatz mit demselben Namen im selben Lager.
7. Das Lager LocId muss in Location existieren.

Anlage Alle fehlerfreien Lagerplätze werden in einer Transaktion in InvBin eingefügt (BinLocID, BinName, BinMaxItems, BinSortNum, BinGroup, TransportBin); CreateEmp/UpdateEmp erhalten den Wert von CreateEmp (Standard API), CreateDate/UpdateDate den aktuellen Zeitpunkt. Ein fehlendes Group wird als Leerstring, ein fehlendes TransportBin als 0 gespeichert.

Antwort Eine Zeile je Bin-Element, sortiert nach seiner Position im XML (Row). Erfolgreich angelegte Lagerplätze haben Status = CREATED, eine leere Message und den neuen BinKey (ermittelt über Name und Lager). Abgelehnte Lagerplätze haben Status = ERROR, den Grund in Message und BinKey = NULL.

Parameter

<Bins>
  <Bin>
    <Name>A-01-01</Name>
    <LocId>001</LocId>
    <Group>Regal A</Group>
    <SortNr>10</SortNr>
    <MaxItems>100</MaxItems>
    <TransportBin>0</TransportBin>
  </Bin>
  <Bin>
    <Name>TR-01</Name>
    <LocId>001</LocId>
    <Group/>
    <SortNr>900</SortNr>
    <MaxItems>0</MaxItems>
    <TransportBin>1</TransportBin>
  </Bin>
</Bins>

Antwort

Result-Set 1 · Wenn BinsXML leer ist, nicht geparst werden kann oder kein Element /Bins/Bin enthält.

Einzelne Statuszeile; es wird kein Lagerplatz angelegt.

Result-Set 2 · Nach der Prüfung, sofern kein unerwarteter SQL-Fehler auftritt.

Eine Zeile je Bin-Element der Anfrage mit dem Ergebnis der Anlage, sortiert nach Row.

Result-Set 3 · Wenn beim Einfügen oder Erstellen der Antwort ein unerwarteter SQL-Fehler auftritt.

Einzelne Statuszeile mit dem SQL-Fehlertext; alle Einfügungen des Aufrufs werden zurückgerollt.

<SqlRowSet1>
  <row>
    <Row>1</Row>
    <BinKey>4711</BinKey>
    <BinName>A-01-01</BinName>
    <LocId>001</LocId>
    <BinGroup>Regal A</BinGroup>
    <SortNr>10</SortNr>
    <MaxItems>100</MaxItems>
    <Status>CREATED</Status>
    <Message/>
    <TransportBin>false</TransportBin>
  </row>
  <row>
    <Row>2</Row>
    <BinName>A-01-02</BinName>
    <LocId>099</LocId>
    <BinGroup>Regal A</BinGroup>
    <SortNr>20</SortNr>
    <MaxItems>100</MaxItems>
    <Status>ERROR</Status>
    <Message>Bin not created (Location does not exist).</Message>
    <TransportBin>false</TransportBin>
  </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:pixiBinCreate>
      <BinsXML><![CDATA[<Bins><Bin><Name>A-01-01</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>100</MaxItems><TransportBin>0</TransportBin></Bin><Bin><Name>TR-01</Name><LocId>001</LocId><Group></Group><SortNr>900</SortNr><MaxItems>0</MaxItems><TransportBin>1</TransportBin></Bin></Bins>]]></BinsXML>
      <!-- <CreateEmp>ShopSync</CreateEmp> -->
    </ns1:pixiBinCreate>
  </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:pixiBinCreate>
      <BinsXML><![CDATA[<Bins><Bin><Name>A-01-01</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>100</MaxItems><TransportBin>0</TransportBin></Bin><Bin><Name>TR-01</Name><LocId>001</LocId><Group></Group><SortNr>900</SortNr><MaxItems>0</MaxItems><TransportBin>1</TransportBin></Bin></Bins>]]></BinsXML>
      <!-- <CreateEmp>ShopSync</CreateEmp> -->
    </ns1:pixiBinCreate>
  </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 = [
    'BinsXML' => '<Bins><Bin><Name>A-01-01</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>100</MaxItems><TransportBin>0</TransportBin></Bin><Bin><Name>TR-01</Name><LocId>001</LocId><Group></Group><SortNr>900</SortNr><MaxItems>0</MaxItems><TransportBin>1</TransportBin></Bin></Bins>',
    // 'CreateEmp' => 'ShopSync',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiBinCreate

Prozedur zuletzt geändert am 2026-10-05

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