pixiMergeOrders

Führt einen Quell-Auftrag mit einem Ziel-Auftrag zusammen, indem alle Auftragspositionen und Bundle-Positionen verschoben und Steuersätze sowie Versandkosten neu berechnet werden.

Überträgt den Inhalt des Auftrags SourceOrderNr in den Auftrag TargetOrderNr.

1. Die Auftragsköpfe beider Aufträge werden gelesen (Auftragsart, Währung, Versandkosten).
2. Bei unterschiedlicher Auftragsart oder Währung wird ein Fehler ausgelöst und abgebrochen. Das geschieht auch, wenn keiner der beiden Aufträge existiert.
3. pipiCanMergeOrders wird ausgeführt. Diese Prozedur prüft die folgenden Bedingungen und liefert eine eigene Ergebniszeile (CanMerge, Reason):
   • beide Aufträge existieren
   • beide gehören zum selben Kunden
   • alle Positionen haben Status ANG
   • beide haben dieselbe Zahlungsart, die keine Kreditkarte K sein darf
   • keine Position liegt auf einer aktiven Pickliste
   • beide haben dieselbe Währung und Auftragsart
4. Ist die Zusammenführung erlaubt, laufen die folgenden Schritte in einer Transaktion:
   • Die Versandkosten im Kopf des Ziel-Auftrags werden auf die höheren Versandkosten der beiden Aufträge gesetzt.
   • Alle vorhandenen Positionen und Bundle-Positionen des Ziel-Auftrags erhalten diese Versandkosten sowie UpdateEmp und UpdateDate.
   • Die Positionen des Quell-Auftrags werden in den Ziel-Auftrag verschoben. Sie übernehmen Rechnungs- und Lieferadresse, Order_Id, OrderNrExternal und VoucherID der Positionen des Ziel-Auftrags.
   • Ihr TaxRate wird über fPixi_GetVATRate neu berechnet. Grundlage sind die Auftragsart des Quell-Auftrags sowie Land und Steuerpflicht der Ziel-Lieferadresse.
   • Bei Einstellung CalculateBundleVAT = 0 erhalten Bundle-Komponenten den Steuersatz ihrer Bundle-Position.
   • Die Bundle-Positionen des Quell-Auftrags werden ebenso verschoben. Bei CalculateBundleVAT = 1 ist ihr Steuersatz der nach Nettobetrag gewichtete Durchschnitt der Komponenten, sonst der Wert aus der Steuerfunktion.
   • Bankzuordnungen (BankMatch) des Quell-Auftrags werden dem Ziel-Auftrag zugeordnet.
   • Der Discount im Kopf des Quell-Auftrags wird auf 0 gesetzt.
5. Zurückgegeben wird ResultMessage:
   • 200 OK bei Erfolg
   • der Grundcode aus pipiCanMergeOrders (401–407), wenn die Zusammenführung nicht erlaubt ist
   • 500 Unexpected error, wenn die Transaktion fehlschlägt

UpdateEmp wird auf Employee mit dem Zusatz (API) gesetzt, ohne Mitarbeiterangabe auf API.

Parameter

Antwort

Result-Set 1 · Immer, wenn die Prüfungen von Auftragsart und Währung bestanden sind (geliefert von pipiCanMergeOrders).

Ergebnis der Vorprüfung der Zusammenführung.

Result-Set 2 · Immer, wenn die Prüfungen von Auftragsart und Währung bestanden sind.

Endergebnis der Zusammenführung.

<SqlRowSet1>
  <row>
    <CanMerge>1</CanMerge>
    <Reason>200 OK</Reason>
  </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:pixiMergeOrders>
      <TargetOrderNr>100245</TargetOrderNr>
      <SourceOrderNr>100251</SourceOrderNr>
      <!-- <Employee>jdoe</Employee> -->
      <!-- <ResultMessage>?</ResultMessage> -->
    </ns1:pixiMergeOrders>
  </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:pixiMergeOrders>
      <TargetOrderNr>100245</TargetOrderNr>
      <SourceOrderNr>100251</SourceOrderNr>
      <!-- <Employee>jdoe</Employee> -->
      <!-- <ResultMessage>?</ResultMessage> -->
    </ns1:pixiMergeOrders>
  </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 = [
    'TargetOrderNr' => '100245',
    'SourceOrderNr' => '100251',
    // 'Employee' => 'jdoe',
    // 'ResultMessage' => '?',
];

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

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

Verwandte Calls

Verwendete Tabellen

SQL-Objekt:

dbo.pipiMergeOrders

Prozedur zuletzt geändert am 2026-10-05

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