Bir checkout oluşturun

Bir checkout oluşturma sürecinde yer alan anahtar/değer çiftlerini keşfedin.

Bu API uç noktası, müşteri sepetinden sepet bilgilerini ve ürünleri Zonos API'sine göndermek için kullanılır.

Bir Zonos Sistemi'nde benzersiz bir sepet tanımlayıcısı olan tempCartUUID içeren bir JSON yanıtı alacaksınız. Bu, müşteriyi siparişi tamamlamak için Zonos Checkout'a yönlendirmek için kullanılacaktır.

Özellikler

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

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

alan	notlar
`boxCount`	Örnek değer: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Virgülle ayrılmış kutu boyutları ve sayısı listesi. Yukarıdaki örnekte toplamda 4 kutu vardır. Listede ilk kutu 22 inç uzunluğunda, 15 inç genişliğinde ve 15 inç yüksekliğindedir. O boyut için yalnızca bir kutu kullanılacaktır. 8x8x4 inç boyutunda iki kutu olacaktır. Eğer sizin için kolaysa, aynı kutu boyutunu birden fazla kez geçmek kabul edilebilir, örneğin: “22x15x15(1),22x15x15(1)”, bu da 22x15x15 inç boyutunda 2 kutu anlamına gelir. Bu alan, siparişi göndermek için kullanılacak kutuları tanımlar. Bir satıcının bunu sipariş anında bilmesi beklenmez; ancak, biliniyorsa, `string` formatında geçilebilir.
`contShoppingURL`	Bu alan, Zonos Checkout içindeki "Alışverişe Devam Et" butonunun HREF'sini geçersiz kılmak için bir URL geçmek için kullanılır. `string`
`domesticShippingCharge`	Bu alan, Zonos Checkout'a bir yerel nakliye ücreti geçmek için kullanılır ve miktar nakliyeye eklenecektir. Bu, nakliye toplamını eklemek veya ayrı bir satır öğesi olarak ayrılmak üzere yapılandırılabilir. `pozitif ondalık, iki ondalık basamak`
`externalConfirmationPageURL`	Bu alan, sipariş onayınız / teşekkür sayfanızın URL'sini geçmek için kullanılır. Müşteri Zonos Checkout içinde ödemeyi tamamladıktan sonra, sipariş onayı için bu URL'ye yönlendirilecektir. Bu URL, genellikle sipariş detaylarını almak ve siparişi sisteme aktarmak için Zonos “orderDetail” API hizmet uç noktasına bir çağrı tetiklemek için kullanılır. `string`
`footerHTML`	Bu alan, URL kodlu bir HTML dizesi geçmek için kullanılır. Bu HTML dizesi, checkout sayfasındaki kapanış body etiketinden önce yerleştirilecektir. Yeniden pazarlama, analiz vb. için kod geçmek için yaygın olarak kullanılır. `URL kodlu dize`
`items` GEREKLİ	Bu alan, ürün haritalarının bir listesidir. `JSON dizesi`
`items[index].countryOfOrigin`	Bu alan, ürünün menşei ülkesini geçmek için kullanılır. Parametre, ülke iki harfli ISO kodu olmalıdır. `string`
`items[index].description` GEREKLİ	Bu alan, sepet satır öğesinin tam ürün tanımını, herhangi bir ürün seçeneği, renk vb. dahil olmak üzere geçmek için kullanılır. `string`
`items[index].height`	Bu alan, ürünün yüksekliğini geçmek için kullanılır ve doğru nakliye tahminleri için şiddetle önerilir. Yükseklik birimleri GEREKLİ inç cinsindendir. `string - pozitif ondalık, iki ondalık basamak / tam sayı (inç)`
`items[index].imageURL` GEREKLİ	Bu alan, ürün resminin URL'sini geçmek için kullanılır. URL, Zonos Checkout içinde görüntülenmesi için HTTPS olmalıdır. `string / HTTPS URL`
`items[index]itemBrand`	Bu alan, ürün markasını geçmek için kullanılır. `string`
`items[index]itemCategory`	Bu alan, ürün kategorisini iletmek için kullanılır ve ürün birden fazla kategoriye sahipse, boru ile ayrılmış olarak iletilebilir. Ö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 ürünle ilgili ek ayrıntıları iletmek için kullanılır; ancak bu, “orderDetail” API hizmet uç noktası aracılığıyla alınabilir.
`items[index]itemHSCode`	Bu alan, ürün HS kodunu iletmek için kullanılır ve noktalarla birlikte veya olmadan olabilir. Örnek değerler: “3926901000” veya “3926.90.1000”`string`
`items[index].itemURL`	Bu alan, ürün sayfasının URL'sini iletmek için kullanılır. `string / URL`
`items[index].length`	Bu alan, ürün uzunluğunu iletmek için kullanılır ve doğru nakliye teklifleri için şiddetle tavsiye edilir. Uzunluk birimleri GEREKLİDİR inç cinsindendir. `string - pozitif ondalık, iki ondalık basamak / tam sayı (inç)`
`items[index].nonShippable`	Bu alan, ürünün nakliye, gümrük ve vergi hesaplamalarına dahil edilip edilmeyeceğini belirtmek için kullanılır. Dijital indirmeler, indirim kodları, işleme ücretleri vb. “true” değeri ile iletilmelidir. `boolean: true veya false`
`items[index].productId`	Bu alan, satır ürünü miktarını iletmek için kullanılır. `string`
`items[index].quantity` GEREKLİDİR	Bu alan, satır ürünü miktarını iletmek için kullanılır. `string`
`items[index].sku`	Bu alan, ürün SKU / UPC / vb. iletmek için kullanılır. `string`
`items[index].unitPrice` GEREKLİDİR	Bu alan, satır ürünü birim fiyatını iletmek için kullanılır. `pozitif ondalık, iki ondalık basamak / tam sayı`
`items[index].weight`	Bu alan, ürün ağırlığını iletmek için kullanılır ve doğru nakliye teklifleri için şiddetle tavsiye edilir. Ağırlık birimleri varsayılan olarak “LBS” olarak ayarlanmıştır, başka bir ağırlık birimi `items[index].itemWeightUnits` içinde iletilmedikçe. `string - pozitif ondalık, iki ondalık basamak / tam sayı`
`items[index].weightUnits`	Bu alan, varsayılan ürün ağırlık birimlerini geçersiz kılmak için kullanılır. Ürün ağırlık birimleri varsayılan olarak “LBS” olarak ayarlanmıştır, başka bir ağırlık birimi bu alanda iletilmedikçe. `string - "LB", "OZ", "KG", veya "G"`
`items[index].width`	Bu alan, ürün genişliğini iletmek için kullanılır ve doğru nakliye teklifleri için şiddetle tavsiye edilir. Genişlik birimleri GEREKLİDİR inç cinsindendir. `string - pozitif ondalık, iki ondalık basamak / tam sayı (inç)`
`misc1 - misc6`	Bu alan, Zonos API'si aracılığıyla siparişle ilişkili çeşitli verileri iletmek için kullanılır ve Zonos “orderDetail” API hizmet uç noktası aracılığıyla döndürülen sipariş verileriyle birlikte alınabilir. `string`
`referenceId`	Bu alan, sisteminizdeki sepet/oturum vb. için benzersiz bir referans tanımlama değeri iletmek için kullanılır. Bu, Zonos sipariş kimliğini Zonos “orderDetail” API hizmet uç noktası aracılığıyla aramak için kullanılabilir. `string`
`storeId` GEREKLİDİR	Zonos tarafından sağlanan Mağaza Kimliği. `tam sayı`

