DOCS
Collect•
首頁全球電商 訂單履行 物流商 帳戶設定、費率和標籤 建立標籤和艙單 - GraphQL

建立澳洲郵政標籤和艙單

使用GraphQL API為澳洲郵政建立標籤並產生艙單。

GraphQL

澳洲郵政以集運組（艙單）形式提交貨件。與標籤屬於獨立操作的其他承運商不同，澳洲郵政的貨件必須屬於一個集運組，而提交至澳洲郵政的正是這個集運組。

整個流程分為三個部分：

  1. 開啟集運組——貨件會加入這個艙單。
  2. 在集運組中建立標籤——每個貨件都會在澳洲郵政系統中登記，並取得標籤。貨件會停留在澳洲郵政的「購物車」中，尚未提交。
  3. 結束集運組——這會向澳洲郵政提交訂單，並產生訂單摘要（紙本艙單），供您在寄件時出示。

收費：商戶會在集運組結束（提交）時被收費，而非在建立標籤時收費。在集運組結束前，您可以自由建立和註銷標籤。

開始之前 

步驟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傳入。此變更會在澳洲郵政系統中登記貨件，並回傳標籤網址和追蹤編號。此時尚未產生任何收費——貨件會保留在澳洲郵政的「購物車」中，直至集運組結束為止。

澳洲郵政專屬欄位：

  • shipmentConsolidationId——步驟1中的集運組id。將貨件加入艙單時為必填。
  • serviceLevel——貨件的澳洲郵政服務等級（例如國際標準或國際特快服務等級）。
  • itnNumber——出口報關編號（EDN）。當貨品總價值超過2,000澳元時為必填。

電話號碼只能包含數字——澳洲郵政會拒絕含有空格或標點符號的電話號碼。

完整欄位清單請參閱ShipmentCreateWorkflowInput；一般（非澳洲郵政）貨件變更請參閱建立貨件。

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來結束集運組。這會向澳洲郵政提交訂單，並在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下載艙單，並在寄件或取件時出示。集運組一旦結束，其中的貨件即已提交，且無法再作修改。

提交前註銷 

由於收費在集運組結束時才會產生，您可以在集運組結束前的任何時間，透過註銷標籤的方式將貨件從集運組中移除。註銷會將貨件從澳洲郵政的「購物車」中移除，因此該貨件永遠不會被提交，亦不會產生收費。

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

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 步驟1：開啟集運組
  • 步驟2：在集運組中建立標籤
  • 步驟3：結束集運組以產生艙單