pixiReport_NewCustomersStats

Liefert für ein Jahr einen Monatsbericht, der Bestellanzahl, Bestellwerte und Durchschnittswerte von Neukunden und Bestandskunden vergleicht.

Erstellt einen pivotierten Bericht mit einer Zeile je Berichtszeile und einer Spalte je Monat (Month01–Month12) sowie einer Spalte Average.

Parameter und Filter

• Year wird bei NULL auf das aktuelle Jahr gesetzt.
• Shop (Vergleich mit Customers.CustomerOf) und Country (Vergleich mit dem Land der Adresse der Auftragsposition) sind optional; ein Leerstring wird wie NULL behandelt, also ohne Filter.

Neukunden Ein Kunde gilt in einem Monat als Neukunde, wenn das früheste OrderDate aller seiner Auftragspositionen (innerhalb des Shop-/Länderfilters) in diesem Monat von Year liegt. Nur die Positionen mit genau diesem Erstbestelldatum zählen als Neukundenbestellung; weitere Bestellungen im selben Monat gelten als Bestellungen von Bestandskunden.

Berichtszeilen (GroupNumber / LineNumber)

• Gruppe 1 – Bestellanzahl:
  • 1 Orders new customers: Anzahl der Kunden, deren Erstbestellung in den Monat fällt.
  • 2 Orders customers: Zeile 3 minus Zeile 1.
  • 3 Total: Anzahl unterschiedlicher Auftragsnummern im Monat, ohne Positionen mit Status STO oder NLB.
  • 4 rate new customers: Zeile 1 / Zeile 3 × 100 (0, wenn Zeile 3 gleich 0).
• Gruppe 2 – Bestellwerte (Summe von OrderLineAmount, Positionen mit Status STO/NLB ausgeschlossen):
  • 5 Wert der Erstbestellungen von Neukunden.
  • 6 Zeile 7 minus Zeile 5.
  • 7 Total: Wert aller Auftragspositionen des Monats.
  • 8 Anteil Neukunden (Zeile 5 / Zeile 7 × 100), 9 Anteil Bestandskunden (Zeile 6 / Zeile 7 × 100).
• Gruppe 3 – Durchschnitt je Auftragsposition:
  • 10 durchschnittlicher OrderLineAmount aller Kandidatenpositionen im Monat.
  • 11 durchschnittlicher OrderLineAmount der Erstbestellpositionen von Neukunden.

Spalte Average: arithmetisches Mittel der für die Zeile vorhandenen Monatswerte.

Die Zeilen sind nach LineNumber sortiert. ParYear, ParShop und ParCountry geben die wirksamen Parameter zurück; dbCurrency enthält den Code der Datenbankwährung, wenn Multi-Currency aktiv ist.

Parameter

Antwort

Result-Set 1 · Immer

Eine Zeile je Berichtszeile (bis zu 11), sortiert nach LineNumber, mit Monatswerten und Durchschnitt.

<SqlRowSet1>
  <row>
    <GroupNumber>1</GroupNumber>
    <LineNumber>1</LineNumber>
    <LineLabel>Orders new customers (Bestellungen Neukunden)</LineLabel>
    <Month01>42</Month01>
    <Month02>37</Month02>
    <Month03>51</Month03>
    <Month04>0</Month04>
    <Month05>0</Month05>
    <Month06>0</Month06>
    <Month07>0</Month07>
    <Month08>0</Month08>
    <Month09>0</Month09>
    <Month10>0</Month10>
    <Month11>0</Month11>
    <Month12>0</Month12>
    <Average>10.83</Average>
    <ParYear>2024</ParYear>
    <ParCountry>DE</ParCountry>
    <dbCurrency>EUR</dbCurrency>
  </row>
  <row>
    <GroupNumber>1</GroupNumber>
    <LineNumber>2</LineNumber>
    <LineLabel>Orders customers (Bestellungen Bestandskunden)</LineLabel>
    <Month01>118</Month01>
    <Month02>104</Month02>
    <Month03>129</Month03>
    <Month04>0</Month04>
    <Month05>0</Month05>
    <Month06>0</Month06>
    <Month07>0</Month07>
    <Month08>0</Month08>
    <Month09>0</Month09>
    <Month10>0</Month10>
    <Month11>0</Month11>
    <Month12>0</Month12>
    <Average>29.25</Average>
    <ParYear>2024</ParYear>
    <ParCountry>DE</ParCountry>
    <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:pixiReport_NewCustomersStats>
      <!-- <Year>2024</Year> -->
      <!-- <Shop>SHP</Shop> -->
      <!-- <Country>DE</Country> -->
    </ns1:pixiReport_NewCustomersStats>
  </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:pixiReport_NewCustomersStats>
      <!-- <Year>2024</Year> -->
      <!-- <Shop>SHP</Shop> -->
      <!-- <Country>DE</Country> -->
    </ns1:pixiReport_NewCustomersStats>
  </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 = [
    // 'Year' => '2024',
    // 'Shop' => 'SHP',
    // 'Country' => 'DE',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiReport_NewCustomersStats

Prozedur zuletzt geändert am 2026-10-05

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