pixiGetSOrdersBySupplier
Liefert bestätigte Lieferantenbestellungen eines Lieferanten für einen Lagerstandort oder die Liste der Lieferanten mit solchen Bestellungen als Basis für Lieferscheinvorlagen.
Der Aufruf gibt beide Parameter an die interne Prozedur Pixi_GetSOrdersBySupplier weiter. Er dient der Auswahl von Lieferantenbestellungen, aus denen eine Lieferscheinvorlage (Lieferantenlieferung) erstellt werden kann.
Vorfilter: Lieferantenbestellungen, bei denen mindestens eine Bestellposition bereits in einer Lieferantenlieferung mit Status NEW (SDelHeader.SDelHStatus = 'NEW') referenziert ist, werden in beiden Modi ausgeschlossen.
Statusfilter: Berücksichtigt werden nur Bestellungen, deren Status IsConfirmed = 1 hat. Ist die Einstellung ConfirmOrderedDocumentOnDelivery auf 1 gesetzt, werden zusätzlich Bestellungen mit Status IsOrderedConfirmed = 1 einbezogen.
Standortfilter: Der Lieferstandort der Bestellung (DeliveryLocationId) muss LocID entsprechen.
Modus abhängig von SupplNr:
SupplNrgesetzt: liefert die passenden Bestellungen dieses Lieferanten (OrderNr,ExternalCode,Code,OrderDate), absteigend sortiert nach interner Bestellnummer. Der StatuscodeBESwird alsORDausgegeben.SupplNristNULL: liefert die eindeutigen Lieferanten (SupplNr,SupplName), die mindestens eine passende Bestellung am Standort haben.
Hinweise
- Beide Parameter haben in diesem Wrapper keinen Standardwert und müssen übergeben werden. Der Modus mit der Lieferantenliste wird nur erreicht, wenn
SupplNrexplizit als NULL übergeben wird; ein Leerstring ist nicht NULL und liefert keine Bestellungen. - Ist
LocIDNULL, werden keine Zeilen geliefert, da der Vergleichlo.LocID = @LocIDnie auf NULL zutrifft. - Der Wrapper übergibt
@LanguageIDnicht, daher verwendet die interne Prozedur immer1:BESwird zuORD; die Übersetzung vonCONzuBGT(Sprache 2) greift nie. - Alle Lesezugriffe erfolgen mit
NOLOCK, daher können nicht festgeschriebene Daten geliefert werden. - Die Einstellung
ConfirmOrderedDocumentOnDeliverywird zur Laufzeit überfpixi_GetSettinggelesen.
Parameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
SupplNr
Pflicht
|
varchar(4) string |
– |
Lieferantennummer. Ist sie gesetzt, werden die Bestellungen dieses Lieferanten geliefert; bei NULL die Liste der Lieferanten mit passenden Bestellungen. Beispiel: |
LocID
Pflicht
|
varchar(3) string |
– |
Standort-ID des Lieferstandorts der Lieferantenbestellungen. Beispiel: |
Antwort
Result-Set 1 · Wenn SupplNr nicht NULL ist
Bestätigte Lieferantenbestellungen des Lieferanten am Standort ohne Lieferantenlieferung im Status NEW, absteigend sortiert nach OrderNr.
| Spalte | Typ | Beschreibung |
|---|---|---|
OrderNr
|
string |
Interne Nummer der Lieferantenbestellung ( |
ExternalCode
Kann leer sein |
varchar(50) string |
Externer Code der Lieferantenbestellung. |
Code
Kann leer sein |
string |
Statuscode der Bestellung; |
OrderDate
Kann leer sein |
datetime dateTime |
Bestelldatum. |
Result-Set 2 · Wenn SupplNr NULL ist
Eindeutige Lieferanten mit mindestens einer passenden Lieferantenbestellung am Standort.
| Spalte | Typ | Beschreibung |
|---|---|---|
SupplNr
Kann leer sein |
string |
Lieferantennummer. |
SupplName
Kann leer sein |
string |
Name des Lieferanten. |
Beispielantwort
<SqlRowSet1>
<row>
<OrderNr>100245</OrderNr>
<ExternalCode>AB-2024-0815</ExternalCode>
<Code>ORD</Code>
<OrderDate>2024-03-12T00:00:00</OrderDate>
</row>
<row>
<OrderNr>100198</OrderNr>
<ExternalCode>AB-2024-0790</ExternalCode>
<Code>CON</Code>
<OrderDate>2024-03-05T00:00:00</OrderDate>
</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:pixiGetSOrdersBySupplier>
<SupplNr>L001</SupplNr>
<LocID>001</LocID>
</ns1:pixiGetSOrdersBySupplier>
</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:pixiGetSOrdersBySupplier>
<SupplNr>L001</SupplNr>
<LocID>001</LocID>
</ns1:pixiGetSOrdersBySupplier>
</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 = [
'SupplNr' => 'L001',
'LocID' => '001',
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiGetSOrdersBySupplier', $soapArguments);
Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiGetSOrdersBySupplier