Siapkan Zonos
Pertama, daftar untuk akun Zonos dan konfigurasikan akun Anda di Zonos Dashboard. Anda kemudian akan dapat mendapatkan kunci API Anda, yang akan memungkinkan Anda untuk mengautentikasi dengan Zonos API.
Tetapkan mata uang dasar
Untuk memberikan konteks tentang jumlah uang yang disertakan dalam permintaan biaya pendaratan, Anda perlu menentukan kode mata uang dasar permintaan Anda (sebagai kode mata uang ISO). Ini akan merujuk pada semua nilai moneter dalam permintaan dan mata uang apa yang akan ditampilkan dalam kutipan biaya pendaratan yang dihasilkan. Anda dapat menemukan daftar mata uang yang didukung dan kode ISO mereka di dokumen biaya pendaratan kami.
{ "currency": "USD"}Berikan detail item
Untuk mendapatkan kutipan biaya pendaratan yang akurat menggunakan Zonos, Anda perlu memberikan detail per-item sebanyak mungkin, termasuk kode harmonisasi (HS). Secara umum, semakin banyak informasi yang Anda sertakan, semakin akurat kutipan Anda.
Meskipun menyediakan kode HS memungkinkan Zonos Landed Cost mengembalikan perhitungan paling akurat dan lengkap, dimungkinkan untuk mendekati biaya pendaratan aktual tanpa kode HS. Namun, perhatikan bahwa jika total biaya item Anda melebihi ambang batas minimis, kode HS mungkin diperlukan. Dalam kasus tersebut, mengirim permintaan tanpa kode HS akan menghasilkan kesalahan.
Untuk setiap item yang ingin Anda sertakan dalam kutipan biaya pendaratan Anda, tambahkan entri ke array items dalam badan permintaan.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Tambahkan alamat pengiriman
Lokasi pengiriman dari dan pengiriman ke untuk pengiriman Anda diperlukan untuk menghitung biaya pendaratan. Alamat lengkap diperlukan untuk tujuan pengiriman, tetapi menyertakan negara pengiriman dari cukup untuk sebagian besar kutipan biaya pendaratan.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Berikan biaya pengiriman
Zonos Landed Cost API tidak menghitung biaya pengiriman - fokusnya pada bea, pajak, dan biaya. Karena pengiriman adalah aspek yang cukup besar dari total kutipan biaya pendaratan dan faktor penting dalam cara perhitungan, penting untuk menentukan biaya pengiriman terlebih dahulu. Nilai ini dapat diperoleh dengan menggunakan API penilaian pengiriman, seperti Zonos Rating API, atau melalui berbagai sarana lain, seperti perangkat lunak pengiriman pembawa Anda, bagan tarif, dll.
Informasi yang berkaitan dengan biaya pengiriman, termasuk jumlah pengiriman keseluruhan, dikirim melalui bidang shipping dalam permintaan API Anda.
{ "shipping": { "amount": 14.23 }}Sementara hanya jumlah yang diperlukan, Anda juga dapat memberikan nama tingkat layanan untuk memungkinkan API menghitung biaya pembawa dari jumlah yang disediakan. Anda dapat melihat daftar pembawa dan tingkat layanan yang didukung di dokumen Biaya Pendaratan kami.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Kirim permintaan API
Sekarang setelah Anda membangun permintaan Anda dan mengonfigurasinya, Anda dapat mengirim permintaan POST ke Zonos Landed Cost API. Pastikan untuk mengautentikasi dengan kunci API Anda dan berikan header versi yang benar dalam permintaan Anda.
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",
Hitung biaya pendaratan
Pelajari cara meminta biaya pendaratan melalui REST API.REST
Zonos Landed Cost API memungkinkan Anda untuk dengan cepat mendapatkan kutipan biaya pendaratan yang sangat akurat untuk pengiriman impor dan ekspor lintas batas. Meskipun menyediakan kode harmonisasi (HS) memungkinkan Zonos Landed Cost mengembalikan perhitungan bea yang paling akurat, kami akan mengembalikan jumlah bea dan pajak perkiraan bahkan ketika kode harmonisasi tidak disediakan.