Home > Webservices > Product acknowledgment

Products status

Webservice URL : https://sws.spartoo.eu/mp/xml_check_status_products.php

This webservice allows you to know the status for one or more products on the website.
In the case that the product is offline, it will tell you the reason why.
It is possible to find the product status for specific sizes; for this, you must have filled in the field size_reference in the product import webservice.

List of Parameters

The parameters of this webservice are required to be in POST

Setting	Description
partner	Must contain your unique identifier code:
xml	XML feed containing the list of information on the items for the delivery note

XML parameter format

The text fields must be protected by CDATA tags if they contain special characters that would make the XML invalid.

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<products_size_reference>string</products_size_reference>
		</product>
		<!-- ... Multiple "<product>" tags possible ... -->
	</products>
</root>

Entry XML field description

Tag	Description	Required
reference_partenaire	Merchant product identification Corresponds to the field reference_parter in the product import webservice	Required
products_size_reference	Reference of the product with size. Corresponds to the field size_reference in the product import webservice	Optional

XML parameter example

<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>

XML format returned

<root>
	<errors>int</errors>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_reference>string</size_reference>
			<status>string</status>
			<description>string</description>
		</product>
		<!-- ... Multiple "<product>" tags possible ... -->
	</products>
</root>

List of webservice error codes

Code	Description
1	No error with parameters
-1	The parameter partenaire has not been set up or it is empty
-2	The parameter partenaire does not exist
-11	The parameter xml has not been set up or it is empty
-15	XML syntax error, verify your XML file
-428	Your account has been deactivated. You will no longer have access to our online services.
-429	You have made too many online requests during this 1-hour time period.

XML response field description

Tag	Description
reference_partner	Product or merchant ID
size_reference	Product and size reference
status	Status list: OK : The product is present on the website OS : The product is not in stock EC : The product has been created in our system, but it is not on the website KO : The product has not been created in our system
description	Description text

XML return examples

<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>