Suppliers Lesen

pixiSupplierOrderLineLocQtyGet

Liefert Lagerplatz-Mengendaten zu einer oder mehreren Lieferantenbestellungen, Bestellpositionen oder Positions-Lagerplatzmengen.

Wrapper um die interne Prozedur pixi.SupplierOrderLineLocQtyGet. Sie liefert Lagerplatz-Mengendaten (Mengen je Lagerplatz) zu Positionen von Lieferantenbestellungen.

Ablauf:

Öffnet eine eigene Transaktion bzw. setzt einen Savepoint, wenn bereits eine äußere Transaktion offen ist.
Ruft pixi.SupplierOrderLineLocQtyGet auf. Die Parameter werden so übergeben:
- SupplierOrderIds → @SoIds
- SupplierOrderLinesIds → @SolIds
- SupplierOrderLinesLocQtyIds → @SolLocQtyIds
Gibt die Ergebnismengen dieser Prozedur unverändert zurück und schließt anschließend die eigene Transaktion ab.

Bei einem Fehler wird die Transaktion bzw. der Savepoint zurückgerollt und eine einzelne Zeile mit ReturnCode = ERROR und dem SQL-Fehlertext in ErrorMessage zurückgegeben.

AppName ist ein Pflichtparameter, wird im Code aber nicht verwendet.

Hinweise

Die Definition von pixi.SupplierOrderLineLocQtyGet liegt nicht vor. Folgende Punkte lassen sich daher nicht aus dem Code ableiten:
- das Format der ID-Listen (vermutlich kommagetrennte Schlüssel, nicht bestätigt);
- wie die drei Filter kombiniert werden;
- was bei durchgehend leeren Filtern geschieht;
- Spalten, Sortierung und Anzahl der zurückgegebenen Ergebnismengen.
Der Aufruf läuft in einer Transaktion (bzw. einem Savepoint), obwohl es ein Lesezugriff ist; die eigentlichen Lesezugriffe erfolgen in der inneren Prozedur.
Schlägt die innere Prozedur fehl, nachdem sie bereits Zeilen geliefert hat, kann der Aufrufer diese Zeilen und danach die Fehlerzeile erhalten.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`AppName` Pflicht	varchar(255) string	–	Name der aufrufenden Anwendung. Pflichtparameter, wird im Code nicht verwendet. Beispiel: `MyShopConnector`
`SupplierOrderIds`	varchar(8000) string	–	Liste von Lieferantenbestellungs-IDs, wird als `@SoIds` an `pixi.SupplierOrderLineLocQtyGet` übergeben. Das Listenformat legt diese Prozedur fest, deren Code nicht vorliegt. Beispiel: `1001,1002`
`SupplierOrderLinesIds`	varchar(8000) string	–	Liste von Bestellpositions-IDs, wird als `@SolIds` an die innere Prozedur übergeben. Beispiel: `50231,50232`
`SupplierOrderLinesLocQtyIds`	varchar(8000) string	–	Liste von IDs der Positions-Lagerplatzmengen, wird als `@SolLocQtyIds` an die innere Prozedur übergeben.

Antwort

Result-Set 1 · Bei Erfolg; geliefert von der inneren Prozedur `pixi.SupplierOrderLineLocQtyGet`.

Lagerplatz-Mengendaten der ausgewählten Bestellpositionen. Spalten und Anzahl der Ergebnismengen legt pixi.SupplierOrderLineLocQtyGet fest, deren Code nicht vorliegt.

Result-Set 2 · Bei einem Fehler.

Fehlerzeile.

Spalte	Typ	Beschreibung
`ReturnCode`	varchar(5) string	Immer `ERROR`.
`ErrorMessage` Kann leer sein	nvarchar(4000) string	Text des SQL-Fehlers (`ERROR_MESSAGE()`).

Fehlermeldungen

Status	Meldung	Ursache
ERROR	{ERROR_MESSAGE()}	Jeder SQL-Fehler bei der Ausführung von `pixi.SupplierOrderLineLocQtyGet`, z. B. durch fehlerhaft formatierte ID-Listen. Die Transaktion wird zurückgerollt und der ursprüngliche Fehlertext zurückgegeben. Abhilfe: korrekt formatierte ID-Listen übergeben.

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:pixiSupplierOrderLineLocQtyGet>
      <AppName>MyShopConnector</AppName>
      <!-- <SupplierOrderIds>1001,1002</SupplierOrderIds> -->
      <!-- <SupplierOrderLinesIds>50231,50232</SupplierOrderLinesIds> -->
      <!-- <SupplierOrderLinesLocQtyIds>?</SupplierOrderLinesLocQtyIds> -->
    </ns1:pixiSupplierOrderLineLocQtyGet>
  </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:pixiSupplierOrderLineLocQtyGet>
      <AppName>MyShopConnector</AppName>
      <!-- <SupplierOrderIds>1001,1002</SupplierOrderIds> -->
      <!-- <SupplierOrderLinesIds>50231,50232</SupplierOrderLinesIds> -->
      <!-- <SupplierOrderLinesLocQtyIds>?</SupplierOrderLinesLocQtyIds> -->
    </ns1:pixiSupplierOrderLineLocQtyGet>
  </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 = [
    'AppName' => 'MyShopConnector',
    // 'SupplierOrderIds' => '1001,1002',
    // 'SupplierOrderLinesIds' => '50231,50232',
    // 'SupplierOrderLinesLocQtyIds' => '?',
];

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

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

SQL-Objekt:: dbo.pipiSupplierOrderLineLocQtyGet