Home > Webservices > Eksport zamówień

Eksport zamówień

URL Webservice : https://sws.spartoo.pl/mp/xml_export_orders.php

Ten webservice pozwala na pobranie informacji dotyczących zamówień złożonych po określonej dacie albo informacji na temat zamówień według ich oznaczeń.
Można wyszukiwać zamówienia używając filtru status.

Lista parametrów

Parametr	Opis
partner	Rubryka musi zawierać Twój indywidualny identyfikator:
date	Data, poczynając od której chcemy wyselekcjonować zamówienia. Format daty: RRRR-MM-DD:gg:mm:ss (np: 2011-11-27:03:00:00)
oID	Numer zamówienia
statut	Status zamówień do pobrania. Jeżeli parametr nie zostanie wskazany, wyselekcjonowane zostaną wszystkie zamówienia. > Zobacz listę statusów

Parametr firmy partnerskiej jest obowiązkowy, jak również jeden z dwóch parametrów - date albo oID - jest obowiązkowy. Parametr statut jest nieobowiązkowy.

Format XML zwrócony

<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" pojawia się wyłącznie dla zamówień doręczanych do punktu dostawy ... -->
				<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>
				<!-- ... Tagi z kategorii "delivery_*" dotyczą wyłącznie zamówień doręczanych bezpośrednio na adres klienta, czyli nie pojawiają się dla zamówień doręczanych do punktu dostawy ... -->
				<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>
				<!-- ... Różne tagi "product" możliwe ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Różne tagi "order" możliwe ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Tagi nieobowiązkowe

W przypadku dostawy do punktu odbioru, dodanie tagu relay_info i usunięcie tagów delivery_* z wyjątkiem nazwiska i imienia.
W przypadku innych zamówień usunięcie tagu relay_info i wyświetlanie się wszystkich tagów z kategoriidelivery_*.

Lista kodów błędów webservice

Kod	Opis
1	Nie ma błędu parametrów
-1	Parametr partenaire nie uzyskał statusu parametru lub jest pusty
-2	Parametr firmy partnerskiej nie istnieje
-3	Brak parametru obowiązkowego (date lub oID/rID )
-4	Nieprawidłowy format daty
-428	Twoje konto zostało dezaktywowane. Nie będziesz już mógł/mogła się do niego zalogować
-429	W ciągu ostatniej godziny wykonałeś/aś zbyt wiele połączeń z tym serwisem internetowym

Opis rubryk odpowiedzi XML

Tag	Opis
orders_id	Numer zamówienia
Klienci	Informacje na temat klienta, dotyczące fakturowania
Dostawa	Informacje na temat klienta, dotyczące dostawy
customers_firstname / delivery_firstname	Imię klienta
customers_lastname / delivery_lastname	Nazwisko klienta
customers_company / delivery_company	Nazwa firmy klienta
customers_street_address / delivery_street_address	Adres klienta
customers_suburb / delivery_suburb	Uzupełnienie adresu klienta
customers_city / delivery_city	Miejscowość klienta
customers_postcode / delivery_postcode	Kod pocztowy klienta
customers_country / delivery_country	Kraj klienta
customers_telephone	Telefon klienta
relay_info	Informacje dotyczące punktu dostawy
relay_id	Identyfikator punktu dostawy
relay_type	Typ punktu dostawy
relay_name	Nazwa punktu dostawy
relay_address	Adres punktu dostawy
relay_city	Miasto punktu dostawy
relay_postcode	Kod pocztowy punktu dostawy
relay_country	Kraj punktu dostawy
payment_method	Sposób płatności
payment_price	Opłata za płatność (obecnie zawsze 0)
order_total	Suma zamówienia
orders_status_name	Nazwa aktualnego statusu zamówienia
orders_status_id	Id statusu zamówienia
date_purchased	Data zamówienia
last_modified	Data ostatniej modyfikacji zamówienia
Produkty	Lista produktów
products_reference	Numer referencyjny produktu firmy partnerskiej
products_spartoo	Numer referencyjny produktu w Spartoo
products_name	Nazwa modelu
products_qty	Ilość produktu
products_manufacturers	Nazwa marki
products_size	Rozmiary produktu
products_color	Kolor produktu
products_price_unit	Cena jednostkowa
products_price_unit_with_reduce	Cena z rabatem
products_final_price	products_price_unit_with_reduce x products_qty

Przykłady komunikatów XML

Przykład odpowiedzi na nieudane połączenie web service :

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

Przykład odpowiedzi na udane połączenie web service :

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