Uvítanie > Webové služby > Export objednávok

Export objednávok

URL webovej služby : https://sws.spartoo.sk/mp/xml_export_orders.php

Táto webová služba umožňuje získanie informácií o objednávkach, ktoré sú buď vystavené po určitom termíne alebo prostredníctvom ich identifikáčného čísla.
Objednávky môžu byť vyfiltrované podľa ich stavu

Zoznam parametrov

Parameter	Popis
partnerský predajca	Musí obsahovať Váš unikátny identifikátor:
dátum	Dátum, od ktorého si želáte vybrať objednávky. Formát: RRRR-MM-DD:hh:mm:ss (príklad: 2011-11-27:03:00:00)
oID	Identifikátor objednávky
stav	Stav objednávok na prevzatie. Ak nie je parameter zadaný, vybraté budú všetky objednávky. > Pozrieť si zoznam možných stavov

Partnerský parameter je povinný a jeden z parametrov: dátum alebo oID je rovnako povinný. Parameter stavu je voliteľný.

Obrátený formát XML

<root>
	<orders>
		<order>
			<orders_id>string</orders_id>
			<customers>
				<customers_firstname>string</customers_firstname>
				<customers_lastname>string</customers_lastname>
				<customers_company>string</customers_company>
				<customers_street_address>string</customers_street_address>
				<customers_suburb>string</customers_suburb>
				<customers_city>string</customers_city>
				<customers_postcode>string</customers_postcode>
				<customers_state>string</customers_state>
				<customers_country>string</customers_country>
				<customers_email_address>string</customers_email_address>
				<customers_telephone>string</customers_telephone>
			</customers>
			<delivery>
				<delivery_firstname>string</delivery_firstname>
				<delivery_lastname>string</delivery_lastname>
				<!-- ... Tag "relay_info" je prítomný, ak je objednávka doručená do doručovacieho miesta ... -->
				<relay_info>
					<relay_id>int</relay_id>
					<relay_type>string</relay_type>
					<relay_name>string</relay_name>
					<relay_address>string</relay_address>
					<relay_city>string</relay_city>
					<relay_postcode>string</relay_postcode>
					<relay_country_iso>string</relay_country_iso>
				</relay_info>
				<!-- ... Doleuvedené tagy "delivery_*" sú prítomné iba pre objednávku doručenú pomimo doručovacích miest ... -->
				<delivery_company>string</delivery_companyy>
				<delivery_suburb>string</delivery_suburb>
				<delivery_street_address>string</delivery_street_address>
				<delivery_city>string</delivery_city>
				<delivery_postcode>string</delivery_postcode>
				<delivery_state>string</delivery_state>
				<delivery_country>string</delivery_country>
			</delivery>
			<payment_method>string</payment_method>
			<payment_price>float</payment_price>
			<shipping_price>float</shipping_price>
			<shipping_name>string</shipping_name>
			<order_total>float</order_total>
			<orders_status_name>string</orders_status_name>
			<orders_status_id>int</orders_status_id>
			<date_purchased>[DATE]</date_purchased>
			<last_modified>[DATE]</last_modified>
			<products>
				<product>
					<products_reference>string</products_reference>
					<products_name>string</products_name>
					<products_qty>int</products_qty>
					<products_spartoo>int</products_spartoo>
					<products_manufacturers>string</products_manufacturers>
					<products_size>string</products_size>
					<products_size_reference>string</products_size_reference>
					<products_color>string</products_color>
					<products_price_unit>float</products_price_unit>
					<products_price_unit_with_reduce>float</products_price_unit_with_reduce>
					<products_final_price>float</products_final_price>
				</product>
				<!-- ... Viacero možných tagov "product" ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Viacero možných tagov "order" ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Nepovinné tagy

V prípade objednávky doručenej do odberného miesta - pridanie tagu relay_info a - vymazanie tagu delivery_*okrem priezviska a mena.
Pokiaľ sa jedná o objednávku mimo doručenia do odberného miesta - vymazanie tagu relay_info a zobrazenie všetkých tagov delivery_*.

Zoznám chybových kódov webovej služby

