DOCS

Créer des étiquettes et manifestes Australia Post

Créez des étiquettes et générez un manifeste pour Australia Post à l'aide de l'API GraphQL.

GraphQL

Australia Post enregistre les expéditions sous forme de consolidation (un manifeste). Contrairement aux transporteurs pour lesquels une étiquette est une action autonome, une expédition Australia Post doit appartenir à un groupe de consolidation, et c'est ce groupe qui est enregistré auprès d'Australia Post.

Le processus comporte trois étapes :

  1. Ouvrir un groupe de consolidation — le manifeste auquel les expéditions sont ajoutées.
  2. Créer des étiquettes dans le groupe — chaque expédition est enregistrée auprès d'Australia Post et une étiquette est renvoyée. Les expéditions restent dans le panier d'Australia Post, non enregistrées.
  3. Fermer le groupe — cela enregistre la commande auprès d'Australia Post et produit le résumé de commande (le manifeste papier) que vous présentez au dépôt.

Facturation : le marchand est facturé lorsque le groupe est fermé (enregistré), et non lors de la création d'une étiquette. Les étiquettes peuvent être créées et annulées librement jusqu'à la fermeture du groupe.

Avant de commencer 

Étape 1 : Ouvrir un groupe de consolidation 

Créez un groupe avec shipmentConsolidationCreate, en utilisant carrierCode: AUSTRALIA_POST. L'id renvoyé est le groupe auquel vous ajoutez des étiquettes. Si vous avez déjà un groupe ouvert pour la journée, réutilisez-le plutôt que d'en créer un nouveau (voir Réutiliser un groupe ouvert ci-dessous).

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

Réutiliser un groupe ouvert

Pour ajouter des étiquettes à un groupe existant plutôt que d'en créer un nouveau, interrogez les groupes ouverts et utilisez l'id de celui que vous souhaitez.

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}

Étape 2 : Créer une étiquette dans le groupe 

Créez l'expédition et son étiquette avec shipmentCreateWorkflow, en transmettant l'id du groupe en tant que shipmentConsolidationId. La mutation enregistre l'expédition auprès d'Australia Post et renvoie une URL d'étiquette et un numéro de suivi. Aucune facturation n'a encore lieu — l'expédition est conservée dans le panier d'Australia Post jusqu'à la fermeture du groupe.

Champs spécifiques à Australia Post :

  • shipmentConsolidationId — l'id du groupe obtenu à l'étape 1. Requis pour ajouter l'expédition au manifeste.
  • serviceLevel — le niveau de service Australia Post pour l'expédition (par exemple, un niveau de service International Standard ou International Express).
  • itnNumber — le numéro de déclaration d'exportation (EDN). Requis lorsque la valeur totale de l'article dépasse 2 000 AUD.

Les numéros de téléphone doivent contenir uniquement des chiffres — Australia Post rejette les espaces et la ponctuation.

Consultez ShipmentCreateWorkflowInput pour la liste complète des champs, et Créer une expédition pour la mutation d'expédition générale (hors 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}

Répétez cette étape pour chaque colis que vous souhaitez inclure dans le même manifeste — en transmettant le même shipmentConsolidationId à chaque fois.

Étape 3 : Fermer le groupe pour générer le manifeste 

Lorsque vous êtes prêt à expédier, fermez le groupe avec shipmentConsolidationUpdate et status: CLOSED. Cela enregistre la commande auprès d'Australia Post et renvoie le manifeste dans customsDocuments (le PDF du résumé de commande). C'est à ce moment que le marchand est facturé. L'expéditeur du manifeste provient de l'adresse d'origine de chaque expédition, donc aucun centre de traitement des commandes n'est nécessaire.

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}

Téléchargez le manifeste depuis customsDocuments.fileUrl et présentez-le au dépôt ou au retrait. Une fois le groupe fermé, ses expéditions sont enregistrées et ne peuvent plus être modifiées.

Annulation avant enregistrement 

Comme la facturation intervient à la fermeture, vous pouvez retirer une expédition d'un groupe à tout moment avant sa fermeture en annulant son étiquette. L'annulation retire l'expédition du panier d'Australia Post, de sorte qu'elle n'est jamais enregistrée ni facturée.

Cette page a-t-elle été utile?