Vad är `tempCartUUID`?

Denna parameter innehåller ett GUID som tilldelas kundens internationella kundvagn och skapas i Zonos-systemet. Fältet anges via en URL-frågeparameter av typen `string` när användarens webbläsare omdirigeras till Zonos Checkout.

Vilka är URL-begärandeparametrarna?

`tempCartUUID` är ett obligatoriskt värde som hämtas genom att anropa API-tjänstslutpunkten Zonos `createTempCart`. `country` är destinationslandets tvåsiffriga ISO-kod. Vi rekommenderar starkt att ni anger parametern för användarupplevelsen. Parametern `country` förväljer destinationslandet i Zonos Checkout.

Checkout•

HemAPI-referens Checkout REST API Skapa en checkout

Skapa en checkout

Q: Hur omdirigerar ni till Zonos Checkout?

Efter att ni har fått ett lyckat svar som innehåller `tempCartUUID` skickar er server en omdirigering från kundens webbläsare till Zonos Checkout med lämpliga URL-frågesträngsparametrar.

Utforska nyckel/värde-paren som används för att skapa en checkout.

Denna API-slutpunkt används för att skicka kundvagnsinformation och artiklar från kundens kundvagn till Zonos API.

Ni får ett JSON-svar som innehåller tempCartUUID, en unik kundvagnsidentifierare i Zonos System. Den används för att omdirigera kunden till Zonos Checkout för att slutföra beställningen.

Attribut

JSON-nyckel/värde-par i begärandetexten

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

fält↕	anmärkningar↕
`boxCount`	Exempelvärde: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Kommaseparerad lista över kartongdimensioner och antal. I exemplet ovan finns totalt 4 kartonger. Den första kartongen i listan är 22 tum lång, 15 tum bred och 15 tum hög. Endast en kartong används för den storleken. Det finns två kartonger med storleken 8x8x4 tum. Ni kan ange samma kartongdimension flera gånger om det är enklare för er, till exempel: ”22x15x15(1),22x15x15(1)”, vilket innebär 2 kartonger med storleken 22x15x15 tum. Fältet beskriver de kartonger som används för att skicka beställningen. En handlare förväntas inte känna till detta vid beställningstillfället, men om informationen är känd kan den anges i `string`-format.
`contShoppingURL`	Fältet används för att ange en URL som åsidosätter HREF:en för knappen ”Continue Shopping” i Zonos Checkout. `string`
`domesticShippingCharge`	Fältet används för att ange en inrikes fraktavgift till Zonos Checkout, och beloppet läggs till frakten. Det kan konfigureras för att läggas till i den totala fraktkostnaden eller visas som en separat radartikel. `positive floating point, two decimal places`
`externalConfirmationPageURL`	Fältet används för att ange URL:en till er orderbekräftelse- eller tacksida. När kunden har slutfört betalningen i Zonos Checkout omdirigeras kunden till denna URL för orderbekräftelse. URL:en används ofta för att anropa API-tjänstslutpunkten Zonos ”orderDetail” för att hämta orderinformationen och importera ordern till systemet. `string`
`footerHTML`	Fältet används för att ange en URL-kodad HTML-sträng. HTML-strängen avkodas och placeras före den avslutande body-taggen på checkout-sidan. Används ofta för kod för remarketing, analys osv. `URL encoded string`
`items` REQUIRED	Fältet är en lista över artikelmappningar. `JSON string`
`items[index].countryOfOrigin`	Fältet används för att ange artikelns ursprungsland. Parametern måste vara landets tvåsiffriga ISO-kod. `string`
`items[index].description` REQUIRED	Fältet används för att ange en fullständig artikelbeskrivning för kundvagnsraden, inklusive artikelalternativ, färger osv. `string`
`items[index].height`	Fältet används för att ange artikelns höjd och rekommenderas starkt för korrekta fraktofferter. Höjdenheten är REQUIRED i tum. `string - positive floating point, two decimal places / integer (inches)`
`items[index].imageURL` REQUIRED	Fältet används för att ange URL:en till artikelns produktbild. URL:en måste vara HTTPS för att visas i Zonos Checkout. `string / HTTPS URL`
`items[index]itemBrand`	Fältet används för att ange artikelns varumärke. `string`
`items[index]itemCategory`	Fältet används för att ange artikelns kategori och kan anges med pipe-avgränsning om artikeln har fler än en kategori. Exempelvärden: ”shoes” eller ”shoes\|sport-shoes\|discount-shoes”`string`
`items[index]itemCustomization`	Fältet används för att ange ytterligare information om artikeln som inte visas i Zonos Checkout. Informationen kan dock hämtas via API-tjänstslutpunkten ”orderDetail”.
`items[index]itemHSCode`	Fältet används för att ange artikelns HS-kod, med eller utan punkter. Exempelvärden: ”3926901000” eller ”3926.90.1000”`string`
`items[index].itemURL`	Fältet används för att ange URL:en till artikelns produktsida. `string / URL`
`items[index].length`	Fältet används för att ange artikelns längd och rekommenderas starkt för korrekta fraktofferter. Längdenheten är REQUIRED i tum. `string - positive floating point, two decimal places / integer (inches)`
`items[index].nonShippable`	Fältet anger om artikeln ska ingå i beräkningarna av frakt, tull och skatt. Digitala nedladdningar, rabattkoder, hanteringsavgifter osv. ska anges med värdet ”true”. `boolean: true or false`
`items[index].productId`	Fältet används för att ange kundvagnsradens antal. `string`
`items[index].quantity` REQUIRED	Fältet används för att ange kundvagnsradens antal. `string`
`items[index].sku`	Fältet används för att ange artikelns SKU / UPC / osv. `string`
`items[index].unitPrice` REQUIRED	Fältet används för att ange kundvagnsradens enhetspris. `positive floating point, two decimal places / integer`
`items[index].weight`	Fältet används för att ange artikelns vikt och rekommenderas starkt för korrekta fraktofferter. Viktenheten är som standard ”LBS” om inte en annan viktenhet anges i items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
`items[index].weightUnits`	Fältet används för att åsidosätta standardenheten för artikelvikt. Artikelviktens enhet är som standard ”LBS” om inte en annan viktenhet anges i detta fält. `string - "LB", "OZ", "KG", or "G”`
`items[index].width`	Fältet används för att ange artikelns bredd och rekommenderas starkt för korrekta fraktofferter. Breddenheten är REQUIRED i tum. `string - positive floating point, two decimal places / integer (inches)`
`misc1 - misc6`	Fältet används för att ange diverse data kopplade till ordern via Zonos API, som hämtas tillsammans med orderdata från API-tjänstslutpunkten Zonos ”orderDetail”. `string`
`referenceId`	Fältet används för att ange ett unikt referensidentifieringsvärde för kundvagnen/sessionen osv. i ert system. Det kan användas för att slå upp Zonos order-ID via API-tjänstslutpunkten Zonos ”orderDetail”. `string`
`storeId` REQUIRED	Butiks-ID som tillhandahålls av Zonos. `integer`

