om_CopyFromPOQueueToOrder_Ad [dstore]

Inhaltsverzeichnis

om_CopyFromPOQueueToOrder_Ad

om_CopyFromPOQueueToOrder_Ad

Macht aus einer „Einkaufs-Auftrags-Queue“ einen Einkaufs-Auftrag.

Allgemeine Hinweise :

1. Eine „Einkaufs-Auftrags-Queue“ ist eindeutig durch…

einen Lieferanten (→ „SupplierID“),
einen Auftrags-Typ (→ „OrderTypeID“) und
einen Zeitpunkt, an dem der Auftrag spätestens beim Lieferanten platziert werden muß (→ „OrderDeadline“)

… bestimmt. Um solche „Queues“ einzusehen, ist die Prozedur om_GetPurchaseOrderQueues_Ad zu verwenden.

2. Wurde die „Deadline“ (→ „OrderDeadline“) überschritten, gibt es natürlich einen Fehler.

HTTP-Method	POST
HTTP-Auth	Optional
Alias	om_CopyFromPurchaseOrderQueueToOrder_Ad
Tags	[om, Copy, From, Purchase, Order, Queue, To, Order, Ad]
Engine-Kategorie	order management
Engine-Typ	Daten-Änderung
Letzte Aktualisierung	7.0.7 (2015-01-29)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	ab Version
SupplierID		ID eines Lieferanten, bei dem bestellt werden soll (also eine „PersonID“)	integer	5.1.9
OrderTypeID		ID eines Auftrag-Typs. Mögliche Werte : siehe om_GetPurchaseOrderTypes_Ad. Allerdings muß natürlich auch eine „Queue“ zum Lieferanten „SupplierID“ und diesem Auftrags-Typ existieren (s. om_GetPurchaseOrderQueues_Ad) !	tinyint	5.1.9
OrderDeadline		Zeitpunkt, an dem der Auftrag spätestens beim Lieferanten platziert werden muß. Es muß natürlich auch eine „Queue“ zum Lieferanten „SupplierID“, dem Auftrags-Typ „OrderTypeID“ und dieser „Deadline“ existieren (s. om_GetPurchaseOrderQueues_Ad) !	datetime	5.1.9
DeliveryPersonID		ID der Person, an die geliefert werden soll (eine Geschäftstelle z.B.). Hinweis : Dieser Wert muß sich von „SupplierID“ unterscheiden !	integer	5.1.9
ShippingTypeID		ID der Versandart. Mögliche Werte : siehe om_GetShippingTypes_Ad. Allerdings sollte im Regelfall der Wert der Rückgabespalte „ShippingTypeID“ des Aufrufs „exec om_GetSupplierConfiguration_Ad <SupplierID>“ verwendet werden !	tinyint	5.1.9
PaymentTypeID		ID der Zahlungsart. Mögliche Werte : siehe om_GetPaymentTypes_Ad. Allerdings sollte im Regelfall der Wert der Rückgabespalte „PaymentTypeID“ des Aufrufs „exec om_GetSupplierConfiguration_Ad <SupplierID>“ verwendet werden !	smallint	5.1.9
DeliveryDateAndTime	NULL	Hier kann (optional) das voraussichtliche Lieferdatum angegeben werden. Hinweis : Wird ein Wert in der Vergangenheit angegeben, gibt es natürlich einen Fehler („-500“) !	datetime	5.1.9

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁴⁾
-1323	Die Person besitzt kein Konto zum angegebenen Typ	nur indirekt
-1322	Transaktion kann nicht durchgeführt weden, da der Status des Kontos dies nicht erlaubt	nur indirekt
-1321	Transaktion kann nicht durchgeführt weden, da das Konto keine ausreichende Deckung aufweist	nur indirekt
-1305	Validierung fehlgeschlagen, der Code zur Zeit inaktiv ist	nur indirekt
-1304	Validierung fehlgeschlagen, da die maximale Menge an Einlösungen der Person für diesen Code erreicht	nur indirekt
-1303	Validierung fehlgeschlagen, da die maximale Menge an Einlösungen für diesen Code erreicht ist	nur indirekt
-1302	Validierung fehlgeschlagen, da der Code nicht mehr gültig ist	nur indirekt
-1301	Validierung fehlgeschlagen, da der Code nicht existiert	nur indirekt
-1204	Fehlender oder falscher Eintrag in CampaignSettings	nur indirekt
-661	Die Person besitzt keine oder eine ungültige Eigenschaft zu einem bestimmten Merkmal	direkt und indirekt
-655	Die VisitorID steht nicht mit der PersonID in Verbindung	nur indirekt
-621	Fehlender oder falscher Eintrag in PersonTypeSettings	nur indirekt
-602	Zur defaultUniqueID („VisitorID = -2“) können keinerlei Daten gespeichert oder verändert werden	nur indirekt
-599	Lizenz ist ungültig oder abgelaufen	nur indirekt
-572	Die Prozedur darf nur innerhalb einer Transaktion ausgeführt werden	nur indirekt
-569	Der Benutzer hat kein Ausführungsrecht für die Prozedur	nur indirekt
-567	Die Prozedur darf z. Zt. nicht ausgeführt werden	nur indirekt
-566	Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden	nur indirekt
-550	Fehlender oder falscher Eintrag in Settings	nur indirekt
-540	Falsches Format	nur indirekt
-535	Das Datum liegt nicht in der Vergangenheit	nur indirekt
-530	Der Wert ist nicht konvertierbar	nur indirekt
-510	Der Benutzer ist nicht registriert	nur indirekt
-507	Fehlerhafte Implementierung einer Prozedur - Daten in einem Ausgabeparameter sind ungültig	nur indirekt
-506	Fehlerhafte Implementierung einer Prozedur - Daten in der Output-Schnittstelle sind ungültig	nur indirekt
-504	Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen	direkt und indirekt
-503	Fehlerhafte Daten in einer Tabelle - genauere Fehlermeldung auf der Standardausgabe	nur indirekt
-502	Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)	nur indirekt
-501	Der Parameter „TableID“ und/oder der Parameter „TableKeyID“ ist ungültig	nur indirekt
-500	Falsche Parameter	direkt und indirekt
-398	Einige OrderSurchargeInformation sind ungültig	nur indirekt
-391	Einige OrderInformation sind ungültig	nur indirekt
-390	Einige OrderContentInformation sind ungültig	nur indirekt
-385	Die Brutto-Summe aus Warenwert plus Surcharges unterschreitet den vorgegebenen Mindestwert	nur indirekt
-348	Status-Änderung konnte aufgrund paralleler Änderungen nicht durchgeführt werden	nur indirekt
-347	Ungültige „OrderStateID“ (da für interne Zwecke reserviert)	nur indirekt
-340	Fehlende Berechtigung zum Ändern des Orderstatus	nur indirekt
-333	Ein benötigter Steuersatz ist nicht bekannt oder konnte nicht ermittelt werden	nur indirekt
-330	Es kann keine oder keine eindeutige PaymentForShippingID zu einer Order ermittelt werden	nur indirekt
-320	Der Bestand eines Produktes darf nicht unter 0 sinken	nur indirekt
-316	Warenkorb kann nur einmal bestellt werden, verm. Ursache : paralleler „…TrolleyToOrder…“-Aufruf	nur indirekt
-285	Der Benutzer hat keine Berechtigung, vergangene Eigenschaften zu diesem(n) Merkmal(en) zu ändern	nur indirekt
-284	Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu modifizieren	nur indirekt
-283	Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu ermitteln	nur indirekt
-245	Einige Artikel-Eigenschaften sind ungültig	nur indirekt
-242	Relative Änderung nicht möglich, da es eine Eigenschaft gibt, deren Gültigkeit in d. Zukunft beginnt	nur indirekt
-241	Änderung(en) der Eigenschaft(en) konnte(n) aufgrund paralleler Änderungen nicht durchgeführt werden	nur indirekt
-221	Es konnte kein rekursives Merkmal mit der Standardwährung als Einheit ermittelt werden	nur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

