Настройка Zonos
Сначала зарегистрируйтесь для получения учетной записи Zonos и настройте свою учетную запись на Zonos Dashboard. Затем вы сможете получить свой API-ключ, который позволит вам аутентифицироваться с API Zonos.
Установите базовую валюту
Чтобы предоставить контекст о денежных суммах, включенных в запрос landed cost, вам необходимо указать код базовой валюты вашего запроса (в качестве кода валюты ISO). Это будет относиться ко всем денежным значениям в запросе и к валюте, в которой будет представлен результирующий расчет landed cost. Вы можете найти список поддерживаемых валют и их коды ISO в нашей документации по landed cost.
Запрос
{
"currency": "USD"
}
Укажите детали товара
Чтобы получить максимально точную возможную landed cost котировку с использованием Zonos, вам необходимо предоставить как можно больше деталей по каждому товару, включая гармонизированные (HS) коды. Как правило, чем больше информации вы предоставите, тем точнее будет ваша котировка.
Хотя предоставление HS кодов позволяет Zonos Landed Cost вернуть наиболее точные и полные расчеты, возможно приблизительно оценить фактическую landed cost без HS кода. Однако обратите внимание, что если общая стоимость ваших товаров превышает порог de minimis, может потребоваться 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"
}
}
Укажите стоимость доставки
API Zonos Landed Cost не рассчитывает стоимость доставки - он сосредоточен на таможенных пошлинах, налогах и сборах. Поскольку доставка является значительным аспектом общей оценки landed cost и важным фактором в том, как все рассчитывается, важно заранее указать стоимость доставки. Это значение можно получить, используя API оценки отправлений, такой как API оценки Zonos, или различными другими способами, такими как программное обеспечение для доставки вашего перевозчика, таблицы rate и т. д.
Информация, относящаяся к стоимости доставки, включая общую сумму доставки, отправляется через поле shipping в вашем запросе API.
Запрос
{
"shipping": {
"amount": 14.23
}
}
Хотя требуется только сумма, вы также можете предоставить название уровня обслуживания, чтобы API мог рассчитать сборы перевозчика на основе предоставленной суммы. Вы можете увидеть список поддерживаемых перевозчиков и уровней обслуживания в наших документах Landed Cost.
Запрос
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Отправить запрос к API
Теперь, когда вы построили свой запрос и настроили его, вы можете отправить POST запрос к API Zonos Landed Cost. Убедитесь, что вы аутентифицировались с помощью вашего 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
Узнайте, как запросить landed cost через REST API.REST
API Zonos Landed Cost позволяет вам быстро получить высокоточный расчет landed cost для трансграничных импортных и экспортных отправлений. Предоставление гармонизированных (HS) кодов позволяет Zonos Landed Cost вернуть наиболее точный расчет пошлин, однако мы также вернем приблизительную сумму пошлин и налогов, даже если гармонизированный код не предоставлен.