pixiGetCustomerAccountBalance

Liefert den Kundenkontosaldo (Summe aller Kontobuchungen bis zu einem optionalen Stichtag) eines Kunden, ermittelt über den internen Schlüssel oder die externe Kundennummer.

Berechnet den Saldo des Kundenkontos (CustomerAccount) für einen oder mehrere Kunden.

Kundensuche

• CustKey wird mit der externen Kundennummer (CustomerNrExternal) und, sofern der Wert in eine Ganzzahl umgewandelt werden kann, mit dem internen Kundenschlüssel (CustKey) verglichen. Ein Kunde wird gefunden, wenn einer der beiden Vergleiche zutrifft.
• Ist ShopId angegeben (nicht leer), werden nur Kunden berücksichtigt, deren CustomerOf diesem Shop entspricht.

Stichtag

• Ist DateTo angegeben, wird der Wert auf das Tagesende (23:59:59.997) erweitert. Summiert werden nur Kontobuchungen mit EventDate bis zu diesem Zeitpunkt oder ohne EventDate.
• Ohne DateTo werden alle Buchungen summiert.

Währungsbehandlung

• Die Einstellung MultiCurrencyEnabled wird zur Laufzeit gelesen.
• Bei 1 wird jeder Buchungsbetrag durch den Wechselkurs der Buchung (ExchRateId) geteilt und das Ergebnis nach der Basiswährung dieses Wechselkurses (BaseCurrency) gruppiert.
• Andernfalls werden die Beträge unverändert summiert und BaseCurrency ist die Datenbank-(Haus-)Währung aus der Einstellung HomeCurrency.

Ergebnis Eine Zeile je gefundenem Kunden (im Mehrwährungsmodus je Basiswährung) mit dem Saldo CAbalance (als money) und dem Datum der letzten einbezogenen Kontobuchung LastEventDate. Kunden ohne Kontobuchungen werden mit Saldo 0 und LastEventDate = NULL geliefert. Wird kein Kunde gefunden, wird keine Zeile geliefert.

Parameter

Antwort

Result-Set 1 · Immer; eine Zeile je gefundenem Kunden (im Mehrwährungsmodus je Basiswährung), leer, wenn kein Kunde gefunden wird.

Kundenkontosaldo je Kunde.

<SqlRowSet1>
  <row>
    <CustomerId>10045</CustomerId>
    <CustomerNrExternal>K-778812</CustomerNrExternal>
    <ShopId>SH1</ShopId>
    <CAbalance>-125.5000</CAbalance>
    <BaseCurrency>EUR</BaseCurrency>
    <LastEventDate>2024-03-28T14:12:05</LastEventDate>
  </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:pixiGetCustomerAccountBalance>
      <CustKey>10045</CustKey>
      <!-- <DateTo>2024-03-31T00:00:00</DateTo> -->
      <!-- <ShopId>SH1</ShopId> -->
    </ns1:pixiGetCustomerAccountBalance>
  </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:pixiGetCustomerAccountBalance>
      <CustKey>10045</CustKey>
      <!-- <DateTo>2024-03-31T00:00:00</DateTo> -->
      <!-- <ShopId>SH1</ShopId> -->
    </ns1:pixiGetCustomerAccountBalance>
  </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 = [
    'CustKey' => '10045',
    // 'DateTo' => '2024-03-31T00:00:00',
    // 'ShopId' => 'SH1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetCustomerAccountBalance

Prozedur zuletzt geändert am 2026-10-05

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