pixiGetCustomerList

Liefert bis zu 10.000 Kunden mit Aufträgen ab einem Kundenschlüssel, mit Auftrags-, Umsatz-, Retouren- und Mahnstatistik sowie Daten der Hauptadresse.

Erstellt eine Kundenliste mit Kennzahlen, ausgehend von den Aufträgen in OrderHeader.

1. StartCustKey (NULL wird als 0 behandelt) legt den ersten Kunden fest. Es werden die ersten 10.000 unterschiedlichen CustRef-Werte aus OrderHeader mit CustRef >= StartCustKey in aufsteigender Reihenfolge ermittelt und ihre Aufträge gezählt (OrderCount). Kunden ohne Auftrag werden nie geliefert.
2. Für jeden dieser Kunden wird berechnet:
   • DaysSinceLastOrder / DaysSinceFirstOrder: Tage zwischen heute und dem spätesten OrderDate in Orderlines des Auftrags mit der höchsten bzw. niedrigsten Auftragsnummer des Kunden.
   • Aus Invoices: Turnover_all (Summe der Rechnungen mit positivem Betrag), Turnover_avgPerOrder (Durchschnitt der positiven Rechnungsbeträge), ReturnCount (Anzahl der Rechnungen mit negativem Betrag), ReturnValue (Summe der negativen Beträge) und ReminderLevel (höchste Mahnstufe).
   • Aus Invlines: ItemCount_all, die Summe aller positiven ItemQty-Werte.
3. Die Währungsbehandlung hängt von der Einstellung MultiCurrencyEnabled ab:
   • nicht 1: Beträge werden in der Originalwährung der Rechnung summiert, BaseCurrency ist NULL.
   • 1: jeder Rechnungsbetrag wird durch den Wechselkurs der Rechnung (pixi.ExchRate) geteilt, BaseCurrency enthält den ISO-Code der Basiswährung.
4. Das Ergebnis wird mit Customers und der Hauptadresse des Kunden (Customers.AddrRef → Addresses) verknüpft und aufsteigend nach CustKey sortiert.

Paging: Für den nächsten Block erneut mit StartCustKey = zuletzt gelieferter CustKey + 1 aufrufen (der Filter ist inklusiv).

Parameter

Antwort

Result-Set 1 · Immer (leer, wenn kein Kunde mit Aufträgen einen Schlüssel >= StartCustKey hat)

Eine Zeile je Kunde mit Aufträgen, höchstens 10.000 Zeilen, aufsteigend nach CustKey sortiert.

<SqlRowSet1>
  <row>
    <CustKey>10001</CustKey>
    <CustomerNrExternal>SHOP-4711</CustomerNrExternal>
    <OrderCount>5</OrderCount>
    <Turnover_all>489.7000</Turnover_all>
    <ItemCount_all>12</ItemCount_all>
    <Turnover_avgPerOrder>97.9400</Turnover_avgPerOrder>
    <ReturnCount>1</ReturnCount>
    <ReturnValue>-39.9000</ReturnValue>
    <ReminderLevel>0</ReminderLevel>
    <DaysSinceLastOrder>14</DaysSinceLastOrder>
    <DaysSinceFirstOrder>412</DaysSinceFirstOrder>
    <ShopID>WEB</ShopID>
    <eMail>max.mustermann@example.com</eMail>
    <Salutation>Herr</Salutation>
    <FirstName>Max</FirstName>
    <LastName>Mustermann</LastName>
    <Name>Max Mustermann</Name>
    <CareOf/>
    <Address>Hauptstraße 1</Address>
    <ZIP>80331</ZIP>
    <Country>DE</Country>
    <ShipLock>0</ShipLock>
    <BaseCurrency>EUR</BaseCurrency>
  </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:pixiGetCustomerList>
      <!-- <StartCustKey>10001</StartCustKey> -->
    </ns1:pixiGetCustomerList>
  </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:pixiGetCustomerList>
      <!-- <StartCustKey>10001</StartCustKey> -->
    </ns1:pixiGetCustomerList>
  </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 = [
    // 'StartCustKey' => '10001',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetCustomerList

Prozedur zuletzt geändert am 2026-10-05

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