Servizio accoglienza > Webservices > Bolla di consegna

Recupero della bolla di consegna

URL del Webservice : http://sws.spartoo.it/mp/xml_export_bl.php

Questo webservice serve a recuperare la bolla di consegna che deve essere nel pacco del tuo ordine Spartoo.

Lista dei parametri

I parametri di questo webservice devono obbligatoriamente passare in POST

Paramètre Descrizione
partner Deve contenere il tuo identificante unico:
xml Serie di caratteri XML contenente la lista degli elementi delle informazioni che permettono di realizzare la bolla di consegna


Format du paramètre xml


I campi testo devono essere protetti da dei balises CDATA se contengono dei caratteri speciali che rendono il XML invalido.

Formato dell'argomentazione XML

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

Descrzione dei campi del XML d'entrata

Balise Descrizione Obbligatorio
order_id Identificativo dell'ordine Si
reference_partenaire Identificativo del prodotto del partner
L'identificativo del prodotto deve contenere solo caratteri alfanumerici e i caratteri seguenti: - (trattino) _ (underscore) e . (punto). 		Si
product_quantity Quantità del prodotto nel pacco Si


Esempio di parametro xml

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

Formato del XML reso

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

Lista dei codici d'errore del webservice


Codice Descrizione
1 Nessun errore di parametro
-1 Il prametro partenaire non è parametrato o è vuoto
-2 Il parametro partenaire non esiste
-5 Manca il parametro rID/oID o il parametro statut
-6 L'ordine o il reso non sono stati trovati, verificare il parametro oID / rID o il parametro partnair.
-11 Il prametro xml non è parametrato o è vuoto
-12 Il prametro reference_partenaire non è parametrato o è vuoto
-15 Errore di sintassi XML, verificare il file XML
-428 Il vostro conto non é più attivo, non potete quindi più fare chiamate Webservice
-429 Avete effettuato troppe chiamate a questo webservice nell' ultima ora

Descrizione dei campi della risposta XML

Tag Descrizione
order_id Identificativo dell'ordine
pdf Bolla di consegna in formato PDF con codice
errors Codice d'errore


Esempio di reso XML

Esempio di risposta a una chiamata web service KO
<root>
	<errors>int</errors>
</root>
Esempio di una risposta al web service OK
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>