pixiCustomersOpenCases

Liefert Sperrkennzeichen, offene Aufträge, unbezahlte Rechnungen, Rechnungsschuld und offenen Auftragswert eines Kunden samt Währungscode der Beträge.

Liefert eine einzelne Zeile mit den offenen Vorgängen des Kunden mit dem angegebenen CustKey.

Das Verhalten hängt von der Einstellung MultiCurrencyEnabled ab.

Mehrwährung deaktiviert (Einstellung ungleich 1):

• Locked ist 1, wenn das Kennzeichen SLocked des Kunden einen anderen Wert als N hat, sonst 0.
• OpenOrders ist die Anzahl unterschiedlicher Auftragsnummern mit mindestens einer Auftragsposition des Kunden (Orderlines.CustRef), deren Status kein Endstatus laut OrderStates (FinalState = 'Y') ist.
• OpenOrderAmount ist die Summe von OrderLineAmount dieser nicht abgeschlossenen Positionen. Die Beträge werden wie gespeichert summiert, ohne Währungsumrechnung.
• UnpaidInvoices ist die Anzahl der Rechnungen des Kunden, bei denen der bezahlte Betrag nicht dem Rechnungsbetrag entspricht. Ein fehlender bezahlter Betrag zählt als 0.
• DebtByInvoices ist die Summe von total - PayedSum über alle Rechnungen des Kunden.
• BaseCurrency ist der Code der Datenbankwährung. Er stammt aus der Einstellung HomeCurrency und muss eine Hauptwährung in pixi.Currency sein.

Mehrwährung aktiviert (Einstellung gleich 1):

• Die Anzahlen werden auf dieselbe Weise ermittelt.
• Jeder Positionsbetrag wird durch den Wechselkurs seines Auftragskopfs (OrderHeader.ExchRateId) geteilt.
• Jede Rechnungsschuld wird durch den Wechselkurs der Rechnung (Invoices.ExchRateId) geteilt.
• Die Ergebnisse sind damit Beträge in Basiswährung.
• BaseCurrency ist der Code der Basiswährung des Shops, dem der Kunde zugeordnet ist (Shops.BaseCurrencyId).

Existiert kein Kunde mit dem angegebenen CustKey, ist die Ergebnismenge leer.

Parameter

Antwort

Result-Set 1 · Wenn die Einstellung MultiCurrencyEnabled ungleich 1 ist und der Kunde existiert

Eine Zeile mit offenen Aufträgen und Rechnungen des Kunden. Die Beträge werden nicht umgerechnet.

Result-Set 2 · Wenn die Einstellung MultiCurrencyEnabled gleich 1 ist und Kunde, Shop und Basiswährung des Shops existieren

Eine Zeile mit offenen Aufträgen und Rechnungen des Kunden. Die Beträge sind in die Basiswährung umgerechnet.

<SqlRowSet1>
  <row>
    <Locked>0</Locked>
    <OpenOrders>2</OpenOrders>
    <UnpaidInvoices>1</UnpaidInvoices>
    <DebtByInvoices>149.9000</DebtByInvoices>
    <OpenOrderAmount>312.5000</OpenOrderAmount>
    <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:pixiCustomersOpenCases>
      <CustKey>10452</CustKey>
    </ns1:pixiCustomersOpenCases>
  </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:pixiCustomersOpenCases>
      <CustKey>10452</CustKey>
    </ns1:pixiCustomersOpenCases>
  </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' => '10452',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCustomersOpenCases

Prozedur zuletzt geändert am 2026-10-05

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