Hent en ordre

Dette "Hent en ordre" API-slutpunkt bruges til at hente data for en gennemført ordre inde i Zonos-systemet. Svaret vil indeholde et JSON-objekt, der repræsenterer alle tilgængelige oplysninger for ordren, herunder fakturerings- og forsendelsesadresser, forsendelsesmetode, ordretotaler og status.

Slutpunkter 

Ordrenumre

Henter en liste over ordrenumre.

Ordredetaljer

Henter detaljerede oplysninger til en ordre.

Brug af API-slutpunktet "Hent en ordre"

Der er to almindelige måder at bruge disse endepunkter på.

1. (Del 1 + Del 2) – Brug en tilpasset ordrebekræftelse/successide på dit domæne til at få dit system til at ringe til orderDetail slutpunkt og importere en gennemført ordre. Ring desuden jævnligt til orderNumbers slutpunkt for at afstemme eventuelle ordrer i Zonos-systemet, der ikke er importeret til dit system.
2. (Kun del 2) – Brug Zonos grundlæggende ordrebekræftelse/successide eller en statisk side på dit domæne for at indikere ordreafslutning til kunden. Planlæg dit system til regelmæssigt at ringe til orderNumbers slutpunkt for at bestemme, hvornår en ny ordre er klar til at blive importeret i dit system. Når en udestående ordre er fundet, ring til orderDetail endepunkt for dataene om disse ordrer.

Del 1: Successide på dit domæne

Hver gang en køber gennemfører en ordre i Zonos Checkout, bliver de straks omdirigeret til en ordresuccesside-URL. Det færdige ordre-id vil blive tilføjet til omdirigerings-URL'en som en forespørgselsstreng. URL'en på siden for ordresucces skal angives til Zonos. URL'en kan også sendes som en parameter i createTempCart endepunkt ved oprettelse af den midlertidige vogn i Zonos-systemet.

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

Når en kunde omdirigeres til denne side, skal dit system analysere værdien for orderId fra URL'en. Du vil derefter bruge orderId til at ringe til orderDetail slutpunkt for at hente ordredataene.

Del 2: Brug et planlagt job

Ud over at hente ordredetaljer, når successiden udløses, anbefaler vi, at du opretter et planlagt opkald for alle ordrer og deres detaljer som en opsamling. På denne måde kan du hente eventuelle afsluttede ordrer i Zonos-systemet, som endnu ikke er blevet importeret til dit system.

Denne proces skal være et planlagt job/script, såsom et Cron-job, kørt en gang i timen/skift/dag/osv. (planlæg så ofte som dine forretningsprocesser finder det nødvendigt). Scriptet skal hente alle ordrer og deres detaljer, der er opstået siden det sidste opkald efter ordrer. De orderNumbers slutpunkt giver dig mulighed for at hente ordrer sinceOrderId eller sinceDate som vist på API-test-GUI'en, der er placeret her. Alle de ordrer, der hentes gennem dette planlagte opkald, skal derefter afstemmes med de ordrer, der er indsat i dit system, hver gang successiden blev udløst. Alle ordrer, der ikke allerede er i dit system, skal indsættes i dit system og behandles som legitime ordrer.

Indledende ordrestatus

IGLOBAL_ORDER_IN_PROCESS eller IGLOBAL_FRAUD_REVIEW

Når du ringer til orderDetail slutpunkt, anbefaler vi, at dit system først tjekker orderStatus-egenskaben i ordredata.

Ordrer, der ikke kræver svindelgennemgang, initialiseres med orderStatus: IGLOBAL_ORDER_IN_PROCESS. En ordre i denne status er klar til at blive behandlet og afsendt.

Ordrer, der kræver svindelgennemgang, initialiseres i orderStatus: IGLOBAL_FRAUD_REVIEW. En ordre med denne status er i øjeblikket ved at blive screenet og gennemgået for mistanke om bedrageri. Vi anbefaler, at du placerer denne ordre på en gennemgang eller tilbageholdelsesstatus i dit system og fortsætter med at ringe til orderDetail slutpunkt, indtil ordren skrider frem forbi Zonos’ svindelgennemgangsproces.

Når Zonos' svindelscreeningsproces er afsluttet, flyttes ordren til en af følgende tilstande:

• Ordre passerer svindelscreening

  • Ordren vil flytte til orderStatus: IGLOBAL_ORDER_IN_PROCESS og kan fortsætte mod forsendelse.

• Ordre falder igennem svindelscreening

  • Ordren vil flytte til orderStatus: IGLOBAL_ORDER_CANCELLED og bør annulleres i dit system.

API test GUI

Venligst kontakt support for dine kontooplysninger.