Início > Webservices > Guia de transporte

Recuperação da guia de transporte

URL do Webservice : http://sws.spartoo.pt/mp/xml_export_bl.php

Este webserviço permite recuperar a guia de transporte que deve estar no pacote da sua encomenda Spartoo.

Lista dos parâmetros

Os parametros deste web serviço tem de ser obrigatoriamente passadas em POST

Parametros Descrição
Parceiro Deve conter o seu identificante único :
xml cadeia de caráteres XML que contém a lista das informações para efetuar a guia de transporte


Formato do parâmetro xml


Os campos de texto devem estar protegidos por balizas CDATA caso contenham caracteres especiais que possam tornar o XML inválido.

Formato do argumento XML

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

Descrição dos campos XML de entrada

etiqueta descrição obrigatória
order_id código da encomenda Sim
referencia_parceiro Código do produto parceiro
O código do produto só pode conter caráteres alfanuméricos assim como os caráteres - (traço) _ (underscore) e . (ponto). 		sim
product_quantity Quantidade de produtos no pacote sim


Exemplo de parámetro xml

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

Formato do XML devolvido

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

Lista dos códigos de erros do webservice


Código Descrição
1 Sem erros nos parâmetros
-1 O parâmetro partenaire não passou no parâmetro ou está vazio
-2 O parâmetro do parceiro não existe
-5 Falta o parâmetro rID ou o parâmetro statut
-6 A devolução não foi encontrada, verifique o parâmetro rID ou o parâmetro do parceiro.
-11 O parâmetro xml não passou no parâmetro ou está vazio
-12 O parâmetro reference_partenaire não passou no parâmetro ou está vazio
-15 Erro de sintaxe XML, verifique o seu ficheiro XML
-428 A sua conta foi desativada. Não pode mais efetuar chamadas ao webservice
-429 Efetuou demasiado chamadas para o Webservice nesta hora corrida

Descrição dos campos da resposta XML

Balise Description
order_id Número da encomenda
pdf Guia de remessa no formato PDF codificado
errors Código do erro


exemplos de devoluções XML

Exemplo de resposta a uma chamada web serviço KO
<root>
	<errors>int</errors>
</root>
Exemplo de resposta a uma chamada web serviço OK
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>