Úvod > Webservis > Export objednávek

Export objednávek

URL Webservisu : https://sws.spartoo.cz/mp/xml_export_orders.php

Webservis dokáže získat informace z předešlých objednávek (dle data či jiného identifikátora).
Objednávky mohou být filtrovány dle statusu (stavu).

Seznam parametrů

Parametr	Popis
partenaire	Musí obsahovat váš unikátní identifikátor:
date	Datum, od kterého si přejete zobrazit objednávky. Formát: RRRR-MM-DD:hh:mm:ss (příklad: 2011-11-27:03:00:00)
oID	Identifikátor objednávky
statut	Status objednávky se aktualizuje. Pokud nemáte parametr, vyberte všechny objednávky. > Zobrazit seznam se statusy

Parametr partnera je povinný a také minimálně jeden z parametrů date (datum) nebo oID (číslo objednávky). Parametr statusu je volitelný.

Formát XML zapsán obráceně

<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>
				<!-- ... Značení "relay_info" se zadává pouze pro objednávky, které jsou doručovány do přebíracího místa ... -->
				<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>
				<!-- ... Značení "delivery_*" je pouze platné pro objednávky, které nejsou doručovány do přebíracího místa ... -->
				<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>
				<!-- ... Možné zadání více "product"  ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Možné zadání více "order"  ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Další značení

V případě, že je objednávka doručována do přebíracího místa, je potřeba přidat značení relay_info a odstranit značení delivery_*, ponechat jméno a příjmení.
Pokud se nejedná objednávku, která je doručována do přebíracího místa, smazat relay_info a ponechat delivery_*.

Seznam kódů chyb webservice

Kód	Popis
1	Žádná chyba v parametrech nenalezena
-1	Parametr partenaire není správný parametr nebo je prázdný
-2	Partnerský parametr neexistuje
-3	Chybí povinné údaje, parametr (datum nebo oID/rID)
-4	Datový formát není platný
-428	Váš účet byl deaktivován. Nemůžete již volat.
-429	Na tuto webovou službu jste volali příliš mnoho, limit je vyčerpán.

Popis pole odpovídající XML

Značení	Popis
orders_id	Identifikátor objednávky
customers	Informace o zákazníkovi pro fakturaci
delivery	Informations o zákazníkovi pro doručení
customers_firstname / delivery_firstname	Křestní jméno zákazníka
customers_lastname / delivery_lastname	Příjmení zákazníka
customers_company / delivery_company	Firma
customers_street_address / delivery_street_address	Adresa zákazníka
customers_suburb / delivery_suburb	Poznámka k adrese zákazníka
customers_city / delivery_city	Město zákazníka
customers_postcode / delivery_postcode	Směrovací číslo zákazníka
customers_country / delivery_country	Země zákazníka
customers_telephone	Telefonní číslo zákazníka
relay_info	Informace o přebíracím místě
relay_id	Identifikátor přebíracího místa
relay_type	Typ přebíracího místa
relay_name	Jméno přebíracího místa
relay_address	Adresa přebíracího místa
relay_city	Město přebíracího místa
relay_postcode	PSČ přebíracího místa
relay_country	Země přebíracího místa
payment_method	Způsob platby
payment_price	Poplatek za platbu (nyní vždy 0)
order_total	Celková částka objednávky
orders_status_name	Aktuální status objednávky
orders_status_id	Id aktuálního statusu objednávky
date_purchased	Datum učinění objednávky
last_modified	Datum poslední úpravy objednávky
products	Seznam produktů
products_reference	Reference produktu u partnera
products_spartoo	Reference produktu na Spartoo
products_name	Název modelu
products_qty	Objednané množství
products_manufacturers	Název značky
products_size	Objednaná velikost
products_color	Barva produktu
products_price_unit	Jednotková cena
products_price_unit_with_reduce	Cena se slevou
products_final_price	products_price_unit_with_reduce x products_qty

Příklad vrácení XML

Příklad odpovědi web servisu 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>

Příklad odpovědi web servisu 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>