属性
请求正文中的 JSON 键/值对
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
上述头信息是此订单完成请求成功完成所需的输入。
| 字段 | 备注 |
|---|---|
account_order_id 可选 | 订单的编号字符串。 |
landed_cost_id 必需 | 商家或出口商的唯一 landed cost 标识符。 |
parties 必需 | 参与运输的各方列表。这包括发货方、收货方、代理方以及负责支付关税和税款的方的信息。提供 ship_from 和 ship_to 各方是必需的。 |
parties.city 必需 | 列出方的地址城市、城镇、地区、郊区或村庄的字符串。 |
parties.contact_email 必需 | 联系电子邮件的字符串。 |
parties.contact_name 必需 | 联系人姓名的字符串。 |
parties.contact_phone 必需 | 联系电话号码。 |
parties.company_name 可选 | 公司名称。 |
parties.country 必需 | 由两个字母的 ISO 代码表示的国家。 |
parties.line1 必需 | 地址的第一行字符串。 |
parties.line2 必需 | 地址的第二行字符串。 |
parties.postal_code 必需 | 邮政编码的字符串。根据进口国，ship_to 可选。 |
parties.state 可选 | 可用时的州代码字符串。仅在加拿大和巴西的 ship_to 中必需。 |
parties.tax_id 可选 | ship_to 方必须提供税号以便进口到巴西等国家。如果未提供税号，货物将在海关被扣留，直到可以联系收件人提供税号。如果无法联系到收件人，交付可能会延迟，可能导致包裹被退回或遗弃。 |
parties.type 必需 | 提供的信息所代表的各方类型。可能的值包括 ship_to、ship_from、shipper、sold_to、duties_taxes_payor 和 broker。 |
test 可选 | 如果填入值为 true，您将不会因与此订单相关的费用而被开具发票。 |
tracking_numbers 可选 | 订单追踪号码的列表。 |
示例请求
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"]
}
示例响应
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"]
}
请求已完成订单
探索已完成订单请求中的键/值对。订单完成 API 允许您创建一个新的请求，以获取已完成订单信息，提供准确处理所需的基本细节。此 API 通过指定涉及各方和追踪号码等必要字段的关键信息，确保订单成功完成。