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:
Buka grup konsolidasi — manifes tempat pengiriman ditambahkan.
Buat label ke dalam grup — setiap pengiriman didaftarkan ke Australia Post
dan sebuah label dikembalikan. Pengiriman berada dalam keranjang Australia Post, belum diajukan.
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.
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).
1mutationShipmentConsolidationCreate(
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.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
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:
shipmentConsolidationId — id 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.
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.
1mutationShipmentConsolidationUpdate(
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Buat label dan manifes - GraphQL
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:
Sebelum memulai
Langkah 1: Buka grup konsolidasi
Buat grup dengan
shipmentConsolidationCreate, menggunakancarrierCode: AUSTRALIA_POST.idyang 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).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}Gunakan kembali grup terbuka
Untuk menambahkan label ke grup yang sudah ada alih-alih membuat yang baru, kueri grup terbuka dan gunakan
iddari grup yang Anda inginkan.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Langkah 2: Buat label ke dalam grup
Buat pengiriman beserta labelnya dengan
shipmentCreateWorkflow, dengan meneruskanidgrup sebagaishipmentConsolidationId. 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:
shipmentConsolidationId—idgrup 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.Lihat
ShipmentCreateWorkflowInputuntuk daftar lengkap kolom, dan Buat pengiriman untuk mutasi pengiriman umum (non-Australia Post).mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}Ulangi langkah ini untuk setiap paket yang ingin Anda sertakan pada manifes yang sama — teruskan
shipmentConsolidationIdyang sama setiap kali.Langkah 3: Tutup grup untuk membuat manifes
Saat Anda siap mengirim, tutup grup dengan
shipmentConsolidationUpdatedanstatus: CLOSED. Tindakan ini mengajukan pesanan ke Australia Post dan mengembalikan manifes dalamcustomsDocuments(PDF Order Summary). Ini adalah titik saat merchant dikenakan biaya. Pengirim manifes berasal dari alamat asal pada setiap pengiriman, sehingga tidak diperlukan pusat pemenuhan.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}Unduh manifes dari
customsDocuments.fileUrldan 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.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Was this page helpful?