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 :
Ouvrir un groupe de consolidation — le manifeste auquel les expéditions sont ajoutées.
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.
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.
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).
1mutationShipmentConsolidationCreate(
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.
1queryShipmentConsolidations{
2 shipmentConsolidations(filter:{status: OPEN }, first:50){
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.
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.
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.
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}
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Créer des étiquettes et manifestes - GraphQL
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 :
Avant de commencer
Étape 1 : Ouvrir un groupe de consolidation
Créez un groupe avec
shipmentConsolidationCreate, en utilisantcarrierCode: AUSTRALIA_POST. L'idrenvoyé 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).mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}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'
idde celui que vous souhaitez.query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}Étape 2 : Créer une étiquette dans le groupe
Créez l'expédition et son étiquette avec
shipmentCreateWorkflow, en transmettant l'iddu groupe en tant queshipmentConsolidationId. 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'iddu 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.Consultez
ShipmentCreateWorkflowInputpour la liste complète des champs, et Créer une expédition pour la mutation d'expédition générale (hors Australia Post).mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}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
shipmentConsolidationUpdateetstatus: CLOSED. Cela enregistre la commande auprès d'Australia Post et renvoie le manifeste danscustomsDocuments(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.mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}Téléchargez le manifeste depuis
customsDocuments.fileUrlet 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.
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
Cette page a-t-elle été utile?