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 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 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 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].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[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": true6
}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 | Not Acceptable. HTTP-rubriken för ”Accept” är ogiltig. |
| 415 | Unsupported media type. HTTP-rubriken för ”Content-Type” är ogiltig. |
| 422 | Unprocessable entity. |
| 500 | ”storeId” var felaktigt eller JSON-texten kunde inte tolkas. |
1
2
3
4
5
6
7
Error 422 Unprocessable Entity 8
9
10
11
12
13
HTTP ERROR 422
14
15
16
Problem accessing /v2/createTempCart. Reason:17
Unprocessable Entity
18
19
20
21
The request entity had the following errors:
22
23
24
25
items may not be empty (was null) 26
27
items may not be null (was null) 28
29
30
31
32
33
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
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZip
Skapa en checkout
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.