pixiPayGetOrdersToAuthorize

Liefert Aufträge mit Positionen im Status HAL, die für eine Zahlungsart zur Autorisierung anstehen, inklusive Beträgen, Karten- und Adressdaten.

Ermittelt Aufträge, die ein Zahlungsanbieter-Connector (z. B. für Kreditkarten) autorisieren soll, und liefert eine Zeile pro Auftrag.

Ablauf der Auswahl:

1. Alle Aufträge mit mindestens einer Auftragsposition im Status HAL werden ermittelt.
2. Berücksichtigt werden nur Aufträge, bei denen:
   • der Auftragskopf zuletzt vor mehr als 10 Minuten geändert wurde (updatedate), damit der Auftrag vollständig ist,
   • die Zahlungsart der Auftragsadresse (Addresses.aPayment) gleich PaymentCode ist,
   • mindestens eine Bedingung erfüllt ist: ccpNumOfTries <= 3, CCPReauthorizeYN = Y (Neuautorisierung angefordert), ShowAll = 1 oder ccpSetFailTries zwischen 1 und 3 und ccpSetFailLastTime älter als 10 Minuten,
   • der Kunde nicht gesperrt ist (Customers.SLocked ungleich Y).
3. Die ersten RowCount Aufträge werden übernommen, sortiert nach ccpNumOfTries aufsteigend, dann OrderHeaderKey aufsteigend (Aufträge mit weniger Versuchen zuerst).
4. Für diese Aufträge wird OrderLineAmount der Positionen in den Status ANG, HAL und AUS getrennt summiert (fehlende Status zählen als 0).

Das Ergebnis enthält Auftragssummen, Positionssummen je Status, Währung, Shop-ID, Karten- und Adressdaten der Auftragsadresse sowie die Autorisierungsfelder des Auftragskopfs. Die Ausgabe ist nach OrderHeaderKey aufsteigend sortiert.

Parameter

Antwort

Result-Set 1 · Immer (ggf. leer)

Eine Zeile pro zu autorisierendem Auftrag, sortiert nach OrderHeaderKey aufsteigend.

<SqlRowSet1>
  <row>
    <OrderNr>104512</OrderNr>
    <OrderNrExternal>SHOP-2024-0815</OrderNrExternal>
    <OrderTotal>129.9000</OrderTotal>
    <OrderLinesTotal>125.0000</OrderLinesTotal>
    <OrderLinesDiscount>0.0000</OrderLinesDiscount>
    <ShipCost>4.9000</ShipCost>
    <OrderLinesTotalANG>0.0000</OrderLinesTotalANG>
    <OrderLinesTotalHAL>125.0000</OrderLinesTotalHAL>
    <OrderLinesTotalAUS>0.0000</OrderLinesTotalAUS>
    <OrderLinesTotal_OrderCurr>125.0000</OrderLinesTotal_OrderCurr>
    <OrderLinesTotalANG_OrderCurr>0.0000</OrderLinesTotalANG_OrderCurr>
    <OrderLinesTotalHAL_OrderCurr>125.0000</OrderLinesTotalHAL_OrderCurr>
    <OrderLinesTotalAUS_OrderCurr>0.0000</OrderLinesTotalAUS_OrderCurr>
    <ShipCost_OrderCurr>4.9000</ShipCost_OrderCurr>
    <OrderCurrency>EUR</OrderCurrency>
    <ShopID>SHOP1</ShopID>
    <CardOwner>Max Mustermann</CardOwner>
    <CardNumber>XXXXXXXXXXXX1111</CardNumber>
    <CardExpiration>12/27</CardExpiration>
    <CardCVC>***</CardCVC>
    <Anrede>Herr</Anrede>
    <CareOf/>
    <FirstName>Max</FirstName>
    <LastName>Mustermann</LastName>
    <Address>Musterstr. 1</Address>
    <City>Berlin</City>
    <ZIP>10115</ZIP>
    <Country>DE</Country>
    <Phone>030123456</Phone>
    <CCPPaymentInfoOK>max@example.com</CCPPaymentInfoOK>
    <CCPLastAuthCode/>
    <CCPNumOfTries>0</CCPNumOfTries>
    <CCPReauthorizeYN>N</CCPReauthorizeYN>
    <ccpPayID/>
    <ccpSetFailTries>0</ccpSetFailTries>
  </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:pixiPayGetOrdersToAuthorize>
      <PaymentCode>K</PaymentCode>
      <!-- <ShowAll>0</ShowAll> -->
      <!-- <RowCount>30</RowCount> -->
    </ns1:pixiPayGetOrdersToAuthorize>
  </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:pixiPayGetOrdersToAuthorize>
      <PaymentCode>K</PaymentCode>
      <!-- <ShowAll>0</ShowAll> -->
      <!-- <RowCount>30</RowCount> -->
    </ns1:pixiPayGetOrdersToAuthorize>
  </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 = [
    'PaymentCode' => 'K',
    // 'ShowAll' => '0',
    // 'RowCount' => '30',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiPayGetOrdersToAuthorize

Prozedur zuletzt geändert am 2026-10-05

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