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:
Åbn en konsolideringsgruppe — manifestet, som forsendelser tilføjes til.
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.
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.
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).
1mutationShipmentConsolidationCreate(
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.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
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.
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.
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}
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Opret labels og manifester - GraphQL
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:
Før du starter
Trin 1: Åbn en konsolideringsgruppe
Opret en gruppe med
shipmentConsolidationCreateved at brugecarrierCode: AUSTRALIA_POST. Det returneredeider 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).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}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.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Trin 2: Opret en label i gruppen
Opret forsendelsen og dens label med
shipmentCreateWorkflowved at angive gruppensidsomshipmentConsolidationId. 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— gruppensidfra 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.Se
ShipmentCreateWorkflowInputfor den fulde liste over felter, og Opret en forsendelse for den generelle (ikke-Australia Post) forsendelsesmutation.mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}Gentag dette trin for hver pakke, du vil have på samme manifest — send det samme
shipmentConsolidationIdhver gang.Trin 3: Luk gruppen for at generere manifestet
Når du er klar til at sende, skal du lukke gruppen med
shipmentConsolidationUpdateogstatus: CLOSED. Dette indleverer ordren til Australia Post og returnerer manifestet icustomsDocuments(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.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}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.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Var denne side nyttig?