pixiCreateSupplierOrderFromProfile

Legt Lieferantenbestellungen anhand eines gespeicherten Bestellvorschlagsprofils an und liefert die Nummern der erzeugten Bestellungen.

Führt den Bestellvorschlag für ein gespeichertes Profil aus und bestätigt das Ergebnis in einem Schritt. Dadurch werden Lieferantenbestellungen angelegt oder erweitert.

Ablauf:

1. Prüft, ob ProfileId übergeben wurde und ob ein Pixi-Benutzer mit dem Namen API existiert. Dieser Benutzer wird als ausführender Benutzer weitergegeben.
2. Liest das Profil-XML aus pixi.SupplierOrderSuggestionProfile.Data zur angegebenen Id. Fehlen Profil oder Daten, wird eine Fehlerzeile geliefert.
3. Überträgt die Profileinstellungen unter /SuggestionProfileDbo auf die Parameter des Bestellvorschlags:
   • OrderMethod: OrderOnDemand = 1, OrderForTargetStock = 2, OrderOnStockTurnover = 3.
   • SupplierPriority: LowestPrice = 1 (Standard), FastestDelivery = 2, LatestDelivery = 3.
   • CalculationSuggestionLocation: CalculateSuggestionForEachLocationSeparately = 0 (Standard), CalculateSuggestionsBasedOnSummarizedParametersForSelectedLocations = 1.
   • ConsiderationOfSuppliers: FromSelectedSuppliers = 0 (Standard), IfSelectedSupplierIsOptimal = 1.
   • SupplierOrdersCreation: CreateOnlyNewSupplierOrders = 0 (Standard), AddSuggestedItemsToOpenSupplierOrders = 1.
   • SelectedLocations/int, SelectedSuppliers/int sowie die Tag-IDs in TagKeysOr, TagKeysAnd und TagKeysNot werden zu kommagetrennten Listen zusammengefasst.
   • ConsiderPackagingUnit, ConsiderMinimumOrderAmount, DeliveryLocationId, OrderLocationId, ExcludeSuppliersWithZeroPrice und IncludeOversoldItems werden direkt übernommen.
   • Nur bei OrderOnStockTurnover: TurnoverInDays, ConsiderReorderLevel und der Verkaufszeitraum. Bei StockTurnoverSalesOption = SalesPerDayForLastXDays umfasst der Zeitraum die letzten SalesForLastXDays Tage bis jetzt, sonst gelten SalesFrom/SalesTo.
4. Erzeugt aus der aktuellen Uhrzeit eine Laufnummer (yyMMddHHmmss) und ruft pixi.SupplierOrderSuggestionPrepareData und danach pixi.SupplierOrderSuggestionConfirmData auf. Die Validierung wird beim Bestätigen übersprungen.
5. Liefert je Lieferantenbestellung dieses Laufs eine Zeile mit der internen Bestellnummer und der Lieferantennummer. Wurde keine Bestellung verknüpft, wird eine INFO-Zeile geliefert.

Parameter

Antwort

Result-Set 1 · Wenn ProfileId fehlt, der Benutzer API nicht existiert oder das Profil nicht gefunden wird

Statuszeile mit dem Validierungsfehler.

Result-Set 2 · Bei Erfolg, wenn mindestens eine Lieferantenbestellung mit dem Vorschlagslauf verknüpft ist

Eine Zeile je Lieferantenbestellung, die durch diesen Lauf angelegt oder erweitert wurde.

Result-Set 3 · Wenn keine Lieferantenbestellung angelegt wurde oder eine Ausnahme auftritt

Statuszeile mit INFO (nichts angelegt) oder ERROR (Ausnahme, Änderungen zurückgerollt).

<SqlRowSet1>
  <row>
    <SupplOrderNr>BE-2024-00125</SupplOrderNr>
    <SupplNr>L1001</SupplNr>
  </row>
  <row>
    <SupplOrderNr>BE-2024-00126</SupplOrderNr>
    <SupplNr>L1017</SupplNr>
  </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:pixiCreateSupplierOrderFromProfile>
      <!-- <ProfileId>3</ProfileId> -->
    </ns1:pixiCreateSupplierOrderFromProfile>
  </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:pixiCreateSupplierOrderFromProfile>
      <!-- <ProfileId>3</ProfileId> -->
    </ns1:pixiCreateSupplierOrderFromProfile>
  </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 = [
    // 'ProfileId' => '3',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreateSupplierOrderFromProfile

Prozedur zuletzt geändert am 2026-10-05

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