Services de bureau de poste
1.0.0
Obtenir l'accès à l’API Services de bureau de poste 1.0.0
Pour obtenir l’accès, créez un compte ou se connecter.
Services de bureau de poste 1.0.0
Obtenez une liste des bureaux de poste à proximité grâce à l’API « Trouver un bureau de poste » ou configurez un service de livraison pratique pour votre clientèle avec le service Livrer au bureau de poste
Pour obtenir l’accès, créez un compte ou se connecter.
Utilisation
L’API « Trouver un bureau de poste » affiche une liste des bureaux de poste situés près d’un emplacement donné. Pour chaque bureau de poste, il y aura une mention indiquant s’il est possible d’y livrer un colis directement, ainsi que les heures d’ouverture.
L’option Livrer au bureau de poste se trouve dans l’outil Trouver un bureau de poste. Vous pouvez utiliser l’outil Trouver un bureau de poste au moment de passer à la caisse pour donner aux gens qui magasinent en ligne la possibilité de faire livrer leurs achats directement à un bureau de poste participant de leur choix près de leur domicile, de leur travail ou ailleurs.
Remarque : Le service Livrer au bureau de poste n’est offert que pour les articles XpresspostMC et Colis accélérésMC.
Fonctionnement
Trouver un bureau de poste
La cliente ou le client fournit un emplacement (un code postal, une adresse ou une intersection) et l’API renvoie une liste des bureaux de poste à proximité dans ce secteur. Ce résultat indique également si chaque emplacement offre la livraison directement au bureau de poste pour plus de flexibilité. Une fois qu’un bureau de poste précis est choisi, l’API récupère des renseignements détaillés à son sujet.
Pour offrir avec succès le service Livrer au bureau de poste :
- Affichez les renseignements sur le bureau de poste au moment de passer à la caisse et permettez aux gens de sélectionner un bureau de poste près de chez eux.
- Saisissez le numéro d’identification du bureau de poste sélectionné à l’aide de l’API du bureau de poste le plus près.
- Lorsque vous voulez expédier votre commande, utilisez l’API de création d’envois pour générer l’étiquette d’expédition Livrer au bureau de poste à l’aide du numéro d’identification du bureau de poste.
- Lorsque le colis arrivera au bureau de poste, les destinataires recevront un courriel.
Dernières mises à jour de cette version
30 avril 2026
Nous avons mis à jour nos API afin d'améliorer la sécurité et les performances. Les protocoles sont désormais exclusivement REST avec une standardisation au format JSON (XML et SOAP ne sont plus pris en charge), et les jetons OAuth 2.0 Bearer sont maintenant obligatoires pour toutes les requêtes. Nous avons également ajouté des fichiers de configuration YAML et élargi le soutien pour 10 langages de programmation.
Pour en savoir plus, consultez les notes de mise à jour.
Flux de travail et requêtes Trouver un bureau de poste
Trouver un bureau de poste peut être utilisé dans n’importe quel ordre, mais il est généralement utilisé au moyen des deux requêtes suivantes :
| Service | Description |
|---|---|
| Obtenir le bureau de poste le plus près | Affiche une liste des bureaux de poste situés près d’un emplacement donné. Précise également lesquels appuient la livraison directe au bureau de poste plutôt qu’à l’adresse de la ou du destinataire. |
| Obtenir les détails d’un bureau de poste | Fournit des détails sur les bureaux de poste affichés lors de la requête Obtenir le bureau de poste le plus près (par exemple, les heures d’ouverture). |
Livrer au bureau de poste
Remarque importante : Si vous voulez offrir l’option « Livrer au bureau de poste », utilisez la requête Bureau de poste le plus près.
Avantages de Livrer au bureau de poste
- Élimine les retards attribuables aux tentatives de livraison infructueuses.
- Augmente la satisfaction de la clientèle grâce à une livraison plus rapide et flexible.
- Les colis sont conservés dans l’un de nos 6 000 emplacements sécuritaires à température contrôlée de Postes Canada.
Flux de travail Livrer au bureau de poste
Le flux de travail Livrer au bureau de poste est divisé en trois grandes étapes. Tout d’abord, la clientèle sélectionne un bureau de poste sur un site de cybercommerce à partir des données de Postes Canada, puis les renseignements d’expédition sont envoyés au système d’expédition du détaillant. Ensuite, une étiquette d’expédition conforme est générée. Enfin, l’étiquette est balayée au bureau de poste et la clientèle est avisée que le colis est prêt pour le ramassage.
Détails de programmatique
| Votre procédé | Résumé programmatique |
|---|---|
| Présentez aux gens une carte montrant les bureaux de poste près de leur adresse d’expédition ou laissez-les entrer un code postal, une adresse ou une intersection près du lieu de ramassage. | Pour trouver les bureaux de poste qui appuient le service Livrer au bureau de poste, envoyez une demande au bureau de poste le plus près et réglez l’élément D2PO à « true ». Ce résultat comprendra seulement les bureaux de poste qui ont la fonction Livrer au bureau de poste. |
| Au moment de passer à la caisse, l’utilisatrice ou l’utilisateur choisit un bureau de poste pour la livraison de colis. | En plus des détails de la commande, vous devez aussi sauvegarder les renseignements suivants :
|
| Les étapes suivantes décrivent comment produire des étiquettes d’expédition à l’aide des services Web. | Lorsque vous utilisez l’API de création d’envoi pour configurer la commande, vous devez inclure ce qui suit :
Lorsque vous imprimez l’étiquette d’adresse :
|
| Lorsque le bureau de poste balaie le code à barres, l’acheteuse ou l’acheteur reçoit un courriel. | Non. |
| Au bureau de poste, la personne présente une pièce d’identité avec photo émise par le gouvernement. L’adresse utilise lors de l’achat de l’article doit figurer sur la pièce d’identité. | Les éléments suivants s’affichent dans le résultat Obtenir les détails de l’envoi : Destination : Contient l’adresse du bureau de poste où l’envoi sera livré Destinataire : Contient l’adresse de destination du courrier que vous avez ajoutée dans l’élément Destination. |
Commencer à utiliser l’API
Commencer
Consultez notre guide du développeur pour obtenir des renseignements sur les jetons d’accès, l’authentification, les limites de tarif et plus.
Obtenir du soutien
Trouvez les réponses aux questions courantes dans notre FAQ. Si vous ne les trouvez pas, communiquez avec notre équipe.