DOCS
Collect•
Strona głównaGlobalny handel elektroniczny Realizacja zamówień Przewoźnicy Konfiguracja konta, wycena i etykiety Utwórz etykiety i manifesty - GraphQL

Utwórz etykiety i manifesty Australia Post

Twórz etykiety i generuj manifest dla Australia Post za pomocą interfejsu GraphQL API.

GraphQL

Australia Post zgłasza przesyłki jako konsolidację (manifest). W przeciwieństwie do innych przewoźników, u których etykieta jest samodzielną czynnością, przesyłka Australia Post musi należeć do grupy konsolidacyjnej, a to właśnie ta grupa jest zgłaszana do Australia Post.

Proces składa się z trzech etapów:

  1. Otwórz grupę konsolidacyjną — manifest, do którego dodawane są przesyłki.
  2. Twórz etykiety w ramach grupy — każda przesyłka jest rejestrowana w Australia Post, a w odpowiedzi zwracana jest etykieta. Przesyłki pozostają w koszyku Australia Post, niezgłoszone.
  3. Zamknij grupę — to zgłasza zamówienie do Australia Post i generuje podsumowanie zamówienia (papierowy manifest), które przedstawiasz przy nadaniu przesyłki.

Rozliczenia: sprzedawca zostaje obciążony opłatą w momencie zamknięcia grupy (zgłoszenia), a nie w momencie utworzenia etykiety. Etykiety można swobodnie tworzyć i unieważniać aż do zamknięcia grupy.

Zanim zaczniesz 

Krok 1: Otwórz grupę konsolidacyjną 

Utwórz grupę za pomocą shipmentConsolidationCreate, używając carrierCode: AUSTRALIA_POST. Zwrócony id to grupa, do której dodajesz etykiety. Jeśli masz już otwartą grupę na dany dzień, użyj jej ponownie zamiast tworzyć nową (zobacz Ponowne użycie otwartej grupy poniżej).

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

Ponowne użycie otwartej grupy

Aby dodać etykiety do istniejącej grupy zamiast tworzyć nową, wykonaj zapytanie o otwarte grupy i użyj id wybranej grupy.

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}

Krok 2: Utwórz etykietę w ramach grupy 

Utwórz przesyłkę wraz z jej etykietą za pomocą shipmentCreateWorkflow, przekazując id grupy jako shipmentConsolidationId. Mutacja rejestruje przesyłkę w Australia Post i zwraca adres URL etykiety oraz numer śledzenia. Opłata jeszcze nie jest naliczana — przesyłka pozostaje w koszyku Australia Post aż do zamknięcia grupy.

Pola specyficzne dla Australia Post:

  • shipmentConsolidationId — id grupy z kroku 1. Wymagane, aby dodać przesyłkę do manifestu.
  • serviceLevel — poziom usługi Australia Post dla przesyłki (na przykład poziom usługi International Standard lub International Express).
  • itnNumber — numer zgłoszenia wywozowego (EDN). Wymagany, gdy łączna wartość towarów przekracza 2000 AUD.

Numery telefonów mogą zawierać wyłącznie cyfry — Australia Post odrzuca spacje i znaki interpunkcyjne.

Pełną listę pól znajdziesz w ShipmentCreateWorkflowInput, a ogólną (niedotyczącą Australia Post) mutację przesyłki opisano w Tworzenie przesyłki.

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}

Powtórz ten krok dla każdej paczki, którą chcesz umieścić na tym samym manifeście — za każdym razem przekazuj to samo shipmentConsolidationId.

Krok 3: Zamknij grupę, aby wygenerować manifest 

Gdy jesteś gotowy do wysyłki, zamknij grupę za pomocą shipmentConsolidationUpdate i status: CLOSED. To zgłasza zamówienie do Australia Post i zwraca manifest w customsDocuments (plik PDF z podsumowaniem zamówienia). To właśnie w tym momencie sprzedawca zostaje obciążony opłatą. Nadawca manifestu pochodzi z adresu nadania każdej przesyłki, więc centrum realizacji nie jest potrzebne.

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}

Pobierz manifest z customsDocuments.fileUrl i przedstaw go przy nadaniu lub odbiorze przesyłki. Po zamknięciu grupy jej przesyłki są zgłoszone i nie można ich już zmienić.

Unieważnianie przed zgłoszeniem 

Ponieważ opłata jest naliczana dopiero przy zamknięciu, możesz wycofać przesyłkę z grupy w dowolnym momencie przed jej zamknięciem, unieważniając jej etykietę. Unieważnienie usuwa przesyłkę z koszyka Australia Post, dzięki czemu nigdy nie zostaje ona zgłoszona ani obciążona opłatą.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

Czy ta strona była pomocna?

Uzyskaj wsparcie·Dokumenty prawne·© 2026 Zonos
Na tej stronie:
  • Utwórz etykiety i manifesty Australia Post
  • Zanim zaczniesz
  • Krok 1: Otwórz grupę konsolidacyjną
  • Krok 2: Utwórz etykietę w ramach grupy
  • Krok 3: Zamknij grupę, aby wygenerować manifest
  • Unieważnianie przed zgłoszeniem