Создавайте этикетки и формируйте манифест для Australia Post с помощью
GraphQL API.
GraphQL
Australia Post оформляет отправления как консолидацию (манифест). В отличие от перевозчиков,
где этикетка — это самостоятельное действие, отправление Australia Post должно принадлежать
консолидационной группе, и именно эта группа передаётся в Australia Post.
Процесс состоит из трёх этапов:
Открытие консолидационной группы — манифест, к которому добавляются отправления.
Создание этикеток в группе — каждое отправление регистрируется в Australia Post
и возвращается этикетка. Отправления находятся в корзине Australia Post, не переданные в перевозку.
Закрытие группы — это передаёт заказ в Australia Post и формирует
сводку заказа (бумажный манифест), которую вы предъявляете при сдаче отправления.
Оплата: с продавца списывается плата, когда группа закрывается (передаётся в перевозку), а не
когда создаётся этикетка. Этикетки можно создавать и аннулировать свободно до закрытия группы.
Создайте группу с помощью shipmentConsolidationCreate, используя carrierCode: AUSTRALIA_POST.
Возвращённый id — это группа, в которую вы добавляете этикетки. Если у вас уже есть открытая группа на
этот день, используйте её повторно вместо создания новой (см. Повторное использование открытой группы ниже).
1mutationShipmentConsolidationCreate(
2$input: ShipmentConsolidationCreateInput!
3){
4 shipmentConsolidationCreate(input:$input) {
5 id
6 name
7 carrierCode
8 status
9}
10}
Повторное использование открытой группы
Чтобы добавить этикетки в существующую группу вместо создания новой, выполните запрос открытых групп
и используйте id нужной группы.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
Создайте отправление и его этикетку с помощью shipmentCreateWorkflow, передав id группы
как shipmentConsolidationId. Мутация регистрирует отправление в Australia Post и
возвращает URL этикетки и номер отслеживания. Списание средств пока не происходит — отправление удерживается
в корзине Australia Post до закрытия группы.
Специфичные для Australia Post поля:
shipmentConsolidationId — id группы из шага 1. Требуется для добавления отправления
в манифест.
serviceLevel — уровень обслуживания Australia Post для отправления (например,
International Standard или International Express).
itnNumber — номер экспортной декларации (EDN). Требуется, если общая стоимость товаров
превышает 2000 AUD.
Номера телефонов должны содержать только цифры — Australia Post отклоняет пробелы и знаки препинания.
Когда вы готовы отправить груз, закройте группу с помощью shipmentConsolidationUpdate и
status: CLOSED. Это передаёт заказ в Australia Post и возвращает манифест в
customsDocuments (PDF сводки заказа). Именно в этот момент с продавца списывается
плата. Отправитель манифеста берётся из адреса происхождения каждого отправления, поэтому
центр выполнения заказов не требуется.
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}
Скачайте манифест по ссылке customsDocuments.fileUrl и предъявите его при сдаче или
получении груза. После закрытия группы её отправления переданы в перевозку и больше не могут быть изменены.
Поскольку списание средств происходит при закрытии, вы можете исключить отправление из группы в любой момент до
её закрытия, аннулировав его этикетку. Аннулирование удаляет отправление из корзины Australia Post,
поэтому оно никогда не передаётся в перевозку и не оплачивается.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Создание этикеток и манифестов - GraphQL
Создание этикеток и манифестов Australia Post
Создавайте этикетки и формируйте манифест для Australia Post с помощью GraphQL API.
GraphQL
Australia Post оформляет отправления как консолидацию (манифест). В отличие от перевозчиков, где этикетка — это самостоятельное действие, отправление Australia Post должно принадлежать консолидационной группе, и именно эта группа передаётся в Australia Post.
Процесс состоит из трёх этапов:
Прежде чем начать
Шаг 1: Открытие консолидационной группы
Создайте группу с помощью
shipmentConsolidationCreate, используяcarrierCode: AUSTRALIA_POST. Возвращённыйid— это группа, в которую вы добавляете этикетки. Если у вас уже есть открытая группа на этот день, используйте её повторно вместо создания новой (см. Повторное использование открытой группы ниже).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}Повторное использование открытой группы
Чтобы добавить этикетки в существующую группу вместо создания новой, выполните запрос открытых групп и используйте
idнужной группы.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Шаг 2: Создание этикетки в группе
Создайте отправление и его этикетку с помощью
shipmentCreateWorkflow, передавidгруппы какshipmentConsolidationId. Мутация регистрирует отправление в Australia Post и возвращает URL этикетки и номер отслеживания. Списание средств пока не происходит — отправление удерживается в корзине Australia Post до закрытия группы.Специфичные для Australia Post поля:
shipmentConsolidationId—idгруппы из шага 1. Требуется для добавления отправления в манифест.serviceLevel— уровень обслуживания Australia Post для отправления (например, International Standard или International Express).itnNumber— номер экспортной декларации (EDN). Требуется, если общая стоимость товаров превышает 2000 AUD.См.
ShipmentCreateWorkflowInputдля полного списка полей и Создание отправления для общей (не относящейся к Australia Post) мутации отправления.mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}Повторите этот шаг для каждой посылки, которую вы хотите включить в один манифест — передавайте тот же
shipmentConsolidationIdкаждый раз.Шаг 3: Закрытие группы для формирования манифеста
Когда вы готовы отправить груз, закройте группу с помощью
shipmentConsolidationUpdateиstatus: CLOSED. Это передаёт заказ в Australia Post и возвращает манифест вcustomsDocuments(PDF сводки заказа). Именно в этот момент с продавца списывается плата. Отправитель манифеста берётся из адреса происхождения каждого отправления, поэтому центр выполнения заказов не требуется.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}Скачайте манифест по ссылке
customsDocuments.fileUrlи предъявите его при сдаче или получении груза. После закрытия группы её отправления переданы в перевозку и больше не могут быть изменены.Аннулирование до передачи в перевозку
Поскольку списание средств происходит при закрытии, вы можете исключить отправление из группы в любой момент до её закрытия, аннулировав его этикетку. Аннулирование удаляет отправление из корзины Australia Post, поэтому оно никогда не передаётся в перевозку и не оплачивается.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Была ли эта страница полезной?