Zonos 설정
먼저, Zonos 계정에 등록하고 Zonos 대시보드에서 계정을 구성합니다. 그러면 API 키를 얻을 수 있으며, 이를 통해 Zonos API에 인증할 수 있습니다.
기본 통화 설정
landed cost 요청에 포함된 금액에 대한 맥락을 제공하기 위해 요청의 기본 통화 코드를 지정해야 합니다(ISO 통화 코드로). 이는 요청의 모든 금전적 가치와 결과적으로 생성될 landed cost 견적의 통화를 참조합니다. 지원되는 통화 및 해당 ISO 코드 목록은 landed cost 문서에서 확인할 수 있습니다.
요청
{
"currency": "USD"
}
항목 세부정보 제공
정확한 landed cost 견적을 얻기 위해 Zonos를 사용하려면, 조화된(HS) 코드 포함하여 가능한 한 많은 항목 세부정보를 제공해야 합니다. 일반적으로 포함하는 정보가 많을수록 견적이 더 정확해집니다.
HS 코드를 제공하면 Zonos Landed Cost가 가장 정확하고 완전한 계산을 반환할 수 있지만, HS 코드 없이도 실제 landed cost를 근사할 수 있습니다. 그러나 귀하의 항목 총 비용이 최소 면세 한도를 초과하는 경우 HS 코드가 필요할 수 있습니다. 이러한 경우 HS 코드 없이 요청을 보내면 오류가 발생합니다.
landed cost 견적에 포함할 각 항목에 대해 요청 본문의 items 배열에 항목을 추가하십시오.
요청
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
배송 주소 추가
배송의 출발지와 도착지 위치는 landed cost를 계산하는 데 필요합니다. 배송 목적지에 대한 완전한 주소가 필요하지만, 대부분의 landed cost 견적에는 출발 국가만 포함하면 충분합니다.
요청
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
배송 비용 제공
Zonos Landed Cost API는 배송 비용을 계산하지 않습니다 - 세금, 관세 및 수수료에 중점을 둡니다. 배송은 총 landed cost 견적의 중요한 측면이며, 계산 방식에 있어 중요한 요소이기 때문에 배송 비용을 사전에 명시하는 것이 필수적입니다. 이 값은 Zonos Rating API와 같은 배송 평가 API를 사용하거나, 귀하의 운송업체의 배송 소프트웨어, rate 차트 등 다양한 방법을 통해 얻을 수 있습니다.
배송 비용과 관련된 정보, 즉 전체 배송 금액은 API 요청의 shipping 필드를 통해 전송됩니다.
요청
{
"shipping": {
"amount": 14.23
}
}
금액만 필요하지만, API가 제공된 금액을 기준으로 운송업체 요금을 계산할 수 있도록 서비스 수준 이름을 제공할 수도 있습니다. 지원되는 운송업체 및 서비스 수준의 목록은 우리의 Landed Cost 문서에서 확인할 수 있습니다.
요청
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
API 요청 보내기
이제 요청을 작성하고 구성했으므로, Zonos Landed Cost API에 POST 요청을 보낼 수 있습니다. API 키로 인증하고 요청에 올바른 버전 헤더를 제공해야 합니다.
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",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
응답
{
"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"
}
landed cost 계산
REST API를 통해 landed cost를 요청하는 방법을 알아보세요.REST
Zonos Landed Cost API를 사용하면 국경 간 수출입 화물에 대한 매우 정확한 landed cost 견적을 신속하게 얻을 수 있습니다. 조화된(HS) 코드를 제공하면 Zonos Landed Cost가 가장 정확한 세금 계산을 반환할 수 있지만, 조화된 코드가 제공되지 않더라도 대략적인 세금 및 세금 금액을 반환합니다.