Generiert eine neue Rechnung auf Basis eines Auftrags oder Auftrags-Positionen.

Anmerkungen zum Parameter „OrderID“ :

1.) Falls angegeben, wird eine Rechnung auf Basis aller Positionen dieses Auftrags erstellt. Es werden dann die Parameter „CurrencyID“, „AddBillContentInformation“, „OtherBillContent“ und AddOtherContentInformation„ ignoriert.
2.) Wird „NULL“ übergeben, müssen die in Rechnung zu stellenden Positionen (zusammen mit der jeweiligen Mengen-Angabe, Netto-Summe etc.) vorher mit Hilfe der Prozedur „if_om_CreateNewBill_Ad“ angegeben werden.

Anmerkung zum Parameter „RecipientPersonID“ :

Auch wenn eine „OrderID“ angegeben wurde, muß dieser Parameter belegt werden - i.d.R. natürlich mit der ID des Auftraggebers.

Hinweis :
Kommt es beim Anlegen von „BillInformation“ oder „BillContentInformation“ oder „OtherBillContentInformation“ (s. „Add…Information“-Parameter) zu Fehlern, bricht die Prozedur mit einem Fehler ab, d.h. es wird KEINE Rechnung angelegt.

Beispiel für zusätzliche Auftragspositionen :

Es sollen zwei zusätzliche Positionen „Versandkosten“ (2 EUR) und „Mindermengenzuschlag“ (5 EUR) auf die Rechnung, wobei zur Position „Mindermengenzuschlag“ noch eine Bemerkung hinterlegt werden soll, die die Information enthält, bis zu welcher Summe dieser Zuschlag zu entrichten ist.

Angenommen die zugehörigen „PredefinedBillContentID“s wären „1“ und „5“, dann müßte vor dem Aufruf dieser Prozedur „if_om_CreateNewBill_Ad“ so aufgerufen werden (bei einem angenommenen Steuersatz von „19%“):
exec if_om_CreateNewBill_Ad '1¶5', '1¶1', '1.68¶4.20', '2.00¶5.00', Delete = 0, OtherContent = 1

Da die „PredefinedBillContentID“ für den „Mindermengenzuschlag“ an ZWEITER Stelle kommt, und kein weiterer Aufruf von „if_om_CreateNewBill_Ad“ mit „OtherContent = 1“ VORHER erfolgte, ist die „Position“-Nummer für die zusätzliche Information also die „2“. Angenommen die „InformationTypeID“ für die Bemerkung ist die „17“, dann müßte der Aufruf von mi_InsertTempdb_AdditionalInfo so aussehen :
exec mi_InsertTempdb_AdditionalInfo '2', '2', '17', 'Mindermengen-Zuschlag bis 20 EUR', Delete = 0

Anmerkung : Wenn dies die einzige zusätzliche Information überhaupt ist (wenn also für „AddBillInformation“ und „AddBillContentInformation“ der Wert „0“ übergeben wird), muß „Delete“ natürlich mit „1“ belegt werden.

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

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

• om_CreateNewBill_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CreateNewBill_Ad?OrderID=<value>&RecipientPersonID=<value>&DrawerPersonID=<value>&CurrencyID=<value>'

Mit xmllint ³⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CreateNewBill_Ad?OrderID=<value>&RecipientPersonID=<value>&DrawerPersonID=<value>&CurrencyID=<value>' | xmllint --format -

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_CreateNewBill_Ad',
		array(
			'OrderID' => <value>,
			'RecipientPersonID' => <value>,
			'DrawerPersonID' => <value>,
			'CurrencyID' => <value>,
			// 'AddBillInformation' => 0,
			// 'AddBillContentInformation' => 0,
			// 'OtherBillContent' => 0,
			// 'AddOtherContentInformation' => 0,
			// 'GetIncorrectInformation' => 0,
			// 'Country' => 'german'
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
 
$OutputParams = $xml_result->getOutputParametersAsArray();

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_CreateNewBill_Ad">
			<Parameters>
				<Parameter Name="OrderID"><!-- integer value --></Parameter>
				<Parameter Name="RecipientPersonID"><!-- integer value --></Parameter>
				<Parameter Name="DrawerPersonID"><!-- integer value --></Parameter>
				<Parameter Name="CurrencyID"><!-- tinyint value --></Parameter>
				<!-- <Parameter Name="AddBillInformation">0</Parameter> -->
				<!-- <Parameter Name="AddBillContentInformation">0</Parameter> -->
				<!-- <Parameter Name="OtherBillContent">0</Parameter> -->
				<!-- <Parameter Name="AddOtherContentInformation">0</Parameter> -->
				<!-- <Parameter Name="GetIncorrectInformation">0</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>