Hvad er `tempCartUUID`?

Denne parameter indeholder en GUID, der er tildelt kundens internationale kurv og oprettet i Zonos-systemet. Denne værdi sendes via en URL-query `string`-parameter, når brugerens browser omdirigeres til Zonos Checkout.

Hvad er URL-requestparametrene?

`tempCartUUID` er en påkrævet værdi, der hentes ved at kalde Zonos `createTempCart` API service endpoint. `country` er destinationslandets to-bogstavs ISO-kode. Vi anbefaler stærkt at sende denne parameter for brugeroplevelsen. `country`-parameteren forudvælger destinationslandet i Zonos Checkout.

Checkout•

HjemAPI reference Checkout REST API Opret en checkout

Opret en checkout

Q: Hvordan omdirigerer man til Zonos Checkout?

Efter at have modtaget et succesfuldt svar, der indeholder `tempCartUUID`, sender din server en omdirigering fra kundens browser til Zonos Checkout med de relevante URL-query string-parametre.

Udforsk nøgle/værdi-parne, der er involveret i oprettelse af en checkout.

Dette API-endpoint bruges til at sende kurvoplysninger og varer fra kundens kurv til Zonos API.

Du modtager et JSON-svar, der indeholder en tempCartUUID, en unik kurvidentifikator i Zonos-systemet. Denne bruges til at omdirigere kunden til Zonos Checkout for at gennemføre ordren.

Attributter

JSON-nøgle/værdi-par i request body

POST https://api.iglobalstores.com/v1/createTempCart

felt↕	noter↕
`boxCount`	Eksempelværdi: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Kommasepareret liste over kassestørrelser og antal. I eksemplet ovenfor er der i alt 4 kasser. Den første kasse på listen er 22 tommer lang, 15 tommer bred og 15 tommer høj. Der bruges kun én kasse i den størrelse. Der vil være to kasser i størrelsen: 8x8x4 tommer. Det er acceptabelt at sende samme kassestørrelse flere gange, hvis det er nemmere for dig, f.eks.: "22x15x15(1),22x15x15(1)", hvilket betyder 2 kasser i størrelsen: 22x15x15 tommer. Dette felt beskriver de kasser, der bruges til at sende ordren. Det forventes ikke, at en merchant kender dette på ordretidspunktet; hvis det er kendt, kan det dog sendes i `string`-format.
`contShoppingURL`	Dette felt bruges til at sende en URL, der tilsidesætter HREF for knappen "Continue Shopping" i Zonos Checkout. `string`
`domesticShippingCharge`	Dette felt bruges til at sende et indenlandsk forsendelsesgebyr til Zonos Checkout, og beløbet tilføjes til forsendelsen. Dette kan konfigureres til at tilføje forsendelsestotalen eller opdeles som en separat linjepost. `positive floating point, two decimal places`
`externalConfirmationPageURL`	Dette felt bruges til at sende en URL til din ordrebekræftelses-/tak-side. Når en kunde gennemfører betaling i Zonos Checkout, omdirigeres de til denne URL for ordrebekræftelse. Denne URL bruges ofte til at udløse et kald til Zonos "orderDetail" API service endpoint for at hente ordredetaljerne og importere ordren i systemet. `string`
`footerHTML`	Dette felt bruges til at sende en URL-kodet HTML-streng. Denne HTML-streng dekodes og placeres før det afsluttende body-tag på checkout-siden. Bruges almindeligvis til at sende kode til remarketing, analytics osv. `URL encoded string`
`items` REQUIRED	Dette felt er en liste over item maps. `JSON string`
`items[index].countryOfOrigin`	Dette felt bruges til at sende varens oprindelsesland. Parameteren skal være landets to-bogstavs ISO-kode. `string`
`items[index].description` REQUIRED	Dette felt bruges til at sende en fuld varebeskrivelse af kurvlinjen, inklusive eventuelle varevalg, farver osv. `string`
`items[index].height`	Dette felt bruges til at sende varens højde og anbefales stærkt for præcise forsendelsestilbud. Højdeenheder er REQUIRED i tommer. `string - positive floating point, two decimal places / integer (inches)`
`items[index].imageURL` REQUIRED	Dette felt bruges til at sende URL'en til varens produktbillede. URL'en skal være HTTPS for at blive vist i Zonos Checkout. `string / HTTPS URL`
`items[index]itemBrand`	Dette felt bruges til at sende varemærket`string`
`items[index]itemCategory`	Dette felt bruges til at sende varekategorien og kan sendes pipe-separeret, hvis varen har mere end én kategori. Eksempelværdier: "shoes" eller "shoes\|sport-shoes\|discount-shoes"`string`
`items[index]itemCustomization`	Dette felt bruges til at sende yderligere oplysninger om varen, der ikke vises i Zonos Checkout; disse kan dog hentes via "orderDetail" API service endpoint.
`items[index]itemHSCode`	Dette felt bruges til at sende varens HS-kode og kan være med eller uden punktummer. Eksempelværdier: "3926901000" eller "3926.90.1000"`string`
`items[index].itemURL`	Dette felt bruges til at sende URL'en til varens produktside. `string / URL`
`items[index].length`	Dette felt bruges til at sende varens længde og anbefales stærkt for præcise forsendelsestilbud. Længdeenheder er REQUIRED i tommer. `string - positive floating point, two decimal places / integer (inches)`
`items[index].nonShippable`	Dette felt bruges til at angive, om varen skal inkluderes i forsendelses-, told- og skatteberegninger. Digitale downloads, rabatkoder, håndteringsgebyrer osv. skal sendes med værdien "true". `boolean: true or false`
`items[index].productId`	Dette felt bruges til at sende linjevaremængden. `string`
`items[index].quantity` REQUIRED	Dette felt bruges til at sende linjevaremængden. `string`
`items[index].sku`	Dette felt bruges til at sende varens SKU / UPC / osv. `string`
`items[index].unitPrice` REQUIRED	Dette felt bruges til at sende linjevarens enhedspris. `positive floating point, two decimal places / integer`
`items[index].weight`	Dette felt bruges til at sende varens vægt og anbefales stærkt for præcise forsendelsestilbud. Vægtenheder er som standard "LBS", medmindre en anden vægtenhed sendes i items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
`items[index].weightUnits`	Dette felt bruges til at tilsidesætte standard vægtenheder for varen. Vægtenheder for varer er som standard "LBS", medmindre en anden vægtenhed sendes i dette felt. `string - "LB", "OZ", "KG", or "G"`
`items[index].width`	Dette felt bruges til at sende varens bredde og anbefales stærkt for præcise forsendelsestilbud. Breddeenheder er REQUIRED i tommer. `string - positive floating point, two decimal places / integer (inches)`
`misc1 - misc6`	Dette felt bruges til at sende diverse data knyttet til ordren gennem Zonos API, som kan hentes sammen med ordredata returneret fra Zonos "orderDetail" API service endpoint. `string`
`referenceId`	Dette felt bruges til at sende en unik referenceidentifikationsværdi for kurven/sessionen/osv. i dit system. Dette kan bruges til at slå Zonos ordre-ID op via Zonos "orderDetail" API service endpoint. `string`
`storeId` REQUIRED	Store ID leveret af Zonos. `integer`

