DOCS

创建 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 注册货物,并返回标签 URL 和跟踪号。此时尚未产生费用 — 货物会保留在 Australia Post 的暂存篮中,直到组被关闭。

Australia Post 特定字段:

  • shipmentConsolidationId — 来自步骤 1 的组 id。将货物添加到清单所必需。
  • serviceLevel — 该货物的 Australia Post 服务等级(例如国际标准或国际快递服务等级)。
  • itnNumber — 出口申报号(EDN)。当商品总价值超过 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 的暂存篮中移除,因此该货物永远不会被投递,也不会被收费。

预约演示

这个页面有帮助吗?


获取支持·法律文件·© 2026 Zonos