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:
Eine Konsolidierungsgruppe öffnen — das Manifest, dem Sendungen hinzugefügt werden.
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.
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.
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).
1mutationShipmentConsolidationCreate(
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.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
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.
Wiederholen Sie diesen Schritt für jedes Paket, das auf demselben Manifest erscheinen
soll — übergeben Sie dabei jedes Mal dieselbe shipmentConsolidationId.
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.
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}
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Labels und Manifeste erstellen - GraphQL
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:
Bevor Sie beginnen
Schritt 1: Konsolidierungsgruppe öffnen
Erstellen Sie eine Gruppe mit
shipmentConsolidationCreateundcarrierCode: AUSTRALIA_POST. Die zurückgegebeneidist 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).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}Offene Gruppe weiterverwenden
Um Labels zu einer bestehenden Gruppe statt einer neu erstellten hinzuzufügen, fragen Sie offene Gruppen ab und verwenden Sie die
idder gewünschten Gruppe.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Schritt 2: Ein Label in die Gruppe erstellen
Erstellen Sie die Sendung und deren Label mit
shipmentCreateWorkflow, indem Sie die Gruppen-idalsshipmentConsolidationIdü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-idaus 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.Die vollständige Liste der Felder finden Sie unter
ShipmentCreateWorkflowInput, die allgemeine (nicht Australia Post-spezifische) Sendungsmutation unter Eine Sendung erstellen.mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}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
shipmentConsolidationUpdateundstatus: CLOSED. Dadurch wird die Bestellung bei Australia Post eingereicht und das Manifest incustomsDocumentszurü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.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}Laden Sie das Manifest über
customsDocuments.fileUrlherunter 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.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
War diese Seite hilfreich?