pixiReport1SS
Liefert monatliche Paketstatistiken aus den Rechnungen für die Abrechnung: Pakete gesamt, Ein-Artikel-Pakete und als 1SS markierte Pakete mit Größenklassen.
Führt die interne Report-Prozedur Report_1SS aus, die für Abrechnungszwecke verwendet wird. Der Aufruf hat keine Parameter.
Aufbau des Reports:
- Jede Rechnung (Tabelle
invoices) mittotal >= 0zählt als ein Paket. Gutschriften mit negativem Betrag sind ausgeschlossen. - Die Rechnungen werden nach Kalendermonat gruppiert, und zwar über den Monatsabstand zwischen
invdateund dem aktuellen Datum.MonthundYearstammen aus dem jüngsten Rechnungsdatum der Gruppe. - Pro Monat werden gezählt:
Packages: alle Rechnungen.Packages_1item: Rechnungen, deren Rechnungspositionen (invlines) in Summe eineitemqtyvon genau 1 ergeben.Packages_1ss: Rechnungen, bei denen die Kennzeichenspalte1SSgleich 1 ist.
- Abgeleitete Werte:
Packages_1item_Percentage: Anteil der Ein-Artikel-Pakete. Das Verhältnis wird auf zwei Nachkommastellen gerundet und danach mit 100 multipliziert. Das Ergebnis ist daher ein ganzzahliger Prozentwert.Class_1item/Class_1SS: Größenklasse der Anzahl. Bis 1000 giltSmall, bis 2500Medium, bis 5000Large, bis 10000Extra Large, darüberXXL.Extra10000_1Item/Extra10000_1SS: Anzahl vollständiger 10.000er-Blöcke (Ganzzahldivision).
Es gibt keinen Datumsfilter. Jeder Monat der gesamten Rechnungshistorie wird geliefert. Sortiert wird aufsteigend nach Year und anschließend nach Month.
Hinweise
- Alle Lesezugriffe erfolgen mit
NOLOCK. Die Zahlen können daher nicht festgeschriebene Daten enthalten. - Der Report liest die vollständigen Tabellen
invoicesundinvlinesohne Datumsfilter. Bei großen Datenbanken kann das lange dauern. - Eine Rechnung gilt als Ein-Artikel-Paket, wenn die Summe der
itemqtyüber alle Positionen 1 ergibt. Das gilt auch, wenn sich mehrere Positionen zu 1 summieren. Rechnungen ohne Positionen zählen nie als Ein-Artikel-Paket. - Rechnungen mit NULL in
invdatebilden eine eigene Gruppe, in derMonthundYearNULL sind.
Parameter
Dieser Call hat keine Parameter.
Antwort
Result-Set 1 · Immer
Eine Zeile pro Kalendermonat der Rechnungshistorie, sortiert nach Jahr und Monat.
| Spalte | Typ | Beschreibung |
|---|---|---|
Month
Kann leer sein |
int |
Monat (1–12) des jüngsten Rechnungsdatums der Gruppe. |
Year
Kann leer sein |
int |
Jahr des jüngsten Rechnungsdatums der Gruppe. |
Packages
|
int |
Anzahl der Rechnungen mit einem Betrag >= 0 in diesem Monat. |
Packages_1item
|
int |
Anzahl der Rechnungen, deren Positionsmengen in Summe genau 1 ergeben. |
Packages_1item_Percentage
|
numeric decimal |
Anteil der Ein-Artikel-Pakete in Prozent. Das Verhältnis wird vor der Multiplikation mit 100 auf zwei Nachkommastellen gerundet. |
Class_1item
|
varchar(11) string |
Größenklasse von |
Packages_1ss
|
int |
Anzahl der Rechnungen mit dem Kennzeichen |
Extra10000_1Item
|
int |
Anzahl vollständiger 10.000er-Blöcke an Ein-Artikel-Paketen (Ganzzahldivision). |
Class_1SS
|
varchar(11) string |
Größenklasse von |
Extra10000_1SS
|
int |
Anzahl vollständiger 10.000er-Blöcke an 1SS-Paketen (Ganzzahldivision). |
Beispielantwort
<SqlRowSet1>
<row>
<Month>4</Month>
<Year>2024</Year>
<Packages>8250</Packages>
<Packages_1item>3120</Packages_1item>
<Packages_1item_Percentage>38.0000</Packages_1item_Percentage>
<Class_1item>Large</Class_1item>
<Packages_1ss>2140</Packages_1ss>
<Extra10000_1Item>0</Extra10000_1Item>
<Class_1SS>Medium</Class_1SS>
<Extra10000_1SS>0</Extra10000_1SS>
</row>
<row>
<Month>5</Month>
<Year>2024</Year>
<Packages>27400</Packages>
<Packages_1item>12650</Packages_1item>
<Packages_1item_Percentage>46.0000</Packages_1item_Percentage>
<Class_1item>XXL</Class_1item>
<Packages_1ss>9800</Packages_1ss>
<Extra10000_1Item>1</Extra10000_1Item>
<Class_1SS>Extra Large</Class_1SS>
<Extra10000_1SS>0</Extra10000_1SS>
</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:pixiReport1SS/>
</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:pixiReport1SS/>
</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 = [
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiReport1SS', $soapArguments);
Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiReport1SS