pixiCreateInkassoBookings

Legt manuelle Kundenkonto-Buchungen für offene, gemahnte Rechnungen im Inkasso an; außerhalb bestimmter Datenbanken nicht mehr unterstützt.

Der Aufruf prüft den Namen der aktuellen Datenbank.

• Datenbank pixi_GCH oder pixi_GCH_test: Die interne Prozedur Pixi_CA_CreateinkassoManualBookings wird mit den drei Parametern ausgeführt. Sie legt manuelle Buchungsereignisse auf dem Kundenkonto an, damit die betroffenen Rechnungen nicht mehr offen sind. In diesem Fall wird keine Ergebnismenge zurückgegeben.
• Jede andere Datenbank: Es wird nichts gebucht. Der Aufruf liefert eine einzelne Zeile mit Status = Info und einer Meldung, dass der Aufruf nicht mehr unterstützt wird.

Die interne Prozedur arbeitet so:

1. Sie liest die Buchungsereignis-ID aus der Einstellung CA_Inkasso_ManualBookingID. Ist die Einstellung leer oder 0, wird INU verwendet.
2. Sie fährt nur fort, wenn in CustomerAccountEvents ein Ereignis mit dieser ID existiert und OriginalAmountMultiply = -1 hat (negatives Ereignis).
3. Sie wählt Rechnungen mit Total > 0 und offenem Betrag (Total - PayedSum) > 0. Der Kunde muss laut fPixi_CA_IsMatched abgeglichen sein. Zusätzlich muss der Kunde mindestens eine offene Rechnung haben, die alle folgenden Bedingungen erfüllt:
   • Mahnstufe zwischen MinimumReminderLevel und MaxReminderLevel;
   • Rechnungsdatum älter als MinimumAgeInDays Tage.
4. Für jede gewählte Rechnung schreibt sie einen Logeintrag in LogTable. Anschließend ruft sie Pixi_CA_InsertManualBookingEvent auf, mit dem negierten offenen Betrag, dem Text Manual booking, dem Benutzer pixi* Automatic, dem Kundenkonto-Schlüssel der Rechnung und deren Währung.

Gebucht werden alle offenen Rechnungen eines qualifizierten Kunden, nicht nur die Rechnungen, die die Alters- und Mahnstufenkriterien erfüllen.

Parameter

Antwort

Result-Set 1 · Nur wenn die Datenbank nicht pixi_GCH oder pixi_GCH_test ist

Info-Zeile mit dem Hinweis, dass der Aufruf nicht mehr unterstützt wird.

<SqlRowSet1>
  <row>
    <Status>Info</Status>
    <Message>API Call: pixiCreateInkassoBookings is no longer suported.</Message>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiCreateInkassoBookings>
      <MinimumAgeInDays>10</MinimumAgeInDays>
      <MinimumReminderLevel>1</MinimumReminderLevel>
      <MaxReminderLevel>3</MaxReminderLevel>
    </ns1:pixiCreateInkassoBookings>
  </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:pixiCreateInkassoBookings>
      <MinimumAgeInDays>10</MinimumAgeInDays>
      <MinimumReminderLevel>1</MinimumReminderLevel>
      <MaxReminderLevel>3</MaxReminderLevel>
    </ns1:pixiCreateInkassoBookings>
  </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 = [
    'MinimumAgeInDays' => '10',
    'MinimumReminderLevel' => '1',
    'MaxReminderLevel' => '3',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateInkassoBookings

Prozedur zuletzt geändert am 2026-10-05

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