DOCS

Buat label dan manifes Australia Post

Buat label dan hasilkan manifes untuk Australia Post menggunakan GraphQL API.

GraphQL

Australia Post mengajukan pengiriman sebagai konsolidasi (manifes). Berbeda dengan kurir lain yang mana label merupakan tindakan yang berdiri sendiri, pengiriman Australia Post harus tergabung dalam grup konsolidasi, dan grup itulah yang diajukan ke Australia Post.

Alur ini terdiri dari tiga bagian:

  1. Buka grup konsolidasi — manifes tempat pengiriman ditambahkan.
  2. Buat label ke dalam grup — setiap pengiriman didaftarkan ke Australia Post dan sebuah label dikembalikan. Pengiriman berada dalam keranjang Australia Post, belum diajukan.
  3. Tutup grup — tindakan ini mengajukan pesanan ke Australia Post dan menghasilkan Order Summary (manifes kertas) yang Anda tunjukkan saat penyerahan paket.

Penagihan: merchant dikenakan biaya saat grup ditutup (diajukan), bukan saat sebuah label dibuat. Label dapat dibuat dan dibatalkan secara bebas sampai grup ditutup.

Sebelum memulai 

Langkah 1: Buka grup konsolidasi 

Buat grup dengan shipmentConsolidationCreate, menggunakan carrierCode: AUSTRALIA_POST. id yang dikembalikan adalah grup tempat Anda menambahkan label. Jika Anda sudah memiliki grup terbuka untuk hari itu, gunakan kembali grup tersebut alih-alih membuat yang baru (lihat Gunakan kembali grup terbuka di bawah).

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

Gunakan kembali grup terbuka

Untuk menambahkan label ke grup yang sudah ada alih-alih membuat yang baru, kueri grup terbuka dan gunakan id dari grup yang Anda inginkan.

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}

Langkah 2: Buat label ke dalam grup 

Buat pengiriman beserta labelnya dengan shipmentCreateWorkflow, dengan meneruskan id grup sebagai shipmentConsolidationId. Mutasi ini mendaftarkan pengiriman ke Australia Post dan mengembalikan URL label serta nomor pelacakan. Belum ada biaya yang dikenakan — pengiriman disimpan dalam keranjang Australia Post sampai grup ditutup.

Kolom khusus Australia Post:

  • shipmentConsolidationIdid grup dari Langkah 1. Wajib diisi untuk menambahkan pengiriman ke manifes.
  • serviceLevel — tingkat layanan Australia Post untuk pengiriman (misalnya, tingkat layanan International Standard atau International Express).
  • itnNumber — nomor deklarasi ekspor (EDN). Wajib diisi jika total nilai barang melebihi AUD 2.000.

Nomor telepon hanya boleh berisi angka — Australia Post menolak spasi dan tanda baca.

Lihat ShipmentCreateWorkflowInput untuk daftar lengkap kolom, dan Buat pengiriman untuk mutasi pengiriman umum (non-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}

Ulangi langkah ini untuk setiap paket yang ingin Anda sertakan pada manifes yang sama — teruskan shipmentConsolidationId yang sama setiap kali.

Langkah 3: Tutup grup untuk membuat manifes 

Saat Anda siap mengirim, tutup grup dengan shipmentConsolidationUpdate dan status: CLOSED. Tindakan ini mengajukan pesanan ke Australia Post dan mengembalikan manifes dalam customsDocuments (PDF Order Summary). Ini adalah titik saat merchant dikenakan biaya. Pengirim manifes berasal dari alamat asal pada setiap pengiriman, sehingga tidak diperlukan pusat pemenuhan.

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}

Unduh manifes dari customsDocuments.fileUrl dan tunjukkan saat penyerahan atau penjemputan paket. Setelah grup ditutup, pengirimannya telah diajukan dan tidak dapat diubah lagi.

Membatalkan sebelum pengajuan 

Karena penagihan terjadi saat penutupan, Anda dapat mengeluarkan pengiriman dari grup kapan saja sebelum grup ditutup dengan membatalkan labelnya. Pembatalan menghapus pengiriman dari keranjang Australia Post, sehingga pengiriman tersebut tidak pernah diajukan dan tidak pernah dikenakan biaya.

Book a demo

Was this page helpful?


Get support·Legal docs·© 2026 Zonos