7.0.7	2015-01-29	Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
7.0.4	2014-03-19	Kleine Kosmetik-Korrektur : Bei einigen Code-Zeilen war am Ende ein CR-Zeichen, was wir entfernt haben
6.0.2	2011-06-08	Umstellung der Versand- und Zahlungskosten auf das verallgemeinterte „OrderSurcharges“-Konzept ⇒ bei der hier intern aufgerufenen Prozedur „_om_InsertNewOrder“ sind Parameter entfallen u. die Input-Schnittstelle hat sich geändert ⇒ entspr. Anpassungen
5.1.9	2007-01-26	Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

om_CopyFromPOQueueToOrder_Ad im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CopyFromPOQueueToOrder_Ad?SupplierID=<value>&OrderTypeID=<value>&OrderDeadline=<value>&DeliveryPersonID=<value>&ShippingTypeID=<value>&PaymentTypeID=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CopyFromPOQueueToOrder_Ad?SupplierID=<value>&OrderTypeID=<value>&OrderDeadline=<value>&DeliveryPersonID=<value>&ShippingTypeID=<value>&PaymentTypeID=<value>' | xmllint --format -

dStore_php

use dStore_php\WebService;
 
$service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80);
 
$request = new WebService\Requests\Engine\Procedure\Request(
			new WebService\Requests\AccessData('default'),
	'om_CopyFromPOQueueToOrder_Ad',
		array(
			'SupplierID' => <value>,
			'OrderTypeID' => <value>,
			'OrderDeadline' => <value>,
			'DeliveryPersonID' => <value>,
			'ShippingTypeID' => <value>,
			'PaymentTypeID' => <value>,
			// 'DeliveryDateAndTime' => NULL
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();

engine/execute

XML zur Ausführung mit der Methode engine/execute, z.B. per

curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'

<?xml version="1.0" encoding="UTF-8"?>
<ListOfBatches>
	<Batch No="0">
		<Procedure Name="om_CopyFromPOQueueToOrder_Ad">
			<Parameters>
				<Parameter Name="SupplierID"><!-- integer value --></Parameter>
				<Parameter Name="OrderTypeID"><!-- tinyint value --></Parameter>
				<Parameter Name="OrderDeadline"><!-- datetime value --></Parameter>
				<Parameter Name="DeliveryPersonID"><!-- integer value --></Parameter>
				<Parameter Name="ShippingTypeID"><!-- tinyint value --></Parameter>
				<Parameter Name="PaymentTypeID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="DeliveryDateAndTime">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾

Pflichtparameter sind unterstrichen

²⁾

siehe Parameter-Konventionen engine/<Prozedur-Name>

³⁾

siehe Datentypen im Bereich "engine"

⁴⁾

direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“

⁵⁾

I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Inhaltsverzeichnis