Zonos'u ayarlayın
Öncelikle, bir Zonos hesabı kaydedin ve Zonos Dashboard'unuzda hesabınızı yapılandırın. Daha sonra, Zonos API'si ile kimlik doğrulamanızı sağlayacak API anahtarınızı alabileceksiniz.
Temel para birimini ayarlayın
Bir landed cost talebinde yer alan para miktarları hakkında bağlam sağlamak için, talebinizin temel para birimi kodunu (ISO para birimi kodu olarak) belirtmeniz gerekir. Bu, talepteki tüm parasal değerleri ve sonuçta elde edilen landed cost teklifinin hangi para biriminde sunulacağını ifade eder. Desteklenen para birimlerinin ve ISO kodlarının listesini landed cost belgelerimizde bulabilirsiniz.
Talep
{
"currency": "USD"
}
Ürün detaylarını sağlayın
Doğru bir landed cost teklifi almak için Zonos kullanarak, mümkün olduğunca fazla ürün detayını sağlamanız gerekecek, bu da harmonize (HS) kodlarını içermektedir. Genel olarak, eklediğiniz bilgi ne kadar fazla olursa, teklifiniz o kadar doğru olacaktır.
HS kodlarını sağlamak, Zonos Landed Cost'un en doğru ve eksiksiz hesaplamaları döndürmesine olanak tanırken, HS kodu olmadan gerçek landed cost'u yaklaşık olarak hesaplamak da mümkündür. Ancak, eşyalarınızın toplam maliyeti de minimis eşiğini aşarsa, bir HS kodu gerekebilir. Bu durumlarda, HS kodu olmadan bir talep göndermek bir hata ile sonuçlanacaktır.
landed cost teklifinize dahil etmek istediğiniz her bir ürün için, istek gövdesindeki items dizisine bir giriş ekleyin.
Talep
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Gönderim adresleri ekleyin
Gönderiminiz için gönderim yapılacak ve gönderim yapılacak yerler, landed cost hesaplamak için gereklidir. Gönderim varış yeri için eksiksiz bir adres gereklidir, ancak çoğu landed cost teklifi için gönderim yapılacak ülkenin belirtilmesi yeterlidir.
Talep
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Nakliye maliyetlerini sağlayın
Zonos Landed Cost API'si nakliye maliyetlerini hesaplamaz - gümrük vergileri, vergiler ve ücretler üzerine odaklanır. Nakliye, toplam landed cost teklifinin önemli bir yönüdür ve hesaplamalarda önemli bir faktördür, bu nedenle nakliye maliyetinin önceden belirtilmesi gereklidir. Bu değer, Zonos Rating API'si gibi bir gönderi değerlendirme API'si kullanılarak veya taşıyıcınızın nakliye yazılımı, rate tabloları gibi çeşitli diğer yollarla elde edilebilir.
Nakliye maliyetleriyle ilgili bilgiler, toplam nakliye tutarı da dahil olmak üzere, API isteğinizdeki shipping alanı aracılığıyla gönderilir.
İstek
{
"shipping": {
"amount": 14.23
}
}
Sadece miktar gerekli olsa da, API'nin sağlanan miktara göre taşıyıcı ücretlerini hesaplayabilmesi için bir hizmet seviyesi adı da verebilirsiniz. Desteklenen taşıyıcılar ve hizmet seviyelerinin listesini Landed Cost belgelerinde görebilirsiniz.
İstek
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Bir API isteği gönderin
Artık isteğinizi oluşturduğunuza ve yapılandırdığınıza göre, Zonos Landed Cost API'sine bir POST isteği gönderebilirsiniz. API anahtarınızla kimlik doğrulaması yaptığınızdan ve isteğinizde doğru sürüm başlığını sağladığınızdan emin olun.
POST https://api.zonos.com/v1/landed_cost
İstek
{
"currency": "USD",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
],
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
Yanıt
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Bir landed cost hesaplayın
REST API aracılığıyla bir landed cost talep etmeyi öğrenin.REST
Zonos Landed Cost API, sınır ötesi ithalat ve ihracat gönderimleri için yüksek doğrulukta bir landed cost teklifi almanızı sağlar. Harmonize (HS) kodları sağlamak, Zonos Landed Cost'un en doğru gümrük hesaplamasını döndürmesine olanak tanırken, bir harmonize kodu sağlanmadığında bile yaklaşık gümrük ve vergi tutarını döndüreceğiz.