Főoldal > Webszervíz > Rendelések exportja

Rendelések exportja

Webszervíz URL-je : https://sws.spartoo.hu/mp/xml_export_orders.php

Ez a webszervíz lehetőséget nyújt szert tenni egy adott dátum utáni rendelések információira, akár egy azonosítón keresztül.
A rendelések szűrve lehetnek státusz szerint

Paraméterek listája

Paraméter	Leírás
partenaire	Tartalmaznia kell az Ön egyedi azonosítóját :
date	Dátum, amelytől kezdve szeretnénk kiválasztani a rendeléseket. Formátum : ÉÉÉÉ-HH-NN:óó:pp:mm (példa : 2011-11-27:03:00:00)
oID	Rendelés azonosítója
statut	Megszerzendő rendelések státusza. Ha a paraméter nincs megadva, az összes rendelést ki fogja választani. > Státuszok listájának megtekintése

A partner paraméter kötelező és egy paraméter a kettő közül, date vagy oID, kötelező. A paraméter státusza fakultatív.

Visszaküldött XML formátuma

<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>
				<!-- ... A "relay_info" jelzés csak az átvételi pontba kézbesített rendelés esetében jelenik meg ... -->
				<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>
				<!-- ... Az alábbi "delivery_*" jelzések csak az átvételi ponton kívül kézbesített rendelések esetében jelennek meg ... -->
				<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>
				<!-- ... Több "product" jelzés lehetséges ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Több "order" jelzés lehetséges ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Opcionális jelzések

Egy átvételi pontba kézbesített rendelés esetében, adjon hozzá egy relay_info jelzést és törölje a delivery_* jelzéseket a vezetéknév és keresztnév kivételével.
Ha egy átvételi ponton kívüli rendelésről van szó, törölje a relay_info jelzést és tegyen közzé minden delivery_* jelzést.

Webszervíz hibakódjainak listája

Kód	Leírás
1	Nincs paraméter hiba
-1	A partenaire paraméter nem ment át a paramétereken vagy üres
-2	A partner paraméter nem létezik
-3	Egy kötelező paraméter hiányzik ( dátum vagy oID/rID )
-4	A dátum formátuma nem érvényes
-428	Fiókja deaktiválásra került. A webservices már nem áll rendelkezésére.
-429	Túl sokszor lépett kapcsolatba a webservice-szel az elmúlt egy órában.

XML válasz mezőinek leírása

Jelzés	Leírás
orders_id	A rendelés azonosítója
customers	Információk az ügyfélről a számlázáshoz
delivery	Információk az ügyfélről a kézbesítéshez
customers_firstname / delivery_firstname	Ügyfél keresztneve
customers_lastname / delivery_lastname	Ügyfél vezetékneve
customers_company / delivery_company	Ügyfél cégének a neve
customers_street_address / delivery_street_address	Ügyfél címe
customers_suburb / delivery_suburb	Ügyfél címkiegészítése
customers_city / delivery_city	Ügyfél városa
customers_postcode / delivery_postcode	Ügyfél irányítószáma
customers_country / delivery_country	Ügyfél országa
customers_telephone	Ügyfél telefonszáma
relay_info	Információk az átvételi pontról
relay_id	Átvételi pont azonosítója
relay_type	Átvételi pont típusa
relay_name	Átvételi pont neve
relay_address	Átvételi pont címe
relay_city	Átvételi pont városa
relay_postcode	Átvételi pont irányítószáma
relay_country	Átvételi pont országa
payment_method	Fizetés módja
payment_price	Fizetés költsége ( jelenleg, mindig 0 )
order_total	Rendelés végösszege
orders_status_name	A rendelés jelenlegi státuszának neve
orders_status_id	A rendelés jelenlegi státuszának azonosítója
date_purchased	Rendelés dátuma
last_modified	A rendelés utolsó módosításának dátuma
products	Termékek listája
products_reference	Termék referenciája a partnernél
products_spartoo	Termék referenciája a Spartoo-nál
products_name	Modell neve
products_qty	Rendelt mennyiség
products_manufacturers	Márka neve
products_size	Rendelt méret
products_color	Termék színe
products_price_unit	Egységár
products_price_unit_with_reduce	Ár kedvezménnyel
products_final_price	products_price_unit_with_reduce x products_qty

Visszaküldött XML példái

Mintaválasz egy webszolgáltatás hívásra 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>

Mintaválasz egy webszolgáltatás hívásra 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>