pixiGetMatchesForDeliveredItem
Liefert die Lieferantenbestellpositionen, die einer Artikelposition eines Lieferscheins zugeordnet sind, mit bestellten, gelieferten, offenen und zugeordneten Mengen.
Liefert die Zuordnungen (BuyingMatch-Datensätze) zwischen einer Position eines Lieferscheins und den Lieferantenbestellpositionen, gegen die sie gebucht wurde.
- Berücksichtigt werden nur Zuordnungen, deren Lieferscheinreferenz
SDelDkeyentspricht. - Jede Zuordnung wird mit ihrer Bestellposition und der Lieferantenbestellung verknüpft. Zuordnungen ohne vorhandene Bestellposition oder Bestellung werden nicht zurückgegeben.
- Die Zeilen werden nach Bestelldatum und Bestellposition gruppiert, es entsteht also eine Zeile je zugeordneter Bestellposition:
OrderNrist die interne Nummer der Lieferantenbestellung,OrderIdderen ID.OrderQty,QtyReceivedundQtyNotDeliveredstammen aus der Bestellposition (QtyNotDeliveredist0, wenn kein Wert hinterlegt ist).BuyingMatchQtyist die Summe aller zugeordneten Mengen dieser Lieferscheinposition zur Bestellposition.SupplNameist der Name des Lieferanten zur in der Zuordnung gespeicherten Lieferantennummer.
Der Aufruf ist ein Wrapper: Er führt die interne Prozedur Pixi_Buy_GetMatchesForDeliveredItem aus, puffert deren Zeilen in einer temporären Tabelle und gibt sie zurück.
Hinweise
- Alle Lesezugriffe verwenden
NOLOCK, daher können nicht festgeschriebene Daten geliefert werden. - Wird
SDelDkeyweggelassen (StandardNULL), werden keine Zeilen geliefert, da der Filter mit=vergleicht. - Die interne Prozedur sortiert nach Bestelldatum und Bestellmenge, der Wrapper liest die temporäre Tabelle jedoch ohne
ORDER BY. Die Reihenfolge ist daher nicht garantiert; bei Bedarf clientseitig sortieren. - Alle Mengenspalten werden in der Puffertabelle als
intgespeichert; Dezimalmengen würden abgeschnitten.
Parameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
SDelDkey
|
int | NULL |
Schlüssel der Lieferscheinposition (Artikelposition), deren Zuordnungen zu Lieferantenbestellpositionen geliefert werden. Beispiel: |
Antwort
Result-Set 1 · Immer; leer, wenn keine Zuordnungen zu SDelDkey existieren oder der Wert NULL ist.
Eine Zeile je Lieferantenbestellposition, die der Lieferscheinposition zugeordnet ist.
| Spalte | Typ | Beschreibung |
|---|---|---|
OrderNr
Kann leer sein |
int |
Interne Nummer der Lieferantenbestellung. |
SOrderLineRef
Kann leer sein |
int |
ID der zugeordneten Lieferantenbestellposition. |
SupplName
Kann leer sein |
varchar(60) string |
Name des in der Zuordnung hinterlegten Lieferanten. |
OrderDate
Kann leer sein |
datetime dateTime |
Datum der Lieferantenbestellung. |
OrderQty
Kann leer sein |
int |
Bestellte Menge der Bestellposition. |
QtyReceived
Kann leer sein |
int |
Bereits gelieferte Menge der Bestellposition. |
QtyNotDelivered
|
int |
Noch nicht gelieferte Menge der Bestellposition; 0, wenn kein Wert hinterlegt ist. |
BuyingMatchQty
Kann leer sein |
int |
Summe der dieser Bestellposition zugeordneten Mengen der Lieferscheinposition. |
OrderId
Kann leer sein |
int |
ID der Lieferantenbestellung. |
Beispielantwort
<SqlRowSet1>
<row>
<OrderNr>10452</OrderNr>
<SOrderLineRef>88213</SOrderLineRef>
<SupplName>Muster Großhandel GmbH</SupplName>
<OrderDate>2024-03-12T00:00:00</OrderDate>
<OrderQty>50</OrderQty>
<QtyReceived>30</QtyReceived>
<QtyNotDelivered>20</QtyNotDelivered>
<BuyingMatchQty>30</BuyingMatchQty>
<OrderId>7731</OrderId>
</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:pixiGetMatchesForDeliveredItem>
<!-- <SDelDkey>154872</SDelDkey> -->
</ns1:pixiGetMatchesForDeliveredItem>
</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:pixiGetMatchesForDeliveredItem>
<!-- <SDelDkey>154872</SDelDkey> -->
</ns1:pixiGetMatchesForDeliveredItem>
</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 = [
// 'SDelDkey' => '154872',
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiGetMatchesForDeliveredItem', $soapArguments);
Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiGetMatchesForDeliveredItem