pixiGetReminders

Liefert unbezahlte Rechnungen einer Zahlungsart, die für die angegebene Mahnstufe fällig sind, inklusive Adress- und Shopdaten.

Listet offene Rechnungen auf, die für die nächste Zahlungserinnerung bzw. Mahnung in Frage kommen. Der Aufruf delegiert an die interne Prozedur pixi_GetReminders.

Eine Rechnung wird geliefert, wenn alle folgenden Bedingungen erfüllt sind:

• Invoices.Payed ist NULL (nicht bezahlt).
• Invoices.Payment entspricht @PaymentType.
• Invoices.total ist größer als 0.
• Zwischen Invoices.ScanOutDate und dem aktuellen Serverdatum liegen mehr Tage als der Schwellenwert.
• Die aktuelle Mahnstufe der Rechnung entspricht der Stufe vor @ReminderLevel:
  • Stufe 1: ReminderLevel ist NULL oder 0,
  • Stufe 2: ReminderLevel = 1,
  • Stufe 3: ReminderLevel = 2,
  • Stufe größer als 3: ReminderLevel = @ReminderLevel - 1.
• Die über Invoices.AddrRef referenzierte Adresse gehört zum Shop @ShopID, oder @ShopID ist NULL (alle Shops).

Der Tages-Schwellenwert wird so ermittelt:

• Stufen 1 bis 3: @ReminderDays, falls angegeben, sonst die Einstellung ReminderLevel1_Days (sofern nicht 0), sonst 15 (Stufe 1), 30 (Stufe 2) bzw. 45 (Stufe 3).
• Stufen über 3: @ReminderDays, falls angegeben, sonst 45. Die Einstellung wird nicht verwendet.

Jede Zeile enthält Rechnungsdaten, die Rechnungsadresse sowie Shopname und Kunden-E-Mail des Shops. Eine Sortierung ist nicht definiert.

Parameter

Antwort

Result-Set 1 · Wenn @ReminderLevel >= 1 (kann leer sein).

Unbezahlte Rechnungen, die für die angeforderte Mahnstufe fällig sind, mit Rechnungsadresse und Shopdaten.

<SqlRowSet1>
  <row>
    <InvoiceNr>100234</InvoiceNr>
    <InvDate>2024-03-01T10:15:00</InvDate>
    <total>89.90</total>
    <Payment>R</Payment>
    <ShipmentTrackingID>00340434161094042557</ShipmentTrackingID>
    <Name>Max Mustermann</Name>
    <Name2/>
    <CareOf/>
    <Street>Hauptstraße</Street>
    <HouseNr>12</HouseNr>
    <City>München</City>
    <State>BY</State>
    <ZIP>80331</ZIP>
    <Country>DE</Country>
    <Phone>+49 89 123456</Phone>
    <eMail>max@example.com</eMail>
    <ShopName>Example Shop</ShopName>
    <CusEmail>service@example-shop.de</CusEmail>
  </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:pixiGetReminders>
      <ReminderLevel>1</ReminderLevel>
      <PaymentType>R</PaymentType>
      <ShopID>SHP</ShopID>
      <!-- <ReminderDays>14</ReminderDays> -->
    </ns1:pixiGetReminders>
  </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:pixiGetReminders>
      <ReminderLevel>1</ReminderLevel>
      <PaymentType>R</PaymentType>
      <ShopID>SHP</ShopID>
      <!-- <ReminderDays>14</ReminderDays> -->
    </ns1:pixiGetReminders>
  </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' => '1',
    'PaymentType' => 'R',
    'ShopID' => 'SHP',
    // 'ReminderDays' => '14',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetReminders

Prozedur zuletzt geändert am 2026-10-05

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