DOCS

Создание этикеток и манифестов Australia Post

Создавайте этикетки и формируйте манифест для Australia Post с помощью GraphQL API.

GraphQL

Australia Post оформляет отправления как консолидацию (манифест). В отличие от перевозчиков, где этикетка — это самостоятельное действие, отправление Australia Post должно принадлежать консолидационной группе, и именно эта группа передаётся в Australia Post.

Процесс состоит из трёх этапов:

  1. Открытие консолидационной группы — манифест, к которому добавляются отправления.
  2. Создание этикеток в группе — каждое отправление регистрируется в Australia Post и возвращается этикетка. Отправления находятся в корзине Australia Post, не переданные в перевозку.
  3. Закрытие группы — это передаёт заказ в Australia Post и формирует сводку заказа (бумажный манифест), которую вы предъявляете при сдаче отправления.

Оплата: с продавца списывается плата, когда группа закрывается (передаётся в перевозку), а не когда создаётся этикетка. Этикетки можно создавать и аннулировать свободно до закрытия группы.

Прежде чем начать 

Шаг 1: Открытие консолидационной группы 

Создайте группу с помощью shipmentConsolidationCreate, используя carrierCode: AUSTRALIA_POST. Возвращённый id — это группа, в которую вы добавляете этикетки. Если у вас уже есть открытая группа на этот день, используйте её повторно вместо создания новой (см. Повторное использование открытой группы ниже).

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

Повторное использование открытой группы

Чтобы добавить этикетки в существующую группу вместо создания новой, выполните запрос открытых групп и используйте id нужной группы.

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}

Шаг 2: Создание этикетки в группе 

Создайте отправление и его этикетку с помощью shipmentCreateWorkflow, передав id группы как shipmentConsolidationId. Мутация регистрирует отправление в Australia Post и возвращает URL этикетки и номер отслеживания. Списание средств пока не происходит — отправление удерживается в корзине Australia Post до закрытия группы.

Специфичные для Australia Post поля:

  • shipmentConsolidationIdid группы из шага 1. Требуется для добавления отправления в манифест.
  • serviceLevel — уровень обслуживания Australia Post для отправления (например, International Standard или International Express).
  • itnNumber — номер экспортной декларации (EDN). Требуется, если общая стоимость товаров превышает 2000 AUD.

Номера телефонов должны содержать только цифры — Australia Post отклоняет пробелы и знаки препинания.

См. ShipmentCreateWorkflowInput для полного списка полей и Создание отправления для общей (не относящейся к Australia Post) мутации отправления.

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}

Повторите этот шаг для каждой посылки, которую вы хотите включить в один манифест — передавайте тот же shipmentConsolidationId каждый раз.

Шаг 3: Закрытие группы для формирования манифеста 

Когда вы готовы отправить груз, закройте группу с помощью shipmentConsolidationUpdate и status: CLOSED. Это передаёт заказ в Australia Post и возвращает манифест в customsDocuments (PDF сводки заказа). Именно в этот момент с продавца списывается плата. Отправитель манифеста берётся из адреса происхождения каждого отправления, поэтому центр выполнения заказов не требуется.

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}

Скачайте манифест по ссылке customsDocuments.fileUrl и предъявите его при сдаче или получении груза. После закрытия группы её отправления переданы в перевозку и больше не могут быть изменены.

Аннулирование до передачи в перевозку 

Поскольку списание средств происходит при закрытии, вы можете исключить отправление из группы в любой момент до её закрытия, аннулировав его этикетку. Аннулирование удаляет отправление из корзины Australia Post, поэтому оно никогда не передаётся в перевозку и не оплачивается.

Была ли эта страница полезной?