pixiAutoMatchPayments

Ordnet die Bankzeilen eines Bank-Headers automatisch offenen Aufträgen oder Rechnungen zu, bestätigt die Zuordnung und gibt den Auftrag bei vollständiger Zahlung frei.

Führt den automatischen Zahlungsabgleich für einen Bank-Header (BankHeaderKey) aus und bestätigt bei einem Treffer die Zuordnung; anschließend wird versucht, den zugeordneten Auftrag freizugeben.

1. Ist BankHeaderKey NULL, wird eine Zeile mit NULL-Werten und der Meldung Parameter BankHeaderKey is mandatory! geliefert; sonst passiert nichts.
2. Der interne automatische Abgleich (Pixi_BankAutomaticMatching) läuft für alle Bankzeilen dieses Headers, die noch keinen Eintrag in BankMatch haben. Gesucht werden 100%-Treffer:
   • Aufträge, deren Zahlungsart einen Abgleich erlaubt (Payments.MatchToOrders = 1) und die mindestens eine Auftragsposition im Status HAL haben. Der Bankbetrag muss dem offenen Betrag (OrderTotal - PaidByCustomer, auf 2 Stellen gerundet) in derselben Währung entsprechen, und der Buchungstext (BankText01–BankText03) muss die externe Auftragsnummer (optional ohne Präfix), die ccpPayID, eine eindeutige externe Kundennummer oder eine eindeutige E-Mail-Adresse enthalten.
   • Rechnungen, die vollständig unbezahlt sind und deren Zahlungsart MatchToInvoices = 1 hat. Der Bankbetrag muss der Rechnungssumme entsprechen; der Buchungstext muss Rechnungsnummer, externe Auftragsnummer, Kundennummer oder E-Mail enthalten.
   • Mehrdeutige Kandidaten werden verworfen. Gefundene Treffer werden als Vorabzuordnung (IsPrematch = 1) in BankMatch geschrieben.
3. Wurde kein Treffer gefunden, lautet message 0 matched orders/invoices found. gefolgt von einem Zeilenumbruch und dem Statistiktext des Abgleichs (Anzahl Bankzeilen, offene und zugeordnete Aufträge/Rechnungen).
4. Andernfalls wird der BankMatch-Eintrag der Bankzeile dieses Headers gelesen, und alle Vorabzuordnungen dieser Bankzeile werden bestätigt (IsPrematch auf 0).
5. Für den zugeordneten Auftrag werden OrderNr und die Differenz ABS(OrderTotal - PaidByCustomer) aus OrderHeader gelesen:
   • Differenz 0: Alle Auftragspositionen des Auftrags im Status HAL werden auf ANG gesetzt (Bearbeiter IPN_API (payments)); Meldung Delta: 0; releasing order: {OrderNr}.
   • Sonst: Meldung Delta: {Delta}; cannot release order:{OrderNr}; der Auftrag bleibt angehalten.
6. Sofern nicht SuppressOutput = 1, wird eine Zeile mit OrderHeaderKey, OrderNr, AmountMatched, BankLineKey und message geliefert.

Parameter

Antwort

Result-Set 1 · Immer, wenn BankHeaderKey NULL ist (Fehlerzeile); sonst nur bei SuppressOutput = 0.

Eine Zeile mit dem zugeordneten Auftrag, dem zugeordneten Betrag, der Bankzeile und einer Statusmeldung.

<SqlRowSet1>
  <row>
    <OrderHeaderKey>215873</OrderHeaderKey>
    <OrderNr>100482</OrderNr>
    <AmountMatched>59.9000</AmountMatched>
    <BankLineKey>88231</BankLineKey>
    <message>Delta: 0; releasing order: 100482</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:pixiAutoMatchPayments>
      <!-- <BankHeaderKey>40098</BankHeaderKey> -->
      <!-- <SuppressOutput>0</SuppressOutput> -->
    </ns1:pixiAutoMatchPayments>
  </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:pixiAutoMatchPayments>
      <!-- <BankHeaderKey>40098</BankHeaderKey> -->
      <!-- <SuppressOutput>0</SuppressOutput> -->
    </ns1:pixiAutoMatchPayments>
  </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 = [
    // 'BankHeaderKey' => '40098',
    // 'SuppressOutput' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiAutoMatchPayments

Prozedur zuletzt geändert am 2026-10-05

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