DOCS

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:

  1. Open een consolidatiegroep — het manifest waaraan zendingen worden toegevoegd.
  2. 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.
  3. 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.

Voordat u begint 

Stap 1: Open een consolidatiegroep 

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).

1mutation ShipmentConsolidationCreate(
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.

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}

Stap 2: Maak een label aan in de groep 

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.

Zie ShipmentCreateWorkflowInput voor de volledige lijst met velden, en Een verzending aanmaken voor de algemene (niet-Australia Post) verzendmutatie.

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}

Herhaal deze stap voor elk pakket dat u op hetzelfde manifest wilt — geef elke keer dezelfde shipmentConsolidationId door.

Stap 3: Sluit de groep om het manifest te genereren 

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.

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 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.

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.

Boek een demo

Was deze pagina nuttig?