Kód	Popis
1	Bezchybné parametre
-1	Parameter partenaire nebol správne zaregistrovaný alebo je prázdny
-2	Parametre partnera neexistujú
-3	Chýba povinný parameter (dátum alebo oID/rID)
-4	Časový formát je neplatný
-428	Váš účet bol deaktivovaný. Odteraz nemáte možnosť zadávať požiadavky webservices
-429	Za túto hodinu ste dosiahli príliš veľký počet požiadaviek webservice

Popis políčok odpovede XML

Tag	Popis
orders_id	Identifikátor objednávky
zákazníci	Informácie o zákazníkovi pre fakturáciu
delivery	Informácie o zákazníkovi pre doručenie objednávky
customers_firstname / delivery_firstname	Meno zákazníka
customers_lastname / delivery_lastname	Priezvisko zákazníka
customers_company / delivery_company	Firma zákazníka
customers_street_address / delivery_street_address	Adresa zákazníka
customers_suburb / delivery_suburb	Doplnok k adrese zákazníka
customers_city / delivery_city	Mesto zákazníka
customers_postcode / delivery_postcode	PSČ zákazníka
customers_country / delivery_country	Krajina zákazníka
customers_telephone	Telefónne číslo zákazníka
relay_info	Informácie o odbernom mieste
relay_id	Identifikant odberného miesta
relay_type	Typ odberného miesta
relay_name	Názov odberného miesta
relay_address	Adresa odberného miesta
relay_city	Mesto odberného miesta
relay_postcode	PSČ odberného miesta
relay_country	Krajina odberného miesta
payment_method	Spôsob platby
payment_price	Poplatok za spôsob platby ( aktuálne stále 0 )
order_total	Celková suma za objednávku
orders_status_name	Názov aktuálneho stavu objednávky
orders_status_id	Identifikátor aktuálneho stavu objednávky
date_purchased	Dátum objednávky
last_modified	Dátum poslednej úpravy objednávky
products	Zoznam produktov
products_reference	Kód tovaru u partnerského predajcu
products_spartoo	Kód tovaru na stránke Spartoo
products_name	Názov modelu
products_qty	Objednané množstvo
products_manufacturers	Názov značky
products_size	Objednaná veľkosť
products_color	Farba produktu
products_price_unit	Jednotková cena
products_price_unit_with_reduce	Cena po zľave
products_final_price	products_price_unit_with_reduce x products_qty

Príklady vrátenia XML

Príklad odpovede web servis KO :

<root>
	<orders>
		<order>
			<orders_id>90D813EA1A2365A8</orders_id>
			<customers>	</customers>
			<delivery>
				<delivery_firstname><![CDATA[Robert]]></delivery_firstname>
				<delivery_lastname><![CDATA[Durand]]></delivery_lastname>
				<relay_info>
					<relay_id>1505</relay_id>
					<relay_type><![CDATA[kiala]]></relay_type>
					<relay_name><![CDATA[(NP)LE PAPYRUS]]></relay_name>
					<relay_address><![CDATA[Boulevard Gambetta]]></relay_address>
					<relay_city><![CDATA[Grenoble]]></relay_city>
					<relay_postcode><![CDATA[38000]]></relay_postcode>
					<relay_country_iso><![CDATA[FR]]></relay_country_iso>
				</relay_info>
				<delivery_company><![CDATA[Spartoo]]></delivery_company>
				<delivery_suburb><![CDATA[16 rue Henri Barbusse]]></delivery_suburb>
				<delivery_street_address><![CDATA[16 rue Henri Barbusse]]></delivery_street_address>
				<delivery_city><![CDATA[Grenoble]]></delivery_city>
				<delivery_postcode><![CDATA[38100]]></delivery_postcode>
				<delivery_state></delivery_state>
				<delivery_country><![CDATA[France]]></delivery_country>
			</delivery>
			<payment_method><![CDATA[Paiement par carte bancaire]]></payment_method>
			<payment_price>0</payment_price>
			<order_total>120.0000</order_total>
			<orders_status_name><![CDATA[Commande Vérifiée]]></orders_status_name>
			<orders_status_id>11</orders_status_id>
			<date_purchased>2013-02-12 14:00:00</date_purchased>
			<last_modified>2013-02-12 14:00:00</last_modified>
			<products>
				<product>
					<products_reference><![CDATA[ABCD]]></products_reference>
					<products_name><![CDATA[ALL STAR HI]]></products_name>
					<products_qty>2</products_qty>
					<products_spartoo>123456</products_spartoo>
					<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
					<products_size>42</products_size>
					<products_size_reference><![CDATA[AAAAAA]]></products_size_reference>
					<products_color><![CDATA[Blanc]]></products_color>
					<products_price_unit>60.00</products_price_unit>
					<products_price_unit_with_reduce>200.00</products_price_unit_with_reduce>
					<products_final_price>120.00</products_final_price>
				</product>
			</products>
			<errors>
				<error>
					<id>-1</id>
					<description>Le paramètre partenaire n'est passé ou est vide</description>
				</error>
			</errors>
		</order>
	</orders>
	<statut>
		<id>41</id>
		<description>Annulation commande</description>
	</statut>
