Maak labels aan en genereer een manifest voor Australia Post met de GraphQL
API.
GraphQL
Australia Post dient zendingen in als een consolidatie (een manifest). In tegenstelling tot
vervoerders waarbij een label een op zichzelf staande actie is, moet een Australia Post-zending
bij een consolidatiegroep horen, en de groep is wat bij Australia Post wordt ingediend.
Het proces bestaat uit drie onderdelen:
Open een consolidatiegroep — het manifest waaraan zendingen worden toegevoegd.
Maak labels aan in de groep — elke zending wordt geregistreerd bij Australia Post
en er wordt een label geretourneerd. Zendingen blijven onbevestigd in het winkelmandje
van Australia Post staan.
Sluit de groep — hierdoor wordt de bestelling bij Australia Post ingediend en wordt de
Order Summary (het papieren manifest) gegenereerd die u bij inlevering overlegt.
Facturering: de handelaar wordt in rekening gebracht wanneer de groep wordt gesloten
(ingediend), niet wanneer een label wordt aangemaakt. Labels kunnen vrij worden aangemaakt
en geannuleerd totdat de groep is gesloten.
Maak een groep aan met shipmentConsolidationCreate, met carrierCode: AUSTRALIA_POST.
De geretourneerde id is de groep waaraan u labels toevoegt. Als u al een open groep voor
die dag heeft, gebruik deze dan opnieuw in plaats van een nieuwe aan te maken (zie
Een open groep hergebruiken hieronder).
1mutationShipmentConsolidationCreate(
2$input: ShipmentConsolidationCreateInput!
3){
4 shipmentConsolidationCreate(input:$input) {
5 id
6 name
7 carrierCode
8 status
9}
10}
Een open groep hergebruiken
Om labels toe te voegen aan een bestaande groep in plaats van een nieuwe aan te maken,
doorzoekt u de open groepen en gebruikt u de id van de gewenste groep.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
Maak de zending en het bijbehorende label aan met shipmentCreateWorkflow, waarbij u de
id van de groep doorgeeft als shipmentConsolidationId. De mutatie registreert de zending
bij Australia Post en retourneert een label-URL en trackingnummer. Er wordt nog geen bedrag
in rekening gebracht — de zending blijft in het winkelmandje van Australia Post staan totdat
de groep is gesloten.
Australia Post-specifieke velden:
shipmentConsolidationId — de id van de groep uit stap 1. Vereist om de zending aan
het manifest toe te voegen.
serviceLevel — het Australia Post-serviceniveau voor de zending (bijvoorbeeld een
International Standard- of International Express-serviceniveau).
itnNumber — het exportaangiftenummer (EDN). Vereist wanneer de totale artikelwaarde
hoger is dan AUD 2.000.
Telefoonnummers mogen alleen cijfers bevatten — Australia Post weigert spaties en leestekens.
Wanneer u klaar bent om te verzenden, sluit u de groep met shipmentConsolidationUpdate en
status: CLOSED. Hierdoor wordt de bestelling bij Australia Post ingediend en wordt het
manifest geretourneerd in customsDocuments (de Order Summary-PDF). Dit is het moment
waarop de handelaar in rekening wordt gebracht. De afzender van het manifest komt van het
herkomstadres van elke zending, dus is er geen fulfillment center nodig.
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 het manifest via customsDocuments.fileUrl en overleg het bij inlevering of ophaling.
Zodra de groep is gesloten, zijn de zendingen ingediend en kunnen ze niet meer worden gewijzigd.
Omdat facturering pas bij het sluiten plaatsvindt, kunt u een zending op elk moment vóór het
sluiten uit een groep verwijderen door het label te annuleren. Annuleren verwijdert de zending
uit het winkelmandje van Australia Post, zodat deze nooit wordt ingediend en nooit in rekening
wordt gebracht.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Labels en manifesten maken - GraphQL
Australia Post-labels en manifesten maken
Maak labels aan en genereer een manifest voor Australia Post met de GraphQL API.
GraphQL
Australia Post dient zendingen in als een consolidatie (een manifest). In tegenstelling tot vervoerders waarbij een label een op zichzelf staande actie is, moet een Australia Post-zending bij een consolidatiegroep horen, en de groep is wat bij Australia Post wordt ingediend.
Het proces bestaat uit drie onderdelen:
Voordat u begint
Stap 1: Open een consolidatiegroep
Maak een groep aan met
shipmentConsolidationCreate, metcarrierCode: AUSTRALIA_POST. De geretourneerdeidis de groep waaraan u labels toevoegt. Als u al een open groep voor die dag heeft, gebruik deze dan opnieuw in plaats van een nieuwe aan te maken (zie Een open groep hergebruiken hieronder).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}Een open groep hergebruiken
Om labels toe te voegen aan een bestaande groep in plaats van een nieuwe aan te maken, doorzoekt u de open groepen en gebruikt u de
idvan de gewenste groep.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Stap 2: Maak een label aan in de groep
Maak de zending en het bijbehorende label aan met
shipmentCreateWorkflow, waarbij u deidvan de groep doorgeeft alsshipmentConsolidationId. De mutatie registreert de zending bij Australia Post en retourneert een label-URL en trackingnummer. Er wordt nog geen bedrag in rekening gebracht — de zending blijft in het winkelmandje van Australia Post staan totdat de groep is gesloten.Australia Post-specifieke velden:
shipmentConsolidationId— deidvan de groep uit stap 1. Vereist om de zending aan het manifest toe te voegen.serviceLevel— het Australia Post-serviceniveau voor de zending (bijvoorbeeld een International Standard- of International Express-serviceniveau).itnNumber— het exportaangiftenummer (EDN). Vereist wanneer de totale artikelwaarde hoger is dan AUD 2.000.Zie
ShipmentCreateWorkflowInputvoor de volledige lijst met velden, en Een verzending aanmaken voor de algemene (niet-Australia Post) verzendmutatie.mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}Herhaal deze stap voor elk pakket dat u op hetzelfde manifest wilt — geef elke keer dezelfde
shipmentConsolidationIddoor.Stap 3: Sluit de groep om het manifest te genereren
Wanneer u klaar bent om te verzenden, sluit u de groep met
shipmentConsolidationUpdateenstatus: CLOSED. Hierdoor wordt de bestelling bij Australia Post ingediend en wordt het manifest geretourneerd incustomsDocuments(de Order Summary-PDF). Dit is het moment waarop de handelaar in rekening wordt gebracht. De afzender van het manifest komt van het herkomstadres van elke zending, dus is er geen fulfillment center nodig.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}Download het manifest via
customsDocuments.fileUrlen overleg het bij inlevering of ophaling. Zodra de groep is gesloten, zijn de zendingen ingediend en kunnen ze niet meer worden gewijzigd.Annuleren vóór indiening
Omdat facturering pas bij het sluiten plaatsvindt, kunt u een zending op elk moment vóór het sluiten uit een groep verwijderen door het label te annuleren. Annuleren verwijdert de zending uit het winkelmandje van Australia Post, zodat deze nooit wordt ingediend en nooit in rekening wordt gebracht.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Was deze pagina nuttig?