Recepție > Webservices > Bon de livrare

Recuperarea bonului de livrare

Adresa URL a serviciului Webservice : http://sws.spartoo.ro/mp/xml_export_bl.php

Acest serviciu web este utilizat pentru recuperarea bonului de livrare care trebuie să fie în coletele comenzilor Sparto..

Lista de parametri

Parametrii acestui serviciu web trebuie în mod obligatoriu să fie în POST

Parametru Descriere
partener Trebuie să conțină numele de utilizator unic :
xml Șir de caractere XML care conține lista de elemente de informații utilizate pentru producerea bonului de livrare


Format parametru xml


Câmpurile de text trebuie să fie protejate de balize CDATA dacă conține caractere speciale care ar putea face XML invalid.

Formatul argumentului XML

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

Descrierea câmpurilor XML de intrare

Balise Descriere Obligatoriu
order_id ID-ul comenzii Da
reference_partenaire Identificator produs vânzător
Identificatorul produsului poate conține doar caractere alfanumerice, precum și caracterele - (liniuță) _ (liniuță jos) și. (punct). 		Da
product_quantity Cantitatea produsului în colet Da


Exemplu de parametru xml

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

Formatul XML returnat

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

Lista codurilor de eroare ale serviciului web


Cod Descriere
1 Nici o eroare de parametru
-1 Parametrul partenaire nu este trecut în parametru sau este gol
-2 Parametrul partenerului nu există
-5 Lipsește parametrul rID / oID sau parametrul statut
-6 Comanda sau returnarea nu a fost găsită, verificați parametrul oID / rID sau parametrul partener.
-11 Parametrul xml nu este trecut în parametru sau este gol
-12 Parametrul reference_partenaire nu este trecut în parametru sau este gol
-15 Eroare de sintaxă XML, verificați fișierul dvs XML
-428 Contul dvs a fost dezactivat. Nu mai puteți efectua solicitări către serviciile web
-429 Ați efectuat prea multe solicitări către serviciile web peste limita la oră

Descrierea câmpurilor răspunsului XML

Balise Descriere
order_id ID-ul comenzii
pdf Bon de livrare în format PDF codificat
errors Cod de eroare


Exemple de retur XML

Exemplu de răspuns la un apel de serviciu web KO
<root>
	<errors>int</errors>
</root>
Exemplu de răspuns la un apel de serviciu web OK
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>