</root>

Príklad odpovede web servis OK :

<root>
	<orders>
		<order>
			<orders_id>90D813EA1A2365A8</orders_id>
			<customers>
				<customers_firstname><![CDATA[Robert]]></customers_firstname>
				<customers_lastname><![CDATA[Durand]]></customers_lastname>
				<customers_company><![CDATA[Spartoo]]></customers_company>
				<customers_street_address><![CDATA[16 rue Henri Barbusse]]></customers_street_address>
				<customers_suburb><![CDATA[2eme Etage]]></customers_suburb>
				<customers_city><![CDATA[Grenoble]]></customers_city>
				<customers_postcode><![CDATA[38100]]></customers_postcode>
				<customers_state></customers_state>
				<customers_country><![CDATA[France]]></customers_country>
				<customers_telephone><![CDATA[0612345678]]></customers_telephone>
			</customers>
			<delivery>
				<delivery_firstname><![CDATA[Robert]]></delivery_firstname>
				<delivery_lastname><![CDATA[Durand]]></delivery_lastname>
				<relay_info>
					<relay_id>1505</relay_id>
					<relay_type><![CDATA[kiala]]></relay_type>
					<relay_name><![CDATA[(NP)LE PAPYRUS]]></relay_name>
					<relay_address><![CDATA[Boulevard Gambetta]]></relay_address>
					<relay_city><![CDATA[Grenoble]]></relay_city>
					<relay_postcode><![CDATA[38000]]></relay_postcode>
					<relay_country_iso><![CDATA[FR]]></relay_country_iso>
				</relay_info>
				<delivery_company><![CDATA[Spartoo]]></delivery_company>
				<delivery_suburb><![CDATA[16 rue Henri Barbusse]]></delivery_suburb>
				<delivery_street_address><![CDATA[16 rue Henri Barbusse]]> </delivery_street_address>
				<delivery_city><![CDATA[Grenoble]]></delivery_city>
				<delivery_postcode><![CDATA[38100]]></delivery_postcode>
				<delivery_state></delivery_state>
				<delivery_country><![CDATA[France]]></delivery_country>
			</delivery>
			<payment_method><![CDATA[Paiement par carte bancaire]]></payment_method>
			<payment_price>0</payment_price>
			<order_total>120.0000</order_total>
			<orders_status_name><![CDATA[Commande Vérifiée]]></orders_status_name>
			<orders_status_id>11<orders_status_id>
			<date_purchased>2013-02-12 14:00:00</date_purchased>
			<last_modified>2013-02-12 14:00:00</last_modified>
			<products>
				<product>
					<products_reference>ABCD</products_reference>
					<products_name><![CDATA[ALL STAR HI]]></products_name>
					<products_qty>2</products_qty>
					<products_spartoo>123456</products_spartoo>
					<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
					<products_size>42></products_size>
					<products_size_reference><![CDATA[AAAAAA]]></products_size_reference>
					<products_color><![CDATA[Blanc]]></products_color>
					<products_price_unit>60.00</products_price_unit>
					<products_price_unit_with_reduce>200.00</products_price_unit_with_reduce>
					<products_final_price>120.00</products_final_price>
				</product>
			</products>
			<errors>
				<error>
					<id>1</id>
					<description>Pas d'erreur de paramètres</description>
				</error>
			</errors>
		</order>
	</orders>
	<statut>
		<id>11</id>
		<description>Commande vérifiée</description>
	</statut>
</root>