Атрибуты
Поле | Заметки |
---|---|
id STRING | Уникальный идентификатор объекта. Идентификатор для объекта Landed Cost всегда будет начинаться с ldct . |
amount_subtotal HASH | Общая сумма Landed cost. Если используется для checkout в электронной коммерции, мы рекомендуем использовать эти суммы для отображения конечному пользователю. Эти суммы позволяют упростить интеграцию без необходимости суммировать пошлины, налоги или сборы по каждому товару и уровню отправки. Дополнительные детали доступны в объекте landed cost. См. дочерние атрибуты ниже. |
amount_subtotal.duties DECIMAL | Сумма всех пошлин в массиве пошлин. Включает пошлины, наложенные на товары, доставку или любые дополнительные пошлины, применяемые к импорту. Чтобы понять, как рассчитываются пошлины, см. документ о ввозных пошлинах. |
amount_subtotal.fees DECIMAL | Сумма различных сборов в массиве сборов. Включает сборы за таможенное оформление, сборы за импорт в страну или другие сборы, применяемые к импорту. Чтобы узнать больше о сборах за импорт, см. документ о сборах за импорт. |
amount_subtotal.taxes DECIMAL | Сумма всех налогов в массиве налогов. Включает налоги, применяемые к товарам, пошлинам, доставке или сборам. Чтобы узнать больше о налогах на импорт, см. документ о налогах на импорт. |
currency HASH | Хэш, предоставляющий информацию о базовой валюте, отправленной в запросе, и других валютах с курсом rate, использованным на момент ответа. Это полезно, если вы хотите конвертировать в валюту страны импорта или в другие валюты, используемые в расчете landed cost. См. дочерние атрибуты ниже. |
currency.id STRING | Уникальный идентификатор для объекта валюты. |
currency.base STRING | Базовая валюта, отправленная в запросе landed cost, представленная трехбуквенным кодом ISO. Все суммы в объекте landed cost указаны в базовой валюте. |
currency.date TIMESTAMP | Дата, когда курс валюты rate был получен, в формате ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ |
currency.rates HASH | Хэш, содержащий валюты и обменные курсы, необходимые для конвертации из базовой валюты. |
currency.rates.currency STRING | Валюта обменного rate, используемая в расчете landed cost. |
currency.rates.rate DECIMAL | Обменный rate на момент запроса landed cost для указанной валюты. |
customs HASH | Хэш, содержащий информацию, используемую для определения landed cost, а также информацию, необходимую для таможенной документации и таможенного оформления. См. дочерние атрибуты ниже. |
customs.delivery_duty_paid STRING | Возможность выставления счетов за пошлины и налоги кому-то, кроме получателя (DDP - доставка с уплаченными пошлинами) варьируется в зависимости от перевозчика, службы доставки или страны назначения. Возможные значения: available , unavailable и unknown . Если landed cost используется для электронной коммерции checkout, вы должны разрешить покупателю оплачивать пошлины и налоги только в том случае, если результат available . Если результат unknown , вы можете либо представить покупателю оценочную сумму пошлины и налога, которые ему придется оплатить при доставке, либо не отображать пошлину и налог вообще для этого уровня услуги перевозчика. Если результат unavailable , ваша учетная запись была настроена в Zonos Dashboard так, чтобы не разрешать DDP, даже если это разрешенная услуга выбранного перевозчика. |
customs.items LIST | Список товаров, отправленных в запросе. См. дочерние атрибуты ниже. |
customs.items.id STRING | Уникальный идентификатор, отправленный в запросе. |
customs.items.amount DECIMAL | Сумма товара в базовой валюте. Это сумма, отправленная в запросе для этого товара. |
customs.items.country_of_origin STRING | Страна производства, где был произведен товар или статья. Представлена двухбуквенным ISO кодом. См. документ о ввозных пошлинах, чтобы понять, как страна происхождения влияет на расчет landed cost. |
customs.items.country_of_origin_source STRING | Источник страны происхождения. Возможные значения: zonos_catalog , api_request и account_default platform . |
customs.items.description_customs STRING | Рекомендуемое описание товаров для коммерческого счета-фактуры. Это описание обычно отличается от розничного описания и обычно включает общее описание того, что это такое, из чего оно сделано и для чего используется. |
customs.items.description_retail STRING | Розничное описание товара. |
customs.items.detail STRING | Дополнительные характеристики, атрибуты или описания товара. |
customs.items.dimensions LIST | Размер отправления. hash |
customs.items.dimensions.height DECIMAL | Высота товара. |
customs.items.dimensions.length DECIMAL | Длина товара. |
customs.items.dimensions.unit STRING | Единица измерения для размеров товара. Возможные значения: inch , centimeter , millimeter и null . Когда null , будет использоваться inch . |
customs.items.dimensions.width DECIMAL | Ширина товара. |
customs.items.hs_code STRING | Гармонизированный тарифный код, используемый для определения тарифной rate в расчете landed cost. |
customs.items.hs_code_source STRING | Источник гармонизированного тарифного кода, который может быть установлен Zonos. Возможные значения: zonos_catalog , api_request , zonos_classified , account_default и hs_correction . |
customs.items.image_url STRING | URL изображения. |
customs.items.note STRING | Дополнительные детали о таможенной очистке или HS коде, если применимо. Пример для Индии: Согласно индийским правилам импорта для личных отправлений, ваш HS код был исправлен на 9804.90.00 . |
customs.items.quantity INTEGER | Количество товара, отправленное в запросе. |
customs.items.upc_code STRING | UPC код товара. |
customs.items.weight DECIMAL | Вес товара. |
customs.items.weight_unit STRING | Единица измерения для веса. Возможные значения: pound , ounce , kilogram и null . Когда null , будет использоваться pound . |
customs.ship_to_country STRING | Страна импорта, где применяются пошлины и налоги. |
customs.shipping_amount DECIMAL | Сумма доставки, которая должна быть указана в таможенной документации. |
de_minimis HASH | Информация о пороге, специфичном для страны, который определяет, когда применяются пошлины и налоги. Массив валютных курсов будет содержать конверсионный rate используемый для определения, превышает ли импорт пороги пошлин и налогов или нет. См. дочерние атрибуты ниже. |
de_minimis.formula STRING | Формула, используемая для расчета права на порог de minimis. |
de_minimis.method STRING | Это метод расчета, такой как cif , cifd , cifdt , fob или fobd . |
de_minimis.note STRING | Дополнительные сведения о de minimis, такие как информация о том, если товар не подлежит рассмотрению по de minimis, например, вино. |
de_minimis.threshold STRING | Применяется ли налог ниже или выше порога налога. Возможные значения: above или below . |
de_minimis.type STRING | De minimis применяется к type . Возможные значения: tax и duty . |
duties HASH | Массив пошлин, применяемых к импорту. Сумма сумм пошлин равна amount_subtotal.duties . См. дочерние атрибуты ниже. |
duties.amount DECIMAL | Сумма пошлины на item , shipping или fee . |
duties.description STRING | Различные описания пошлины, такие как duty , anti_dumping_duty и другие. |
duties.formula STRING | Формула, используемая для расчета суммы пошлины. Для пошлины это обычно тариф для страны импорта и может быть ад валорем или конкретной пошлиной rate. |
duties.item_id STRING | Уникальный идентификатор, отправленный в запросе. Идентификатор предоставляется только тогда, когда тип item . |
duties.note STRING | Дополнительные сведения о пошлине, включая соглашения о свободной торговле, сниженные ставки пошлин, антидемпинговые пошлины и другие. |
duties.type STRING | Пошлина применяется к type . Возможные значения: item , shipping и fee . |
fees HASH | Массив сборов, применяемых к импорту. Сумма сумм сборов равна amount_subtotal.fees . См. дочерние атрибуты ниже. |
fees.amount DECIMAL | Сумма сбора, применяемая к товару, доставке, пошлине, уровню обслуживания, перевозчику или стране. Эта сумма указана в базовой валюте и могла быть конвертирована из соответствующей валюты страны импорта в базовую валюту, отправленную в запросе. |
fees.description STRING | Различные описания сбора, такие как UPS Disbursement Fee , FedEx Advancement Fee и An Post Clearance Fee . |
fees.formula STRING | Формула, используемая для расчета сбора. Для сборов это обычно фиксированная сумма, процент от пошлин и налогов или другая формула. |
fees.item_id STRING | Ваш уникальный идентификатор, отправленный в запросе landed cost. Идентификатор предоставляется только тогда, когда тип item . |
fees.note STRING | Дополнительные сведения о сборе, если это необходимо. |
fees.type STRING | Сбор применяется к type . Возможные значения: advancement , additional_tariff_lines , ddp_service_fee , brokerage , cod , country и other . |
messages HASH | Список некритических сообщений, например: "Сумма доставки в запросе была равна нулю, это может повлиять на расчет." |
messages.message STRING | Полезное сообщение, относящееся к вашему запросу Landed Cost и о том, какая некритическая информация отсутствовала. |
messages.type STRING | Тип сообщения. Возможные значения: price_adjustment , default_value_used , shipping_missing и item_weight_missing . |
remittance HASH | Массив, содержащий сумму и детали того, что необходимо перечислить в конкретную страну (например, Австралия, Новая Зеландия, Норвегия или Великобритания). |
remittance.amount DECIMAL | Сумма денег, которую необходимо перечислить в конкретную страну. |
remittance.description STRING | Описание того, для чего предназначено перечисление (например, НДС Великобритании). |
remittance.note STRING | Заметка о том, как налог должен быть уплачен (например, remit в HMRC ежеквартально). |
removed_items LIST | Список товаров, удаленных из запроса для расчета landed cost. См. дочерние атрибуты ниже. |
removed_items.id STRING | Уникальный идентификатор, отправленный в запросе. |
removed_items.amount DECIMAL | Сумма товара в базовой валюте. Это сумма, отправленная в запросе для этого товара. |
removed_items.country_of_origin STRING | Страна производства, где был произведен товар или статья. Представлена двухбуквенным ISO кодом. См. документ о ввозных пошлинах, чтобы понять, как страна происхождения влияет на расчет landed cost. |
removed_items.country_or_origin_source STRING | Источник страны происхождения. Возможные значения: zonos_catalog , api_request и account_default platform . |
removed_items.description_customs STRING | Предложенное описание товаров для коммерческого счета-фактуры. Это описание обычно отличается от розничного описания и обычно включает общее описание того, что это, из чего это сделано и для чего это используется. |
removed_items.description_retail STRING | Розничное описание товара. |
removed_items.hs_code STRING | Гармонизированный тарифный код, используемый для определения тарифной rate в расчете landed cost. |
removed_items.hs_code_source STRING | Источник гармонизированного тарифного кода, который может быть установлен Zonos. Возможные значения: zonos_catalog , api_request , platform , zonos_classified , account_default и hs_correction . |
removed_items.note STRING | Дополнительные сведения о таможенной очистке или HS коде, если применимо. Пример для Индии: Согласно индийским импортным правилам для личных отправлений, ваш HS код был исправлен на 9804.90.00 . |
removed_items.quantity INTEGER | Количество товара, отправленное в запросе. |
taxes HASH | Массив налогов, применяемых к импорту. Сумма налоговых сумм равна amount_subtotal.taxes . См. дочерние атрибуты ниже. |
taxes.amount DECIMAL | Сумма налога на товар, доставку, пошлину или сбор. |
taxes.description STRING | Различные описания применяемого налога, такие как tax , VAT , GST , PST , HST и другие. |
taxes.formula STRING | Формула, используемая для расчета суммы налога, обычно включает налог страны импорта; однако это также может быть налог штата (или провинции) или сниженный (или добавленный) налог. |
taxes.item_id STRING | Уникальный идентификатор, отправленный в запросе landed cost. Идентификатор предоставляется только в том случае, если тип item . |
taxes.note STRING | Дополнительные сведения о налоге, включая сниженные налоговые ставки или другую применимую информацию о применяемом налоге. |
taxes.type STRING | Налог применяется к type . Возможные значения включают item , duty и shipping , а также типы сборов advancement , additional_tariff_lines , ddp_service_fee , brokerage , cod , country и other . |
Пример запроса
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
"amount_subtotal": {
"duties": 0,
"fees": 15,
"taxes": 12.25
},
"currency": {
"id": "b5f06418-3",
"base": "USD",
"date": "2021-01-07T00:34:03.471+0000",
"rates": [
{
"currency": "GBP",
"rate": 0.8117
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 39.17,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Hoka One Running Shoe - Women's",
"description_retail": "Hoka One Running Shoe - Women's",
"hs_code": "6116.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
"quantity": 1
},
{
"id": "294396",
"amount": 7.83,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Galaxy Quest Men's Tee Blue",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "GB"
},
"de_minimis": [
{
"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
"method": "FOB",
"note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
"threshold": "below",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 gbp)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [],
"fees": [
{
"amount": 15,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
}
],
"remittance": [
{
"amount": 12.25,
"description": "UK VAT",
"note": "remit to HMRC quarterly"
}
],
"removed_items": [],
"taxes": [
{
"amount": 7.83,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 2.3719,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "shipping"
},
{
"amount": 1.57,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 0.4741,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "shipping"
}
]
}
Landed Cost объект
Изучите возможности и функции объекта Landed Cost.
Объект Landed Cost предоставляет разбивку и общую сумму импортных пошлин, налогов и сборов.