Siapkan Zonos
Pertama, daftarkan akun Zonos dan konfigurasikan akun Anda di Dashboard Zonos. Anda kemudian akan dapat mendapatkan kunci API Anda, yang akan memungkinkan Anda untuk mengautentikasi dengan API Zonos.
Tetapkan mata uang dasar
Untuk memberikan konteks tentang jumlah uang yang termasuk dalam permintaan landed cost, 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 digunakan dalam kutipan landed cost yang dihasilkan. Anda dapat menemukan daftar mata uang yang didukung dan kode ISO mereka di dokumen landed cost kami.
Permintaan
{
"currency": "USD"
}
Berikan detail item
Untuk mendapatkan kutipan landed cost yang akurat menggunakan Zonos, Anda perlu memberikan sebanyak mungkin detail per-item, termasuk kode harmonisasi (HS). Umumnya, semakin banyak informasi yang Anda sertakan, semakin akurat kutipan Anda.
Meskipun memberikan kode HS memungkinkan Zonos Landed Cost untuk mengembalikan perhitungan yang paling akurat dan lengkap, adalah mungkin untuk memperkirakan landed cost yang sebenarnya tanpa kode HS. Namun, perlu dicatat bahwa jika total biaya item Anda melebihi ambang de minimis, kode HS mungkin diperlukan. Dalam kasus tersebut, mengirimkan permintaan tanpa kode HS akan mengakibatkan kesalahan.
Untuk setiap item yang ingin Anda sertakan dalam kutipan landed cost, tambahkan entri ke dalam array items pada body permintaan.
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 dan tujuan untuk pengiriman Anda diperlukan untuk menghitung landed cost. Alamat lengkap diperlukan untuk tujuan pengiriman, tetapi mencantumkan negara pengirim sudah cukup untuk sebagian besar kutipan landed cost.
Permintaan
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Berikan biaya pengiriman
API Zonos Landed Cost tidak menghitung biaya pengiriman - ia fokus pada bea cukai, pajak, dan biaya. Karena pengiriman adalah aspek yang cukup besar dari total kutipan landed cost dan faktor signifikan dalam bagaimana hal-hal dihitung, sangat penting untuk menentukan biaya pengiriman di awal. Nilai ini dapat diperoleh dengan menggunakan API penilaian pengiriman, seperti API Penilaian Zonos, atau melalui berbagai cara lain, seperti perangkat lunak pengiriman dari penyedia layanan Anda, grafik rate, dll.
Informasi yang berkaitan dengan biaya pengiriman, termasuk jumlah pengiriman keseluruhan, dikirim melalui bidang shipping dalam permintaan API Anda.
Permintaan
{
"shipping": {
"amount": 14.23
}
}
Sementara hanya jumlah yang diperlukan, Anda juga dapat memberikan nama tingkat layanan untuk memungkinkan API menghitung biaya pengangkut berdasarkan jumlah yang diberikan. Anda dapat melihat daftar pengangkut dan tingkat layanan yang didukung di Landed Cost docs.
Permintaan
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Kirim permintaan API
Sekarang setelah Anda membangun permintaan Anda dan mengkonfigurasinya, Anda dapat mengirim permintaan POST ke API Zonos Landed Cost. Pastikan untuk mengautentikasi dengan kunci API Anda dan memberikan header versi yang benar dalam permintaan Anda.
POST https://api.zonos.com/v1/landed_cost
Permintaan
{
"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"
}
}
Respon
{
"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"
}
Hitung landed cost
Pelajari cara meminta landed cost melalui REST API.REST
API Zonos Landed Cost memungkinkan Anda dengan cepat mendapatkan kutipan landed cost yang sangat akurat untuk pengiriman impor dan ekspor lintas batas. Sementara memberikan kode harmonisasi (HS) memungkinkan Zonos Landed Cost untuk mengembalikan perhitungan bea yang paling akurat, kami akan mengembalikan jumlah perkiraan bea dan pajak bahkan ketika kode harmonisasi tidak disediakan.