Uvítanie > Webové služby > Dodací list

Získanie dodacieho listu

URL webovej služby : http://sws.spartoo.sk/mp/xml_export_bl.php

Táto webová služba slúži na získanie dodacieho listu, ktorý treba vložiť do balíkov s objednávkami vystavenými na stránke Spartoo.

Zoznam parametrov

Parametre tejto webovej služby musia povinne prejsť procesom POST

Parameter Popis
partner Musí obsahovať váš unikátny identifikátor:
xml Reťazec parametrov XML obsahujúci zoznam elementov informácií umožňujúci vytvorenie dodacieho listu


Formát parametra xml


Textové polia musia byť chránené značkami CDATA , ak obsahujú špeciálne znaky, ktoré by spôsobili neplatnosť XML.

Formát argumentu XML

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

Popis vstupných políčok XML

Tag Popis Povinné
order_id Identifikátor objednávky Áno
reference_partenaire Identifikátor partnerského produktu
Identifikátor produktu môže obsahovať iba alfanumerické znaky alebo znaky - (pomlčka) _ (podtržník) a . (bodka). 		Áno
product_quantity Počet kusov produktu v balíku Áno


Príklad parametru xml

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

Formát vráteného XML

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

Zoznám chybových kódov webovej služby


Kód Popis
1 Bezchybné parametre
-1 Parameter partenaire nebol správne zaregistrovaný alebo je prázdny
-2 Parametre partnera neexistujú
-5 Cýba parameter rID/oID alebo parameter stavu
-6 Objednávka alebo vrátenie neboli nájdené, overte parameter oID / rID alebo partnerský parameter.
-11 Parameter xml nebol správne zaregistrovaný alebo je prázdny
-12 Parameter reference_partenaire nebol správne zaregistrovaný alebo je prázdny
-15 Chyba syntaxu XML, overte súbor XML
-428 Váš účet bol deaktivovaný. Odteraz nemáte možnosť zadávať požiadavky webservices
-429 Za túto hodinu ste dosiahli príliš veľký počet požiadaviek webservice

Popis políčok odpovede XML

Tag Popis
id_objednávky Identifikátor objednávky
pdf Dodací list v zakódovanom formáte PDF
chyby Chybový kód


Príklady vrátenia XML

Príklad odpovede web servis KO
<root>
	<errors>int</errors>
</root>
Príklad odpovede web servis OK
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>