pixiReportCustomerSales

Liefert Rechnungspositionen mit Kunde, Land, Netto-Positionssumme, Währung und letztem Verkaufsdatum, gefiltert nach Artikel, Shop, Zahlungsart, Kunde und Rechnungsdatum.

Umsatzbericht auf Ebene der Rechnungspositionen. Laut Kopfkommentar handelt es sich um eine Kundenauswertung für den Kunden BAF; die Prozedur wurde also für eine bestimmte Installation erstellt.

Parameterbehandlung

• ItemNrSuppl, ShopID, PaymentType und CustomerNrExternal: Ein Leerstring wird wie NULL behandelt und bedeutet kein Filter.
• DateFrom: Bei NULL oder einem Datum vor dem 01.01.1990 wird das aktuelle Datum mit Uhrzeit minus einen Tag verwendet.
• DateTo: Bei NULL oder einem Datum vor dem 01.01.1990 wird das aktuelle Datum mit Uhrzeit verwendet.

Filter (alle mit UND verknüpft)

• ItemNrSuppl muss der Lieferanten-Artikelnummer des Artikels (Items.ItemNrSuppl) entsprechen.
• ShopID muss dem Shop der Rechnung (Invoices.InvShopID) entsprechen.
• PaymentType muss der an der Rechnungsadresse hinterlegten Zahlungsart (Addresses.APayment) entsprechen, nicht der Zahlungsart der Rechnung.
• CustomerNrExternal muss der externen Kundennummer der Rechnungsadresse entsprechen.
• Für das Rechnungsdatum gilt InvDate >= DateFrom und InvDate < DateTo. Die Obergrenze ist exklusiv.

Ausgabe Es wird eine Zeile je Rechnungsposition geliefert. Jede Zeile enthält:

• Lieferanten-Artikelnummer und EAN des Artikels;
• Firma (CareOf), Name und externe Kundennummer der Rechnungsadresse;
• die Menge;
• die Netto-Positionssumme;
• die ISO3-Ländercodes von Rechnungs- und Lieferadresse;
• den Währungscode der Rechnung;
• LastSaleDate: das späteste Rechnungsdatum aller Rechnungen, die den Artikel enthalten.

Die Netto-Positionssumme wird so berechnet: Der Einzelpreis der Position wird durch 1 + MwSt-Satz geteilt, auf 2 Nachkommastellen gerundet und anschließend mit der Menge multipliziert. Als MwSt-Satz dient bei MwSt-Kennzeichen H der volle Satz der Rechnung, bei L der ermäßigte Satz und bei jedem anderen Kennzeichen 0.

Das Ergebnis hat keine definierte Sortierung.

Parameter

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile je Rechnungsposition, die den Filtern entspricht.

<SqlRowSet1>
  <row>
    <ItemNrSuppl>BAF-10045</ItemNrSuppl>
    <EANUPC>4006381333931</EANUPC>
    <Company>Muster GmbH</Company>
    <CustomerName>Max Mustermann</CustomerName>
    <CustomerNrExternal>K-204711</CustomerNrExternal>
    <Qty>2</Qty>
    <ItemTotal_Net>33.60</ItemTotal_Net>
    <CountryCodeISO3_Billing>DEU</CountryCodeISO3_Billing>
    <CountryCodeISO3_Shipping>AUT</CountryCodeISO3_Shipping>
    <LastSaleDate>2024-03-28T14:12:05</LastSaleDate>
    <CurrencyCode>EUR</CurrencyCode>
  </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:pixiReportCustomerSales>
      <!-- <ItemNrSuppl>BAF-10045</ItemNrSuppl> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <PaymentType>R</PaymentType> -->
      <!-- <CustomerNrExternal>K-204711</CustomerNrExternal> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-04-01T00:00:00</DateTo> -->
    </ns1:pixiReportCustomerSales>
  </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:pixiReportCustomerSales>
      <!-- <ItemNrSuppl>BAF-10045</ItemNrSuppl> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <PaymentType>R</PaymentType> -->
      <!-- <CustomerNrExternal>K-204711</CustomerNrExternal> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-04-01T00:00:00</DateTo> -->
    </ns1:pixiReportCustomerSales>
  </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 = [
    // 'ItemNrSuppl' => 'BAF-10045',
    // 'ShopID' => 'SHP',
    // 'PaymentType' => 'R',
    // 'CustomerNrExternal' => 'K-204711',
    // 'DateFrom' => '2024-03-01T00:00:00',
    // 'DateTo' => '2024-04-01T00:00:00',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiReportCustomerSales

Prozedur zuletzt geändert am 2026-10-05

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