DOCS
Collect•
HemGlobal e-handel Fulfillment Transportörer Kontoinställning, prissättning och etiketter Skapa etiketter och manifest - GraphQL

Skapa Australia Post-etiketter och manifest

Skapa etiketter och generera ett manifest för Australia Post med GraphQL-API:et.

GraphQL

Australia Post lämnar in sändningar som en konsolidering (ett manifest). Till skillnad från andra transportörer, där en etikett är en fristående åtgärd, måste en Australia Post-sändning tillhöra en konsolideringsgrupp, och det är gruppen som lämnas in till Australia Post.

Flödet består av tre delar:

  1. Öppna en konsolideringsgrupp – manifestet som sändningar läggs till i.
  2. Skapa etiketter i gruppen – varje sändning registreras hos Australia Post och en etikett returneras. Sändningarna ligger i Australia Posts korg, oinlämnade.
  3. Stäng gruppen – detta lämnar in ordern till Australia Post och genererar Order Summary (pappersmanifestet) som du visar upp vid inlämning.

Fakturering: handlaren debiteras när gruppen stängs (lämnas in), inte när en etikett skapas. Etiketter kan skapas och makuleras fritt fram till dess att gruppen stängs.

Innan du börjar 

Steg 1: Öppna en konsolideringsgrupp 

Skapa en grupp med shipmentConsolidationCreate och använd carrierCode: AUSTRALIA_POST. Det returnerade id:t är gruppen du lägger till etiketter i. Om du redan har en öppen grupp för dagen, återanvänd den istället för att skapa en ny (se Återanvänd en öppen grupp nedan).

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

Återanvänd en öppen grupp

För att lägga till etiketter i en befintlig grupp istället för att skapa en ny, gör en fråga (query) efter öppna grupper och använd id:t för den du vill använda.

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}

Steg 2: Skapa en etikett i gruppen 

Skapa sändningen och dess etikett med shipmentCreateWorkflow genom att skicka gruppens id som shipmentConsolidationId. Mutationen registrerar sändningen hos Australia Post och returnerar en etikett-URL och ett spårningsnummer. Ingen debitering sker ännu – sändningen hålls i Australia Posts korg tills gruppen stängs.

Australia Post-specifika fält:

  • shipmentConsolidationId – gruppens id från steg 1. Krävs för att lägga till sändningen i manifestet.
  • serviceLevel – Australia Posts servicenivå för sändningen (till exempel en servicenivå av typen International Standard eller International Express).
  • itnNumber – exportdeklarationsnumret (EDN). Krävs när det totala artikelvärdet överstiger AUD 2 000.

Telefonnummer får endast innehålla siffror – Australia Post avvisar mellanslag och skiljetecken.

Se ShipmentCreateWorkflowInput för den fullständiga listan över fält, och Skapa en sändning för den allmänna (icke-Australia Post) sändningsmutationen.

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}

Upprepa detta steg för varje paket du vill ha på samma manifest – skicka samma shipmentConsolidationId varje gång.

Steg 3: Stäng gruppen för att generera manifestet 

När du är redo att skicka, stäng gruppen med shipmentConsolidationUpdate och status: CLOSED. Detta lämnar in ordern till Australia Post och returnerar manifestet i customsDocuments (Order Summary-PDF:en). Det är vid denna tidpunkt handlaren debiteras. Manifestets avsändare hämtas från ursprungsadressen på varje sändning, så inget fulfillment center behövs.

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}

Ladda ner manifestet från customsDocuments.fileUrl och visa upp det vid inlämning eller upphämtning. När gruppen har stängts är dess sändningar inlämnade och kan inte längre ändras.

Makulera innan inlämning 

Eftersom debitering sker vid stängning kan du ta bort en sändning ur en grupp när som helst innan den stängs genom att makulera dess etikett. Makulering tar bort sändningen från Australia Posts korg, så att den aldrig lämnas in och aldrig debiteras.

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

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

Var den här sidan till hjälp?

Få support·Juridiska dokument·© 2026 Zonos
På den här sidan:
  • Skapa Australia Post-etiketter och manifest
  • Innan du börjar
  • Steg 1: Öppna en konsolideringsgrupp
  • Steg 2: Skapa en etikett i gruppen
  • Steg 3: Stäng gruppen för att generera manifestet
  • Makulera innan inlämning