pixiCreateReplacement

Legt einen Ersatzauftrag mit negativen Mengen für ausgewählte Auftragspositionen an, basierend auf Kunde und Adressen eines bestehenden Auftrags.

Legt einen neuen Ersatzauftrag an und liefert den Schlüssel des neuen Auftragskopfs. Die Verarbeitung übernimmt die interne Prozedur Pixi_CreateReplacementOrder.

1. Liest eine Auftragsposition des Auftrags OrderNr (TOP 1 ohne Sortierung). Daraus werden Kunde, Rechnungsadresse, Lieferadresse, LocationID und LastOrdLocationID übernommen. Als Erstelldatum dient das aktuelle Datum.
2. Kopiert die Rechnungsadresse dieser Position als neuen Datensatz in Addresses. Username wird als Ersteller und Bearbeiter gespeichert. Alle übrigen Felder werden unverändert übernommen.
3. Liest Lieferland, Umsatzsteuerpflicht (AddrNoChargeVAT) und Shop des Kunden (CustomerOf) aus der Lieferadresse.
4. Zerlegt Orderlines. Einträge sind durch Kommas getrennt. Jeder Eintrag hat die Form OrderlineKey;Menge. Die Menge ist optional; ohne Angabe wird die volle Menge der Originalposition verwendet.
5. Liest aus dem Auftragskopf einer der angegebenen Positionen folgende Werte: Auftragstyp (Standard B2C), Versandkosten, Steuersätze, MwSt.-Einstellungen der Versandkosten, Währung und Address_Remarks. Zusätzlich wird die Rechnung dieser Position in Invlines ermittelt.
6. Ermittelt einen Wechselkurs für Währung und aktuelles Datum und legt einen neuen Auftragskopf an (Pixi_OrderHeader_Insert). Der Auftrag erhält den Standard-CCP-Merchant aus der Einstellung DefaultCCPMerchant und einen Rabatt von 0. Die externe Auftragsnummer ist P + neue Auftragsnummer.
7. Fügt je angegebener Originalposition eine Auftragsposition ein:
   • Menge negiert (-Menge bzw. -Qty), Status MIN;
   • Preise, Artikeldaten, Seriennummer, Charge und MHD übernommen;
   • LocationID aus dem Auftrag OrderNr;
   • Steuersatz neu berechnet aus Auftragstyp, Steuerpflicht, Lieferland und Steuerklasse des Artikels;
   • Positionsbeträge negiert und gerundet: brutto auf 2 Nachkommastellen bei B2C (sonst 4), netto auf 2 bei B2B (sonst 4);
   • Betragsdifferenzen negiert.
8. Verknüpft den neuen Auftrag mit der Originalrechnung über einen Eintrag in pixi.InvoiceAttribute (TypeId 3, Wert = neue Auftragsnummer).
9. Liefert den neuen OrderHeaderKey und schreibt die Transaktion fest.

Parameter

Antwort

Result-Set 1 · Wenn bei der Verarbeitung kein Fehler auftritt. Bei einem Fehler wird nichts geliefert.

Schlüssel des neu angelegten Auftragskopfs.

<SqlRowSet1>
  <row>
    <OrderHeaderKey>98765</OrderHeaderKey>
  </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:pixiCreateReplacement>
      <OrderNr>104512</OrderNr>
      <Orderlines>556781;1,556782;2</Orderlines>
      <!-- <Username>API</Username> -->
    </ns1:pixiCreateReplacement>
  </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:pixiCreateReplacement>
      <OrderNr>104512</OrderNr>
      <Orderlines>556781;1,556782;2</Orderlines>
      <!-- <Username>API</Username> -->
    </ns1:pixiCreateReplacement>
  </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 = [
    'OrderNr' => '104512',
    'Orderlines' => '556781;1,556782;2',
    // 'Username' => 'API',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateReplacement

Prozedur zuletzt geändert am 2026-10-05

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