pixiGetRemindersCA

Liefert Rechnungen mit Mahnhistorie, Mahnkosten, offenem Betrag, Kundenkontostatus und Rechnungsadresse, optional gefiltert nach Mahnstufe, Shop, Zahlungsart und Datum.

Liefert eine Zeile je Rechnung, die den Filtern entspricht, ergänzt um Mahndaten, Kennzahlen des Kundenkontos (CA) und die Rechnungsadresse.

Normalisierung der Parameter

• ReminderLevel = 0, ShopID = '' und PaymentType = '' werden als NULL (kein Filter) behandelt.
• ReminderDays = 0 wird als NULL behandelt. Ist ReminderDays > 0, werden InvoiceFrom und InvoiceTo überschrieben mit dem Zeitraum von jetzt minus ReminderDays Tagen bis jetzt.
• Ist InvoiceFrom gesetzt und InvoiceTo leer, wird InvoiceTo auf das aktuelle Datum mit Uhrzeit gesetzt.

Filter (alle mit UND verknüpft)

• ReminderLevel: nur Rechnungen mit mindestens einer Mahnposition genau dieser Mahnstufe. Bei NULL sind alle Rechnungen Kandidaten, auch Rechnungen ohne Mahnung.
• InvoiceFrom/InvoiceTo: Rechnungsdatum zwischen beiden Werten (inklusive). Wird nur angewendet, wenn InvoiceFrom gesetzt ist.
• PaymentType: Zahlungsart der Rechnung entspricht dem Wert.
• ShopID: der Kunde gehört zu diesem Shop (CustomerOf).
• OnlyUnmatched = 1: nur Rechnungen, deren bezahlter Betrag vom Rechnungsbetrag abweicht.
• OnlyWhenCAUnbalanced: siehe Hinweise – der wirksame Wert wird aus OnlyUnmatched übernommen; wenn aktiv, nur Rechnungen von Kunden, deren Kundenkontosaldo ungleich 0 ist.

Es werden nur Rechnungen geliefert, deren Kunde existiert, einem vorhandenen Shop zugeordnet ist und deren Rechnungsadresse existiert.

Gelieferte Daten

• Rechnungsdaten: Schlüssel, Rechnungsnummer, Kunden- und Adressschlüssel, Shop, höchste Auftragsnummer und die externe Auftragsnummer dieses Auftrags, Datum und Rechnungsbetrag.
• Mahndaten: höchste Mahnstufe, frühestes Mahndatum je Stufe 1–6 (ReminderDate1 … ReminderDate6), Kosten der letzten Mahnung (höchster Mahnungsschlüssel) und Summe der Kosten aller Mahnungen der Rechnung.
• OpenInvoiceAmount = Rechnungsbetrag minus bezahlter Betrag.
• Kundenkonto: CAMatched (1, wenn alle positiven oder alle negativen Kontobuchungen vollständig ausgeglichen sind, sonst 0) und CAFinancialBalance (Saldo des Kundenkontos; bei mehreren Währungen mit dem heutigen Wechselkurs umgerechnet, falls Mehrwährung aktiviert ist).
• Kunden- und Adressdaten (externe Kundennummer, Firma, Name, Straße, PLZ, Ort, Land, Telefon, Fax, E-Mail).

Die Zeilen sind nach Kundenschlüssel sortiert; innerhalb eines Kunden gibt es keine weitere Sortierung und kein Paging.

Parameter

Antwort

Result-Set 1 · Immer (ggf. leer)

Eine Zeile je passender Rechnung mit Mahn-, Kundenkonto- und Adressdaten, sortiert nach Kundenschlüssel.

<SqlRowSet1>
  <row>
    <InvoiceKey>48211</InvoiceKey>
    <InvoiceNr>2024010532</InvoiceNr>
    <CustKey>10233</CustKey>
    <AddrKey>55120</AddrKey>
    <ShopID>SHP</ShopID>
    <LastOrderNr>300512</LastOrderNr>
    <LastOrderNrExternal>WEB-100245</LastOrderNrExternal>
    <InvoiceDate>2024-02-03T10:15:00</InvoiceDate>
    <InvoiceTotal>149.9000</InvoiceTotal>
    <CurrentReminderLevel>2</CurrentReminderLevel>
    <ReminderDate1>2024-02-20T08:00:00</ReminderDate1>
    <ReminderDate2>2024-03-05T08:00:00</ReminderDate2>
    <LastReminderCosts>5.0000</LastReminderCosts>
    <AllReminderCosts>7.5000</AllReminderCosts>
    <OpenInvoiceAmount>149.9000</OpenInvoiceAmount>
    <CAMatched>0.0000</CAMatched>
    <CAFinancialBalance>-149.9000</CAFinancialBalance>
    <CustomerNrExternal>K-4711</CustomerNrExternal>
    <FirstName>Anna</FirstName>
    <LastName>Muster</LastName>
    <FullName>Anna Muster</FullName>
    <Street>Hauptstraße</Street>
    <HouseNr>12</HouseNr>
    <ZIP>80331</ZIP>
    <City>München</City>
    <Country>DE</Country>
    <Email>anna.muster@example.com</Email>
  </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:pixiGetRemindersCA>
      <!-- <ReminderLevel>2</ReminderLevel> -->
      <!-- <PaymentType>R</PaymentType> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <ReminderDays>30</ReminderDays> -->
      <!-- <InvoiceFrom>2024-01-01T00:00:00</InvoiceFrom> -->
      <!-- <InvoiceTo>2024-03-31T23:59:59</InvoiceTo> -->
      <!-- <OnlyUnmatched>1</OnlyUnmatched> -->
      <!-- <OnlyWhenCAUnbalanced>0</OnlyWhenCAUnbalanced> -->
    </ns1:pixiGetRemindersCA>
  </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:pixiGetRemindersCA>
      <!-- <ReminderLevel>2</ReminderLevel> -->
      <!-- <PaymentType>R</PaymentType> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <ReminderDays>30</ReminderDays> -->
      <!-- <InvoiceFrom>2024-01-01T00:00:00</InvoiceFrom> -->
      <!-- <InvoiceTo>2024-03-31T23:59:59</InvoiceTo> -->
      <!-- <OnlyUnmatched>1</OnlyUnmatched> -->
      <!-- <OnlyWhenCAUnbalanced>0</OnlyWhenCAUnbalanced> -->
    </ns1:pixiGetRemindersCA>
  </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 = [
    // 'ReminderLevel' => '2',
    // 'PaymentType' => 'R',
    // 'ShopID' => 'SHP',
    // 'ReminderDays' => '30',
    // 'InvoiceFrom' => '2024-01-01T00:00:00',
    // 'InvoiceTo' => '2024-03-31T23:59:59',
    // 'OnlyUnmatched' => '1',
    // 'OnlyWhenCAUnbalanced' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetRemindersCA

Prozedur zuletzt geändert am 2026-10-05

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