Reports Lesen

pixiReportReceivedOrders

Liefert die Anzahl der in einem Zeitraum angelegten Aufträge (Standard: heute ab 0:00 bis jetzt), optional nach Shop gefiltert und nach Lager gruppiert.

Dashboard-Report, der eingegangene Aufträge anhand ihres Anlagedatums (OrderHeader.CreateDate) zählt.

Zeitraum

FromTime ist standardmäßig der Beginn des aktuellen Tages (0:00).
UntilTime ist standardmäßig das aktuelle Datum mit Uhrzeit.
Beide Grenzen sind inklusive.

Shop-Filter

Ist ShopID gesetzt, werden nur Aufträge gezählt, die mindestens eine Auftragsposition mit OrdShopID = ShopID haben. Leerer String oder NULL bedeutet alle Shops.

Modus abhängig von PerLocation

0 (Standard, auch bei NULL): zählt alle Aufträge im Zeitraum, die mindestens eine Auftragsposition haben (passend zum Shop-Filter). Die Anzahl wird als eine Zeile mit der Spalte ReceivedOrders geliefert und zusätzlich in den Output-Parameter ReceivedOrders geschrieben.
1: verknüpft Aufträge mit ihren Auftragspositionen und liefert je LocationID der Positionen eine Zeile mit der Anzahl unterschiedlicher Aufträge pro Lager. Es wird keine Sortierung angewendet.

Hinweise

Alle Lesezugriffe erfolgen mit NOLOCK; die Zahlen können daher nicht festgeschriebene Daten enthalten.
Der Output-Parameter MinutesSinceRefresh wird von der Prozedur nie gesetzt und liefert immer NULL.
Im Modus pro Lager wird der Output-Parameter ReceivedOrders nicht gesetzt. Ein Auftrag mit Positionen in mehreren Lagern wird je Lager einmal gezählt, die Summe aller Zeilen kann daher die Gesamtzahl aus Modus 0 übersteigen.
Aufträge ohne Auftragspositionen werden nie gezählt.
Wegen NULLIF(..., '') auf Datumswerten wird 1900-01-01 00:00:00 für FromTime oder UntilTime wie NULL behandelt und durch den Standardwert ersetzt.
Der Parameter PerLocation trägt im Code den Kommentar "old way".

Parameter

Parameter	Typ	Standardwert	Beschreibung
`FromTime`	datetime dateTime	NULL	Beginn des Zeitraums (inklusive) für das Anlagedatum des Auftrags. Standard: heute 0:00. Beispiel: `2024-05-14T00:00:00`
`UntilTime`	datetime dateTime	NULL	Ende des Zeitraums (inklusive). Standard: aktuelles Datum mit Uhrzeit. Beispiel: `2024-05-14T18:30:00`
`ShopID`	varchar(3) string	NULL	Optionaler Shop-Filter auf `Orderlines.OrdShopID`. Leer oder NULL zählt Aufträge aller Shops. Beispiel: `ABC`
`ReceivedOrders` OUTPUT	int	NULL	Ausgabe: Anzahl eingegangener Aufträge. Wird nur bei `PerLocation` = 0 gesetzt.
`MinutesSinceRefresh` OUTPUT	int	NULL	Output-Parameter, der von der Prozedur nie gesetzt wird; immer NULL.
`PerLocation`	bit boolean	0	Wählt den Ausgabemodus: Gesamtanzahl oder Anzahl pro Lager. NULL wird wie 0 behandelt. Erlaubte Werte `0` – Eine Zeile mit der Gesamtanzahl eingegangener Aufträge liefern. `1` – Je Lager eine Zeile mit der Anzahl unterschiedlicher Aufträge liefern. Beispiel: `0`

Antwort

Result-Set 1 · Wenn `PerLocation` = 0 (Standard)

Eine Zeile mit der Gesamtanzahl eingegangener Aufträge im Zeitraum.

Spalte	Typ	Beschreibung
`ReceivedOrders`	int	Anzahl der im Zeitraum angelegten Aufträge mit mindestens einer passenden Auftragsposition.

Result-Set 2 · Wenn `PerLocation` = 1

Je Lager der Auftragspositionen eine Zeile mit der Anzahl unterschiedlicher Aufträge.

Spalte	Typ	Beschreibung
`LocationID` Kann leer sein	int	Lager der Auftragspositionen (`Orderlines.LocationID`).
`ReceivedOrders`	int	Anzahl unterschiedlicher Aufträge mit mindestens einer Position in diesem Lager.

Beispielantwort

<SqlRowSet1>
  <row>
    <ReceivedOrders>127</ReceivedOrders>
  </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:pixiReportReceivedOrders>
      <!-- <FromTime>2024-05-14T00:00:00</FromTime> -->
      <!-- <UntilTime>2024-05-14T18:30:00</UntilTime> -->
      <!-- <ShopID>ABC</ShopID> -->
      <!-- <ReceivedOrders>?</ReceivedOrders> -->
      <!-- <MinutesSinceRefresh>?</MinutesSinceRefresh> -->
      <!-- <PerLocation>0</PerLocation> -->
    </ns1:pixiReportReceivedOrders>
  </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:pixiReportReceivedOrders>
      <!-- <FromTime>2024-05-14T00:00:00</FromTime> -->
      <!-- <UntilTime>2024-05-14T18:30:00</UntilTime> -->
      <!-- <ShopID>ABC</ShopID> -->
      <!-- <ReceivedOrders>?</ReceivedOrders> -->
      <!-- <MinutesSinceRefresh>?</MinutesSinceRefresh> -->
      <!-- <PerLocation>0</PerLocation> -->
    </ns1:pixiReportReceivedOrders>
  </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 = [
    // 'FromTime' => '2024-05-14T00:00:00',
    // 'UntilTime' => '2024-05-14T18:30:00',
    // 'ShopID' => 'ABC',
    // 'ReceivedOrders' => '?',
    // 'MinutesSinceRefresh' => '?',
    // 'PerLocation' => '0',
];

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

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

Verwendete Tabellen

OrderHeader · Lesen Orderlines · Lesen

SQL-Objekt:: dbo.pipiReportReceivedOrders