DOCS
Collect•
InicioComercio electrónico global Fulfillment Transportistas Configuración de cuenta, tarifas y etiquetas Crear etiquetas y manifiestos - GraphQL

Crear etiquetas y manifiestos de Australia Post

Crea etiquetas y genera un manifiesto para Australia Post usando la API GraphQL.

GraphQL

Australia Post despacha los envíos como una consolidación (un manifiesto). A diferencia de otras transportadoras, donde una etiqueta es una acción independiente, un envío de Australia Post debe pertenecer a un grupo de consolidación, y es ese grupo el que se despacha ante Australia Post.

El flujo consta de tres partes:

  1. Abrir un grupo de consolidación — el manifiesto al que se agregan los envíos.
  2. Crear etiquetas dentro del grupo — cada envío se registra ante Australia Post y se devuelve una etiqueta. Los envíos permanecen en la canasta de Australia Post, sin despachar.
  3. Cerrar el grupo — esto despacha el pedido ante Australia Post y produce el Order Summary (el manifiesto en papel) que presentas al momento de la entrega.

Facturación: al comerciante se le cobra cuando el grupo se cierra (se despacha), no cuando se crea una etiqueta. Las etiquetas se pueden crear y anular libremente hasta que se cierre el grupo.

Antes de empezar 

Paso 1: Abrir un grupo de consolidación 

Crea un grupo con shipmentConsolidationCreate, usando carrierCode: AUSTRALIA_POST. El id devuelto es el grupo al que agregas las etiquetas. Si ya tienes un grupo abierto para el día, reutilízalo en lugar de crear uno nuevo (consulta Reutilizar un grupo abierto más abajo).

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

Reutilizar un grupo abierto

Para agregar etiquetas a un grupo existente en lugar de crear uno nuevo, consulta los grupos abiertos y usa el id del que quieras.

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}

Paso 2: Crear una etiqueta dentro del grupo 

Crea el envío y su etiqueta con shipmentCreateWorkflow, pasando el id del grupo como shipmentConsolidationId. La mutación registra el envío ante Australia Post y devuelve una URL de etiqueta y un número de seguimiento. Todavía no se genera ningún cobro — el envío se mantiene en la canasta de Australia Post hasta que se cierra el grupo.

Campos específicos de Australia Post:

  • shipmentConsolidationId — el id del grupo del Paso 1. Es obligatorio para agregar el envío al manifiesto.
  • serviceLevel — el nivel de servicio de Australia Post para el envío (por ejemplo, un nivel de servicio International Standard o International Express).
  • itnNumber — el número de declaración de exportación (EDN, por sus siglas en inglés). Es obligatorio cuando el valor total del artículo supera los AUD 2.000.

Los números de teléfono deben contener solo dígitos — Australia Post rechaza espacios y puntuación.

Consulta ShipmentCreateWorkflowInput para ver la lista completa de campos, y Crear un envío para la mutación general de envíos (no específica de 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}

Repite este paso para cada paquete que quieras incluir en el mismo manifiesto — pasa el mismo shipmentConsolidationId cada vez.

Paso 3: Cerrar el grupo para generar el manifiesto 

Cuando estés listo para enviar, cierra el grupo con shipmentConsolidationUpdate y status: CLOSED. Esto despacha el pedido ante Australia Post y devuelve el manifiesto en customsDocuments (el PDF de Order Summary). Este es el momento en que se cobra al comerciante. El remitente del manifiesto proviene de la dirección de origen de cada envío, por lo que no se necesita ningún centro de cumplimiento.

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}

Descarga el manifiesto desde customsDocuments.fileUrl y preséntalo en la entrega o recolección. Una vez que el grupo se cierra, sus envíos quedan despachados y ya no se pueden modificar.

Anular antes del despacho 

Dado que el cobro ocurre al cierre, puedes retirar un envío de un grupo en cualquier momento antes de que se cierre, anulando su etiqueta. Anular elimina el envío de la canasta de Australia Post, por lo que nunca se despacha ni se cobra.

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

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

Was this page helpful?

Get support·Legal docs·© 2026 Zonos
En esta página:
  • Crear etiquetas y manifiestos de Australia Post
  • Antes de empezar
  • Paso 1: Abrir un grupo de consolidación
  • Paso 2: Crear una etiqueta dentro del grupo
  • Paso 3: Cerrar el grupo para generar el manifiesto
  • Anular antes del despacho