Reports Lesen

pixiGetProductSalesReport

Liefert die verkaufte Menge eines Artikels pro Rechnungsmonat und -jahr, optional eingeschränkt auf einen Shop.

Erstellt einen monatlichen Verkaufsbericht für einen einzelnen Artikel auf Basis von Rechnungspositionen.

Liest Rechnungspositionen aus der View PV_InvlinesRep und verknüpft sie über die Rechnungsnummer mit den Rechnungen in PV_Rechnungen.
Filtert auf die interne Artikelnummer ItemNrInt.
Ist ShopID angegeben, werden nur Rechnungspositionen dieses Shops berücksichtigt; fehlt der Parameter oder ist er NULL, werden alle Shops einbezogen.
Gruppiert nach Rechnungsmonat und Rechnungsjahr und summiert die verkaufte Menge (QtySold).
Die Zeilen sind chronologisch sortiert: nach Jahr aufsteigend, dann nach Monat aufsteigend.

Es erscheinen nur Monate, in denen der Artikel berechnet wurde; Monate ohne Verkäufe werden nicht als Nullzeilen geliefert.

Hinweise

Laut Kopfkommentar wurde die Prozedur für einen bestimmten Kunden (JAL) erstellt.
Beide Views werden WITH (NOLOCK) gelesen, die Werte können daher nicht festgeschriebene Daten enthalten.
Die Definitionen von PV_InvlinesRep und PV_Rechnungen liegen nicht vor; die genaue Bedeutung von QtySold (z. B. ob Gutschriften die Menge mindern) sowie die Datentypen der Monats-/Jahresspalten hängen von diesen Views ab.
Es gibt keinen Datumsfilter; die gesamte Rechnungshistorie des Artikels wird aggregiert, was bei Artikeln mit vielen Rechnungspositionen langsam sein kann.
Eine unbekannte ItemNrInt liefert eine leere Ergebnismenge, keinen Fehler.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemNrInt` Pflicht	varchar(50) string	–	Interne Artikelnummer des Artikels, dessen Verkäufe ausgewertet werden. Beispiel: `100234`
`ShopID`	varchar(3) string	NULL	Optionale Shop-ID. Ist sie gesetzt, werden nur Rechnungspositionen dieses Shops summiert; `NULL` berücksichtigt alle Shops. Beispiel: `WEB`

Antwort

Result-Set 1 · Immer (leer, wenn der Artikel keine passenden Rechnungspositionen hat)

Eine Zeile pro Rechnungsmonat und -jahr mit der verkauften Gesamtmenge, sortiert nach Jahr und Monat aufsteigend.

Spalte	Typ	Beschreibung
`Monat` Kann leer sein	int	Rechnungsmonat (`Rechnung_Monat` aus `PV_Rechnungen`).
`Jahr` Kann leer sein	int	Rechnungsjahr (`Rechnung_Jahr` aus `PV_Rechnungen`).
`Sum` Kann leer sein	decimal	Summe von `QtySold` aller passenden Rechnungspositionen in diesem Monat.

Beispielantwort

<SqlRowSet1>
  <row>
    <Monat>11</Monat>
    <Jahr>2023</Jahr>
    <Sum>42</Sum>
  </row>
  <row>
    <Monat>12</Monat>
    <Jahr>2023</Jahr>
    <Sum>67</Sum>
  </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:pixiGetProductSalesReport>
      <ItemNrInt>100234</ItemNrInt>
      <!-- <ShopID>WEB</ShopID> -->
    </ns1:pixiGetProductSalesReport>
  </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:pixiGetProductSalesReport>
      <ItemNrInt>100234</ItemNrInt>
      <!-- <ShopID>WEB</ShopID> -->
    </ns1:pixiGetProductSalesReport>
  </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 = [
    'ItemNrInt' => '100234',
    // 'ShopID' => 'WEB',
];

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

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

Verwendete Tabellen

PV_InvlinesRep · Lesen PV_Rechnungen · Lesen

SQL-Objekt:: dbo.pipiGetProductSalesReport