Home > Webservices > Lieferschein

Lieferschein erhalten

URL des Webservice : http://sws.spartoo.de/mp/xml_export_bl.php

Dieser Webservice dient dazu, den Lieferschein zu erhalten, der in den Paketen Ihrer Spartoo-Bestellungen enthalten sein muss.

Liste der Parameter

Die Parameter dieses Webservice müssen unbedingt per POST übertragen werden

Parameter Beschreibung
partenaire Muss Ihre Benutzeridentifizierung enthalten:
xml XML-Zeichenfolge die die Liste der Informationen enthält, die für den Lieferschein notwendig sind


Format des XML-Parameters


Die Textfelder müssen durch CDATA Tags geschützt sein, wenn sie Sonderzeichen enthalten, durch die das XML ungültig wird.
Die Textfelder müssen durch CDATA Tags geschützt sein wenn Sie Sonderzeichen enthalten, durch die die XML-Datei ungültig wäre.

Format XML-Argument

<root>
	<order_id>string</order_id>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<product_quantity>int</product_quantity>
		</product>
	</products>
</root>

Beschreibung der Felder der Eingangs-XML

Tag Beschreibung obligatorisch
order_id Bestellungs-ID Ja
reference_partenaire Partnerprodukt-ID
Die Produkt-ID kann ausschließlich alphanumerische Zeichen und folgende Zeichen enthalten: - (Bindestrich) _ (Unterstrich) und . (Punkt). 		Ja
product_quantity Anzahl des Produktes im Paket Ja


Beispiel xml-Paramter

<root>
	<order_id>3FF75E96C3434E92</order_id>
	<products>
		<product>
			<reference_partenaire>39870-42</reference_partenaire>
			<product_quantity>1</product_quantity>
		</product>
	</products>
</root>

Format der XML Retoure

<root>
	<bl>
		<order_id>string</order_id>
		<pdf>string</pdf>
	</bl>
	<errors>int</errors>
</root>

Liste der Fehlercodes des Webservice


Code Beschreibung
1 Kein Parameterfehler
-1 Der Parameter partenaire fehlt oder ist leer
-2 Der Partnerparameter existiert nicht
-5 Der Parameter rID/oID oder der Statusparameter fehlen
-6 Die Bestellung oder die Retoure wurden nicht gefunden, überprüfen Sie den Parameter oID/rID oder den Partnerparameter.
-11 Der Parameter xml fehlt oder ist leer
-12 Der Parameter reference_partenaire fehlt oder ist leer
-15 XML-Sytnaxfehler, überprüfen Sie Ihre XML-Datei
-428 Ihr Kundenkonto wurde nun desaktiviert. Sie können nun keine weiteren Anfragen an den Webservice stellen.
-429 Sie haben innerhalb der zur Verfügung stehenden Zeit zu viele Anfragen an den Webservice gestellt.

Beschreibung der Felder der XML-Antwort

Etikett Beschreibung
order_id Bestellnummer
pdf Retourenschein im PDF Format
errors Fehlercode


Beispiel XML Retoure

Beispielantwort auf einen KO-Aufruf eines Webdienstes
<root>
	<errors>int</errors>
</root>
Beispielantwort auf einen KO-Aufruf eines Webdienstes
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>