Uç Noktalar
Nakliye teklifleri talep etme
POST | https://api.iglobalstores.com/2.0/shipping-quotes - Alışveriş sepetindeki ürünler için ithalat vergileri ve harçları ile birlikte kısıtlama tarama bilgilerini içeren yeni bir nakliye teklifi talebi oluşturun.
HTTPS isteği
| Alan | Notlar |
|---|---|
| HTTP yöntemi | POST |
| Uç nokta URL'si | https://api.iglobalstores.com/2.0/shipping-quotes |
| Protokol | HTTPS |
| Mesaj formatı | JSON |
| Accept HTTP başlığı | Accept: application/json |
| Güvenlik Token HTTP Başlığı | serviceToken: your-test-token-valueHTTPS isteğinize serviceToken adında bir başlık ekleyin ve değer olarak Test Güvenlik API Token'ınızı kullanın. (Bu token için Hesap Yöneticinizle iletişime geçin) |
| Content-Type HTTP Başlığı | Content-Type: application/jsonServise JSON verisi göndereceğiniz için, HTTPS isteğinize Content-Type adında bir başlık ekleyin ve değer olarak application/json kullanın |
JSON ANAHTAR/DEĞER PAIR'LERİ istek gövdesinde
Mesaj Formatı: JSON
Örnek istek
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
"boxCount": null,
"items": [
{
"cartItemId": 1,
"detailedDescription": "description including options, material content, etc",
"category": "sunglasses",
"productId": "17898-675234",
"sku": "oakley-123",
"unitPrice": 199.0,
"quantity": 1,
"length": 2.5,
"width": 6.5,
"height": 2.5,
"dimensionalUnits": null,
"weight": 4,
"weightUnits": "OZ",
"hsCode": null,
"brandName": "Oakley",
"countryOfOrigin": "CN"
},
{
"cartItemId": 2,
"detailedDescription": "description including options, material content, etc",
"category": "sunglasses",
"productId": "17898-675235",
"sku": "oakley-125",
"unitPrice": 179.0,
"quantity": 1,
"length": 2.5,
"width": 6.5,
"height": 2.5,
"dimensionalUnits": null,
"weight": 4,
"weightUnits": "OZ",
"hsCode": null,
"brandName": "Oakley",
"countryOfOrigin": "CN"
}
],
"shippingAmountOverride": null,
"shipFromAddress": null,
"shipToAddress": {
"name": "John Doe",
"address1": "123 S West Elm St",
"address2": null,
"address3": null,
"city": "Calgary",
"state": "Alberta",
"stateCode": "AB",
"postalCode": "T2P 5G8",
"countryCode": "CA"
}
}
İstek JSON Tanımları
| Alan | Notlar |
|---|---|
boxCount | Bu alan, siparişi göndermek için kullanılacak kutuları tanımlar. Bir tüccarın bunu sipariş sırasında bilmesi beklenmez; ancak, biliniyorsa, aşağıdaki belirli formatta iletilebilir.Ö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. Listedeki ilk kutu 22 inç uzunluğunda, 15 inç genişliğinde ve 15 inç yüksekliğinde olacaktır. Bu boyutta yalnızca bir kutu kullanılacaktır. 8x8x4 inç boyutunda iki kutu olacaktır. Aynı kutu boyutunu birden çok kez iletmek sizin için kolay ise, bu kabul edilebilir: “22x15x15(1),22x15x15(1)”, bu da 22x15x15 inç boyutunda 2 kutu anlamına gelir. |
items ZORUNLU | Bir öğe haritaları listesi |
items[index].brandName | Belirli bir öğenin marka adı, kurallar motorumuzun, öğeye hedef ülke için bir kısıtlama uygulanıp uygulanmadığını en iyi şekilde belirlemesine yardımcı olacaktır. Bir öğenin marka adı belirli bir kısıtlamayla metinsel olarak eşleşse de eşleşmese de, kurallar motorumuz öğenin SKU'sunu ve/veya productId'sini kullanarak öğenin gerçekten hedef ülkeye kısıtlanıp kısıtlanmadığını daha iyi belirleyecektir. Marka adı mevcutsa lütfen gönderin.Örnek değerler: “Oakley” veya “Nike” veya null |
items[index].cartItemId ZORUNLU | Bu alan, özellikle öğeler listesi içinde öğeyi tanımlamak için gereklidir. Basit bir indeks değeri kadar basit olabilir. Bu cartItemId'yi, JSON yanıtında kısıtlanmışsa bir öğeyi tanımlamak için kullanacağız. Bu nedenle, bize ilettiğiniz bu cartItemId ile sepetinizdeki aynı öğeyi tanımlayabildiğinizden emin olun.Örnek değerler: 1 veya 2 veya 3 |
items[index].category | Ürün kategorileri - parçası olduğu belirli ürün. Kategori, kurallar motorumuzun, öğeye hedef ülke için bir kısıtlama uygulanıp uygulanmadığını en iyi şekilde belirlemesine yardımcı olacaktır. Bir öğenin kategorisi belirli bir kısıtlamayla metinsel olarak eşleşse de eşleşmese de, kurallar motorumuz öğenin SKU'sunu ve/veya productId'sini kullanarak öğenin gerçekten hedef ülkeye kısıtlanıp kısıtlanmadığını daha iyi belirleyecektir.Format: Kategori adlarının boru ile ayrılmış listesi. Her kategori adı bir veya daha fazla kelime olabilir. Bir öğe birden fazla kategoride bulunuyorsa, lütfen her ikisini de boru “” karakteri ile ayırarak listeleyin.Örnek: değerler “Güneş Gözlüğü” veya “Akşam AksesuarlarıÇantalar” |
items[index].countryOfOrigin | Menşei, ürünün üretildiği veya ilk olarak geldiği ülkedir. Menşei, kurallar motorumuzun, ürünün hedef ülke için bir kısıtlama uygulanıp uygulanmadığını en iyi şekilde belirlemesine yardımcı olacaktır. Bazı ülkeler, diğer belirli ülkelerden gelen belirli türde mallara izin vermez. Örnek değerler: “CN” Çin için veya “US” Amerika Birleşik Devletleri için veya null |
items[index].detailedDescription GEREKEN | Bu alan basit bir metin olup, satın alınan ürün hakkında mümkün olduğunca fazla bilgi içermelidir. Örneğin, tam adı ve varsa ürün kodu, seçilen renk veya diğer seçenekler, malzeme içeriği ve ürün için sahip olduğunuz herhangi bir açıklama metni. Yabancı ülkelere yapılan ithalat kısıtlamalarının birçok farklı türü vardır, örneğin, İtalya'ya deri ayakkabı. Bazen, bu kısıtlı ürünleri yakalamanın tek yolu detailedDescription üzerinden geçmektir. Not: Bir ürünün detailedDescription'ı belirli bir kısıtlamayla metin olarak eşleşse de eşleşmese de, kurallar motorumuz ürünün SKU'sunu ve/veya productId'sini kullanarak ürünün gerçekten hedef ülkeye kısıtlı olup olmadığını daha iyi karar verecektir. En iyi sonuçlar için, lütfen detailedDescription alanında mümkün olduğunca fazla bilgi gönderin. Örnek değer: “Tory Burch, Robinson – Double Zip’ Tote, renk: Yeni Karnaval, malzeme içeriği: deri, Renkli deri, dikkat çekici bir çekicilik sunar, tamamen şık bir görünüm için logo donanımı ve yuvarlak kulplarla düzenli bir çanta. İki fermuarlı bölmesi olan manyetik kapanma. İç fermuarlı, duvar ve cep telefonu cepleri. Koruyucu metal ayaklar. Deri. Tory Burch tarafından; ithal.” |
items[index].height | Bu, ürününüzün yüksekliğidir. Bu ölçüm için inç veya santimetre belirtmek için dimensionalUnits adında başka bir alan vardır. Lütfen virgül olmadan ve en fazla iki ondalık basamakla sağlayın. Örnek değer: 25.5. Bu alanı geçerseniz, nakliye ücretleriniz en doğru şekilde olacaktır. |
items[index].hsCode | Bu, ürünü yabancı ülkelere tanımlayan HS Kodudur. hsCode'u geçmek, belirli ürün için doğru ithalat vergisi rate'ni doğru bir şekilde tanımlamaya yardımcı olacaktır. Kullanılamıyorsa gerekli değildir – eğer yoksa biz hallederiz. Format: Ya 10 haneli ya da 6 haneli kod; ayırıcı “.” karakterlerini içerebilir veya içermeyebilir. Örnek değerler: “20.4560.0000” veya “20.4560” veya “204560” (her iki 10 veya 6 haneli kod da kabul edilebilir) |
items[index].length | Bu, ürününüzün uzunluğudur. Bu ölçüm için inç veya santimetre belirtmek için dimensionalUnits adında başka bir alan vardır. Lütfen virgül olmadan ve en fazla iki ondalık basamakla sağlayın. Örnek değer: 25.5. Bu alanı geçerseniz, nakliye ücretleriniz en doğru şekilde olacaktır. |
items[index].productId | Bu, belirli ürün için ürün kimliğinizdir. Kurallar motorumuz, bu değeri öğrenilen ürün bilgilerini ürününüze bağlamak için bir kimlik olarak kullanacaktır. Örnek değer: “17898-675235”. Lütfen en azından productID veya SKU'yu geçin. Her ikisini geçmek tercih edilir. |
items[index].quantity GEREKEN | Bu, belirli ürün için satın alınan miktardır. Lütfen pozitif bir tam sayı olarak, virgül olmadan ve ondalık basamak olmadan sağlayın. Örnek değerler: 1 veya 9999 (daha fazla ürün satmanızı tercih ederiz!) |
items[index].sku | Bu, belirli ürün için SKU'nuzdur. Kurallar motorumuz, bu değeri öğrenilen ürün bilgilerini ürününüze bağlamak için bir kimlik olarak kullanacaktır. Örnek değer: “oakley-125”. Lütfen en azından productId veya SKU'yu geçin. Her ikisini geçmek tercih edilir. |
items[index].unitPrice GEREKEN | Bu, ürününüzün birim fiyatıdır USD (Amerikan doları) cinsinden. Lütfen virgül olmadan, dolar işareti “$” olmadan ve iki ondalık basamakla sağlayın. Örnek değer: 2102.99 |
items[index].weight | Bu, ürününüzün ağırlığıdır. Bu ölçüm için pound, ons, gram veya kilogram belirttiğiniz başka bir alan olan weightUnits bulunmaktadır. Lütfen virgül kullanmadan ve en fazla iki ondalık basamakla sağlayın. Örnek değer: 4.2Bu alanı geçerseniz, nakliye oranlarınız en doğru şekilde olacaktır. |
items[index].weightUnits | Pound için varsayılan olarak “LB” dır. Ağırlık değeri için ölçü birimidir. Null olarak ayarlanırsa, “LB” (pound) varsayılan olarak kabul edilecektir. Örnek değerler: “LB” pound için veya “OZ” ons için veya “G” gram için veya “KG” kilogram için veya null |
items[index].width | Bu, ürününüzün genişliğidir. Bu ölçüm için inç veya santimetre belirttiğiniz başka bir alan olan dimensionalUnits bulunmaktadır. Lütfen virgül kullanmadan ve en fazla iki ondalık basamakla sağlayın. Örnek değer: 25.5Bu alanı geçerseniz, nakliye oranlarınız en doğru şekilde olacaktır. |
shipFromAddress | Null olarak geçilirse, satıcı hesabınıza bağlı varsayılan shipFromAddress kullanılacaktır. Bu, siparişin gönderileceği adrestir, yani depo adresinizdir. Bu, aşağıdaki adres alanlarını içeren bir haritadır: address1, address2, address3, city, state, stateCode, postalCode, countryCode. Bu alanların gerekliliği, ülkeye bağlı olarak değişir. Yerelleştirme uç noktası, her ülke için hangi belirli adres alanlarının gerekli olduğunu döndürür. Not: stateCode her zaman gerekli değildir ve yerelleştirme uç noktasında belirtilmemiştir. Eğer mevcutsa stateCode geçebilirsiniz. |
shippingAmountOverride | Bu, API'yi çağırmadan önce nakliye maliyetini biliyorsanız yalnızca kullanılır. USD (ABD doları) cinsindendir. Lütfen virgül kullanmadan, dolar işareti “$” olmadan ve iki ondalık basamakla sağlayın. Bu özellik, Zonos temsilcisi ile ayarlanmadan çalışmayacaktır. Örnek değer: 212.99 |
shipToAddress GEREKLİ | Bu, siparişin gönderileceği adrestir. Bu, aşağıdaki adres alanlarını içeren bir haritadır: name, address1, address2, address3, city, state, stateCode, postalCode, countryCode. Bu alanların gerekliliği, ülkeye bağlı olarak değişir. Yerelleştirme uç noktası, her ülke için hangi belirli adres alanlarının gerekli olduğunu döndürür. Not: name ve stateCode her zaman gerekli değildir ve yerelleştirme uç noktasında belirtilmemiştir. Eğer mevcutsa name ve/veya stateCode geçebilirsiniz. |
HTTPS yanıtı
Mesaj formatı: JSON
Sadece Kanada ve Avustralya için örnek yanıt
Not: Gerçek yanıtlar, tüm desteklenen ülkeleri içerecektir.
Örnek istek
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
"shippingQuotes": [
{
"id": "bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a",
"carrier": "UPS",
"conversionRate": 1.32,
"currencyCode": "CAD",
"displayName": "Express Air 2-4 Day Delivery",
"duty": 10.2,
"dutyTaxBrokerageFee": 5.0,
"dutyTaxCarrierPrepaymentFee": 5.0,
"dutyTaxEnabled": true,
"dutyTaxForced": false,
"dutyTaxTotal": 29.38,
"dutyTaxUnderDeminimus": false,
"restrictedItems": [
{
"cartItemId": 1,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
},
{
"cartItemId": 2,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
}
],
"shippingTotal": 23.62,
"taxOrVat": 9.18
},
{
"id": "80c57724-ab4e-4997-8477-08b668fef103",
"carrier": "USPS",
"conversionRate": 1.32,
"currencyCode": "CAD",
"displayName": "Post 5-10 Day Delivery",
"duty": 9.2,
"dutyTaxBrokerageFee": 5.0,
"dutyTaxCarrierPrepaymentFee": 5.0,
"dutyTaxEnabled": true,
"dutyTaxForced": false,
"dutyTaxTotal": 27.38,
"dutyTaxUnderDeminimus": false,
"restrictedItems": [
{
"cartItemId": 1,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
},
{
"cartItemId": 2,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
}
],
"shippingTotal": 13.62,
"taxOrVat": 8.18
}
]
}
Yanıt JSON tanımları
| Alan | Notlar |
|---|---|
shippingQuotes | Bu, nakliye teklifi haritalarının bir listesidir. |
shippingQuotes[index].carrier | Nakliye teklifinin spesifik olduğu taşıyıcı. Sadece, satıcının genel nakliye profilleri oluşturulmasını istemesi durumunda null olarak ayarlanır, taşıyıcıya özgü değildir. Nakliye teklifleri taşıyıcıya özgü olmak zorunda değildir; ancak olabilir. Nakliye profillerinizi ayarlamak için Hesap Yöneticinizle iletişime geçin.Örnek değerler: UPS veya FEDEX veya DHL veya USPS veya CAPOST veya null |
shippingQuotes[index].displayName | Alışveriş yapanlara gösterilmek üzere uygun olan nakliye seçeneği için görüntüleme adı. Bu değerler satıcı için özelleştirilebilir. Bunu yapmak için Hesap Yöneticinizle iletişime geçin.Örnek değer: “Hızlı Hava 2-4 Gün Teslimat” |
shippingQuotes[index].duty | dutyTaxTotal içinde yer alan ithalat vergisi tutarı. Bu tutar USD cinsindendir, virgül içermez ve iki ondalık basamağa sahiptir.Örnek değer: 8.29 |
shippingQuotes[index] .dutyTaxBrokerageFee | Yabancı ithalat brokerinin, ithalat vergilerinizi ve vergilerinizi işlemek için sizden alacağı ücret. Bu tutar dutyTaxTotal içinde yer alır. Tutar USD cinsindendir, virgül içermez ve iki ondalık basamağa sahiptir.Örnek değer: 5.00 |
shippingQuotes[index] .duyTaxCarrierPrepaymentFee | Taşıyıcının, ithalat ülkesine vergileri ve harçları prepay için sizden alacağı ücret. Bu tutar dutyTaxTotal içinde yer alır. Bu tutar USD cinsindendir, virgül içermez ve iki ondalık basamağa sahiptir.Örnek değer: 5.00 |
shippingQuotes[index] .duyTaxEnabled | Bu nakliye teklifinin alışveriş yapanın ithalat vergilerini ve harçlarını prepay etmesine izin verip vermediği. Eğer false olarak ayarlanırsa, dutyTaxTotal göz ardı edilmelidir.Örnek değerler: true veya false |
shippingQuotes[index] .duyTaxForced | Bu nakliye teklifinin alışveriş yapanı ithalat vergilerini ve harçlarını prepay etmeye zorlayıp zorlamadığı. Eğer true olarak ayarlanırsa, dutyTaxTotal siparişte yer almalı ve alışveriş yapanı bu spesifik nakliye seçeneği ile gerekli olduğu konusunda bilgilendirmelisiniz. Eğer false olarak ayarlanırsa, alışveriş yapanın ithalat vergilerini ve harçlarını prepay etmek isteyip istemediğini seçmesine izin verebilirsiniz.Örnek değerler: true veya false |
shippingQuotes[index].dutyTaxTotal | Verilen nakliye teklifi için toplam vergi ve harç maliyeti. Vergi ve harç, verilen nakliye teklifi için isteğe bağlı, mevcut olmayabilir veya zorunlu olabilir. Bu tutar shippingTotal içinde yer almaz. Bu tutar USD cinsindendir, virgül içermez ve iki ondalık basamağa sahiptir.Örnek değer: 19.55 |
shippingQuotes[index] .dutyTaxUnderDeMinimis | Bu spesifik nakliye seçeneğini kullanarak siparişin toplamının hem vergi/KDV de minimis tutarının hem de harç de minimis tutarının altında olup olmadığı. Eğer true olarak ayarlanırsa, dutyTaxTotal 0.00 olarak ayarlanacak ve müşteriye siparişlerinde ithalat vergisi veya harçlarının olmayacağı mesajı verilmelidir. Ayrıca, maliyet 0.00 olduğu için vergilerin ve harçların ön ödemesini zorunlu kılmalısınız. |
shippingQuotes[index].id | Belirli bir nakliye teklifi için bir tanımlayıcı; 36 karakterli UUID.Örnek değer: bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a |
shippingQuotes[index].restrictedItems | Bu, bu belirli nakliye teklifi kullanılarak kısıtlanan sepet öğeleri hakkında ayrıntılar içeren haritalar listesidir. Her kısıtlı öğenin bir reasonCode vardır. Sebep, nakliye seçeneğine özgü olabilir veya olmayabilir. Öğelerin kısıtlanmasının bazı nedenleri, ülke ithalat yasaları, marka kısıtlamaları veya hatta satıcı tarafından oluşturulan kurallar nedeniyle olabilir. Alışveriş yapan tarafından her seferinde bir nakliye seçeneği seçildiğinde, sepet öğeleri nakliye teklifinin restrictedItems listesi ile karşılaştırılmalıdır. Eğer sepet öğelerinden herhangi biri kısıtlıysa, alışveriş yapan için bir mesaj görüntülenmeli ve kısıtlı öğe(ler) siparişin toplamından çıkarılmalıdır, vb. |
shippingQuotes[index] .restrictedItems[index].cartItemId | Bu, kısıtlı bir sepet öğesinin istek JSON'undaki cartItemId'dir. Bu cartItemId'yi alışveriş yapanın sepetindeki belirli bir öğeye bağlayabilmelisiniz. Örnek değerler: 1 veya 2 veya 3 |
shippingQuotes[index] .restrictedItems[index].message | Bu, alışveriş yapan için öğenin neden kısıtlandığı hakkında görüntülenebilecek bir mesajdır. Bu mesajlar satıcı tarafından özelleştirilebilir. Detaylar için lütfen Zonos temsilcinizle iletişime geçin. Örnek değer: “Oakley ürünlerini ülkenize satamıyoruz.” |
shippingQuotes[index] .restrictedItems[index].reasonCode | Bu, öğenin kısıtlanma nedeninin kodudur. Kısıtlamalar her zaman ülkeye özgüdür ve neden kodlarımız bunu açıkça gösterir. Örnek değerler: BRAND_COUNTRY veya IMPORT_COUNTRY veya EXPORT_COUNTRY veya CARRIER_COUNTRY veya MERCHANT_COUNTRY. BRAND_COUNTRY, belirli bir ülke grubuna bir markayı satamayacağınızı belirttiğiniz anlamına gelir. IMPORT_COUNTRY, ithalat ülkesinin öğenin ithalatına izin vermeyeceği anlamına gelir. EXPORT_COUNTRY, ihracat ülkesinin (genellikle Amerika Birleşik Devletleri) öğenin ihracatına izin vermeyeceği anlamına gelir. CARRIER_COUNTRY, belirli bir taşıyıcının öğeyi taşımayacağı anlamına gelir. MERCHANT_COUNTRY, öğenin tetiklediği özel bir kısıtlama kuralı belirlediğiniz anlamına gelir. |
shippingQuotes[index] .shippingTotal | Verilen nakliye teklifi için toplam nakliye maliyetidir. Nakliye teklifleri ayrıca bu shippingTotal'a dahil olmayan bir dutyTaxTotal miktarına sahip olabilir. Bu miktar USD cinsindendir, virgül içermez ve iki ondalık basamak içerir. Örnek değer: 25.82 |
shippingQuotes[index].taxOrVat | dutyTaxTotal'a dahil edilen vergi veya KDV miktarıdır. Bazı ülkeler için bu bir vergidir; diğerleri için KDV'dir. Bu miktar USD cinsindendir, virgül içermez ve iki ondalık basamak içerir. Örnek değer: 4.35 |
Landed Cost API Mirası
Miras Landed Cost API'sinin nasıl çalıştığını öğrenin.Aşağıdaki bilgiler, miras Landed Cost API'miz içindir. En son sürüm için Landed Cost API'mizi inceleyin.
Shipping-quotes uç noktası, alışveriş sepetinizdeki detayları kabul eder, ithalat vergileri ve harçları ile birlikte nakliye teklifleri döner ve ürünleri kısıtlamalar için tarar. Dönen bu nakliye teklifleri, bu API uç noktasının kullanılmasından önce ayarlanan nakliye profillerine dayanmaktadır.
Test amaçları için varsayılan nakliye profillerimiz mevcuttur, ancak şirketinizin kullanmak istediği gerçek nakliye profilleri ve ayarlarını oluşturmak için Hesap Yöneticinizle çalışmanız gerekecektir.