pixiCAGetCustomerEvents

Liefert alle Kundenkonto-Ereignisse (Buchungen, inklusive gelöschter) eines Kunden zusammen mit den Kontostatistiken wie Saldo und vorgeschlagener Erstattung.

Listet das Kundenkonto eines Kunden auf.

Kunde bestimmen

• Entweder CustRef (interner Kundenschlüssel) übergeben oder
• ShopID und CustNrExt (externe Kundennummer im Shop) gemeinsam übergeben. Die Prozedur ermittelt dann CustKey aus Customers über CustomerOf = ShopID und CustomerNrExternal = CustNrExt.
• Ist CustRef leer oder 0 und fehlt ShopID oder CustNrExt, wird ein Fehler ausgelöst.
• Ist CustRef angegeben, werden ShopID und CustNrExt ignoriert.

Ereignisse Alle Kontoereignisse des Kunden werden ohne Filter gesammelt (Übersetzungen in Sprache 1):

• aktive Buchungen aus CustomerAccount (IsDeleted = 0),
• gelöschte Buchungen aus CustomerAccountLog mit Historienvermerk DELETE (IsDeleted = 1).

Number enthält je nach Bezug des Ereignisses die Rechnungsnummer, den Bankzeilentext, die Kontonummer der Lastschrift oder die Referenz der manuellen Buchung. OpenTOMatch ist Amount abzüglich des ausgeglichenen Betrags.

Statistik Die Kontostatistik (Saldo, offene Aufträge, vorgeschlagene Erstattung, Ausgleichs-Kennzeichen, Kontowährung) wird pro Kunde berechnet und an jede Ereigniszeile angehängt.

Ergebnis Eine Zeile pro Ereignis mit jeweils denselben Statistikspalten. Hat der Kunde keine Ereignisse, wird eine einzelne Zeile geliefert, in der nur die Statistikspalten gefüllt sind (Ereignisspalten einschließlich CustRef sind NULL).

Parameter

Antwort

Result-Set 1 · Bei Erfolg (Parameter gültig)

Eine Zeile pro Kundenkonto-Ereignis mit der Kontostatistik des Kunden; eine reine Statistikzeile, falls keine Ereignisse vorhanden sind.

<SqlRowSet1>
  <row>
    <CustRef>10452</CustRef>
    <EventDate>2024-03-04T10:15:00</EventDate>
    <EventID>INV</EventID>
    <Number>RE-2024-00871</Number>
    <Reference>Order 55120</Reference>
    <Amount>-119.0000</Amount>
    <OpenTOMatch>0.0000</OpenTOMatch>
    <DoNotRefund>false</DoNotRefund>
    <OrderCurrency>EUR</OrderCurrency>
    <IsAcountMatched>true</IsAcountMatched>
    <CustomerBalance>0.0000</CustomerBalance>
    <OpenOrders>0.0000</OpenOrders>
    <SuggestedRefound>0.0000</SuggestedRefound>
    <IsDeleted>false</IsDeleted>
    <AccountCurrencyCode>EUR</AccountCurrencyCode>
  </row>
  <row>
    <CustRef>10452</CustRef>
    <EventDate>2024-03-06T08:02:00</EventDate>
    <EventID>BNK</EventID>
    <Number>Payment 55120</Number>
    <Reference>K-200381 Order 55120</Reference>
    <Amount>119.0000</Amount>
    <OpenTOMatch>0.0000</OpenTOMatch>
    <DoNotRefund>false</DoNotRefund>
    <OrderCurrency>EUR</OrderCurrency>
    <IsAcountMatched>true</IsAcountMatched>
    <CustomerBalance>0.0000</CustomerBalance>
    <OpenOrders>0.0000</OpenOrders>
    <SuggestedRefound>0.0000</SuggestedRefound>
    <IsDeleted>false</IsDeleted>
    <AccountCurrencyCode>EUR</AccountCurrencyCode>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiCAGetCustomerEvents>
      <!-- <CustRef>10452</CustRef> -->
      <!-- <CustNrExt>K-200381</CustNrExt> -->
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiCAGetCustomerEvents>
  </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:pixiCAGetCustomerEvents>
      <!-- <CustRef>10452</CustRef> -->
      <!-- <CustNrExt>K-200381</CustNrExt> -->
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiCAGetCustomerEvents>
  </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 = [
    // 'CustRef' => '10452',
    // 'CustNrExt' => 'K-200381',
    // 'ShopID' => 'ABC',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCAGetCustomerEvents

Prozedur zuletzt geändert am 2026-10-05

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