Thuộc tính
Các cặp khóa/giá trị JSON trong phần thân yêu cầu
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Tiêu đề trên là đầu vào bắt buộc để yêu cầu chi phí hạ cấp này hoàn tất thành công.
| Trường↕ | Ghi chú↕ |
|---|---|
currency BẮT BUỘC | Chuỗi tiền tệ cơ sở, được biểu thị bằng mã ISO ba ký tự. |
discounts KHÔNG BẮT BUỘC | Thông tin liên quan đến bất kỳ chiết khấu nào, bao gồm id, số tiền và bất kỳ chi tiết nào. |
discounts.id KHÔNG BẮT BUỘC | Mã định danh chiết khấu duy nhất cho nhà cung cấp hoặc nhà xuất khẩu. |
discounts.amount KHÔNG BẮT BUỘC | Số thập phân với số tiền chiết khấu, tính bằng đô la và xu. |
discounts.detail KHÔNG BẮT BUỘC | Các tính năng, thuộc tính hoặc mô tả bổ sung về chiết khấu. |
items BẮT BUỘC | Danh sách các mục đang được xuất khẩu. hash |
items.id BẮT BUỘC | Mã định danh mục duy nhất cho nhà cung cấp hoặc nhà xuất khẩu. |
items.amount BẮT BUỘC | Số thập phân với tổng của một mục duy nhất, tính bằng đô la và xu. |
items.amount_discount KHÔNG BẮT BUỘC | Số tiền chiết khấu áp dụng cho mục. |
items.brand KHÔNG BẮT BUỘC | Thương hiệu của mục, ví dụ: Leatherman. |
items.category KHÔNG BẮT BUỘC | Mô tả danh mục của mục, ví dụ: Quần áo. |
items.color KHÔNG BẮT BUỘC | Màu của mục. |
items.country_of_origin KHÔNG BẮT BUỘC | Đất nước sản xuất hoặc sản xuất, được biểu thị bằng mã ISO hai ký tự. Điều này được khuyến cáo cho báo giá chính xác nhất. Nếu không nhận được quốc gia xuất xứ, tỷ lệ Quốc gia Được ưa chuộng Nhất (MFN) được sử dụng. |
items.description_customs KHÔNG BẮT BUỘC | Mô 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ả chung về nó là gì, nó được làm từ cái gì và nó được sử dụng để làm gì. |
items.description_retail KHÔNG BẮT BUỘC | Mô tả bán lẻ của mục. |
items.detail KHÔNG BẮT BUỘC | Các tính năng, thuộc tính hoặc mô tả bổ sung về mục. |
items.dimensions KHÔNG BẮT BUỘC | Kích thước của lô hàng. Điều này được khuyến cáo để nhận được báo giá chính xác nhất vào các quốc gia nơi thuế quan bị ảnh hưởng bởi kích thước của mục. hash |
items.dimensions.height KHÔNG BẮT BUỘC | Số thập phân cho chiều cao của mục. |
items.dimensions.length KHÔNG BẮT BUỘC | Số thập phân cho độ dài của mục. |
items.dimensions.unit KHÔNG BẮT BUỘC | Đơn vị đo lường cho kích thước mục. Các giá trị có thể là inch, centimeter, millimeter và null. Khi null, inch sẽ được sử dụng. |
items.dimensions.width KHÔNG BẮT BUỘC | Số thập phân cho chiều rộng của mục. |
items.duty_tax_fee_free KHÔNG BẮT BUỘC | Chuỗi để chỉ định xem mục có nên được loại khỏi tính toán chi phí hạ cấp hay không. Khi exclude được gửi trong yêu cầu, mục sẽ xuất hiện trong removed_items trong phản hồi API. |
items.hs_code KHÔNG BẮT BUỘC | Mã HS của mục, từ 2 đến 10 chữ số. |
items.image_url KHÔNG BẮT BUỘC | URL hình ảnh. |
items.quantity BẮT BUỘC | Số nguyên với số lượng của mục. |
items.upc_code KHÔNG BẮT BUỘC | Chuỗi mã UPC cho mục. |
items.weight KHÔNG BẮT BUỘC | Số thập phân cho cân nặng của mục. |
items.weight_unit KHÔNG BẮT BUỘC | Chuỗi đơn vị đo lường cho cân nặng. Các giá trị có thể là pound, ounce, kilogram và null. Khi null, pound sẽ được sử dụng. |
landed_cost KHÔNG BẮT BUỘC | Loại yêu cầu chi phí hạ cấp. Các giá trị có thể bao gồm delivery_duty_paid và delivery_duty_unpaid. Phí cho chi phí hạ cấp có thể khác nhau, cho dù nó được gửi DDP hay DDU. Nếu null, yêu cầu DDP sẽ được giả định. Nếu yêu cầu DDP được thực hiện và DDP không khả dụng, lỗi 400 sẽ được trả về kèm theo thông báo nêu rõ rằng DDP không khả dụng cho mức dịch vụ được cung cấp. DDP và DDU thường có sẵn trong mỗi mức dịch vụ, vui lòng đảm bảo rằng điều này có thể được định cấu hình trên cơ sở mỗi dịch vụ thay vì cấp độ tài khoản. |
sale_type KHÔNG BẮT BUỘC | Chỉ số loại bán hàng. Các giá trị có thể bao gồm not_for_resale for_resale. Nếu null, yêu cầu not_for_resale sẽ được giả định. |
ship_from_country BẮT BUỘC | Chuỗi quốc gia gửi từ, được biểu thị bằng mã ISO hai ký tự. |
ship_to BẮT BUỘC | Địa chỉ đích. hash |
ship_to.city KHÔNG BẮT BUỘC* | Chuỗi cho thành phố, thị trấn, quận, vùng ngoại ô hoặc làng của khách hàng. Tùy thuộc vào quốc gia nhập khẩu, trường này có thể là BẮT BUỘC. |
ship_to.country BẮT BUỘC | Chuỗi cho quốc gia đích nơi tài khoản ngân hàng được đặt, được biểu thị bằng mã ISO hai ký tự. |
ship_to.postal_code KHÔNG BẮT BUỘC* | Chuỗi cho mã bưu chính đích. Trường này có thể được yêu cầu khi lô hàng nằm giữa Bắc Ireland và Liên minh Châu Âu. |
ship_to.state KHÔNG BẮT BUỘC* | Chuỗi cho mã tiểu bang đích khi có sẵn. Nếu quốc gia nhập khẩu là Brazil hoặc Canada, trường này là bắt buộc. |
shipping BẮT BUỘC | Chi tiết vận chuyển như số tiền, số tiền chiết khấu và mức dịch vụ với nhà cung cấp vận chuyển. hash |
shipping.amount BẮT BUỘC | Số thập phân cho tổng cộng chi phí vận chuyển, tính bằng đô la và xu. |
shipping.amount_discount KHÔNG BẮT BUỘC | Số thập phân cho số tiền chiết khấu áp dụng cho vận chuyển. |
shipping.service_level BẮT BUỘC | Mức dịch vụ với nhà cung cấp vận chuyển. Xem tài liệu nhà cung cấp vận chuyển để biết danh sách đầy đủ các mức dịch vụ có sẵn theo nhà cung cấp vận chuyển. |
*Trường này là tùy chọn tùy thuộc vào yêu cầu trường địa chỉ cho quốc gia nhập khẩu.
1
{2
"currency": "USD",3
"discounts": [4
{5
"id": "sale124",6
"amount": 43,7
"detail": null8
}9
],10
"items": [11
{12
"id": "294395",13
"amount": 75,14
"amount_discount": 0,15
"brand": null,16
"category": "Women's Clothing",17
"color": null,18
"country_of_origin": "FR",19
"description_customs": null,20
"description_retail": "Hoka One Running Shoe - Women's",21
"detail": null,22
"dimensions": {23
"height": 4,24
"length": 6,25
"unit": "inch",26
"width": 1127
},28
"duty_tax_fee_free": null,29
"hs_code": "6116.10.00",30
"image_url": "https://zonos.com/images/handbag.webp",31
"quantity": 1,32
"upc_code": null,33
"weight": 10,34
"weight_unit": "pound"35
},36
{37
"id": "294396",38
"amount": 15,39
"country_of_origin": "CN",40
"country_of_origin_source": "account_default",41
"description_customs": "Men's t-shirt 100% polyester",42
"description_retail": "Galaxy Quest Men's Tee Blue",43
"detail": null,44
"dimensions": {45
"height": 4,46
"lenght": 6,47
"unit": "inch",48
"width": 1149
},50
"duty_tax_fee_free": "exclude",51
"hs_code": "6217.10",52
"image_url": null,53
"note": null,54
"quantity": 1,55
"upc_code": null,56
"weight": 1,57
"weight_unit": "pound"58
}59
],60
"landed_cost": "delivery_duty_paid",61
"sale_type": "not_for_resale",62
"ship_from_country": "US",63
"ship_to": {64
"city": "Campinas",65
"country": "BR",66
"postal_code": "75828-000",67
"state": "SP"68
},69
"shipping": {70
"amount": 14.23,71
"amount_discount": 0,72
"service_level": "ups_express_saver"73
},74
"tariff_rate": "zonos_preferred"75
}
Yêu cầu báo giá chi phí hạ cấp
Tìm các cặp khóa/giá trị trong yêu cầu chi phí hạ cấp.Mặc dù Zonos Landed Cost có thể cung cấp báo giá chi phí hạ cấp chính xác dựa chỉ trên mô tả của một mục, càng cung cấp nhiều thông tin thì báo giá chi phí hạ cấp sẽ càng chính xác. Dưới đây là các đầu vào BẮT BUỘC và KHÔNG BẮT BUỘC, nhưng nên điền vào càng nhiều trường KHÔNG BẮT BUỘC càng tốt.