`tempCartUUID` nedir?

Bu parametre müşterinizin uluslararası sepetine atanan bir GUID içerecek ve Zonos sisteminde oluşturulacaktır. Bu dosya, kullanıcı tarayıcısı Zonos Checkout'a yönlendirilirken URL sorgusu `string` parametresi aracılığıyla geçirilecektir.

Zonos Checkout'a nasıl yönlendirilir?

`tempCartUUID`'i içeren başarılı bir yanıt aldıktan sonra, sunucunuz müşterinin tarayıcısından uygun URL sorgusu dize parametreleriyle Zonos Checkout'a bir yeniden yönlendirme gönderecektir.

URL istek parametreleri nelerdir?

`tempCartUUID` Zonos `createTempCart` API hizmeti uç noktası çağrılarak elde edilen gerekli bir değerdir. `country` hedef ülkenin iki harfli ISO kodudur. Kullanıcı deneyimi için bu parametreyi geçmenizi şiddetle tavsiye ederiz. `country` parametresi Zonos Checkout içindeki hedef ülkeyi önceden seçecektir.

Checkout•

Ana sayfaAPI referansı Checkout REST API Checkout oluşturma

Checkout oluşturma

Checkout oluşturmada yer alan anahtar/değer çiftlerini keşfedin.

Bu API uç noktası, müşterinin sepetinden sepet bilgilerini ve öğeleri Zonos API'sına göndermek için kullanılır.

tempCartUUID içeren bir JSON yanıtı alacaksınız; Zonos Sistemi'nde benzersiz bir sepet tanımlayıcısı. Bu, müşteri siparişi tamamlamak için Zonos Checkout'a yönlendirilecektir.

Öznitelikler

İstek gövdesindeki JSON anahtar/değer çiftleri

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

field↕	notes↕
`boxCount`	Örnek değer: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Kutu boyutları ve sayının virgülle ayrılmış listesi. Yukarıdaki örnekte toplam 4 kutu vardır. Listedeki ilk kutu 22 inç uzunluğunda, 15 inç genişliğinde, 15 inç yüksekliğinde olacaktır. Bu boyut için yalnızca bir kutu kullanılacaktır. 8x8x4 inç boyutunda iki kutu olacaktır. Sizin için kolay olması durumunda aynı kutu boyutunu birden çok kez geçmek kabul edilebilir, şöyle: "22x15x15(1),22x15x15(1)", bu da 22x15x15 inç boyutunda 2 kutunun olduğu anlamına gelir. Bu alan, siparişi göndermek için kullanılacak kutuları açıklar. Bir tüccarın sipariş zamanında bunu bilmesi beklenmez; ancak biliniyorsa, `string` biçiminde geçirilebilir.
`contShoppingURL`	Bu alan, Zonos Checkout içindeki "Alışverişe Devam" düğmesinin HREF'ini geçersiz kılmak için bir URL'yi geçmek için kullanılır. `string`
`domesticShippingCharge`	Bu alan, Zonos Checkout'a yurtiçi kargo ücreti geçmek için kullanılır ve tutar kargoya eklenecektir. Bunu kargo toplamını eklemek için yapılandırabilir veya ayrı bir satır öğesi olarak bölümlendirilebilir. `positive floating point, two decimal places`
`externalConfirmationPageURL`	Bu alan, sipariş onayı / teşekkür sayfanızın URL'sini geçmek için kullanılır. Müşteri Zonos Checkout içinde ödeme tamamladıktan sonra, sipariş onayı için bu URL'ye yönlendirilecektir. Bu URL, sipariş ayrıntısını almak ve siparişi sisteme aktarmak için Zonos "orderDetail" API hizmeti uç noktasına bir çağrı tetiklemek için sıklıkla kullanılır. `string`
`footerHTML`	Bu alan, URL kodlamalı bir HTML dizesi geçmek için kullanılır. Bu HTML dizesi çözülecek ve kasa sayfasındaki kapanış gövde etiketinden önce yerleştirilecektir. Genellikle yeniden pazarlama, analitik vb. için kod geçmek için kullanılır. `URL encoded string`
`items` REQUIRED	Bu alan, öğe haritalarının bir listesidir. `JSON string`
`items[index].countryOfOrigin`	Bu alan, öğenin menşei ülkesini geçmek için kullanılır. Parametre ülke iki harfli ISO kodu olmalıdır. `string`
`items[index].description` REQUIRED	Bu alan, herhangi bir öğe seçeneği, rengi vb. dahil olmak üzere sepet satırı öğesinin tam açıklamasını geçmek için kullanılır. `string`
`items[index].height`	Bu alan, öğe yüksekliğini geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Yükseklik birimleri REQUIRED inç cinsinden. `string - positive floating point, two decimal places / integer (inches)`
`items[index].imageURL` REQUIRED	Bu alan, öğe ürün görüntüsüne URL'yi geçmek için kullanılır. URL, Zonos Checkout içinde görüntülemek için HTTPS olmalıdır. `string / HTTPS URL`
`items[index]itemBrand`	Bu alan, öğe markasını geçmek için kullanılır. `string`
`items[index]itemCategory`	Bu alan, öğe kategorisini geçmek için kullanılır ve öğenin birden fazla kategorisi varsa boru sınırlandırılmış geçirilebilir. Örnek değerler: "ayakkabılar" veya "ayakkabılar\|spor-ayakkabılar\|indirimli-ayakkabılar"`string`
`items[index]itemCustomization`	Bu alan, Zonos Checkout'ta gösterilmeyen öğe hakkında ek ayrıntılar geçmek için kullanılır; ancak bu, "orderDetail" API hizmeti uç noktası aracılığıyla alınabilir.
`items[index]itemHSCode`	Bu alan, öğe HS kodunu geçmek için kullanılır ve nokta ile veya nokta olmadan olabilir. Örnek değerler: "3926901000" veya "3926.90.1000"`string`
`items[index].itemURL`	Bu alan, öğe ürün sayfasına URL'yi geçmek için kullanılır. `string / URL`
`items[index].length`	Bu alan, öğe uzunluğunu geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Uzunluk birimleri REQUIRED inç cinsinden. `string - positive floating point, two decimal places / integer (inches)`
`items[index].nonShippable`	Bu alan, öğenin kargo, vergi ve vergi hesaplamalarına dahil edilip edilmeyeceğini belirtmek için kullanılır. Dijital indirmeler, indirim kodları, işlem ücretleri vb. "true" değeriyle geçirilmelidir. `boolean: true or false`
`items[index].productId`	Bu alan, satır öğesi miktarını geçmek için kullanılır. `string`
`items[index].quantity` REQUIRED	Bu alan, satır öğesi miktarını geçmek için kullanılır. `string`
`items[index].sku`	Bu alan, öğe SKU / UPC / vb. geçmek için kullanılır. `string`
`items[index].unitPrice` REQUIRED	Bu alan, satır öğesi birim fiyatını geçmek için kullanılır. `positive floating point, two decimal places / integer`
`items[index].weight`	Bu alan, öğe ağırlığını geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Ağırlık birimleri, `items[index].itemWeightUnits`da başka bir ağırlık birimi geçilmedikçe varsayılan olarak "LBS"dir `string - positive floating point, two decimal places / integer`
`items[index].weightUnits`	Bu alan, varsayılan öğe ağırlığı birimlerini geçersiz kılmak için kullanılır. Öğe ağırlığı birimleri "LBS" olarak varsayılan olarak ayarlanır; bu alan içinde başka bir ağırlık birimi geçilmedikçe. `string - "LB", "OZ", "KG", or "G"`
`items[index].width`	Bu alan, öğe genişliğini geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Genişlik birimleri REQUIRED inç cinsinden. `string - positive floating point, two decimal places / integer (inches)`
`misc1 - misc6`	Bu alan, Zonos API aracılığıyla siparişle ilişkili çeşitli verileri geçmek için kullanılır ve Zonos "orderDetail" API hizmeti uç noktasından döndürülen sipariş verileriyle birlikte alınacaktır. `string`
`referenceId`	Bu alan, sisteminizde sepet/oturum/vb. için benzersiz bir referans kimlik değeri geçmek için kullanılır. Bu, Zonos "orderDetail" API hizmeti uç noktası aracılığıyla Zonos sipariş kimliğini aramak için kullanılabilir. `string`
`storeId` REQUIRED	Zonos tarafından sağlanan mağaza kimliği. `integer`

