Hent en ordre

Dette “Hent en ordre” API-endepunkt bruges til at hente data for en gennemført ordre inden for Zonos-systemet. Svaret vil indeholde et JSON-objekt, der repræsenterer alle tilgængelige oplysninger for ordren, herunder fakturerings- og leveringsadresser, leveringsmetode, ordrebeløb og status.

Endepunkter 

Ordrenumre

Henter en liste over ordrenumre.

Ordredetaljer

Henter detaljerede oplysninger for en ordre.

Brug af API-endepunktet til at hente en ordre

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

1. (Del 1 + Del 2) – Brug en tilpasset ordrebekræftelses-/succes-side på dit domæne til at få dit system til at kalde orderDetail-endepunktet og importere en gennemført ordre. Derudover skal du regelmæssigt kalde orderNumbers-endepunktet for at afstemme eventuelle ordrer i Zonos-systemet, der ikke er importeret til dit system.
2. (Del 2 Kun) – Brug Zonos's grundlæggende ordrebekræftelses-/succes-side eller en statisk side på dit domæne til at angive ordregennemførelse til kunden. Planlæg dit system til regelmæssigt at kalde orderNumbers-endepunktet for at bestemme, hvornår en ny ordre er klar til at blive importeret i dit system. Når en udestående ordre findes, skal du kalde orderDetail-endepunktet for data om disse ordrer.

Del 1: Succes-side på dit domæne

Hver gang en køber gennemfører en ordre i Zonos Checkout, bliver de straks omdirigeret til en ordresucces-side URL. Den gennemførte ordre-ID vil blive tilføjet til omdirigerings-URL'en som en forespørgselsstreng. URL'en til ordresucces-siden skal gives til Zonos. URL'en kan også sendes som en parameter i createTempCart-endepunktet, når den midlertidige kurv oprettes i Zonos-systemet.

Eksempel: 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 kalde orderDetail-endepunktet for at hente ordredataene.

Del 2: Brug et planlagt job

Ud over at kalde for ordredetaljer, når succespagen aktiveres, anbefaler vi, at du opsætter et planlagt kald for alle ordrer og deres detaljer som en catch-all. På denne måde kan du hente eventuelle gennemførte ordrer i Zonos-systemet, der endnu ikke er importeret til dit system.

Denne proces bør være et planlagt job/script, såsom et Cron-job, der køres en gang i timen/skift/dag/etc. (planlæg så ofte som dine forretningsprocesser anser for nødvendigt). Scriptet skal kalde for alle ordrer og deres detaljer, der er sket siden det sidste kald for ordrer. orderNumbers-endepunktet giver dig mulighed for at hente ordrer sinceOrderId eller sinceDate, som demonstreret på API-test GUI'en, der findes her. Alle ordrer, der hentes gennem dette planlagte kald, skal derefter afstemmes mod de ordrer, der er indsat i dit system, hver gang succespagen blev aktiveret. Eventuelle 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 kalder orderDetail-endepunktet, anbefaler vi, at dit system først tjekker orderStatus-egenskaben for ordredataene.

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

Ordrer, der kræver svindelgennemgang, vil initialisere i orderStatus : IGLOBAL_FRAUD_REVIEW. En ordre i denne status er i øjeblikket under screening og gennemgang for mistænkt svindel. Vi anbefaler, at du placerer denne ordre i en gennemgangs- eller holdstatus i dit system og fortsætter med at kalde orderDetail-endepunktet, indtil ordren skrider frem forbi Zonos’ svindelgennemgangsproces.

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

• Ordren består svindelscreening

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

• Ordren består ikke 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.