Ytterligare string-datatyper

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

Rabatter, kuponger och kampanjkoder

För att skicka rabatter, kuponger och kampanjkoder till Zonos via serverposten måste de anges som en separat artikel med ett negativt värde för parametrarna: “unitPrice” och “nonShippable”:true.

1{

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

3 "unitPrice": -15.5,

4 "quantity": 1,

5 "nonShippable": true

6}

HTTPS-svar

Lyckat HTTP-svar

Meddelandeformat: JSON

1{

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

3}

Definitioner för svars-JSON

fält↕	anmärkningar↕
`tempCartUUID`	Parametern innehåller ett GUID som tilldelas kundens internationella kundvagn och skapas i Zonos-systemet. Fältet anges via en URL-frågeparameter av typen `string` när användarens webbläsare omdirigeras till Zonos Checkout.

HTTP-felsvar

Felkod↕	betydelse↕
400	Oväntet tecken i begärandetexten.
406	Ej godtagbar. HTTP-rubriken för ”Accept” är ogiltig.
415	Medietypen stöds inte. HTTP-rubriken för ”Content-Type” är ogiltig.
422	Kan inte bearbetas.
500	”storeId” var felaktigt eller JSON-texten kunde inte tolkas.

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 till Zonos Checkout

Efter att ni har fått ett lyckat svar som innehåller tempCartUUID skickar er server en omdirigering från kundens webbläsare till Zonos Checkout med lämpliga URL-frågesträngsparametrar enligt nedan.

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

Obs!: [yourassignedsubdomain] – Kontakta er kontaktperson i Zonos implementeringsteam för att få er Zonos.com-underdomän.

URL-begärandeparametrar

fält↕	anmärkningar↕
`tempCartUUID` REQUIRED	Värdet hämtas genom att anropa API-tjänstslutpunkten Zonos `createTempCart`. `string / GUID`
`country`	Destinationslandets tvåsiffriga ISO-kod. Vi rekommenderar starkt att ni anger parametern för användarupplevelsen. Parametern `country` förväljer destinationslandet i Zonos Checkout. När ni använder Zonos Hello JS (JavaScript) på webbplatsen kan ni hämta värdet genom att anropa JavaScript-metoden: `zonos.country()`. `string` (Length: 2)

Ytterligare string-datatyper

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Boka en demo

Skapa en checkout

Attribut

JSON-nyckel/värde-par i begärandetexten

Ytterligare string-datatyper

Rabatter, kuponger och kampanjkoder

HTTPS-svar

Definitioner för svars-JSON

HTTP-felsvar

HTTP ERROR 422

The request entity had the following errors:

Omdirigering till Zonos Checkout

URL-begärandeparametrar

Ytterligare string-datatyper

Var den här sidan till hjälp?