DOCS

Opret Australia Post-labels og manifester

Opret labels og generer et manifest for Australia Post med GraphQL API'et.

GraphQL

Australia Post indleverer forsendelser som en konsolidering (et manifest). I modsætning til transportører, hvor en label er en selvstændig handling, skal en Australia Post-forsendelse tilhøre en konsolideringsgruppe, og det er gruppen, der indleveres til Australia Post.

Forløbet består af tre dele:

  1. Åbn en konsolideringsgruppe — manifestet, som forsendelser tilføjes til.
  2. Opret labels i gruppen — hver forsendelse registreres hos Australia Post, og en label returneres. Forsendelserne ligger i Australia Posts kurv, uden at være indleveret.
  3. Luk gruppen — dette indleverer ordren til Australia Post og genererer Order Summary (det fysiske manifest), som du fremviser ved afleveringen.

Fakturering: forhandleren opkræves, når gruppen lukkes (indleveres), ikke når en label oprettes. Labels kan oprettes og annulleres frit, indtil gruppen lukkes.

Før du starter 

Trin 1: Åbn en konsolideringsgruppe 

Opret en gruppe med shipmentConsolidationCreate ved at bruge carrierCode: AUSTRALIA_POST. Det returnerede id er den gruppe, du tilføjer labels til. Hvis du allerede har en åben gruppe for dagen, skal du genbruge den i stedet for at oprette en ny (se Genbrug en åben gruppe nedenfor).

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

Genbrug en åben gruppe

For at tilføje labels til en eksisterende gruppe i stedet for at oprette en ny, skal du forespørge på åbne grupper og bruge id'et for den, du vil bruge.

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}

Trin 2: Opret en label i gruppen 

Opret forsendelsen og dens label med shipmentCreateWorkflow ved at angive gruppens id som shipmentConsolidationId. Mutationen registrerer forsendelsen hos Australia Post og returnerer en label-URL og et trackingnummer. Der opkræves intet endnu — forsendelsen opbevares i Australia Posts kurv, indtil gruppen lukkes.

Australia Post-specifikke felter:

  • shipmentConsolidationId — gruppens id fra trin 1. Påkrævet for at tilføje forsendelsen til manifestet.
  • serviceLevel — Australia Posts serviceniveau for forsendelsen (for eksempel et International Standard- eller International Express-serviceniveau).
  • itnNumber — eksportdeklarationsnummeret (EDN). Påkrævet, når den samlede artikelværdi overstiger AUD 2.000.

Telefonnumre må kun indeholde cifre — Australia Post afviser mellemrum og tegnsætning.

Se ShipmentCreateWorkflowInput for den fulde liste over felter, og Opret en forsendelse for den generelle (ikke-Australia Post) forsendelsesmutation.

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}

Gentag dette trin for hver pakke, du vil have på samme manifest — send det samme shipmentConsolidationId hver gang.

Trin 3: Luk gruppen for at generere manifestet 

Når du er klar til at sende, skal du lukke gruppen med shipmentConsolidationUpdate og status: CLOSED. Dette indleverer ordren til Australia Post og returnerer manifestet i customsDocuments (Order Summary-PDF'en). Dette er tidspunktet, hvor forhandleren opkræves. Manifestets afsender kommer fra oprindelsesadressen på hver forsendelse, så der er ikke brug for et fulfillmentcenter.

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}

Download manifestet fra customsDocuments.fileUrl, og fremvis det ved afleveringen eller afhentningen. Når gruppen er lukket, er dens forsendelser indleveret og kan ikke længere ændres.

Annullering før indlevering 

Fordi opkrævningen sker ved lukning, kan du til enhver tid trække en forsendelse ud af en gruppe, før den lukkes, ved at annullere dens label. Annullering fjerner forsendelsen fra Australia Posts kurv, så den aldrig indleveres og aldrig opkræves.

Book en demo

Var denne side nyttig?