Statistics Lesen

pixiGetItemSalesStats

Liefert Verkaufsstatistiken für einen Artikel: verkaufte Mengen der letzten 30/120/365 Tage, offene und gehaltene Mengen, offene Einzelstück-Aufträge und ABC-Klasse.

Liefert eine Zeile mit Verkaufskennzahlen für einen einzelnen Artikel.

Artikelsuche: Der Artikel wird über EANUPC oder ItemNrInt ermittelt. Verwendet wird der erste Artikel (niedrigster ItemKey), dessen EAN @EANUPC oder dessen interne Artikelnummer @ItemNrInt entspricht.
Offene Einzelstück-Aufträge (Open1SS): Gezählt werden alle Aufträge, die mindestens eine Auftragsposition dieses Artikels mit Status ANG enthalten und deren Positionen (alle Positionen des Auftrags, unabhängig vom Status) zusammen genau die Menge 1 ergeben.
Verkaufszeiträume: Berücksichtigt werden alle Auftragspositionen des Artikels mit einem Auftragsdatum innerhalb der letzten 365 Tage (bezogen auf aktuelles Datum und Uhrzeit), ausgenommen Positionen mit Status STO oder NLB.
- Sales30: bestellte Menge der letzten 30 Tage
- Sales120: bestellte Menge der letzten 120 Tage (inklusive 30-Tage-Zeitraum)
- Sales365: bestellte Menge der letzten 365 Tage
- OrderQtyANG: Menge der Positionen mit Status ANG innerhalb der letzten 365 Tage
- OrderQtyHAL: Menge der Positionen mit Status HAL innerhalb der letzten 365 Tage
ABC-Klasse: ermittelt über die Artikel-Tags A, B oder C (in dieser Reihenfolge geprüft); Leerstring, wenn keiner dieser Tags zugeordnet ist.

Hinweise

Alle Lesezugriffe erfolgen mit NOLOCK, die Zahlen können daher nicht festgeschriebene Daten enthalten.
Werden beide Parameter übergeben, werden sie mit OR verknüpft; verwendet wird der Artikel mit dem niedrigsten ItemKey, der einem der Werte entspricht. Zur Vermeidung von Mehrdeutigkeiten nur einen Identifikator übergeben.
Wird kein Artikel gefunden, erfolgt keine Fehlermeldung: Open1SS ist 0, ABC und alle Verkaufsspalten sind NULL.
Die Verkaufsspalten sind NULL (nicht 0), wenn im jeweiligen Zeitraum keine passenden Auftragspositionen existieren.
Die Zeiträume werden ab aktuellem Datum und Uhrzeit berechnet (GETDATE() minus n Tage), nicht ab Mitternacht.
Für Open1SS wird die Menge aller Positionen eines Auftrags summiert, auch von Positionen mit anderem Status (z. B. stornierte Positionen).

Parameter

Parameter	Typ	Standardwert	Beschreibung
`EANUPC`	varchar(13) string	NULL	EAN/UPC des Artikels. Alternative zu `ItemNrInt`. Beispiel: `4006381333931`
`ItemNrInt`	varchar(50) string	NULL	Interne Artikelnummer. Alternative zu `EANUPC`. Beispiel: `ART-100234`

Antwort

Result-Set 1 · Immer (eine Zeile, auch wenn kein Artikel gefunden wird)

Verkaufsstatistik des Artikels.

Spalte	Typ	Beschreibung
`Open1SS`	int	Anzahl der Aufträge mit offener (`ANG`) Position dieses Artikels, deren Gesamtmenge genau 1 beträgt.
`ABC` Kann leer sein	char(1) string	ABC-Klasse aus den Artikel-Tags (`A`, `B`, `C`), Leerstring wenn keiner; `NULL`, wenn der Artikel nicht gefunden wurde.
`Sales30` Kann leer sein	int	Bestellte Menge der letzten 30 Tage (ohne `STO`/`NLB`).
`Sales120` Kann leer sein	int	Bestellte Menge der letzten 120 Tage (ohne `STO`/`NLB`).
`Sales365` Kann leer sein	int	Bestellte Menge der letzten 365 Tage (ohne `STO`/`NLB`).
`OrderQtyANG` Kann leer sein	int	Menge der Auftragspositionen mit Status `ANG` innerhalb der letzten 365 Tage.
`OrderQtyHAL` Kann leer sein	int	Menge der Auftragspositionen mit Status `HAL` innerhalb der letzten 365 Tage.

Beispielantwort

<SqlRowSet1>
  <row>
    <Open1SS>3</Open1SS>
    <ABC>A</ABC>
    <Sales30>42</Sales30>
    <Sales120>160</Sales120>
    <Sales365>512</Sales365>
    <OrderQtyANG>7</OrderQtyANG>
    <OrderQtyHAL>2</OrderQtyHAL>
  </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:pixiGetItemSalesStats>
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <ItemNrInt>ART-100234</ItemNrInt> -->
    </ns1:pixiGetItemSalesStats>
  </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:pixiGetItemSalesStats>
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <ItemNrInt>ART-100234</ItemNrInt> -->
    </ns1:pixiGetItemSalesStats>
  </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 = [
    // 'EANUPC' => '4006381333931',
    // 'ItemNrInt' => 'ART-100234',
];

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

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

Verwendete Tabellen

items · Lesen Orderlines · Lesen Tag · Lesen TagMatch · Lesen

SQL-Objekt:: dbo.pipiGetItemSalesStats