pixiReportTurnover

Liefert den Netto-Rechnungsumsatz für den Stichtag, den Vortag, den laufenden Monat und den Vormonat, optional gefiltert nach Shop.

Dashboard-Report, der Total_Net der Rechnungen (Invoices) zu vier Umsatzwerten summiert und diese in einer Zeile zurückgibt.

Datumslogik

• toDate ist standardmäßig das aktuelle Datum mit Uhrzeit. Die Uhrzeit ist relevant: Stichtag und laufender Monat werden nur bis toDate gezählt, nicht bis zum Tagesende.
• fromDate ist standardmäßig der erste Tag des Vormonats von toDate. Liegt fromDate nach toDate, wird es auf toDate gesetzt.
• Grundsätzlich werden nur Rechnungen mit InvDate zwischen dem Beginn des Vormonats und toDate berücksichtigt.

Shop-Filter Eine Rechnung wird nur gezählt, wenn der Kunde (CustRef) mindestens eine Adresse in Addresses mit AddrShopID = ShopID hat. Ein leerer oder NULL-Wert für ShopID schließt alle Rechnungen ein, zu denen überhaupt eine Adresse existiert.

Die vier Werte

• TurnoverNetGivenDate: liegt fromDate in einem anderen Monat als toDate, Rechnungen vom Tagesbeginn von toDate bis toDate; liegt fromDate am selben Tag wie toDate, Rechnungen von fromDate bis toDate.
• TurnoverNetDayBefore: liegt fromDate in einem anderen Monat, der gesamte Vortag von toDate; zusätzlich, falls fromDate auf den Vortag fällt, Rechnungen von fromDate bis zum Ende dieses Tages.
• TurnoverNetGivenMonth: liegt fromDate in einem anderen Monat, vom 1. des Monats von toDate bis toDate; im selben Monat von fromDate bis toDate.
• TurnoverNetPreviousMonth: liegt fromDate vor dem Vormonat, der gesamte Vormonat; liegt fromDate im Vormonat, von fromDate bis zum Ende des Vormonats.

Mit dem Standardwert für fromDate ergibt sich: heute bis jetzt, gestern, Monat bis heute und der gesamte Vormonat.

Währung Ist die Einstellung MultiCurrencyEnabled gleich 1, wird jeder Rechnungsbetrag durch den Wechselkurs aus pixi.ExchRate für die Datenbank-Kursquelle (DatabaseCurrencyExchRateSourceId) und die Hauswährung geteilt, zugeordnet über Kursdatum und Währung des Rechnungskurses. dbCurrency enthält dann den Code der Datenbankwährung. Andernfalls werden die Beträge wie gespeichert summiert und dbCurrency ist NULL.

Parameter

Antwort

Result-Set 1 · Immer, außer bei einem SQL-Fehler

Eine Zeile mit den vier Netto-Umsatzwerten und dem Code der Datenbankwährung.

<SqlRowSet1>
  <row>
    <TurnoverNetGivenDate>1523.40</TurnoverNetGivenDate>
    <TurnoverNetDayBefore>4210.75</TurnoverNetDayBefore>
    <TurnoverNetGivenMonth>58320.10</TurnoverNetGivenMonth>
    <TurnoverNetPreviousMonth>112845.60</TurnoverNetPreviousMonth>
    <dbCurrency>EUR</dbCurrency>
  </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:pixiReportTurnover>
      <!-- <fromDate>2024-05-01T00:00:00</fromDate> -->
      <!-- <toDate>2024-06-15T18:00:00</toDate> -->
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiReportTurnover>
  </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:pixiReportTurnover>
      <!-- <fromDate>2024-05-01T00:00:00</fromDate> -->
      <!-- <toDate>2024-06-15T18:00:00</toDate> -->
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiReportTurnover>
  </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 = [
    // 'fromDate' => '2024-05-01T00:00:00',
    // 'toDate' => '2024-06-15T18:00:00',
    // 'ShopID' => 'ABC',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiReportTurnover

Prozedur zuletzt geändert am 2026-10-05

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