Recepție > Webservices > Import de produse

Actualizare produs

Adresa URL a serviciului Webservice : https://sws.spartoo.ro/mp/xml_maj_stock_batch.php

Acest serviciu web este folosit pentru actualizarea stocului de produse de pe site-ul web Spartoo.
Pentru fiecare produs trimis, serviciul web va returna un cod care indică dacă totul a decurs bine sau nu.

Acest serviciu web este folosit pentru actualizarea stocului de produse. Poate fi folosit pentru a trimite catalogul întreg sau doar câteva produse.

Acest serviciu web funcționează în modul „Actualizare” și nu în modul „Dezactivare”. Asta înseamnă că produsele care nu sunt trimise în XML nu vor fi șterse.
Pentru a retrage un produs de pe site, trebuie să puneți stocul la 0.

Lista de parametri

Parametrii acestui serviciu web trebuie obligatoriu atribuite în POST

Parametru Descriere
partener Trebuie să includă identificatorul unic :
xml Șir de caractere XML care conține lista elementelor de actualizat


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. 

<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
					<languages>
						<language>
							<code>string</code>
							<product_price>float</product_price>
							<discount>
								<startdate>timestamp</startdate>
								<stopdate>timestamp</stopdate>
								<price_discount>float</price_discount>
								<rate>int</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Mai multe balize "language" posibile ... -->
					</languages>
					<!-- ... Mai multe balize "languages" posibile ... -->
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>


Descrierea câmpurilor XML de intrare


Balise Descriere Obligatoriu
reference_partenaire Identificator produs vânzător. Este sku cel care identifică un produs al unei brand într-o culoare precisă
Identificatorul produsului poate conține doar caractere alfanumerice, precum și caractere - (liniuță) _ (liniuță jos) et . (punct). 		Da
product_quantity Stocul total al unui produs
Ignorați dacă sunt detectate una sau mai multe balize size_quantity pentru produs.
Pentru produsele cu o singură mărime, trebuie în mod obligatoriu o baliză product_quantity dacă baliza size_quantity nu este completată. 		Nu
size Lista mărimilor și a stocului acestora.
Facultativ pentru produsele fără mărime ( Genți / Accesorii ). În caz contrar oblgatoriu. 		Da / Nu
size_quantity Pentru fiecare mărime, trebuie specificat stocul.
Pentru a dezactiva un produs, trebuie să actualizați stocul la 0.
Când stocul este la 0, produsul este dezactivat și nu mai apare pe Spartoo. 		Da
size_reference Referință produs la mărime. Da


Exemplu de parametru xml

<catalogue>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<size_list>
				<size>
					<size_reference>98_38</size_reference>
					<size_quantity>5</size_quantity>
					<languages>
						<language>
							<code>FR</code>
							<product_price>100.00</product_price>
							<discount>
								<startdate>1199170800</startdate>
								<stopdate>1204354800</stopdate>
								<price_discount>90.00</price_discount>
								<rate>10</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Mai multe balize "language" posibile ... -->
					</languages>
					<!-- ... Mai multe balize "languages" posibile ... -->
				</size>
				<size>
					<size_reference>98_39</size_reference>
					<size_quantity>7</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>158_tailor</reference_partenaire>
			<size_list>
				<size>
					<size_reference>158_37</size_reference>
					<size_quantity>2</size_quantity>
				</size>
				<size>
					<size_reference>158_36</size_reference>
					<size_quantity>0</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>

Formatul XML returnat


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Mai multe balize "product" posibile ... -->
	</products>
</catalogue>


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ă
-11 Parametrul xml nu este trecut în parametru sau este gol
-13 Parametrul products_size_reference nu este trecut în parametru sau este gol
-15 Eroare de sintaxă XML, verificați fișierul dvs XML
-18 Stocul este același ca cel din bază și prin urmare nu a fost actualizat
-20 Imposibil de actualizat stocul. Mărimea nu mai este validă pentru acest produs, stocul pentru acest produs și această mărime este la 0.
-31 Această size_reference nu există
-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ă



Exemple de returnări XML


Exemplu de răspuns la un apel de serviciu web KO :

<catalogue>
	<products></products>
	<errors>-1</errors>
</catalogue>

Exemplu de răspuns la un apel de serviciu web OK :

<catalogue>
	<products>
		<product>
			<reference_partenaire>EEAJBCC</reference_partenaire>
			<size_list>
				<size>
					<size_reference>EEAJBCC_38</size_reference>
					<errors>1</errors>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<size_list>
				<size>
					<size_reference></size_reference>
					<errors>-13</errors>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>