Yderligere string-datatyper

items[index].itemDescriptionLong
items[index].itemDescriptionDetailed
items[index].itemFabricContent
items[index].itemColor
items[index].itemLtlClass
items[index].status
items[index].itemMaterial

Rabatter, kuponer og promokoder

For at sende rabatter, kuponer og promokoder til Zonos via server post skal de sendes som en separat vare med en negativ værdi for parametrene: "unitPrice" og "nonShippable":true.

1{

2 "description": "Discount (10OFF) - 10% OFF",

3 "unitPrice": -15.5,

4 "quantity": 1,

5 "nonShippable": true

6}

HTTPS-svar

Succesfuldt HTTP-svar

Meddelelsesformat: JSON

1{

2 "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"

3}

Definitioner af response JSON

felt↕	noter↕
`tempCartUUID`	Denne parameter indeholder en GUID, der er tildelt kundens internationale kurv og oprettet i Zonos-systemet. Denne værdi sendes via en URL-query `string`-parameter, når brugerens browser omdirigeres til Zonos Checkout.

Fejl-HTTP-svar

Fejlkode↕	betydning↕
400	Uventet tegn i request body.
406	Not Acceptable. HTTP-header for "Accept" er ugyldig.
415	Unsupported media type. HTTP-header for "Content-Type" er ugyldig.
422	Unprocessable entity.
500	"storeId" var forkert, eller JSON body kunne ikke parses.

7Error 422 Unprocessable Entity

13HTTP ERROR 422

16 Problem accessing /v2/createTempCart. Reason:

17 Unprocessable Entity

21The request entity had the following errors:

25items may not be empty (was null)

27items may not be null (was null)

Omdirigering til Zonos Checkout

Efter at have modtaget et succesfuldt svar, der indeholder tempCartUUID, sender din server en omdirigering fra kundens browser til Zonos Checkout med de relevante URL-query string-parametre beskrevet nedenfor.

Eksempel på omdirigerings-URL: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

Note: [yourassignedsubdomain] - Kontakt dit Zonos-implementeringsteammedlem for at modtage dit Zonos.com-subdomæne.

URL-requestparametre

felt↕	noter↕
`tempCartUUID` REQUIRED	Denne værdi hentes ved at kalde Zonos `createTempCart` API service endpoint. `string / GUID`
`country`	Destinationslandets to-bogstavs ISO-kode. Vi anbefaler stærkt at sende denne parameter for brugeroplevelsen. `country`-parameteren forudvælger destinationslandet i Zonos Checkout. Når du bruger Zonos Hello JS (JavaScript) på sitet, kan du hente denne værdi ved at kalde JavaScript-metoden: `zonos.country()`. `string` (Length: 2)

Yderligere string-datatyper

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Book en demo

Opret en checkout

Attributter

JSON-nøgle/værdi-par i request body

Yderligere string-datatyper

Rabatter, kuponer og promokoder

HTTPS-svar

Definitioner af response JSON

Fejl-HTTP-svar

HTTP ERROR 422

The request entity had the following errors:

Omdirigering til Zonos Checkout

URL-requestparametre

Yderligere string-datatyper

Var denne side nyttig?