Question 1

如何使用訂單完成 API 建立完成訂單信息的新請求？

Accepted Answer

你可以通過向 `https://api.zonos.com/v1/orders` 發送 POST 請求並使用必需的標題頭 `zonos-version: 2021-01-01` 來建立新請求。請求本體應包括 JSON 鍵值對，例如 `account_order_id`、`landed_cost_id`、`parties` 等。請參考 API 文檔以了解所有必需和可選字段的完整清單。

Question 2

訂單完成 API 請求本體中的必需字段是什麼？

Accepted Answer

請求本體中的必需字段包括 `landed_cost_id`、`parties`、`parties.city`、`parties.contact_email`、`parties.contact_name`、`parties.contact_phone`、`parties.country`、`parties.line1`、`parties.line2`、`parties.postal_code` 和 `parties.type`。

Question 3

訂單完成 API 請求本體中的可選字段是什麼？

Accepted Answer

請求本體中的可選字段包括 `account_order_id`、`parties.company_name`、`parties.state`、`parties.tax_id` 和 `tracking_numbers`。

Question 4

訂單完成 API 中 `parties.type` 欄位的目的是什麼？

Accepted Answer

`parties.type` 欄位代表所提供信息代表的各方的類型。可能的值包括 `ship_to`、`ship_from`、`shipper`、`sold_to`、`duties_taxes_payor` 和 `broker`。

欄位↕	說明↕
`account_order_id` 可選	訂單的號碼字符串。
`landed_cost_id` 必需	商人或出口商的唯一著陸成本標識符。
`parties` 必需	參與運輸的各方清單。這包括運送包裹的一方、接收包裹的一方、經紀包裹的一方和負責關稅和稅款支付的一方的信息。提供 `ship_from` 和 `ship_to` 各方是必需的。
`parties.city` 必需	列出的各方地址城市、城鎮、地區、郊區或村莊的字符串。
`parties.contact_email` 必需	聯絡電子郵件的字符串。
`parties.contact_name` 必需	聯絡人名稱的字符串。
`parties.contact_phone` 必需	聯絡電話號碼。
`parties.company_name` 可選	公司名稱。
`parties.country` 必需	由兩個字母的 ISO 代碼表示的國家/地區。
`parties.line1` 必需	地址第 1 行的字符串。
`parties.line2` 必需	地址第 2 行的字符串。
`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` 可選	訂單追蹤號碼的清單。

發送訂單完成請求

屬性

請求本體中的 JSON 鍵值對