Đối tượng Landed Cost

Khám phá các khả năng và chức năng của đối tượng Landed Cost.

Đối tượng Landed Cost cung cấp một phân tích và tổng số thuế nhập khẩu, thuế và phí.

Thuộc tính 

TrườngGhi chú
id STRINGĐịnh danh duy nhất cho đối tượng. Id cho đối tượng Landed Cost sẽ luôn được tiền tố bằng ldct.
amount_subtotal HASHTổng của Landed cost. Nếu sử dụng cho checkout thương mại điện tử, chúng tôi khuyên bạn nên sử dụng các tổng này để hiển thị cho người dùng cuối. Các tổng này cho phép tích hợp dễ dàng hơn mà không cần phải cộng dồn thuế, phí hoặc lệ phí theo từng mặt hàng và cấp độ vận chuyển. Thông tin chi tiết bổ sung có sẵn trong đối tượng landed cost. Xem các thuộc tính con bên dưới.
amount_subtotal.duties DECIMALTổng của tất cả các lệ phí trong mảng lệ phí. Bao gồm các lệ phí áp dụng cho mặt hàng, vận chuyển hoặc bất kỳ lệ phí bổ sung nào áp dụng cho việc nhập khẩu. Để hiểu cách tính lệ phí, xem tài liệu thuế nhập khẩu.
amount_subtotal.fees DECIMALTổng của các phí khác nhau trong mảng phí. Bao gồm phí thông quan, phí nhập khẩu quốc gia hoặc các phí khác áp dụng cho việc nhập khẩu. Để hiểu thêm về phí nhập khẩu, xem tài liệu phí nhập khẩu.
amount_subtotal.taxes DECIMALTổng của tất cả các thuế trong mảng thuế. Bao gồm thuế áp dụng cho mặt hàng, lệ phí, vận chuyển hoặc phí. Để hiểu thêm về thuế nhập khẩu, xem tài liệu thuế nhập khẩu.
currency HASHHash cung cấp thông tin về tiền tệ cơ sở được gửi trong yêu cầu và các loại tiền tệ khác với rate tỷ giá hối đoái được sử dụng tại thời điểm phản hồi. Điều này hữu ích nếu bạn muốn chuyển đổi sang tiền tệ của quốc gia nhập khẩu hoặc sang các loại tiền tệ khác được sử dụng trong tính toán landed cost. Xem các thuộc tính con bên dưới.
currency.id STRINGĐịnh danh duy nhất cho đối tượng tiền tệ.
currency.base STRINGTiền tệ cơ sở được gửi trong yêu cầu landed cost, được biểu thị bằng mã ISO ba chữ cái. Tất cả các khoản tiền trong đối tượng landed cost đều được liệt kê bằng tiền tệ cơ sở.
currency.date TIMESTAMPNgày mà tỷ giá rate được lấy, theo định dạng ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASHHash chứa các loại tiền tệ và tỷ giá hối đoái cần thiết để chuyển đổi từ tiền tệ cơ sở.
currency.rates.currency STRINGMột loại tiền tệ rate được sử dụng trong tính toán landed cost.
currency.rates.rate DECIMALTỷ giá rate tại thời điểm yêu cầu landed cost cho loại tiền tệ được chỉ định.
customs HASHHash chứa thông tin được sử dụng để xác định landed cost cũng như thông tin cần thiết cho tài liệu hải quan và thông quan hải quan. Xem các thuộc tính con bên dưới.
customs.delivery_duty_paid STRINGKhả năng tính phí thuế và lệ phí cho một người khác ngoài người nhận (DDP - đã thanh toán lệ phí giao hàng) khác nhau tùy theo nhà vận chuyển, dịch vụ vận chuyển hoặc quốc gia đích. Các giá trị có thể là available, unavailable, và unknown. Nếu landed cost được sử dụng cho một checkout thương mại điện tử, bạn chỉ nên cho phép người mua thanh toán thuế và lệ phí nếu kết quả là available. Nếu kết quả là unknown, bạn có thể trình bày cho người mua một số tiền ước tính về thuế và lệ phí mà họ sẽ phải trả khi giao hàng hoặc bạn có thể không muốn hiển thị thuế và lệ phí cho cấp dịch vụ vận chuyển đó. Nếu kết quả là unavailable, tài khoản của bạn đã được cấu hình trong Zonos Dashboard để không cho phép DDP, mặc dù đây là một dịch vụ được phép bởi nhà vận chuyển đã chọn.
customs.items LISTDanh sách các mặt hàng được gửi trong yêu cầu. Xem các thuộc tính con bên dưới.
customs.items.id STRINGMã định danh duy nhất được gửi trong yêu cầu.
customs.items.amount DECIMALSố lượng mặt hàng trong tiền tệ cơ sở. Đây là số lượng được gửi trong yêu cầu cho mặt hàng này.
customs.items.country_of_origin STRINGQuốc gia sản xuất nơi mặt hàng hoặc sản phẩm được sản xuất. Được đại diện bởi một mã ISO hai chữ cái. Xem tài liệu thuế nhập khẩu để hiểu cách quốc gia xuất xứ ảnh hưởng đến việc tính toán landed cost.
customs.items.country_of_origin_source STRINGNguồn gốc của quốc gia xuất xứ. Các giá trị có thể là zonos_catalog, api_request, và account_default platform.
customs.items.description_customs STRINGMô tả hàng hóa được đề xuất cho hóa đơn thương mại. Mô tả này thường khác với mô tả bán lẻ và thường bao gồm một mô tả chung về nó, nó được làm từ gì, và nó được sử dụng để làm gì.
customs.items.description_retail STRINGMô tả bán lẻ của mặt hàng.
customs.items.detail STRINGCác tính năng, thuộc tính hoặc mô tả bổ sung của mặt hàng.
customs.items.dimensions LISTKích thước của lô hàng. hash
customs.items.dimensions.height DECIMALChiều cao của mặt hàng.
customs.items.dimensions.length DECIMALChiều dài của mặt hàng.
customs.items.dimensions.unit STRINGĐơn vị đo lường cho kích thước mặt hàng. Các giá trị có thể là inch, centimeter, millimeter, và null. Khi null, inch sẽ được sử dụng.
customs.items.dimensions.width DECIMALChiều rộng của mặt hàng.
customs.items.hs_code STRINGMã thuế hài hòa được sử dụng để xác định mức thuế rate trong việc tính toán landed cost.
customs.items.hs_code_source STRINGNguồn của mã thuế hài hòa được sử dụng, có thể được thiết lập bởi Zonos. Các giá trị có thể là zonos_catalog, api_request, zonos_classified, account_default, và hs_correction.
customs.items.image_url STRINGURL hình ảnh.
customs.items.note STRINGChi tiết bổ sung về việc thông quan mặt hàng hoặc mã HS, nếu có. Một ví dụ cho Ấn Độ là Theo hướng dẫn nhập khẩu của Ấn Độ cho các lô hàng cá nhân, mã HS của bạn đã được sửa thành 9804.90.00.
customs.items.quantity INTEGERSố lượng mặt hàng được gửi trong yêu cầu.
customs.items.upc_code STRINGMã UPC của mặt hàng.
customs.items.weight DECIMALTrọng lượng của mặt hàng.
customs.items.weight_unit STRINGĐơn vị đo lường cho trọng lượng. Các giá trị có thể là pound, ounce, kilogram, và null. Khi null, pound sẽ được sử dụng.
customs.ship_to_country STRINGQuốc gia nhập khẩu nơi thuế và lệ phí được áp dụng.
customs.shipping_amount DECIMALSố tiền vận chuyển cần được liệt kê trên tài liệu hải quan.
de_minimis HASHThông tin về ngưỡng cụ thể của quốc gia xác định khi nào thuế và phí áp dụng. Mảng tỷ giá tiền tệ sẽ chứa rate chuyển đổi được sử dụng để xác định xem việc nhập khẩu có vượt quá hay không vượt quá ngưỡng thuế và phí. Xem các thuộc tính con bên dưới.
de_minimis.formula STRINGCông thức được sử dụng để tính toán đủ điều kiện ngưỡng de minimis.
de_minimis.method STRINGĐây là phương pháp tính toán, chẳng hạn như cif, cifd, cifdt, fob, hoặc fobd.
de_minimis.note STRINGChi tiết bổ sung về de minimis, chẳng hạn như cung cấp thông tin nếu một mặt hàng không đủ điều kiện xem xét de minimis, như rượu.
de_minimis.threshold STRINGLiệu thuế có dưới hay trên ngưỡng thuế. Các giá trị có thể bao gồm above hoặc below.
de_minimis.type STRINGDe minimis áp dụng cho type. Các giá trị có thể bao gồm taxduty.
duties HASHMột mảng các khoản thuế áp dụng cho việc nhập khẩu. Tổng số tiền thuế bằng với amount_subtotal.duties. Xem các thuộc tính con bên dưới.
duties.amount DECIMALSố tiền thuế trên item, shipping, hoặc fee.
duties.description STRINGCác mô tả khác nhau về thuế như duty, anti_dumping_duty, và nhiều hơn nữa.
duties.formula STRINGCông thức được sử dụng để tính toán số tiền thuế. Đối với thuế, điều này thường là thuế quan cho quốc gia nhập khẩu và có thể là thuế theo giá trị hoặc thuế cụ thể rate.
duties.item_id STRINGĐịnh danh duy nhất được gửi trong yêu cầu. Id chỉ được cung cấp khi loại là item.
duties.note STRINGChi tiết bổ sung về thuế, bao gồm các hiệp định thương mại tự do, tỷ lệ thuế giảm, thuế chống bán phá giá, và nhiều hơn nữa.
duties.type STRINGThuế được áp dụng cho type. Các giá trị có thể bao gồm item, shipping, và fee.
fees HASHMột mảng các khoản phí áp dụng cho việc nhập khẩu. Tổng số tiền phí bằng với amount_subtotal.fees. Xem các thuộc tính con bên dưới.
fees.amount DECIMALSố tiền phí áp dụng cho mặt hàng, vận chuyển, thuế, cấp dịch vụ, nhà vận chuyển, hoặc quốc gia. Số tiền này ở đơn vị tiền tệ cơ sở và có thể đã được chuyển đổi từ tiền tệ tương ứng của quốc gia nhập khẩu sang đơn vị tiền tệ cơ sở được gửi trong yêu cầu.
fees.description STRINGCác mô tả khác nhau về phí như UPS Disbursement Fee, FedEx Advancement Fee, và An Post Clearance Fee.
fees.formula STRINGCông thức được sử dụng để tính toán phí. Đối với phí, điều này thường là một số tiền cố định, một tỷ lệ phần trăm của thuế và phí, hoặc một công thức khác.
fees.item_id STRINGĐịnh danh duy nhất của bạn được gửi trong yêu cầu landed cost. Id chỉ được cung cấp khi loại là item.
fees.note STRINGChi tiết bổ sung về phí, nếu cần.
fees.type STRINGPhí được áp dụng cho type. Các giá trị có thể bao gồm advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country, và other.
messages HASHDanh sách các thông điệp không quan trọng, ví dụ, Số tiền vận chuyển trong yêu cầu là null, điều này có thể ảnh hưởng đến việc tính toán.
messages.message STRINGMột thông điệp hữu ích liên quan đến yêu cầu Landed Cost của bạn và thông tin không quan trọng nào bị thiếu.
messages.type STRINGLoại thông điệp. Các giá trị có thể bao gồm price_adjustment, default_value_used, shipping_missing, và item_weight_missing
remittance HASHMột mảng chứa số tiền và chi tiết về những gì cần được chuyển đến một quốc gia cụ thể, ví dụ, Úc, New Zealand, Na Uy, hoặc Vương quốc Anh.
remittance.amount DECIMALSố tiền cần được chuyển đến một quốc gia cụ thể.
remittance.description STRINGMột mô tả về mục đích của việc chuyển tiền, ví dụ, UK VAT.
remittance.note STRINGMột ghi chú về cách thuế nên được nộp, ví dụ, remit cho HMRC hàng quý.
removed_items LISTDanh sách các mặt hàng đã bị loại bỏ khỏi yêu cầu tính toán landed cost. ItemsXem các thuộc tính con bên dưới.
removed_items.id STRINGĐịnh danh duy nhất được gửi trong yêu cầu.
removed_items.amount DECIMALSố tiền của mặt hàng bằng tiền tệ cơ sở. Đây là số tiền được gửi trong yêu cầu cho mặt hàng này.
removed_items.country_of_origin STRINGQuốc gia sản xuất nơi mặt hàng hoặc sản phẩm được sản xuất. Được đại diện bởi một mã ISO hai chữ cái. Xem tài liệu thuế nhập khẩu để hiểu cách quốc gia xuất xứ ảnh hưởng đến tính toán landed cost.
removed_items.country_or_origin_source STRINGNguồn gốc của quốc gia xuất xứ. Các giá trị có thể là zonos_catalog, api_request, và account_default platform.
removed_items.description_customs STRINGMô tả hàng hóa được đề xuất cho hóa đơn thương mại. Mô tả này thường khác với mô tả bán lẻ và thường bao gồm một mô tả chung về nó, nó được làm từ gì, và nó được sử dụng để làm gì.
removed_items.description_retail STRINGMô tả bán lẻ của mặt hàng.
removed_items.hs_code STRINGMã thuế hài hòa được sử dụng để xác định rate thuế trong tính toán landed cost.
removed_items.hs_code_source STRINGNguồn của mã thuế hài hòa được sử dụng, có thể được thiết lập bởi Zonos. Các giá trị có thể là zonos_catalog, api_request, platform, zonos_classified, account_default, và hs_correction.
removed_items.note STRINGChi tiết bổ sung về việc thông quan mặt hàng hoặc mã HS, nếu có. Một ví dụ cho Ấn Độ là Theo hướng dẫn nhập khẩu của Ấn Độ cho các lô hàng cá nhân, mã HS của bạn đã được sửa thành 9804.90.00.
removed_items.quantity INTEGERSố lượng của mặt hàng như đã gửi trong yêu cầu.
taxes HASHMột mảng các loại thuế áp dụng cho việc nhập khẩu. Tổng số tiền thuế bằng với amount_subtotal.taxes. Xem các thuộc tính con bên dưới.
taxes.amount DECIMALSố tiền thuế trên mặt hàng, vận chuyển, thuế nhập khẩu, hoặc phí.
taxes.description STRINGCác mô tả khác nhau của thuế áp dụng như thuế, VAT, GST, PST, HST, và nhiều hơn nữa.
taxes.formula STRINGCông thức được sử dụng để tính toán số tiền thuế thường bao gồm thuế của quốc gia nhập khẩu; tuy nhiên, điều này cũng có thể là thuế tiểu bang (hoặc tỉnh) hoặc thuế giảm (hoặc tăng).
taxes.item_id STRINGĐịnh danh duy nhất được gửi trong yêu cầu landed cost. ID chỉ được cung cấp khi loại là item.
taxes.note STRINGChi tiết bổ sung về thuế, bao gồm các mức thuế giảm hoặc thông tin khác áp dụng cho thuế đã áp dụng.
taxes.type STRINGThuế được áp dụng cho type. Các giá trị có thể bao gồm item, dutyshipping cũng như các loại phí như advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country, và other.

Ví dụ yêu cầu

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

Trang này có hữu ích không?