Ek dize veri türleri

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

İndirimler, kuponlar ve promosyon kodları

İndirimler, kuponlar ve promosyon kodlarını sunucu POST aracılığıyla Zonos'a göndermek için, bunları aşağıdaki parametreler için negatif bir değer içeren ayrı bir öğe olarak geçirilmelidir: "unitPrice" ve "nonShippable":true.

1{

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

3 "unitPrice": -15.5,

4 "quantity": 1,

5 "nonShippable": true

6}

HTTPS yanıtı

Başarılı HTTP yanıtı

İleti biçimi: JSON

1{

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

3}

Yanıt JSON tanımları

field↕	notes↕
`tempCartUUID`	Bu parametre müşterinizin uluslararası sepetine atanan bir GUID içerecek ve Zonos sisteminde oluşturulacaktır. Bu dosya, kullanıcı tarayıcısı Zonos Checkout'a yönlendirilirken URL sorgusu `string` parametresi aracılığıyla geçirilecektir.

Hata HTTP yanıtları

Error code↕	meaning↕
400	İstek gövdesinde beklenmeyen karakter.
406	Kabul edilemez. "Accept" için HTTP başlığı geçersiz.
415	Desteklenmeyen medya türü. "Content-Type" için HTTP başlığı geçersiz.
422	İşlenemeyen varlık.
500	"storeId" yanlış veya JSON gövdesi ayrıştırılamadı.

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)

Zonos Checkout'a Yönlendirme

tempCartUUID'i içeren başarılı bir yanıt aldıktan sonra, sunucunuz müşterinin tarayıcısından aşağıda kapsanan uygun URL sorgusu dize parametreleriyle Zonos Checkout'a bir yeniden yönlendirme gönderecektir.

Örnek Yönlendirme URL'si: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

Not: [yourassignedsubdomain] - Zonos.com alt etki alanınızı almak için Zonos uygulama takımı üyesi ile iletişime geçin.

URL istek parametreleri

field↕	notes↕
`tempCartUUID` REQUIRED	Bu değer, Zonos `createTempCart` API hizmeti uç noktası çağrılarak elde edilir. `string / GUID`
`country`	Hedef ülkenin iki harfli ISO kodu. Kullanıcı deneyimi için bu parametreyi geçmenizi şiddetle tavsiye ederiz. `country` parametresi, Zonos Checkout içindeki hedef ülkeyi önceden seçecektir. Sitede Zonos Hello JS (JavaScript) kullanırken, bu değeri JavaScript yöntemini çağırarak elde edebilirsiniz: `zonos.country()`. `string` (Length: 2)

Ek dize veri türleri

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Demo rezervasyonu yap

Checkout oluşturma

Öznitelikler

İstek gövdesindeki JSON anahtar/değer çiftleri

Ek dize veri türleri

İndirimler, kuponlar ve promosyon kodları

HTTPS yanıtı

Yanıt JSON tanımları

Hata HTTP yanıtları

HTTP ERROR 422

The request entity had the following errors:

Zonos Checkout'a Yönlendirme

URL istek parametreleri

Ek dize veri türleri

Bu sayfa faydalı mıydı?