pixiGetInvoicesForCustomer

Liefert die Rechnungen eines Kunden, identifiziert über Kundenschlüssel oder externe Kundennummer, optional gefiltert auf eine einzelne Rechnungsnummer.

Listet Rechnungen eines Kunden mit Zahlungs-, Bank- bzw. Karten-, Versand- und Auftragsinformationen auf.

Identifikation des Kunden

NULL-Werte werden zunächst durch 0 (bei CustKey) bzw. einen Leerstring ersetzt. Danach muss genau ein Merkmal gesetzt sein:

• CustKey <> 0 und CustomerNrExternal leer: Die Rechnungen dieses Kundenschlüssels werden geliefert.
• CustKey = 0 und CustomerNrExternal gesetzt: Alle Kunden in Customers mit dieser CustomerNrExternal werden verwendet. Teilen sich mehrere Kunden die Nummer, werden die Rechnungen aller dieser Kunden geliefert.
• Beide gesetzt oder beide leer: Es wird kein Kunde ausgewählt und die Ergebnismenge ist leer.

Rechnungsfilter

• Ist InvoiceNr leer oder NULL, werden alle Rechnungen des Kunden geliefert.
• Andernfalls wird nur die Rechnung mit genau dieser InvoiceNr geliefert.

Gelieferte Daten je Rechnung

• Rechnungsdaten aus Invoices: Nummer, Datum, IDs der Rechnungs- und Lieferadresse, Gesamtbetrag, Zahlungscode, Zahlungsdatum, bezahlter Betrag, Tracking-ID, Versanddatum und Mahnstufe.
• PaymentText stammt aus Payments. Wird der Code dort nicht gefunden, wird der Zahlungscode selbst geliefert.
• Paid ist 1, wenn der bezahlte Betrag (ein fehlender Betrag zählt als 0) dem Gesamtbetrag entspricht, sonst 0.
• Karten- und Bankdaten (Cc…, Account, Blz, BankName, AccountName) stammen aus der Rechnungsadresse in Addresses.
• OrderNr und OrderNrExternal sind die höchsten Werte unter den Auftragspositionen, die mit den Rechnungspositionen verknüpft sind. Sie sind NULL, wenn die Rechnung keine verknüpften Auftragspositionen hat.
• OrderCurrencyCode ist der Währungscode aus pixi.Currency.

Der Code legt keine Sortierung fest.

Parameter

Antwort

Result-Set 1 · Immer; leer, wenn kein Kunde ermittelt werden konnte oder keine Rechnung passt.

Eine Zeile je Rechnung des bzw. der ausgewählten Kunden.

<SqlRowSet1>
  <row>
    <InvoiceNr>RE2024001234</InvoiceNr>
    <InvoiceDate>2024-03-12T10:15:00</InvoiceDate>
    <PaymentAddressId>88231</PaymentAddressId>
    <ShipmentAddressId>88232</ShipmentAddressId>
    <total>129.90</total>
    <PaymentCode>VK</PaymentCode>
    <PaymentText>Vorkasse</PaymentText>
    <PaymentDate>2024-03-14T00:00:00</PaymentDate>
    <Paid>true</Paid>
    <TotalToPay>129.90</TotalToPay>
    <PaidSum>129.90</PaidSum>
    <TrackingID>00340434161234567890</TrackingID>
    <ShipDate>2024-03-15T08:42:00</ShipDate>
    <ReminderLevel>0</ReminderLevel>
    <OrderNr>502311</OrderNr>
    <OrderNrExternal>SHOP-77812</OrderNrExternal>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
  </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:pixiGetInvoicesForCustomer>
      <!-- <CustKey>4711</CustKey> -->
      <!-- <CustomerNrExternal>SHOP-100234</CustomerNrExternal> -->
      <!-- <InvoiceNr>RE2024001234</InvoiceNr> -->
    </ns1:pixiGetInvoicesForCustomer>
  </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:pixiGetInvoicesForCustomer>
      <!-- <CustKey>4711</CustKey> -->
      <!-- <CustomerNrExternal>SHOP-100234</CustomerNrExternal> -->
      <!-- <InvoiceNr>RE2024001234</InvoiceNr> -->
    </ns1:pixiGetInvoicesForCustomer>
  </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' => '4711',
    // 'CustomerNrExternal' => 'SHOP-100234',
    // 'InvoiceNr' => 'RE2024001234',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetInvoicesForCustomer

Prozedur zuletzt geändert am 2026-10-05

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