DOCS

Landed cost object

/

Đố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 của đối tượng Landed Cost luôn được tiền tố bởi ldct.
amount_subtotal HASHTổng 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 tổng số này để hiển thị cho người dùng cuối. Những tổng số này cho phép tích hợp dễ dàng hơn mà không cần phải tính tổng thuế, phí hoặc lệ phí theo từng mặt hàng và mức vận chuyển. Thông tin chi tiết hơn có 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 khoản thuế trong mảng thuế. Bao gồm thuế được áp dụng cho các mặt hàng, vận chuyển, hoặc bất kỳ khoản thuế bổ sung nào áp dụng cho việc nhập khẩu. Để hiểu cách tính thuế, xem tài liệu import duty doc.
amount_subtotal.fees DECIMALTổng của các khoản 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 import fees doc.
amount_subtotal.taxes DECIMALTổng của tất cả các khoản thuế trong mảng thuế. Bao gồm thuế được áp dụng cho các mặt hàng, thuế, vận chuyển hoặc phí. Để hiểu thêm về thuế nhập khẩu, xem tài liệu import taxes doc.
currency HASHHash cung cấp thông tin về đồng tiền cơ sở được gửi trong yêu cầu và các đồng tiền khác với tỷ giá rate đượ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 các đồng tiền 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 STRINGĐồng tiền cơ sở được gửi trong yêu cầu landed cost, được biểu diễn 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 đồng tiền 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 đồng tiền và tỷ giá hối đoái cần thiết để chuyển đổi từ đồng tiền cơ sở.
currency.rates.currency STRINGMột đồng tiền tỷ giá 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 đồng tiền đượ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 như đã 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ế ad valorem 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ừ đơn vị 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ụ: VAT Vương quốc Anh).
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ục đã 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 STRINGMã định danh duy nhất được gửi trong yêu cầu.
removed_items.amount DECIMALSố tiền của mục trong tiền tệ cơ sở. Đây là số tiền được gửi trong yêu cầu cho mục này.
removed_items.country_of_origin STRINGQuốc gia sản xuất nơi mục 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.
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ục.
removed_items.hs_code STRINGMã thuế hài hòa được sử dụng để xác định thuế rate trong việc 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ục 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ục 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ục, 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 STRINGMã định danh duy nhất được gửi trong yêu cầu landed cost. Mã 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?