Home > Webservices > Een bestelling updaten

Status van een bestelling vernieuwen

URL van de Webservice : https://sws.spartoo.be/mp/xml_maj_orders.php

Deze webservice dient om de status van een bestelling te vernieuwen.

Bestelling in status 2 (Bestelling in voorbereiding): De bestelling wordt beschouwd als aanvaard. De gegevens van de bestelling (naam, leveradres, transporteur, etc ...) zullen niet meer veranderen.
Bestelling in status 3 (Bestelling verzonden): We beschouwen dat de voorraad in mindering werd gebracht. De bestelling werd overgemaakt aan de transporteur. De tracking code is beschikbaar.
Bestelling in status 41 (Bestelling geannuleerd): Bestelling geannuleerd, de klant ontvangt geen levering. De klant zal eerstdaags terugbetaald worden.
Bestelling in status 45 ( Bestelling verzonden) : De bestelling is verloren geraakt tijdens de levering.
Bestelling in status 47 ( Bestelling verzonden) : De levering kan niet plaatsvinden (Klant woont niet op het opgegeven adres, pakket kan niet worden aangenomen, ...).

Een bestelling kan enkel naar status 2 gaan, indien de bestelling in status 11 staat.
Een bestelling kan enkel naar status 3 gaan, indien de bestelling in status 2 staat.
Een bestelling kan enkel naar status 41 gaan, indien de bestelling niet in status 3 of 41 staat.

Een bestelling kan enkel naar status 45 gaan, indien de bestelling in status 3 staat.
Een bestelling kan enkel naar status 47 gaan, indien de bestelling in status 3 staat.
De tracking van de bestelling wordt aangemaakt wanneer de bestelling in status 3 komt te staan. Op dat moment moet de parameter tracking_number opgegeven worden.
Op dat moment wordt een e-mail met de tracking link verstuurd naar de klant met de info dat zijn/haar bestelling verzonden werd

> Zie hier de lijst van de verschillende statussen van een bestelling > Bekijk de lijst met de bestelstatussen

Lijst met parameters

Parameter	Omschrijving
Partner	Dient uw unieke ID te bevatten:
oID	Referentie te vernieuwen bestelling
statut	Nieuwe status bestelling (2, 3 of 41)
tracking_number	Tracking nummer transporteur (op te geven wanneer de bestelling naar status 3 verandert)

Het is ook mogelijk om een XML te verstrekken als u toegang hebt tot het verzenden van meerdere pakketten.
Wanneer u deze webservice in multi pakkketten aanroept, wordt de status van de bestelling automatisch ingesteld op 2 (opdracht geaccepteerd)
Zodra alle producten van de bestelling in het pakket zitten, schakelt de bestelling automatisch naar status 3 (bestelling verzonden)

<root>
	<parcel>
		<tracking>string</tracking>
		<products>
			<product>
				<products_reference>string</products_reference>
				<products_size>string</products_size>
			</product>
		</products>
	</parcel>
</root>

Exemple :

<root>
	<parcel>
		<tracking>12563AF256</tracking>
		<products>
			<product>
				<products_reference>basket_model_7</products_reference>
				<products_size>36</products_size>
			</product>
			<product>
				<products_reference>basket_model_7</products_reference>
				<products_size>37</products_size>
			</product>
		</products>
	</parcel>
	<parcel>
		<tracking>12563AF257</tracking>
		<products>
			<product>
				<products_reference>tshirt_blue_268</products_reference>
				<products_size>M</products_size>
			</product>
		</products>
	</parcel>
</root>

Lijst met de foutcodes van de webservice

Code	Omschrijving
1	Geen fouten in de parameters
-1	De parameter partenaire werd niet als parameter aangemaakt of is leeg
-2	De partner parameter bestaat niet
-5	De parameter rID/oID of de parameter status ontbreken
-6	De bestelling of de retour werden niet gevonden, gelieve de parameter oID/rID of de parameter partner na te kijken.
-8	Fout bij ingave tracking nummer
-9	De nieuwe status is dezelfde als de huidige
-10	De nieuwe status bestaat niet
-11	De parameter xml werd niet als parameter aangemaakt of is leeg
-14	Het product werd niet gevonden in onze database
-17	Crossdock bestelling: het pakketnummer is verplicht
-19	Probleem met de status van de bestelling Status 2 is enkel van toepassing indien de bestelling in status 11 is Status 3 is enkel van toepassing indien de bestelling in status 2 is Status 41 is enkel van toepassing indien de bestelling niet in status 3 is
-26	Deze bestelling gaat retour en we kunnen deze bestelling dus niet als verloren/levering mislukt beschouwen
-27	De bestelling is al geannuleerd
-28	Bestelling niet gevonden
-29	Onbekende fout (verloren/levering mislukt)
-30	De bestelling is te oud om te zetten naar status 3. Contact de service Marketplace
-428	Uw account is gedeactiveerd. U kunt niet langer gebruik maken van de webservices
-429	U heeft te veel gebruik gemaakt van deze webservice voor dit uur