pixiGetInvoicesUnpaid

Liefert alle unbezahlten Rechnungen oder mit `PaidInvoices` = 1 alle bezahlten Rechnungen mit Zahlungs-, Bank-, Adress- und Währungsdaten, sortiert nach Rechnungsdatum.

Liest Rechnungen aus Invoices zusammen mit dem Kunden, der Zahlungsart, der Rechnungsadresse, deren Land und der Rechnungswährung.

Der Parameter PaidInvoices wählt einen von zwei Modi:

• 0 (Standard): unbezahlte Rechnungen. Eine Rechnung wird geliefert, wenn die bezahlte Summe (PayedSum, NULL zählt als 0) nicht exakt dem auf 2 Nachkommastellen gerundeten Rechnungsbetrag entspricht und in CustomerAccount kein Eintrag für diesen Kunden und diese Rechnung mit DoNotRefund = 1 ohne Bankzeilen-, DTAUS- oder manuelle Buchungsreferenz existiert.
• 1: bezahlte Rechnungen. Eine Rechnung wird geliefert, wenn die bezahlte Summe um weniger als 0,01 vom gerundeten Rechnungsbetrag abweicht oder ein solcher DoNotRefund-Eintrag in CustomerAccount existiert.

Es werden nur Rechnungen geliefert, zu denen Währung, Kunde, Zahlungsart (Payments.Code = Zahlungscode der Rechnung) und Rechnungsadresse existieren (Inner Joins). Das Land ist optional.

Die Sortierung erfolgt aufsteigend nach Rechnungsdatum. Es gibt kein Paging; alle passenden Rechnungen werden geliefert.

Spaltenlogik:

• Paid ist nur 1, wenn die bezahlte Summe exakt dem gerundeten Rechnungsbetrag entspricht, sonst 0.
• PaymentDate ist das Zahlungsdatum der Rechnung, wenn Paid = 1, sonst NULL.
• PaymentText ist der Text der Zahlungsart, ersatzweise der Zahlungscode.
• Currency und OrderCurrency enthalten beide den Währungscode der Rechnung; total, TotalToPay und TotalToPay_OrderCurr enthalten alle den Rechnungsbetrag.

Parameter

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile pro passender Rechnung, aufsteigend sortiert nach Rechnungsdatum.

<SqlRowSet1>
  <row>
    <InvoiceNr>RE100234</InvoiceNr>
    <InvoiceDate>2024-03-04T10:15:00</InvoiceDate>
    <ShopID>SHOP1</ShopID>
    <PaymentAddressId>55012</PaymentAddressId>
    <ShipmentAddressId>55013</ShipmentAddressId>
    <CustKey>20871</CustKey>
    <total>89.90</total>
    <PaymentCode>RE</PaymentCode>
    <PaymentText>Rechnung</PaymentText>
    <Paid>false</Paid>
    <TotalToPay>89.90</TotalToPay>
    <PaidSum>0.00</PaidSum>
    <TrackingID>00340434161234567890</TrackingID>
    <ShipDate>2024-03-04T15:42:00</ShipDate>
    <UpdateDate>2024-03-04T15:42:00</UpdateDate>
    <ReminderLevel>0</ReminderLevel>
    <ShipVendor>DHL</ShipVendor>
    <Currency>EUR</Currency>
    <OrderCurrency>EUR</OrderCurrency>
    <TotalToPay_OrderCurr>89.90</TotalToPay_OrderCurr>
    <InvoiceKey>100234</InvoiceKey>
    <CustomerNrExternal>K-4711</CustomerNrExternal>
    <InvZIP>80331</InvZIP>
    <InvCity>München</InvCity>
    <InvCountryCodeISO3>DEU</InvCountryCodeISO3>
    <InvName>Max Mustermann</InvName>
    <InvFirstName>Max</InvFirstName>
    <InvLastName>Mustermann</InvLastName>
    <InvStreet>Marienplatz</InvStreet>
    <InvHouseNr>1</InvHouseNr>
    <DueDate>2024-03-18T00:00:00</DueDate>
    <DatevUserAccount>10871</DatevUserAccount>
  </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:pixiGetInvoicesUnpaid>
      <!-- <PaidInvoices>0</PaidInvoices> -->
    </ns1:pixiGetInvoicesUnpaid>
  </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:pixiGetInvoicesUnpaid>
      <!-- <PaidInvoices>0</PaidInvoices> -->
    </ns1:pixiGetInvoicesUnpaid>
  </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 = [
    // 'PaidInvoices' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetInvoicesUnpaid

Prozedur zuletzt geändert am 2026-10-05

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