DOCS
Collect•
首頁全球電商 訂單處理 快遞公司 帳戶設定、費率和標籤 建立標籤和艙單 - GraphQL

建立 Australia Post 標籤和艙單

使用 GraphQL API 為 Australia Post 建立標籤並生成艙單。

GraphQL

Australia Post 以合併（艙單）的方式提交貨件。與標籤本身即為獨立動作的運輸商不同，Australia Post 的貨件必須屬於一個合併組，而該組正是提交給 Australia Post 的內容。

此流程分為三個部分：

  1. 開啟合併組 — 貨件會被加入其中的艙單。
  2. 在該組中建立標籤 — 每筆貨件都會向 Australia Post 註冊並取得一個標籤。貨件會保留在 Australia Post 的暫存區中，尚未提交。
  3. 關閉該組 — 這會將訂單提交給 Australia Post，並產生您在寄件時出示的訂單摘要（紙本艙單）。

計費： 商家會在合併組關閉（提交）時才被收費，而不是在建立標籤時。在該組關閉之前，可以自由建立和作廢標籤。

開始之前 

第 1 步：開啟合併組 

使用 shipmentConsolidationCreate 並帶上 carrierCode: AUSTRALIA_POST 來建立一個組。傳回的 id 即為您要加入標籤的組。如果您當天已有開啟的組，請重複使用它，而非建立新的組（請見下方的重複使用開啟的組）。

1mutation ShipmentConsolidationCreate(
2$input: ShipmentConsolidationCreateInput!
3) {
4 shipmentConsolidationCreate(input: $input) {
5 id
6 name
7 carrierCode
8 status
9 }
10}

重複使用開啟的組

若要將標籤加入現有的組而非建立新組，請查詢開啟中的組，並使用您想要的那個組的 id。

1query ShipmentConsolidations {
2 shipmentConsolidations(filter: { status: OPEN }, first: 50) {
3 edges {
4 node {
5 id
6 name
7 carrierCode
8 status
9 }
10 }
11 }
12}

第 2 步：在該組中建立標籤 

使用 shipmentCreateWorkflow 建立貨件及其標籤，並將該組的 id 作為 shipmentConsolidationId 傳入。此變動會向 Australia Post 註冊該貨件，並傳回標籤網址和追蹤號碼。此時尚未產生費用 — 貨件會保留在 Australia Post 的暫存區中，直到該組關閉為止。

Australia Post 專屬欄位：

  • shipmentConsolidationId — 第 1 步中的組 id。將貨件加入艙單時為必填。
  • serviceLevel — 該貨件適用的 Australia Post 服務等級（例如國際標準或國際快捷服務等級）。
  • itnNumber — 出口申報號碼（EDN）。當品項總價值超過 AUD 2,000 時為必填。

電話號碼只能包含數字 — Australia Post 會拒絕含有空格和標點符號的號碼。

完整欄位清單請見 ShipmentCreateWorkflowInput，一般（非 Australia Post）的貨件變動請見建立貨件。

1mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 tracking {
6 number
7 }
8 shipmentCartons {
9 label {
10 url
11 trackingNumber
12 }
13 }
14 }
15}

同一份艙單上的每一件包裹都請重複此步驟 — 每次都傳入相同的 shipmentConsolidationId。

第 3 步：關閉該組以生成艙單 

當您準備好寄送時，使用 shipmentConsolidationUpdate 並帶上 status: CLOSED 來關閉該組。這會將訂單提交給 Australia Post，並在 customsDocuments 中傳回艙單（訂單摘要 PDF）。**商家會在此時被收費。**艙單的寄件人資訊來自每筆貨件的原始地址，因此不需要履行中心。

1mutation ShipmentConsolidationUpdate(
2$input: ShipmentConsolidationUpdateInput!
3) {
4 shipmentConsolidationUpdate(input: $input) {
5 id
6 status
7 customsDocuments {
8 id
9 fileUrl
10 fileName
11 documentType
12 fileType
13 }
14 }
15}

從 customsDocuments.fileUrl 下載艙單，並在寄件或取件時出示。該組一旦關閉，其中的貨件即已提交，無法再變更。

提交前作廢 

由於收費發生在關閉時，您可以在該組關閉之前的任何時間，透過作廢標籤將貨件移出該組。作廢會將貨件從 Australia Post 的暫存區中移除，使其永遠不會被提交，也不會產生費用。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 建立 Australia Post 標籤和艙單
  • 第 1 步：開啟合併組
  • 第 2 步：在該組中建立標籤
  • 第 3 步：關閉該組以生成艙單