Ek string 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ı

İndirimleri, kuponları ve promosyon kodlarını Zonos'a sunmak için, bunlar ayrı bir ürün olarak iletilmeli ve parametreler için negatif bir değer verilmelidir: “unitPrice” ve “nonShippable”:true.

İNDİRİM ÜRÜN HARİTASI ÖRNEĞİ

{
  "description": "Discount (10OFF) - 10% OFF",
  "unitPrice": -15.5,
  "quantity": 1,
  "nonShippable": true
}

HTTPS yanıtı

Başarılı HTTP yanıtı

Mesaj formatı: JSON

BAŞARILI YANIT ÖRNEĞİ

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

Yanıt JSON tanımları

alan	notlar
`tempCartUUID`	Bu parametre, müşterinizin uluslararası sepetine atanan ve Zonos sisteminde oluşturulan bir GUID içerecektir. Bu alan, kullanıcının tarayıcısını Zonos Checkout'a yönlendirirken bir URL sorgu `string` parametresi aracılığıyla iletilecektir.

Hata HTTP yanıtları

Hata kodu	anlamı
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	İşlenemez varlık.
500	“storeId” yanlış veya JSON gövdesi ayrıştırılamadı.

ÖRNEK HATA YANITI

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <title>Error 422 Unprocessable Entity</title>
  </head>
  <body>
    <h2>HTTP ERROR 422</h2>
    <p>
      Problem accessing /v2/createTempCart. Reason:
      <pre>Unprocessable Entity</pre>
    </p>
    <h2>The request entity had the following errors:</h2>
    <ul>
      <li>items may not be empty (was null)</li>
      <li>items may not be null (was null)</li>
    </ul>
  </body>
</html>

Zonos Checkout'a Yönlendirme

Başarılı bir tempCartUUID içeren yanıt aldıktan sonra, sunucunuz müşterinin tarayıcısından aşağıda belirtilen uygun URL sorgu dizesi parametreleri ile Zonos Checkout'a bir 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 alan adınızı almak için Zonos uygulama ekibinizle iletişime geçin.

URL istek parametreleri

alan	notlar
`tempCartUUID` GEREKEN	Bu değer, Zonos `createTempCart` API hizmet uç noktasını çağırarak 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çinde hedef ülkeyi önceden seçecektir. Sitede Zonos Hello JS (JavaScript) kullanıyorsanız, bu değeri şu JavaScript yöntemini çağırarak elde edebilirsiniz: `zonos.country()`. `string` (Uzunluk: 2)

Ek string veri türleri

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Bu sayfa yardımcı oldu mu?

Sorular?

Bizimle iletişime geçin.

Zonos'u gör

politikalar ve anlaşmalar