Sprejem > Web storitve > Izvoz naročil

Izvoz naročil

URL Webservice-a : https://sws.spartoo.si/mp/xml_export_orders.php

Ta spletna storitev omogoča pridobivanje informacij o naročilih, bodisi oddanih po določenem datumu, bodisi prek identifikatorja.
Naročila lahko filtriramo po statusu.

Seznam nastavitev

Paramètre	Opis
partenaire	Mora vsebovati edinstven ID :
date	Datum, od katerega naprej želite izbrati naročila. Format : AAAA-MM-JJ:hh:mm:ss (primer : 2011-11-27:03:00:00)
oID	ID naročila
statut	Status naročil, ki ga želite pridobiti. Če nastavitev ni na voljo, bo izbralo vsa naročila. > Glej seznam statusov

Partnerska nastavitev je obvezna, prav tako ena od dveh nastavitev datuma ali ID. Nastavitev statusa ni obvezna.

Format izvoženega 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>
				<!-- ... Oznaka "relay_info" je prisotna samo za naročilo, dostavljeno na prevzemno točko ... -->
				<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>
				<!-- ... Spodnje oznake "delivery_ *" so na voljo samo za naročila, dostavljena izven prevzemnih točk ... -->
				<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>
				<!-- ... Več možnih oznak "product" ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Več možnih oznak "order" ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Izbirne oznake

V primeru naročila, dostavljenega na prevzemno točko, dodajte oznako relay_info in izbrišite oznake delivery_* z izjemo imena in priimka.
Če gre za ukaz izven prevzemne točke, odstranite oznako relay_info in izberite prikaz vseh oznakdelivery_*.

Seznam kod za napake spletnih storitev

Koda	Opis
1	Ni napak v nastavitvah
-1	Nastavitev partenaire ni bila zaznana kot nastavitev ali pa je prazna
-2	Partnerske nastavitve ne obstajajo
-3	Manjka obvezna nastavitev ( datum ali oID/rID )
-4	Neveljavna oblika datuma
-428	Vaš račun je deaktiviran. Ne morete več naročati spletnih storitev
-429	V tekoči uri ste to spletno storitev prevečkrat naročili

Opis polj odzivov XML

Primer vračila XML

Balise	Opis
orders_id	ID naročila
customers	Informacije o stranki za izstavitev računa
delivery	Informacije o stranki za dostavo
customers_firstname / delivery_firstname	Ime stranke
customers_lastname / delivery_lastname	Priimek stranke
customers_company / delivery_company	Podjetje stranke
customers_street_address / delivery_street_address	Naslov stranke
customers_suburb / delivery_suburb	Dopolnilo k naslovu stranke
customers_city / delivery_city	Mesto stranke
customers_postcode / delivery_postcode	Poštna koda stranke
customers_country / delivery_country	Država stranke
customers_telephone	Telefonska številka stranke
relay_info	Informacije o prevzemnih točkah
relay_id	ID prevzemne točke
relay_type	Tip prevzemne točke
relay_name	Ime prevzemne točke
relay_address	Naslov prevzemne točke
relay_city	Mesto prevzemne točke
relay_postcode	Poštna koda prevzemne točke
relay_country	Država prevzemne točke
payment_method	Način plačila
payment_price	Strošek plačila ( trenutno, vedno 0 )
order_total	Skupno naročilotd>
orders_status_name	Ime trenutnega statusa naročila
orders_status_id	ID trenutnega statusa naročila
date_purchased	Datum opravljenega naročila
last_modified	Datum zadnje spremembe naročila
products	Seznam izdelkov
products_reference	Referenca izdelka pri partnerju
products_spartoo	Referenca izdelka pri Spartoo
products_name	Ime modela
products_qty	Naročena količina
products_manufacturers	Ime znamke
products_size	Naročena velikost
products_color	Barva izdelka
products_price_unit	Cena na enoto
products_price_unit_with_reduce	Cena s popustom
products_final_price	products_price_unit_with_reduce x products_qty

Primer odgovora na spletno povpraševanje 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>

Primer odgovora na spletno povpraševanje 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>