Thuộc tính
Các cặp khóa/giá trị JSON trong thân yêu cầu
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Header trên là một đầu vào bắt buộc cho yêu cầu đơn hàng hoàn thành này để hoàn thành thành công.
| Trường | Ghi chú |
|---|---|
account_order_id TÙY CHỌN | Chuỗi số cho đơn hàng. |
landed_cost_id BẮT BUỘC | Mã định danh landed cost duy nhất cho thương nhân hoặc nhà xuất khẩu. |
parties BẮT BUỘC | Danh sách các bên liên quan trong lô hàng. Điều này bao gồm thông tin cho bên gửi gói hàng, bên nhận gói hàng, bên môi giới gói hàng và bên chịu trách nhiệm thanh toán thuế và phí. Cung cấp thông tin cho các bên ship_from và ship_to là bắt buộc. |
parties.city BẮT BUỘC | Một chuỗi cho thành phố, thị trấn, quận, khu phố hoặc làng của bên được liệt kê. |
parties.contact_email BẮT BUỘC | Một chuỗi cho email liên hệ. |
parties.contact_name BẮT BUỘC | Một chuỗi cho tên liên hệ. |
parties.contact_phone BẮT BUỘC | Số điện thoại liên hệ. |
parties.company_name TÙY CHỌN | Tên công ty. |
parties.country BẮT BUỘC | Quốc gia, được đại diện bởi mã ISO hai chữ cái. |
parties.line1 BẮT BUỘC | Một chuỗi cho dòng 1 của địa chỉ. |
parties.line2 BẮT BUỘC | Một chuỗi cho dòng 2 của địa chỉ. |
parties.postal_code BẮT BUỘC | Một chuỗi cho mã bưu chính. Tùy chọn cho ship_to tùy thuộc vào quốc gia nhập khẩu. |
parties.state TÙY CHỌN | Một chuỗi cho mã tiểu bang khi có sẵn. Chỉ bắt buộc ở Canada và Brazil cho ship_to. |
parties.tax_id TÙY CHỌN | Bên ship_to phải cung cấp mã số thuế để nhập khẩu vào các quốc gia như Brazil. Nếu không được cung cấp cho các lô hàng đến Brazil, lô hàng sẽ bị giữ lại tại hải quan cho đến khi người nhận có thể được liên hệ để cung cấp mã số thuế. Nếu không thể liên lạc với người nhận, việc giao hàng có thể bị trì hoãn, có thể dẫn đến việc gói hàng bị trả lại hoặc bỏ rơi. |
parties.type BẮT BUỘC | Loại bên mà thông tin được cung cấp đại diện. Các giá trị có thể bao gồm ship_to, ship_from, shipper, sold_to, duties_taxes_payor, và broker. |
test TÙY CHỌN | Nếu được điền với giá trị true, bạn sẽ không bị tính phí cho các khoản phí liên quan đến đơn hàng này. |
tracking_numbers TÙY CHỌN | Danh sách cho các số theo dõi đơn hàng. |
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
{
"account_order_id": "123456",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"parties": [
{
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Ví dụ phản hồi
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
{
"id": "ordr_5LwjnR9AW6L9eXs9lfeMC7",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"account_order_id": "123456",
"zonos_order_id": "1000151",
"parties": [
{
"id": "prty_12165151351",
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"line3": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Yêu cầu một đơn hàng hoàn thành
Khám phá các cặp khóa/giá trị trong một yêu cầu đơn hàng hoàn thành.
Order Complete API cho phép bạn tạo một yêu cầu mới cho thông tin đơn hàng đã hoàn thành, cung cấp các chi tiết thiết yếu cho việc xử lý chính xác. API này đảm bảo hoàn thành đơn hàng thành công bằng cách chỉ định thông tin quan trọng về các bên liên quan và số theo dõi, cùng với các trường bắt buộc khác.