DOCS

Opdater ordrestatus

Opdater ordrestatus

Lær, hvordan slutpunktet til at opdatere ordrestatus fungerer.

Dette updateVendorOrderStatus-slutpunkt bruges til at opdatere ordrestatussen for en ordre inde i Zonos-systemet. Dette vil blive brugt til programmæssigt at opdatere ordrens forsendelsesstatus eller til at anmode om en annullering.

Aktuelle ordrestatusværdier 

Nedenfor er en aktuel liste over ordrestatusser, som en ordre kan have.

Forsigtighed - Zonos kan tilføje flere statusser til enhver tid; dit system skal kunne rumme tilstedeværelsen af yderligere statusser.

Statusserne i produktionen forbliver i produktionen. Zonos vil aldrig fjerne eksisterende statusser.

StatusBeskrivelseIndstillelig af
IGLOBAL_FRAUD_REVIEWOrdren er i øjeblikket under svindelgennemgang af iGlobal.Zonos
IGLOBAL_ORDER_IN_PROCESSOrdren er gyldig og klar til behandling.Zonos
IGLOBAL_ORDER_ON_HOLDOrdren er i øjeblikket på et midlertidigt statushold.Zonos
IGLOBAL_ORDER_CANCELLEDOrdren er blevet annulleret i iGlobal-systemet.Zonos
VENDOR_PREPARING_ORDERSælgeren har markeret ordren under forberedelse.Sælger
VENDOR_SHIPMENT_READYSælgeren har markeret ordren klar til forsendelse.Sælger
VENDOR_LABELS_PRINTED_DATESælgeren har trykte forsendelsesetiketter.Sælger
VENDOR_CANCELLATION_REQUESTOrdren er blevet anmodet om annullering.Sælger
VENDOR_END_OF_DAY_COMPLETEOrdren er afsluttet og fuldført.Sælger

vendorOrderStatuskan ikke opdateres af sælgeren, mens ordren er i en af følgende ordrestatusser:

IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE

HTTPS-anmodning

POST |https://api.iglobalstores.com/v1/updateVendorOrderStatus

FeltVærdi
HTTP-metodePOST
Endpoint URLhttps://api.iglobalstores.com/v1/updateVendorOrderStatus
ProtokolHTTPS
MeddelelsesformatJSON
Accept HTTP-headerAccept: application/json
Content-Type HTTP-headerContent-Type: application/json

JSON-nøgle/værdi-par i anmodningens brødtekst

Meddelelsesformat: JSON

1{
2 "store": "999",
3 "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
4 "orderId": "999-9999",
5 "orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
6}

JSON-definitioner for anmodningen

FeltNoter
orderIdPÅKRÆVETZonos-ordre-id'et kan videregives med eller uden dit butiks-id og bindestreg (eksempel: 123-45678 eller 45678). Efter ordreafslutning og betaling vil kunden blive omdirigeret til en ordreafslutnings-/ordre-takkeside, der er hostet på dit domæne. URL'en vil indeholde en querystring-parameterorderIDder vil indeholde denne værdi.integer / string
orderStatusPÅKRÆVETDette felt bruges til at opdatere Zonos-systemet med den nye status for en ordre. Følgende ordrestatusser kan indstilles via denne API.-VENDOR_PREPARING_ORDER

-VENDOR_SHIPMENT_READY -VENDOR_LABELS_PRINTED -VENDOR_END_OF_DAY_COMPLETE -VENDOR_CANCELLATION_REQUEST``string| |secretPÅKRÆVET | API hemmelig GUID leveret af Zonos.string| |storePÅKRÆVET | Butiks-id leveret af Zonosinteger|

HTTPS-svar

Meddelelsesformat: JSON

1{
2 "success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"
3}

Fejl i HTTP-svar

HTTP-svarkoderEksempel/beskrivelse på svartekst
406 - Ikke acceptabeltHTML-enhed. HTTP "Accept"-headeren er ugyldig.
415 - Ikke-understøttet medietypeHTML-enhed. HTTP "Content-Type" header er ugyldig.
200"error": "kunne ikke parse input"
200"error":"Parameter orderId påkrævet for at opdatereVendorOrderStatus"
200"error": "Parameterordrestatus påkrævet for at opdatereVendorOrderStatus."
200"error":"orderId: 999-99999 er ikke et gyldigt orderId"
200"error":"Kunne ikke hente ordre for at opdatereVendorOrderStatus fra orderId: 999-99999"
200"error":"OrderId: 999-99999 er allerede blevet annulleret, og status kan ikke opdateres."
200"error":"Kan ikke opdatere ordrestatus til status: VENDOR_CANCELLATION_REQUEST"
200"error":"Kan ikke opdatere ordrestatus til ugyldig status: NEW_ORDER_STATUS"
200"error":"OrderId: 999-99999 har allerede aktuel status: VENDOR_SHIPMENT_READY"
200"error":"OrderId: 999-99999 kan ikke flyttes til ordrestatus: VENDOR_CANCELLATION_REQUEST i status: VENDOR_END_OF_DAY_COMPLETE"
200"error":"Ny status: NEW_ORDER_STATUS er ikke en gyldig ordrestatus"
200"error":"Kunne ikke behandle updateVendorOrderStatus."
200"error":"Ugyldige sikkerhedsoplysninger"

Svar JSON definitioner

BeskedDefinition
successDenne parameter vil indeholde en oversigt over opdateringen.string
errorDenne parameter vil kun være til stede i svaret, når der er opstået en fejl, og vil indeholde en beskrivelse af årsagen.string
Book en demo

Var denne side nyttig?