pixiGetHistoricalSupplierPriceMatching

Liefert FIFO-zugeordnete Lieferanten-Einkaufspreise und Verkaufspreise für Lagerbewegungen eines oder aller Artikel in einem Zeitraum von bis zu 31 Tagen.

Liefert die historische FIFO-Zuordnung zwischen Lagerzugängen (mit Lieferantenpreis) und Lagerabgängen (mit Verkaufspreis) auf Basis des Lagerplatz-Artikelprotokolls.

Parameterprüfung

• DateFrom und DateTo müssen beide übergeben werden, obwohl sie mit dem Standardwert NULL deklariert sind.
• Beide Werte werden auf den Datumsanteil reduziert. Das Ende des Zeitraums ist DateTo + 1 Tag.
• Der Zeitraum von DateFrom bis DateTo + 1 Tag darf 31 Tage nicht überschreiten.
• DateTo darf höchstens der gestrige Tag sein; Daten für den aktuellen Tag können nicht abgefragt werden.

Auswahl

• Wird ItemKey übergeben, wird nur dieser Artikel geliefert, andernfalls alle Artikel.
• Ein Zugang wird berücksichtigt, wenn sein Erstelldatum oder das Änderungsdatum seines Lieferantenpreis-Datensatzes zwischen DateFrom und DateTo + 1 Tag liegt (beide Grenzen inklusive, Vergleich als Datum um Mitternacht).
• Zugänge werden auf zwei Arten mit Abgängen verknüpft, die Ergebnisse beider Wege werden zusammengeführt:
  1. Abgänge, die direkt auf den Zugangsdatensatz verweisen,
  2. Abgänge, die über Artikel und FIFO-Zeilennummer zum Zugang passen.
• Für jede Zuordnung werden Lieferantenpreis, Verkaufspreis, die Herkunftsbeschreibungen beider Preise, die Lieferung (eigene oder zugewiesene Lieferung) und die Verkaufsbelegzeile (Rechnungsposition oder POS-Position) ermittelt.

Ausgabe

• Wurden keine Zeilen gefunden, wird eine einzelne Zeile mit Staus = Warning geliefert.
• Andernfalls werden die Datenzeilen sortiert nach InvBinItemLogId geliefert. Die Lieferscheinnummer des Lieferanten stammt aus der Lieferantenlieferung; Datum und Nummer des Verkaufsbelegs stammen aus der Rechnung oder, falls keine vorhanden ist, aus dem POS-Beleg.
• Jeder Fehler, auch die Prüfungsfehler, wird als Zeile mit Staus = Error und dem Fehlertext in Message geliefert.

Parameter

Antwort

Result-Set 1 · Wenn passende Datensätze gefunden wurden

FIFO-Zuordnungen von Lagerzugängen und -abgängen mit Lieferanten- und Verkaufspreisen, sortiert nach InvBinItemLogId.

Result-Set 2 · Wenn keine passenden Datensätze gefunden wurden

Einzelne Warnungszeile.

Result-Set 3 · Bei Prüfungsfehler oder sonstigem Fehler

Einzelne Fehlerzeile mit der Fehlermeldung.

<SqlRowSet1>
  <row>
    <InvBinItemLogId>1583321</InvBinItemLogId>
    <ItemID>4711</ItemID>
    <DatePutToStock>2024-03-04T09:15:22</DatePutToStock>
    <Quantity>2</Quantity>
    <SupplierPrice>12.50</SupplierPrice>
    <SupplierId>17</SupplierId>
    <RefTypeSupplierPrice>Supplier delivery</RefTypeSupplierPrice>
    <RefDocumentNumberSupplierPrice>LS-2024-0815</RefDocumentNumberSupplierPrice>
    <SellDocumentDate>2024-03-12T14:02:10</SellDocumentDate>
    <SellingPrice>24.90</SellingPrice>
    <RefTypeSellingPrice>Invoice</RefTypeSellingPrice>
    <RefDocumentNumberSellingPrice>RE240312001</RefDocumentNumberSellingPrice>
  </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:pixiGetHistoricalSupplierPriceMatching>
      <!-- <ItemKey>4711</ItemKey> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-03-30T00:00:00</DateTo> -->
    </ns1:pixiGetHistoricalSupplierPriceMatching>
  </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:pixiGetHistoricalSupplierPriceMatching>
      <!-- <ItemKey>4711</ItemKey> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-03-30T00:00:00</DateTo> -->
    </ns1:pixiGetHistoricalSupplierPriceMatching>
  </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 = [
    // 'ItemKey' => '4711',
    // 'DateFrom' => '2024-03-01T00:00:00',
    // 'DateTo' => '2024-03-30T00:00:00',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetHistoricalSupplierPriceMatching

Prozedur zuletzt geändert am 2026-10-05

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