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:
Åpne en konsolideringsgruppe — manifestet som sendinger legges til i.
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.
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.
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).
1mutationShipmentConsolidationCreate(
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.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
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.
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.
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}
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Opprett etiketter og manifester - GraphQL
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:
Før du starter
Steg 1: Åpne en konsolideringsgruppe
Opprett en gruppe med
shipmentConsolidationCreate, medcarrierCode: AUSTRALIA_POST. Den returnerteid-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).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}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.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Steg 2: Opprett en etikett i gruppen
Opprett sendingen og etiketten med
shipmentCreateWorkflow, og send gruppensidsomshipmentConsolidationId. 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— gruppensidfra 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.Se
ShipmentCreateWorkflowInputfor den fullstendige listen over felt, og Opprett en sending for den generelle sendingsmutasjonen (uten Australia Post).mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}Gjenta dette steget for hver pakke du vil ha på samme manifest — send samme
shipmentConsolidationIdhver gang.Steg 3: Lukk gruppen for å generere manifestet
Når du er klar til å sende, lukker du gruppen med
shipmentConsolidationUpdateogstatus: CLOSED. Dette sender bestillingen inn til Australia Post og returnerer manifestet icustomsDocuments(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.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}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.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Var denne siden nyttig?