Postman-Collection
Invoices Lesen

pixiGetPaidInvoices

Liefert Rechnungen, die über Ausgleiche im Kundenkonto vollständig bezahlt sind und deren Zahlung im angegebenen Zeitraum gebucht wurde.

Ermittelt Rechnungen, die im Kundenkonto (CustomerAccount) ausgeglichen wurden, und liefert eine Zeile je Rechnungsbuchung.

Ablauf:

  1. Es werden alle Kundenkontobuchungen mit EventDate zwischen @From und @To (inklusive, BETWEEN) und Amount > 0 ermittelt. Das sind in der Regel die Zahlungsbuchungen.
  2. Über CustomerAccountMatch werden alle Kundenkontobuchungen gesucht, die mit diesen Buchungen ausgeglichen wurden, in beide Richtungen (CARef1 ↔ CARef2).
  3. Berücksichtigt werden nur ausgeglichene Buchungen mit Bezug zu einer Rechnung (InvoiceRef IS NOT NULL).
  4. Berücksichtigt werden nur vollständig ausgeglichene Buchungen: Die Summe von AbsoluteMatchAmount über alle Ausgleiche der Buchung plus der eigene Amount der Buchung muss genau 0 ergeben.

Für jede verbleibende Buchung werden geliefert:

  • Rechnungsschlüssel und Rechnungsnummer aus Invoices,
  • DatePaid: das späteste EventDate aller mit der Rechnungsbuchung ausgeglichenen Kundenkontobuchungen (nicht auf den Zeitraum beschränkt),
  • ShopID: der Shop des Kunden (Customers.CustomerOf),
  • OrderNRExternal: die höchste externe Auftragsnummer der über Invlines mit der Rechnung verknüpften Auftragspositionen,
  • PaymentType: die Zahlungsart der Rechnung.

Eine Sortierung ist nicht festgelegt.

Hinweise

  • Alle Tabellen werden WITH (NOLOCK) gelesen; das Ergebnis kann nicht festgeschriebene Daten enthalten.
  • BETWEEN schließt beide Grenzen ein. Wird @To als Datum ohne Uhrzeit (Mitternacht) übergeben, fehlen spätere Zahlungen dieses Tages.
  • Die Prüfung auf vollständigen Ausgleich vergleicht exakt mit 0; Rundungsdifferenzen in den Ausgleichen schließen eine Rechnung aus.
  • Hat eine Rechnung mehrere Kundenkontobuchungen, die jeweils die Bedingungen erfüllen, kann die Rechnung mehrfach erscheinen.
  • DatePaid ist das späteste Datum aller ausgeglichenen Buchungen und kann außerhalb von @From/@To liegen.
  • In der Ausgleichsprüfung sind die Spalten Amount und CustomerAccountKey nicht qualifiziert; der Code verlässt sich darauf, dass sie auf die äußere CustomerAccount-Buchung verweisen.
  • Der Kopfkommentar der Prozedur ("Checks pixi* user credentials") passt nicht zur Funktion und ist offenbar ein Kopierrest.

Parameter

Parameter Typ Standardwert Beschreibung
From
Pflicht
datetime
dateTime
–

Beginn des Zeitraums (inklusive) für das Buchungsdatum (EventDate) der Zahlungsbuchungen.

Beispiel: 2024-05-01T00:00:00

To
Pflicht
datetime
dateTime
–

Ende des Zeitraums (inklusive) für das Buchungsdatum (EventDate) der Zahlungsbuchungen.

Beispiel: 2024-05-31T23:59:59

Antwort

Result-Set 1 · Immer (kann leer sein).

Eine Zeile je vollständig ausgeglichener Rechnungsbuchung im Kundenkonto, deren ausgeglichene Zahlung im Zeitraum liegt.

Spalte Typ Beschreibung
InvoiceKey int

Schlüssel der Rechnung (CustomerAccount.InvoiceRef).

InvoiceNr
Kann leer sein
string

Rechnungsnummer aus Invoices.InvoiceNr.

DatePaid
Kann leer sein
datetime
dateTime

Spätestes EventDate aller mit der Rechnungsbuchung ausgeglichenen Kundenkontobuchungen.

ShopID
Kann leer sein
string

Shop des Kunden (Customers.CustomerOf).

OrderNRExternal
Kann leer sein
string

Höchste externe Auftragsnummer (Orderlines.OrderNRExternal) der auf dieser Rechnung berechneten Auftragspositionen.

PaymentType
Kann leer sein
string

Zahlungsart der Rechnung (Invoices.Payment).

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:pixiGetPaidInvoices>
      <From>2024-05-01T00:00:00</From>
      <To>2024-05-31T23:59:59</To>
    </ns1:pixiGetPaidInvoices>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

CustomerAccount · Lesen CustomerAccountMatch · Lesen Invoices · Lesen Customers · Lesen Orderlines · Lesen Invlines · Lesen
SQL-Objekt:
dbo.pipiGetPaidInvoices
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben