Início > Webservices > Verificação do estatuto dos produtos

Verificação do estatuto dos produtos

URL do Webservice : https://sws.spartoo.pt/mp/xml_check_status_products.php

Este webservice permite recuperar o estatuto de um ou mais produtos no site.
Se o produto não está online, este webservice permitirá saber o porquê.
É possível conhecer o detalhe do estatuto do artigo por tamanho, para isso é preciso indicar o campo size_reference no webservice de importação dos produtos.

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. 
<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<products_size_reference>string</products_size_reference>
		</product>
		<!-- ... Várias balizas "<product>" possíveis ... -->
	</products>
</root>


Descrição dos campos XML de entrada


Baliza Descrição Obrigatório
reference_partenaire Identificação do produto do parceiro
Corresponde ao campo reference_partenaire no webservice de importação dos produtos. 		Obrigatório
products_size_reference Referência do produto por tamanho.
Corresponde ao campo size_reference no webservice de importação dos produtos. 		Facultativo


Exemplo de parâmetro xml 

<root>
	<products>
		<product>
			<reference_partenaire>SKU_PARENT</reference_partenaire>
			<products_size_reference>SKU</products_size_reference>
		</product>
		<product>
			<reference_partenaire>SKU_PARENT 2</reference_partenaire>
		</product>
	</products>
</root>


Formato do XML devolvido


<root>
	<errors>int</errors>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_reference>string</size_reference>
			<status>string</status>
			<description>string</description>
		</product>
		<!-- ... Várias balizas "<product>" possíveis ... -->
	</products>
</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
-11 O parâmetro xml 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


Baliza Descrição
reference_partenaire Identificação do produto do parceiro
size_reference Referência do produto por tamanho
status Lista dos status:
  • OK : O produto está presente no site
  • OS : O produto já não existe em stock
  • EC : O produto foi criado no nosso sistema, mas não está no site
  • KO : O produto não foi criado no nosso sistema
descrição Descrição texto


Exemplos de devolução XML 


<root>
	<errors>1</errors>
	<products>
		<product>
			<reference_partenaire>SKU_PARENT</reference_partenaire>
			<size_reference>SKU</size_reference>
			<status>KO</status>
			<description>Cette référence de taille n'existe pas pour ce produit</description>
		</product>
		<product>
			<reference_partenaire>SKU_PARENT 2</reference_partenaire>
			<status>OS</status>
			<description>Ce produit n'est plus en ligne parce qu'il n'a plus de stock</description>
		</product>
	</products>
</root>