Stock Lesen

pixiGetLocations

Liefert die Stammdaten der Lager, entweder aller sichtbaren Lager oder eines einzelnen Lagers anhand seiner ID.

Liefert pro Lager eine Zeile aus der Tabelle Location. Jede Zeile enthält die Adressdaten, das Versandkennzeichen, die Reservierungs- und Umlagerungseinstellungen sowie ein Kennzeichen, ob das Lager als Kassen-Lager (POS) verwendet wird.

Filterung:

Ist LocID nicht angegeben, NULL oder leer, werden alle Lager mit ShowLocation <> 0 (sichtbare Lager) geliefert.
Ist LocID gesetzt, wird nur das Lager mit dieser ID geliefert. Der Filter auf ShowLocation greift in diesem Fall nicht, ausgeblendete Lager werden also ebenfalls geliefert.

IsPosLocation ist '1', wenn mindestens ein Datensatz in POSheader2 über PHlocID auf das Lager verweist, sonst '0'.

Die Abfrage hat kein ORDER BY, die Reihenfolge der Zeilen ist daher nicht garantiert.

Hinweise

Location wird mit NOLOCK gelesen, nicht festgeschriebene Änderungen können daher im Ergebnis erscheinen. Die Unterabfrage auf POSheader2 verwendet keinen Sperrhinweis.
Da in der WHERE-Klausel AND stärker bindet als OR, greift der Sichtbarkeitsfilter ShowLocation <> 0 nur, wenn keine LocID übergeben wird. Die Abfrage eines einzelnen ausgeblendeten Lagers liefert dieses Lager trotzdem.
Eine unbekannte LocID liefert ein leeres Ergebnis. Es wird kein Fehler ausgelöst.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`LocID`	varchar(3) string	NULL	ID des Lagers, das geliefert werden soll. Leer oder `NULL` liefert alle sichtbaren Lager. Beispiel: `001`

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile pro passendem Lager.

Spalte	Typ	Beschreibung
`LocID`	string	ID des Lagers.
`LocationKey` Kann leer sein	string	Schlüssel des Lagers.
`LocName` Kann leer sein	string	Name des Lagers.
`LocAddress` Kann leer sein	string	Straßenadresse des Lagers.
`LocCity` Kann leer sein	string	Ort.
`LocZIP` Kann leer sein	string	Postleitzahl.
`LocCountry` Kann leer sein	string	Land.
`LocState` Kann leer sein	string	Bundesland bzw. Region.
`LocCompany` Kann leer sein	string	Dem Lager zugeordnete Firma.
`AllowShipping` Kann leer sein	string	Wert von `LocAllowShipping`, gibt an, ob der Versand aus diesem Lager erlaubt ist.
`SpecialStock` Kann leer sein	string	Sonderbestand-Einstellung des Lagers.
`ResLocID` Kann leer sein	string	Lager-ID für Reservierungen.
`TranLocID` Kann leer sein	string	Lager-ID für Umlagerungen.
`ResExpDays` Kann leer sein	string	Anzahl Tage, nach denen Reservierungen verfallen.
`IsPosLocation`	varchar(1) string	`1`, wenn das Lager in `POSheader2` referenziert wird, sonst `0`.

Beispielantwort

<SqlRowSet1>
  <row>
    <LocID>001</LocID>
    <LocationKey>MAIN</LocationKey>
    <LocName>Zentrallager</LocName>
    <LocAddress>Industriestr. 5</LocAddress>
    <LocCity>München</LocCity>
    <LocZIP>80331</LocZIP>
    <LocCountry>DE</LocCountry>
    <LocState>BY</LocState>
    <LocCompany>Muster GmbH</LocCompany>
    <AllowShipping>1</AllowShipping>
    <SpecialStock>0</SpecialStock>
    <ResLocID>001</ResLocID>
    <TranLocID>002</TranLocID>
    <ResExpDays>14</ResExpDays>
    <IsPosLocation>0</IsPosLocation>
  </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:pixiGetLocations>
      <!-- <LocID>001</LocID> -->
    </ns1:pixiGetLocations>
  </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:pixiGetLocations>
      <!-- <LocID>001</LocID> -->
    </ns1:pixiGetLocations>
  </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 = [
    // 'LocID' => '001',
];

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

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

Verwendete Tabellen

Location · Lesen POSheader2 · Lesen

SQL-Objekt:: dbo.pipiGetLocations