DOCS

Landed cost object

/

Landed Cost 对象

探索 Landed Cost 对象的功能和能力。

Landed Cost 对象提供了进口关税、税费和费用的详细信息和总计。

属性 

字段备注
id 字符串对象的唯一标识符。Landed Cost 对象的 id 始终以 ldct 为前缀。
amount_subtotal 哈希Landed cost 总计。如果用于电子商务 checkout,我们建议使用这些总计向最终用户显示。这些总计允许更轻松的集成,无需按项目和运输级别汇总关税、税费或费用。有关更多详细信息,请参见 landed cost 对象。请参见下面的子属性。
amount_subtotal.duties 十进制关税数组中所有关税的总和。包括对商品、运输或任何额外征收的关税。要了解关税是如何计算的,请参见 进口关税文档
amount_subtotal.fees 十进制费用数组中各种费用的总和。包括清关费用、国家进口费用或其他适用于进口的费用。要了解更多关于进口费用的信息,请参见 进口费用文档
amount_subtotal.taxes 十进制税费数组中所有税费的总和。包括适用于商品、关税、运输或费用的税费。要了解更多关于进口税的信息,请参见 进口税文档
currency 哈希提供请求中发送的基础货币信息以及响应时使用的其他货币和汇率 rate。如果您想转换为进口国货币或其他用于 landed cost 计算的货币,这非常有用。请参见下面的子属性。
currency.id 字符串货币对象 的唯一标识符。
currency.base 字符串在 landed cost 请求中发送的基础货币,以三字母 ISO 代码表示。landed cost 对象中的所有金额均以基础货币列出。
currency.date 时间戳以 ISO 8601 格式提取货币 rate 的日期:YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates 哈希包含从基础货币转换所需的货币和汇率的哈希。
currency.rates.currency 字符串在 rate 计算中使用的汇率 landed cost 货币。
currency.rates.rate 十进制在 rate 请求时指定货币的汇率 landed cost。
customs 哈希包含用于确定 landed cost 的信息以及海关文档和海关清关所需的信息的哈希。请参见下面的子属性。
customs.delivery_duty_paid STRING向接收者以外的其他人收取关税和税费的能力(DDP - 已支付交付关税)因运输承运人、运输服务或目的国而异。可能的值为 availableunavailableunknown。如果在电子商务 landed cost 中使用 checkout,则应仅在结果为 available 时允许购物者支付关税和税费。如果结果为 unknown,您可以向购物者提供他们在交付时需要支付的关税和税费的估算金额,或者您可能不想在该承运人服务级别下显示关税和税费。如果结果为 unavailable,则您的帐户已在 Zonos 仪表板中配置为不允许 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_catalogapi_requestaccount_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物品尺寸的计量单位。可能的值为 inchcentimetermillimeternull。当为 null 时,将使用 inch
customs.items.dimensions.width DECIMAL物品的宽度。
customs.items.hs_code STRING用于确定 rate 的关税协调编码,在 landed cost 计算中使用。
customs.items.hs_code_source STRING使用的关税协调编码的来源,可以由 Zonos 设置。可能的值为 zonos_catalogapi_requestzonos_classifiedaccount_defaulths_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重量的计量单位。可能的值为 poundouncekilogramnull。当为 null 时,将使用 pound
customs.ship_to_country STRING征收关税和税费的进口国。
customs.shipping_amount DECIMAL应在海关文件上列出的运费金额。
de_minimis HASH关于特定国家阈值的信息,该阈值决定何时适用关税和税费。货币汇率数组将包含用于确定进口是否超过或低于关税和税费阈值的转换 rate。请参见下面的子属性。
de_minimis.formula STRING用于计算最低免税阈值资格的公式。
de_minimis.method STRING计算方法,例如 cifcifdcifdtfobfobd
de_minimis.note STRING关于最低免税的附加细节,例如提供信息以说明某项物品是否不符合最低免税考虑,例如葡萄酒。
de_minimis.threshold STRING税费是否低于或高于税费阈值。可能的值包括 abovebelow
de_minimis.type STRING应用于 type 的最低免税。可能的值包括 taxduty
duties HASH应用于进口的关税数组。关税金额的总和等于 amount_subtotal.duties。请参见下面的子属性。
duties.amount DECIMALitemshippingfee 的关税金额。
duties.description STRING关税的不同描述,例如 dutyanti_dumping_duty 等。
duties.formula STRING用于计算关税金额的公式。对于关税,这通常是进口国的关税,可能是从价税或特定关税 rate。
duties.item_id STRING请求中发送的唯一标识符。仅在类型为 item 时提供该 ID。
duties.note STRING关于关税的附加细节,包括自由贸易协议、降低的关税率、反倾销关税等。
duties.type STRING关税适用于 type。可能的值包括 itemshippingfee
fees HASH应用于进口的费用数组。费用金额的总和等于 amount_subtotal.fees。请参见下面的子属性。
fees.amount DECIMAL应用于物品、运费、关税、服务级别、承运人或国家的费用金额。该金额以基本货币表示,可能已从进口国的相应货币转换为请求中发送的基本货币。
fees.description STRING费用的不同描述,例如 UPS Disbursement FeeFedEx Advancement FeeAn Post Clearance Fee
fees.formula STRING用于计算费用的公式。对于费用,这通常是固定金额、关税和税费的百分比或其他公式。
fees.item_id STRING在 landed cost 请求中发送的唯一标识符。仅在类型为 item 时提供该 ID。
fees.note STRING关于费用的附加细节(如有需要)。
fees.type STRING费用适用于 type。可能的值包括 advancementadditional_tariff_linesddp_service_feebrokeragecodcountryother
messages HASH一系列非关键消息,例如“请求中的运费为 null,这可能会影响计算。”
messages.message STRING与您的 Landed Cost 请求相关的有用消息,以及缺少的非关键性信息。
messages.type STRING消息类型。可能的值包括 price_adjustmentdefault_value_usedshipping_missingitem_weight_missing
remittance HASH包含需要汇款到特定国家(例如澳大利亚、新西兰、挪威或英国)的金额和详细信息的数组。
remittance.amount DECIMAL需要汇款到特定国家的金额。
remittance.description STRING汇款用途的描述(例如英国增值税)。
remittance.note 字符串关于税款应如何汇款的说明(例如,remit 每季度向 HMRC 汇款)。
removed_items 列表从请求中移除的 landed cost 计算的项目列表。项目请参见下面的子属性。
removed_items.id 字符串请求中发送的唯一标识符。
removed_items.amount 十进制基础货币中的项目金额。这是为该项目在请求中发送的金额。
removed_items.country_of_origin 字符串制造该项目或物品的国家。由 两字母 ISO 代码 表示。请参阅 进口关税文档 以了解原产国如何影响 landed cost 计算。
removed_items.country_or_origin_source 字符串原产国的来源。可能的值为 zonos_catalogapi_requestaccount_default platform
removed_items.description_customs 字符串商业发票上建议的商品描述。该描述通常与零售描述不同,通常包括对其是什么、由什么制成以及用途的一般描述。
removed_items.description_retail 字符串项目的零售描述。
removed_items.hs_code 字符串用于确定 rate 计算中的关税 landed cost 的协调关税代码。
removed_items.hs_code_source 字符串使用的协调关税代码的来源,可以由 Zonos 设置。可能的值为 zonos_catalogapi_requestplatformzonos_classifiedaccount_defaulths_correction
removed_items.note 字符串关于项目清关或 HS 代码的附加细节(如适用)。印度的一个示例是 根据印度个人货物的进口指南,您的 HS 代码已更正为 9804.90.00
removed_items.quantity 整数请求中发送的项目数量。
taxes 哈希应用于进口的税费数组。税额的总和等于 amount_subtotal.taxes。请参见下面的子属性。
taxes.amount 十进制项目、运输、关税或费用的税额。
taxes.description 字符串应用税的不同描述,例如 taxVATGSTPSTHST 等。
taxes.formula 字符串用于计算税额的公式通常包括进口国税;但是,这也可能是州(或省)税或减免(或增加)税。
taxes.item_id 字符串在 landed cost 请求中发送的唯一标识符。仅在类型为 item 时提供该 ID。
taxes.note 字符串关于税的附加细节,包括减税率或其他适用的税务信息。
taxes.type 字符串税适用于 type。可能的值包括 itemdutyshipping,以及费用类型的 advancementadditional_tariff_linesddp_service_feebrokeragecodcountryother

示例请求

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"
    }
  ]
}

这个页面有帮助吗?


有问题吗?

联系我们。
在本页上: