DOCS

Opprett Australia Post-etiketter og manifester

Opprett etiketter og generer et manifest for Australia Post med GraphQL API-et.

GraphQL

Australia Post sender inn sendinger som en konsolidering (et manifest). I motsetning til transportører der en etikett er en frittstående handling, må en Australia Post-sending tilhøre en konsolideringsgruppe, og det er gruppen som sendes inn til Australia Post.

Flyten har tre deler:

  1. Åpne en konsolideringsgruppe — manifestet som sendinger legges til i.
  2. Opprett etiketter i gruppen — hver sending registreres hos Australia Post og en etikett returneres. Sendingene ligger i Australia Posts kurv, uten å være sendt inn.
  3. Lukk gruppen — dette sender bestillingen inn til Australia Post og genererer ordresammendraget (papirmanifestet) du viser frem ved innlevering.

Fakturering: forhandleren belastes når gruppen lukkes (sendes inn), ikke når en etikett opprettes. Etiketter kan opprettes og annulleres fritt frem til gruppen lukkes.

Før du starter 

Steg 1: Åpne en konsolideringsgruppe 

Opprett en gruppe med shipmentConsolidationCreate, med carrierCode: AUSTRALIA_POST. Den returnerte id-en er gruppen du legger til etiketter i. Hvis du allerede har en åpen gruppe for dagen, gjenbruk den i stedet for å opprette en ny (se Gjenbruk en åpen gruppe nedenfor).

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

Gjenbruk en åpen gruppe

For å legge til etiketter i en eksisterende gruppe i stedet for å opprette en ny, spør etter åpne grupper og bruk id-en til den du vil bruke.

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: Opprett en etikett i gruppen 

Opprett sendingen og etiketten med shipmentCreateWorkflow, og send gruppens id som shipmentConsolidationId. Mutasjonen registrerer sendingen hos Australia Post og returnerer en etikett-URL og et sporingsnummer. Ingen belastning skjer ennå — sendingen holdes i Australia Posts kurv til gruppen lukkes.

Australia Post-spesifikke felt:

  • shipmentConsolidationId — gruppens id fra steg 1. Kreves for å legge sendingen til i manifestet.
  • serviceLevel — Australia Post-tjenestenivået for sendingen (for eksempel et International Standard- eller International Express-tjenestenivå).
  • itnNumber — eksportdeklarasjonsnummeret (EDN). Kreves når den samlede vareverdien overstiger AUD 2000.

Telefonnumre må kun inneholde sifre — Australia Post avviser mellomrom og tegnsetting.

Se ShipmentCreateWorkflowInput for den fullstendige listen over felt, og Opprett en sending for den generelle sendingsmutasjonen (uten 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}

Gjenta dette steget for hver pakke du vil ha på samme manifest — send samme shipmentConsolidationId hver gang.

Steg 3: Lukk gruppen for å generere manifestet 

Når du er klar til å sende, lukker du gruppen med shipmentConsolidationUpdate og status: CLOSED. Dette sender bestillingen inn til Australia Post og returnerer manifestet i customsDocuments (PDF-en for ordresammendraget). Dette er tidspunktet forhandleren blir belastet. Manifestets avsender hentes fra opprinnelsesadressen på hver sending, så det er ikke behov for et oppfyllingssenter.

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}

Last ned manifestet fra customsDocuments.fileUrl, og vis det frem ved innlevering eller henting. Når gruppen er lukket, er sendingene sendt inn og kan ikke lenger endres.

Annullering før innsending 

Siden belastningen skjer ved lukking, kan du ta en sending ut av en gruppe når som helst før den lukkes, ved å annullere etiketten. Annullering fjerner sendingen fra Australia Posts kurv, slik at den aldri sendes inn og aldri belastes.

Bestill en demo

Var denne siden nyttig?