DOCS

Landed cost object

/

Landed Cost объект

Изучите возможности и функции объекта Landed Cost.

Объект Landed Cost предоставляет разбивку и общую сумму импортных пошлин, налогов и сборов.

Атрибуты 

ПолеЗаметки
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 STRINGURL изображения.
customs.items.note STRINGДополнительные детали о таможенной очистке или HS коде, если применимо. Пример для Индии: Согласно индийским правилам импорта для личных отправлений, ваш HS код был исправлен на 9804.90.00.
customs.items.quantity INTEGERКоличество товара, отправленное в запросе.
customs.items.upc_code STRINGUPC код товара.
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 STRINGDe 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"
    }
  ]
}

Была ли эта страница полезной?


На этой странице: