Атрибуты
Пары ключ-значение в JSON в теле запроса
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Приведенный выше заголовок является обязательным входным параметром для успешного завершения этого запроса расчета таможенной стоимости.
| Поле↕ | Примечания↕ |
|---|---|
currency ТРЕБУЕТСЯ | Строка базовой валюты, представленная трехбуквенным кодом ISO. |
discounts ОПЦИОНАЛЬНО | Информация, связанная с любыми скидками, включая идентификатор, сумму и любые детали. |
discounts.id ОПЦИОНАЛЬНО | Уникальный идентификатор скидки для продавца или экспортера. |
discounts.amount ОПЦИОНАЛЬНО | Десятичное число с суммой скидки в долларах и центах. |
discounts.detail ОПЦИОНАЛЬНО | Дополнительные функции, атрибуты или описания скидки. |
items ТРЕБУЕТСЯ | Список экспортируемых товаров. hash |
items.id ТРЕБУЕТСЯ | Уникальный идентификатор товара для продавца или экспортера. |
items.amount ТРЕБУЕТСЯ | Десятичное число с общей суммой одного товара в долларах и центах. |
items.amount_discount ОПЦИОНАЛЬНО | Размер скидки, применяемой к товару. |
items.brand ОПЦИОНАЛЬНО | Бренд товара, например, Leatherman. |
items.category ОПЦИОНАЛЬНО | Описание категории товара, например, Одежда. |
items.color ОПЦИОНАЛЬНО | Цвет товара. |
items.country_of_origin ОПЦИОНАЛЬНО | Страна производства, представленная двухбуквенным кодом ISO. Рекомендуется для наиболее точных расчетов. Если страна происхождения не указана, используется ставка "Наиболее благоприятствуемой нации" (МБН). |
items.description_customs ОПЦИОНАЛЬНО | Рекомендуемое описание товаров для коммерческого счета-фактуры. Это описание обычно отличается от розничного описания и обычно включает общее описание того, что это такое, из чего оно сделано и для чего оно используется. |
items.description_retail ОПЦИОНАЛЬНО | Розничное описание товара. |
items.detail ОПЦИОНАЛЬНО | Дополнительные функции, атрибуты или описания товара. |
items.dimensions ОПЦИОНАЛЬНО | Размер партии. Рекомендуется для получения наиболее точных расчетов в странах, где тарифы зависят от размеров товара. hash |
items.dimensions.height ОПЦИОНАЛЬНО | Десятичное число для высоты товара. |
items.dimensions.length ОПЦИОНАЛЬНО | Десятичное число для длины товара. |
items.dimensions.unit ОПЦИОНАЛЬНО | Единица измерения размеров товара. Возможные значения: inch, centimeter, millimeter и null. Если значение null, будет использоваться inch. |
items.dimensions.width ОПЦИОНАЛЬНО | Десятичное число для ширины товара. |
items.duty_tax_fee_free ОПЦИОНАЛЬНО | Строка для указания, должен ли товар быть исключен из расчета таможенной стоимости. Когда в запросе отправляется значение exclude, товар будет отображаться в removed_items в ответе API. |
items.hs_code ОПЦИОНАЛЬНО | Код HS товара, от 2 до 10 цифр. |
items.image_url ОПЦИОНАЛЬНО | URL изображения. |
items.quantity ТРЕБУЕТСЯ | Целое число, обозначающее количество товара. |
items.upc_code ОПЦИОНАЛЬНО | Строка кода UPC для товара. |
items.weight ОПЦИОНАЛЬНО | Десятичное число для веса товара. |
items.weight_unit ОПЦИОНАЛЬНО | Строка единицы измерения веса. Возможные значения: pound, ounce, kilogram и null. Если значение null, будет использоваться pound. |
landed_cost ОПЦИОНАЛЬНО | Тип запроса расчета таможенной стоимости. Возможные значения: delivery_duty_paid и delivery_duty_unpaid. Сборы за расчет таможенной стоимости могут отличаться в зависимости от того, отправляется ли DDP или DDU. Если значение null, будет предполагаться запрос DDP. Если выполняется запрос DDP и DDP недоступен, будет возвращена ошибка 400 с сообщением о том, что DDP недоступен для указанного уровня обслуживания. DDP и DDU обычно доступны в рамках каждого уровня обслуживания, поэтому убедитесь, что это может быть настроено на основе уровня обслуживания, а не на уровне учетной записи. |
sale_type ОПЦИОНАЛЬНО | Индикатор типа продажи. Возможные значения: not_for_resale и for_resale. Если значение null, будет предполагаться запрос not_for_resale. |
ship_from_country ТРЕБУЕТСЯ | Строка страны отправки, представленная двухбуквенным кодом ISO. |
ship_to ТРЕБУЕТСЯ | Адрес назначения. hash |
ship_to.city ОПЦИОНАЛЬНО* | Строка города, поселка, района, пригорода или деревни по адресу доставки. В зависимости от страны импорта это поле может быть ТРЕБУЕТСЯ. |
ship_to.country ТРЕБУЕТСЯ | Строка страны назначения, в которой находится банковский счет, представленная двухбуквенным кодом ISO. |
ship_to.postal_code ОПЦИОНАЛЬНО* | Строка почтового индекса пункта назначения. Это поле может быть требуется при отправке между Северной Ирландией и Европейским союзом. |
ship_to.state ОПЦИОНАЛЬНО* | Строка кода штата/области пункта назначения, если доступно. Если страна импорта — Бразилия или Канада, это поле требуется. |
shipping ТРЕБУЕТСЯ | Детали доставки, такие как размер, размер скидки и уровень обслуживания у перевозчика. hash |
shipping.amount ТРЕБУЕТСЯ | Десятичное число, представляющее общую стоимость доставки в долларах и центах. |
shipping.amount_discount ОПЦИОНАЛЬНО | Десятичное число, представляющее размер скидки на доставку. |
shipping.service_level ТРЕБУЕТСЯ | Уровень обслуживания у перевозчика. Полный список доступных уровней обслуживания по перевозчикам см. в документации перевозчика. |
*Это поле опционально в зависимости от требований к адресным полям для страны импорта.
1
{2
"currency": "USD",3
"discounts": [4
{5
"id": "sale124",6
"amount": 43,7
"detail": null8
}9
],10
"items": [11
{12
"id": "294395",13
"amount": 75,14
"amount_discount": 0,15
"brand": null,16
"category": "Women's Clothing",17
"color": null,18
"country_of_origin": "FR",19
"description_customs": null,20
"description_retail": "Hoka One Running Shoe - Women's",21
"detail": null,22
"dimensions": {23
"height": 4,24
"length": 6,25
"unit": "inch",26
"width": 1127
},28
"duty_tax_fee_free": null,29
"hs_code": "6116.10.00",30
"image_url": "https://zonos.com/images/handbag.webp",31
"quantity": 1,32
"upc_code": null,33
"weight": 10,34
"weight_unit": "pound"35
},36
{37
"id": "294396",38
"amount": 15,39
"country_of_origin": "CN",40
"country_of_origin_source": "account_default",41
"description_customs": "Men's t-shirt 100% polyester",42
"description_retail": "Galaxy Quest Men's Tee Blue",43
"detail": null,44
"dimensions": {45
"height": 4,46
"lenght": 6,47
"unit": "inch",48
"width": 1149
},50
"duty_tax_fee_free": "exclude",51
"hs_code": "6217.10",52
"image_url": null,53
"note": null,54
"quantity": 1,55
"upc_code": null,56
"weight": 1,57
"weight_unit": "pound"58
}59
],60
"landed_cost": "delivery_duty_paid",61
"sale_type": "not_for_resale",62
"ship_from_country": "US",63
"ship_to": {64
"city": "Campinas",65
"country": "BR",66
"postal_code": "75828-000",67
"state": "SP"68
},69
"shipping": {70
"amount": 14.23,71
"amount_discount": 0,72
"service_level": "ups_express_saver"73
},74
"tariff_rate": "zonos_preferred"75
}
Запрос расчета таможенной стоимости
Найдите пары ключ-значение в запросе расчета таможенной стоимости.
Хотя Zonos Landed Cost способен предоставить точный расчет таможенной стоимости на основе только описания товара, чем больше информации будет предоставлено, тем точнее будет расчет. Ниже приведены ТРЕБУЕМЫЕ и ОПЦИОНАЛЬНЫЕ входные данные, но рекомендуется заполнить как можно больше ОПЦИОНАЛЬНЫХ полей.