Настройка 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 рейтинга поставок, например Zonos Rating API, или другими способами, такими как программное обеспечение вашего перевозчика, таблицы тарифов и т. д.
Информация, связанная со стоимостью доставки, включая общую сумму доставки, отправляется через поле 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"
Рассчитайте Landed Cost
Узнайте, как запросить Landed Cost через REST API.REST
API Zonos Landed Cost позволяет быстро получить точную смету Landed Cost для трансграничного импорта и экспорта. Хотя предоставление гармонизированных (HS) кодов позволяет Zonos Landed Cost вернуть наиболее точный расчет пошлины, мы вернем приблизительный размер пошлин и налогов даже без гармонизированного кода.