Zonos'u kur
İlk olarak, bir Zonos hesabı için kaydolun ve hesabınızı Zonos Dashboard'da yapılandırın. Daha sonra API anahtarınızı alabileceksiniz ve bu sayede Zonos API ile kimlik doğrulaması yapabileceksiniz.
Temel para birimini ayarla
Bir iniş maliyeti isteğine dahil edilen para miktarları hakkında bağlam sağlamak için, isteğinizin temel para birim kodunu (ISO para birimi kodu olarak) belirtmeniz gerekir. Bu, istekteki tüm parasal değerlere ve elde edilen iniş maliyeti teklifinin işleneceği para birimine başvuracaktır. Desteklenen para birimleri ve bunların ISO kodlarının bir listesini iniş maliyeti belgelerimizde bulabilirsiniz.
{ "currency": "USD"}Öğe ayrıntılarını sağla
Zonos kullanarak doğru bir olası iniş maliyeti teklifi almak için, HS kodları dahil olmak üzere mümkün olduğunca fazla öğe başına ayrıntı sağlamanız gerekecektir. Genel olarak, ne kadar fazla bilgi eklerseniz, teklifiniz o kadar doğru olacaktır.
HS kodları sağlamak Zonos Landed Cost'un en doğru ve eksiksiz hesaplamaları döndürmesine olanak tanırken, HS kodu olmadan fiili iniş maliyetini yaklaştırmak mümkündür. Ancak, öğelerinizin toplam maliyeti de minimis eşiğini aşarsa, HS kodu gerekli olabilir. Bu durumda, HS kodu olmadan bir istek göndermek bir hatayla sonuçlanacaktır.
İniş maliyeti teklifinize dahil etmek istediğiniz her öğe için, istek gövdesindeki items dizisine bir giriş ekleyin.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Kargo adreslerini ekle
Gönderiminizin nereden gönderileceği ve nereye ulaştırılacağı konumları iniş maliyetini hesaplamak için gereklidir. Sevkiyat hedefi için tam bir adres gereklidir, ancak çoğu iniş maliyeti teklifinde gönderme ülkesini dahil etmek yeterlidir.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Kargo maliyetlerini sağla
Zonos Landed Cost API, kargo maliyetlerini hesaplamaz - gümrük vergileri, vergiler ve ücretlere odaklanır. Kargo, toplam bir iniş maliyeti teklifinin önemli bir yönü ve işlerin nasıl hesaplandığının önemli bir faktörü olduğundan, kargo maliyetini önceden belirtmek çok önemlidir. Bu değer, Zonos Rating API gibi bir sevkiyat derecelendirme API'si kullanılarak veya taşıyıcınızın kargo yazılımı, oran tabloları vb. gibi çeşitli diğer yollarla elde edilebilir.
Kargo maliyetleriyle ilgili bilgiler, genel kargo miktarı da dahil olmak üzere, API isteğinizde shipping alanı aracılığıyla gönderilir.
{ "shipping": { "amount": 14.23 }}Yalnızca miktar gerekli olmakla birlikte, API'nin sağlanan miktardan taşıyıcı ücretlerini hesaplamasını etkinleştirmek için bir hizmet düzeyi adı da sağlayabilirsiniz. Desteklenen taşıyıcılar ve hizmet seviyeleri listesini Landed Cost belgelerimizde görebilirsiniz.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Bir API isteği gönder
İsteğinizi oluşturduktan ve yapılandırdıktan sonra, Zonos Landed Cost API'sine bir POST isteği gönderebilirsiniz. API anahtarınızla kimlik doğrulaması yaptığınızdan ve isteğinize doğru sürüm başlığını sağladığınızdan emin olun.
POST https://api.zonos.com/v1/landed_cost
{ "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",
Bir iniş maliyeti hesapla
REST API aracılığıyla bir iniş maliyeti talep etmeyi öğrenin.
REST
Zonos Landed Cost API, sınır ötesi ithalat ve ihracat gönderimleri için hızlı ve yüksek doğruluklu bir iniş maliyeti teklifi almanızı sağlar. Uyumlaştırılmış (HS) kodlar sağlamak Zonos Landed Cost'un en doğru gümrük vergisi hesaplamasını döndürmesine olanak tanırken, uyumlaştırılmış bir kod sağlanmadığında bile yaklaşık gümrük ve vergi miktarını döndüreceğiz.