pixiGetInkassoBookings

Liefert die im Zeitraum an das Inkasso übergebenen Rechnungen mit Kundenadresse und Beträgen; nur in den Datenbanken pixi_GCH unterstützt.

Dieser Aufruf ist kundenspezifisch und funktioniert nur, wenn die Pixi-Datenbank pixi_GCH oder pixi_GCH_test heißt. In allen anderen Datenbanken wird eine Statuszeile mit Status = Info und dem Hinweis geliefert, dass der Aufruf nicht mehr unterstützt wird.

In den unterstützten Datenbanken wird die interne Prozedur Pixi_CA_GetInkassoBookings ausgeführt und deren Zeilen werden zurückgegeben:

1. Die Buchungs-Event-ID für manuelle Inkasso-Buchungen wird aus der Einstellung CA_Inkasso_ManualBookingID gelesen (Standard INU).
2. Alle Kundenkonto-Buchungen (CustomerAccount) mit dieser Event-ID und einem EventDate zwischen FromDate und ToDate (jeweils einschließlich) werden ermittelt.
3. Über CustomerAccountMatch werden die zugeordneten Buchungen in beide Richtungen gesucht und die Rechnungen bestimmt, auf die diese Buchungen verweisen.
4. Pro Rechnung wird eine Zeile mit Kunde (Customers) und Kundenadresse (Addresses) geliefert, aufsteigend sortiert nach Rechnungsdatum (InvDate).

Das Zeilenformat ist ein festes Exportformat für ein Inkassobüro:

• Feste Werte: KundenNr = 975503, RecordCode = 0, CompanyType = 99, Land = 001, Adresszusatz und Rechnungsgrund leer.
• Sprachcode ist D, wenn die Adresse zum Shop GCH gehört, sonst F.
• Geschlecht ist m bei Anrede Herr, w bei Frau, sonst f.
• Datumswerte (Geburtsdatum, Rechnungsdatum) haben das Format dd.mm.yyyy.
• Beträge (BetragCHF, Mahnkosten, BetragCHFtotal) werden als Text mit Punkt als Dezimaltrennzeichen geliefert. BetragCHF ist der Betrag der zugeordneten Inkasso-Buchung, BetragCHFtotal der Rechnungsbetrag, Mahnkosten die Mahngebühren (0, wenn keine vorhanden).

Parameter

Antwort

Result-Set 1 · Wenn die Datenbank pixi_GCH oder pixi_GCH_test ist

Eine Zeile pro im Zeitraum an das Inkasso übergebener Rechnung, sortiert nach Rechnungsdatum.

Result-Set 2 · Wenn die Datenbank nicht pixi_GCH oder pixi_GCH_test ist

Einzelne Statuszeile mit dem Hinweis, dass der Aufruf nicht mehr unterstützt wird.

<SqlRowSet1>
  <row>
    <KundenNr>975503</KundenNr>
    <RecordCode>0</RecordCode>
    <KundenRefNr>K-104522</KundenRefNr>
    <Name1>Muster</Name1>
    <Name2>Hans</Name2>
    <CompanyType>99</CompanyType>
    <Adresszusatz/>
    <Strasse>Bahnhofstrasse</Strasse>
    <Hausnummer>12</Hausnummer>
    <Postleitzahl>8001</Postleitzahl>
    <Ort>Zürich</Ort>
    <Land>001</Land>
    <Sprachcode>D</Sprachcode>
    <Geschlecht>m</Geschlecht>
    <Geburtsdatum>14.03.1978</Geburtsdatum>
    <Geburtsjahr>1978</Geburtsjahr>
    <Telefon>044 123 45 67</Telefon>
    <Telefax/>
    <E_Mail>hans.muster@example.ch</E_Mail>
    <Mobile>079 123 45 67</Mobile>
    <Rechnungsdatum>05.10.2023</Rechnungsdatum>
    <Rechnungsnummer>RE2023104411</Rechnungsnummer>
    <BetragCHF>149.90</BetragCHF>
    <Rechnungsgrund/>
    <Mahnkosten>20.00</Mahnkosten>
    <BetragCHFtotal>149.90</BetragCHFtotal>
  </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:pixiGetInkassoBookings>
      <FromDate>2024-01-01T00:00:00</FromDate>
      <ToDate>2024-01-31T23:59:59</ToDate>
    </ns1:pixiGetInkassoBookings>
  </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:pixiGetInkassoBookings>
      <FromDate>2024-01-01T00:00:00</FromDate>
      <ToDate>2024-01-31T23:59:59</ToDate>
    </ns1:pixiGetInkassoBookings>
  </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 = [
    'FromDate' => '2024-01-01T00:00:00',
    'ToDate' => '2024-01-31T23:59:59',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetInkassoBookings

Prozedur zuletzt geändert am 2026-10-05

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