DOCS

Australia Post-Labels und -Manifeste erstellen

Erstellen Sie Labels und generieren Sie ein Manifest für Australia Post über die GraphQL-API.

GraphQL

Australia Post reicht Sendungen als Konsolidierung (ein Manifest) ein. Anders als bei Carriern, bei denen ein Label eine eigenständige Aktion ist, muss eine Australia Post-Sendung zu einer Konsolidierungsgruppe gehören, und diese Gruppe ist es, die bei Australia Post eingereicht wird.

Der Ablauf besteht aus drei Teilen:

  1. Eine Konsolidierungsgruppe öffnen — das Manifest, dem Sendungen hinzugefügt werden.
  2. Labels in die Gruppe erstellen — jede Sendung wird bei Australia Post registriert und ein Label wird zurückgegeben. Die Sendungen bleiben im Warenkorb von Australia Post, ohne eingereicht zu sein.
  3. Die Gruppe schließen — dadurch wird die Bestellung bei Australia Post eingereicht und die Order Summary (das Papier-Manifest) erstellt, die Sie bei der Abgabe vorlegen.

Abrechnung: Der Händler wird belastet, wenn die Gruppe geschlossen (eingereicht) wird, nicht wenn ein Label erstellt wird. Labels können bis zum Schließen der Gruppe frei erstellt und storniert werden.

Bevor Sie beginnen 

Schritt 1: Konsolidierungsgruppe öffnen 

Erstellen Sie eine Gruppe mit shipmentConsolidationCreate und carrierCode: AUSTRALIA_POST. Die zurückgegebene id ist die Gruppe, der Sie Labels hinzufügen. Wenn Sie für den Tag bereits eine offene Gruppe haben, verwenden Sie diese weiter, anstatt eine neue zu erstellen (siehe Offene Gruppe weiterverwenden unten).

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

Offene Gruppe weiterverwenden

Um Labels zu einer bestehenden Gruppe statt einer neu erstellten hinzuzufügen, fragen Sie offene Gruppen ab und verwenden Sie die id der gewünschten Gruppe.

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}

Schritt 2: Ein Label in die Gruppe erstellen 

Erstellen Sie die Sendung und deren Label mit shipmentCreateWorkflow, indem Sie die Gruppen-id als shipmentConsolidationId übergeben. Die Mutation registriert die Sendung bei Australia Post und gibt eine Label-URL sowie eine Sendungsverfolgungsnummer zurück. Es fällt noch keine Gebühr an — die Sendung bleibt im Warenkorb von Australia Post, bis die Gruppe geschlossen wird.

Australia Post-spezifische Felder:

  • shipmentConsolidationId — die Gruppen-id aus Schritt 1. Erforderlich, um die Sendung dem Manifest hinzuzufügen.
  • serviceLevel — die Australia Post-Service-Stufe für die Sendung (zum Beispiel eine International Standard- oder International Express-Service-Stufe).
  • itnNumber — die Ausfuhrerklärungsnummer (EDN). Erforderlich, wenn der Gesamtwert der Artikel AUD 2.000 übersteigt.

Telefonnummern dürfen nur Ziffern enthalten — Australia Post lehnt Leerzeichen und Satzzeichen ab.

Die vollständige Liste der Felder finden Sie unter ShipmentCreateWorkflowInput, die allgemeine (nicht Australia Post-spezifische) Sendungsmutation unter Eine Sendung erstellen.

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}

Wiederholen Sie diesen Schritt für jedes Paket, das auf demselben Manifest erscheinen soll — übergeben Sie dabei jedes Mal dieselbe shipmentConsolidationId.

Schritt 3: Die Gruppe schließen, um das Manifest zu erstellen 

Wenn Sie versandbereit sind, schließen Sie die Gruppe mit shipmentConsolidationUpdate und status: CLOSED. Dadurch wird die Bestellung bei Australia Post eingereicht und das Manifest in customsDocuments zurückgegeben (das Order Summary-PDF). An diesem Punkt wird der Händler belastet. Der Absender des Manifests stammt aus der Ursprungsadresse jeder Sendung, sodass kein Fulfillment-Center erforderlich ist.

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}

Laden Sie das Manifest über customsDocuments.fileUrl herunter und legen Sie es bei der Abgabe oder Abholung vor. Sobald die Gruppe geschlossen ist, sind ihre Sendungen eingereicht und können nicht mehr geändert werden.

Stornieren vor der Einreichung 

Da die Abrechnung erst beim Schließen erfolgt, können Sie eine Sendung jederzeit vor dem Schließen aus einer Gruppe entfernen, indem Sie deren Label stornieren. Durch das Stornieren wird die Sendung aus dem Warenkorb von Australia Post entfernt, sodass sie nie eingereicht und nie berechnet wird.

War diese Seite hilfreich?