Haal een bestelling op

Deze “Haal een Bestelling Op” API-endpoint wordt gebruikt om gegevens op te halen voor een voltooide bestelling binnen het Zonos systeem. De respons bevat een JSON-object dat alle beschikbare informatie voor de bestelling vertegenwoordigt, inclusief factuur- en verzendadressen, verzendmethode, besteltotalen en status.

Endpoints 

Bestelnummer

Haal een lijst van bestelnummer op.

Bestelgegevens

Haal gedetailleerde informatie voor een bestelling op.

Gebruik van de Haal een bestelling op API-endpoint

Er zijn twee gebruikelijke manieren om deze endpoints te gebruiken.

1. (Deel 1 + Deel 2) – Gebruik een aangepaste bestelbevestiging / succespagina op uw domein om uw systeem te activeren om de orderDetail endpoint aan te roepen en een voltooide bestelling te importeren. Daarnaast regelmatig de orderNumbers endpoint aanroepen om eventuele bestellingen in het Zonos systeem die niet in uw systeem zijn geïmporteerd, te reconciliëren.
2. (Deel 2 Alleen) – Gebruik de Zonos basis bestelbevestiging / succespagina of een statische pagina op uw domein om de klant te informeren over de voltooiing van de bestelling. Plan uw systeem om regelmatig de orderNumbers endpoint aan te roepen om te bepalen wanneer een nieuwe bestelling klaar is om in uw systeem te worden geïmporteerd. Wanneer een openstaande bestelling wordt gevonden, roep dan de orderDetail endpoint aan voor de gegevens over die bestellingen.

Deel 1: Succespagina op uw domein

Elke keer dat een koper een bestelling voltooit in de Zonos Checkout, worden ze onmiddellijk doorgestuurd naar een URL van de bestel succespagina. De voltooide bestel-ID wordt als een querystring aan de omleidings-URL toegevoegd. De URL van de bestel succespagina moet aan Zonos worden verstrekt. De URL kan ook als parameter worden doorgegeven in de createTempCart endpoint bij het aanmaken van de tijdelijke winkelwagentje in het Zonos systeem.

Voorbeeld: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Wanneer een klant naar deze pagina wordt doorgestuurd, moet uw systeem de waarde voor orderId uit de URL parseren. U gebruikt vervolgens de orderId om de orderDetail endpoint aan te roepen om de bestelgegevens op te halen.

Deel 2: Gebruik een geplande taak

Naast het aanroepen van bestelgegevens wanneer de succespagina wordt geactiveerd, raden we aan om een geplande oproep in te stellen voor alle bestellingen en hun details als een vangnet. Op deze manier kunt u alle voltooide bestellingen in het Zonos systeem ophalen die nog niet in uw systeem zijn geïmporteerd.

Dit proces moet een geplande taak/script zijn, zoals een Cron-taak, die eenmaal per uur/shift/dag/etc. wordt uitgevoerd (plan zo vaak als uw bedrijfsprocessen nodig achten). Het script moet alle bestellingen en hun details ophalen die zijn gebeurd sinds de laatste oproep voor bestellingen. De orderNumbers endpoint stelt u in staat om bestellingen sinceOrderId of sinceDate op te halen zoals gedemonstreerd op de API-test GUI die hier te vinden is. Alle bestellingen die via deze geplande oproep zijn opgehaald, moeten vervolgens worden vergeleken met de bestellingen die elke keer dat de succespagina werd geactiveerd in uw systeem zijn ingevoerd. Alle bestellingen die nog niet in uw systeem zijn, moeten in uw systeem worden ingevoerd en als legitieme bestellingen worden behandeld.

Initiële bestelstatus

IGLOBAL_ORDER_IN_PROCESS of IGLOBAL_FRAUD_REVIEW

Wanneer u de orderDetail endpoint aanroept, raden we aan dat uw systeem eerst de orderStatus eigenschap van de bestelgegevens controleert.

Bestellingen die geen fraudecontrole vereisen, worden geïnitialiseerd met orderStatus : IGLOBAL_ORDER_IN_PROCESS. Een bestelling in deze status is klaar om te worden verwerkt en verzonden.

Bestellingen die wel een fraudecontrole vereisen, worden geïnitialiseerd in orderStatus : IGLOBAL_FRAUD_REVIEW. Een bestelling in deze status wordt momenteel gescreend en beoordeeld op vermoedelijke fraude. We raden aan om deze bestelling in uw systeem op een beoordelings- of wachtstatus te plaatsen en de orderDetail endpoint te blijven aanroepen totdat de bestelling verder gaat dan het fraudecontroleproces van Zonos.

Zodra het fraude screeningproces van Zonos is voltooid, zal de bestelling naar een van de volgende staten gaan:

• Bestelling doorstaat fraude screening

  • De bestelling zal overgaan naar orderStatus : IGLOBAL_ORDER_IN_PROCESS en kan verder gaan naar verzending.

• Bestelling faalt voor fraude screening

  • De bestelling zal overgaan naar orderStatus : IGLOBAL_ORDER_CANCELLED en moet in uw systeem worden geannuleerd.

API-test GUI

Neem alstublieft contact op met de ondersteuning voor uw accountgegevens.