DOCS
Collect•
Trang chủThương mại điện tử toàn cầu Xử lý đơn hàng Nhà vận chuyển Thiết lập tài khoản, tỷ giá và nhãn Tạo nhãn và bản kê khai - GraphQL

Tạo nhãn và bản kê khai Australia Post

Tạo nhãn và tạo bản kê khai cho Australia Post bằng API GraphQL.

GraphQL

Australia Post tạo đơn hàng cho các lô hàng dưới dạng một consolidation (một bản kê khai). Không giống như các vận tải viên khác, nơi nhãn là một hành động độc lập, một lô hàng Australia Post phải thuộc về một nhóm consolidation, và nhóm đó chính là thứ được tạo đơn hàng với Australia Post.

Luồng quy trình có ba phần:

  1. Mở một nhóm consolidation — bản kê khai mà các lô hàng được thêm vào.
  2. Tạo nhãn vào nhóm — mỗi lô hàng được đăng ký với Australia Post và một nhãn được trả về. Các lô hàng nằm trong giỏ hàng của Australia Post, chưa được tạo đơn hàng.
  3. Đóng nhóm — điều này tạo đơn hàng với Australia Post và tạo ra Tóm tắt Đơn hàng (bản kê khai giấy) mà bạn trình bày khi gửi hàng.

Thanh toán: người bán bị tính phí khi nhóm được đóng (đã tạo đơn hàng), không phải khi nhãn được tạo. Nhãn có thể được tạo và hủy tự do cho đến khi nhóm được đóng.

Trước khi bắt đầu 

Bước 1: Mở một nhóm consolidation 

Tạo một nhóm bằng shipmentConsolidationCreate, sử dụng carrierCode: AUSTRALIA_POST. id được trả về là nhóm mà bạn thêm nhãn vào. Nếu bạn đã có một nhóm đang mở cho ngày hôm đó, hãy sử dụng lại nhóm đó thay vì tạo một nhóm mới (xem Sử dụng lại một nhóm đang mở bên dưới).

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

Sử dụng lại một nhóm đang mở

Để thêm nhãn vào một nhóm hiện có thay vì tạo một nhóm mới, hãy truy vấn các nhóm đang mở và sử dụng id của nhóm bạn muốn.

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}

Bước 2: Tạo nhãn vào nhóm 

Tạo lô hàng và nhãn của nó bằng shipmentCreateWorkflow, truyền id của nhóm dưới dạng shipmentConsolidationId. Mutation này đăng ký lô hàng với Australia Post và trả về URL nhãn cùng số theo dõi. Chưa có khoản phí nào phát sinh — lô hàng được giữ trong giỏ hàng của Australia Post cho đến khi nhóm được đóng.

Các trường dành riêng cho Australia Post:

  • shipmentConsolidationId — id của nhóm từ Bước 1. Bắt buộc để thêm lô hàng vào bản kê khai.
  • serviceLevel — cấp độ dịch vụ Australia Post cho lô hàng (ví dụ: cấp độ dịch vụ International Standard hoặc International Express).
  • itnNumber — số khai báo xuất khẩu (EDN). Bắt buộc khi tổng giá trị mặt hàng vượt quá 2.000 AUD.

Số điện thoại chỉ được chứa chữ số — Australia Post từ chối khoảng trắng và dấu câu.

Xem ShipmentCreateWorkflowInput để biết danh sách đầy đủ các trường, và Tạo lô hàng cho mutation lô hàng chung (không dành riêng cho 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}

Lặp lại bước này cho mỗi kiện hàng bạn muốn có trên cùng một bản kê khai — truyền cùng shipmentConsolidationId mỗi lần.

Bước 3: Đóng nhóm để tạo bản kê khai 

Khi bạn sẵn sàng gửi hàng, hãy đóng nhóm bằng shipmentConsolidationUpdate và status: CLOSED. Điều này tạo đơn hàng với Australia Post và trả về bản kê khai trong customsDocuments (PDF Tóm tắt Đơn hàng). Đây là thời điểm người bán bị tính phí. Người gửi trên bản kê khai được lấy từ địa chỉ xuất xứ trên mỗi lô hàng, vì vậy không cần trung tâm thực hiện đơn hàng nào.

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}

Tải bản kê khai xuống từ customsDocuments.fileUrl và trình bày nó khi gửi hàng hoặc lấy hàng. Sau khi nhóm được đóng, các lô hàng của nó đã được tạo đơn hàng và không thể thay đổi được nữa.

Hủy trước khi tạo đơn hàng 

Vì việc tính phí xảy ra khi đóng nhóm, bạn có thể rút một lô hàng ra khỏi nhóm bất kỳ lúc nào trước khi nhóm được đóng bằng cách hủy nhãn của nó. Việc hủy sẽ loại bỏ lô hàng khỏi giỏ hàng của Australia Post, vì vậy nó sẽ không bao giờ được tạo đơn hàng và không bao giờ bị tính phí.

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

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Tạo nhãn và bản kê khai Australia Post
  • Trước khi bắt đầu
  • Bước 1: Mở một nhóm consolidation
  • Bước 2: Tạo nhãn vào nhóm
  • Bước 3: Đóng nhóm để tạo bản kê khai
  • Hủy trước khi tạo đơn hàng