Question 1

如何使用 Order Complete 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

Order Complete 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

Order Complete API 申請本體中的可選欄位是什麼？

Accepted Answer

申請本體中的可選欄位包括 `account_order_id`、`parties.company_name`、`parties.state`、`parties.tax_id` 和 `tracking_numbers`。

Question 4

Order Complete 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 鍵/值配對