Canada Post Universal Shipping pour Magento® 2.x

Canada Post Universal Shipping est une extension Magento 2 qui vous permet de gérer tout le cycle de l'expédition Canada Post via l'API Canada Post.

Canada Post est le service postal national du Canada : il livre à chaque adresse du pays et vers plus de 190 destinations dans le monde. L'extension relie votre boutique à ce réseau de bout en bout — tarifs en temps réel au checkout, étiquettes et documents douaniers depuis l'administration, suivi, annulations, retours, enlèvements et manifestes de fin de journée.

Les principaux avantages de l'extension Canada Post Universal Shipping :

Étiquettes d'expédition PDF et thermiques

La création d'étiquettes d'expédition est possible manuellement, en masse depuis la grille des commandes, automatiquement et même selon un planning. L'extension associe chaque étiquette à une commande, une expédition ou un avoir. Toutes les étiquettes sont stockées sur votre serveur et restent accessibles à tout moment depuis l'interface d'administration.
Avant une création manuelle, vous choisissez le service Canada Post souhaité et voyez immédiatement le coût d'expédition. En mode automatique, les étiquettes sont créées soit selon la méthode choisie par l'acheteur, soit selon un service national et international que vous configurez. Les étiquettes reviennent en PDF au format 8.5x11, 4x6 et 3x5, ou en ZPL pour les imprimantes thermiques.

Tarifs et méthodes d'expédition

Obtenez les tarifs d'expédition au checkout exactement comme sur canadapost.ca. Les prix d'expédition dépendent des codes postaux d'origine et de destination, du poids, des dimensions, du type d'adresse et des options actives — l'extension prend tout cela en compte. Les cotations sont mises en cache pendant un intervalle que vous définissez, afin qu'un checkout chargé ne réinterroge pas le transporteur pour le même panier. Le coût d'une méthode peut être statique ou dynamique, les prix comme l'affichage se règlent par des limites, et vous créez autant de méthodes que vous le souhaitez. Plus de détails ici.

Comptes avec et sans contrat

Un numéro de contrat commercial débloque les tarifs négociés, la facturation sur compte, les manifestes et les Open Returns. Sans contrat, vous pouvez toujours coter et expédier : l'extension bascule sur le point d'accès sans contrat et chaque étiquette est réglée à l'unité. La livraison elle-même se règle uniquement auprès de Canada Post — l'extension ne facture ni l'expédition, ni les étiquettes, ni les appels de tarification.

Retours

Deux flux de retour, tous deux natifs chez Canada Post. Un Authorized Return émet une étiquette par colis, avec votre adresse comme destinataire. Un Open Return est un modèle permanent dans lequel la boutique puise des étiquettes jusqu'à épuisement de son quota — créez-le d'un bouton depuis les réglages de retours et l'extension conserve l'identifiant du modèle pour vous. Les clients peuvent demander une étiquette de retour depuis leur compte ; elle arrive par e-mail dans un modèle que vous contrôlez.

Enlèvement et suivi

Commandez un enlèvement de colis directement depuis le panneau d'administration de votre boutique — à la demande pour un créneau précis, ou selon un planning hebdomadaire permanent. La disponibilité pour un code postal se vérifie avant la réservation, et un enlèvement réservé peut être annulé.

Une fois vos colis partis, suivez-les avec notre extension. Vous voyez toutes les étapes franchies et la position actuelle, soit dans une fenêtre à l'intérieur de Magento, soit sur le site de Canada Post, et le numéro de suivi accompagne l'e-mail de commande.

Manifestes

Les marchands sous contrat peuvent regrouper les expéditions et les transmettre en une fois en fin de journée plutôt qu'une par une. Clôturez manuellement depuis l'administration ou laissez faire le cron ; le PDF du manifeste produit par Canada Post est téléchargé et rangé à côté des étiquettes, et le numéro de PO signé par le chauffeur est inscrit sur chaque étiquette du groupe.

Douane et international

Les déclarations douanières des étiquettes internationales sont construites à partir des produits facturés de la commande. Motif d'exportation, devise douanière, droits prépayés, numéros de licence et de certificat d'exportation, immatriculation IOSS pour l'Union européenne et déclaration AES pour les États-Unis sont tous configurables, et un destinataire « sold to » distinct peut être transmis lorsqu'il diffère du destinataire réel.

Recherche de bureaux de poste

Laissez l'acheteur choisir le bureau où retirer son colis. La recherche s'effectue autour du code postal de livraison, dans un rayon que vous fixez, et affiche les résultats sous forme de liste ou sur une carte Google ou Bing. Le bureau choisi est reporté sur l'étiquette comme une livraison en point de retrait.

Impression

L'impression est l'une des étapes les plus importantes du travail avec les étiquettes d'expédition. Utilisez notre application pour imprimer les étiquettes PDF et thermiques sur vos imprimantes locales et réseau. Vous pouvez l'obtenir ici. Chaque type de document — étiquette, bon de livraison, facture — peut être dirigé vers sa propre imprimante.

Configuration

Les possibilités de notre module sont pratiquement illimitées grâce à des réglages souples. Les paramètres restent pourtant intuitifs et beaucoup sont préremplis. Vous configurez l'extension pour une boutique précise ou un pays précis. Vous appliquez certains réglages aux envois nationaux et d'autres aux envois internationaux, et des réglages distincts sont également possibles pour les étiquettes de retour.

Ce dont vous avez besoin

Un compte au Canada Post Developer Program, qui délivre une clé API et la rattache à votre numéro de client, ainsi qu'une adresse d'origine canadienne — Canada Post expédie depuis le Canada.

Démo

Vous pouvez essayer cette extension pendant 30 jours. Demandez la démo sur cette page avec Demander une démo ; le fonctionnement est expliqué sur Essayer une extension pendant 30 jours.

Hyva Theme et Hyva Checkout

Compatible avec Hyva Theme et Hyva Checkout

L'extension s'installe avec Composer. Le dépôt à ajouter dépend de l'endroit où vous l'avez achetée — l'installation elle-même est identique dans les deux cas.

1. Connecter le dépôt

Achetée sur extmag.com. Votre page de compte affiche l'adresse du dépôt et vos identifiants personnels, ainsi que les deux commandes composer config à coller. Exécutez-les une fois par projet ; toutes les extensions que vous possédez sont ensuite disponibles depuis le même dépôt.

Achetée sur l'Adobe Commerce Marketplace. Le paquet est servi par repo.magento.com, déjà configuré sur la plupart des boutiques. Sinon, ajoutez les Access Keys de votre compte Adobe sous My Profile -> Access Keys.

2. Installer l'extension

À la racine du projet :

composer require extmag/canadapostshipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Composer résout les paquets Extmag partagés dont l'extension dépend : il n'y a rien d'autre à demander à la main.

Déconnectez-vous de l'administration puis reconnectez-vous, et l'extension est prête.

3. Obtenir vos identifiants Canada Post

Inscrivez-vous au Canada Post Developer Program. L'inscription délivre une clé API — un nom d'utilisateur et un mot de passe — et la rattache à votre numéro de client. Canada Post délivre deux clés distinctes, une pour la passerelle de développement et une pour la production ; elles ne sont pas interchangeables. Conservez un compte expéditeur pour chacune et basculez de l'une à l'autre avec l'interrupteur Live Account du formulaire de compte.

Le numéro de contrat commercial est facultatif : sans lui, l'extension cote et expédie quand même, aux tarifs publiés et avec un règlement à l'étiquette. La facturation sur compte, les manifestes et les Open Returns exigent un contrat.

Prérequis

• Magento 2.4.x (Open Source ou Adobe Commerce)
• PHP 8.1 ou plus récent, Composer 2.x
• Une clé API du Canada Post Developer Program et un numéro de client
• Une adresse d'origine canadienne — Canada Post expédie depuis le Canada
• Un accès HTTPS sortant vers soa-gw.canadapost.ca et ct.soa-gw.canadapost.ca

Cron

L'extension enregistre une tâche horaire qui clôture les groupes de manifeste lorsque la stratégie de manifeste est réglée sur le cron quotidien. Avec la stratégie par défaut, chaque envoi est transmis dès sa création et la tâche se termine immédiatement. Le cron Magento doit tourner pour que la variante planifiée clôture quoi que ce soit.

Impression des étiquettes

Pour imprimer les étiquettes sur une imprimante locale ou réseau, installez notre logiciel d'impression depuis ici, puis suivez Installation et configuration d'el-Print.

Hyva Theme et Hyva Checkout

Les boutiques sous Hyva ont besoin d'un paquet de plus :

composer require extmag/shiplab-hyva
composer require magewirephp/magewire

L'intégration remplace un template Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Si votre thème surcharge déjà ce fichier, fusionnez les modifications au lieu de le remplacer.

Essayer avant d'acheter

Vous pouvez demander une démo de 30 jours de cette extension et l'installer exactement comme ci-dessus — même paquet, même dépôt, mêmes commandes. Comment fonctionnent les démos.

Installation sans Composer

L'archive peut être décompressée dans app/code/Extmag/, mais l'extension se retrouve alors hors de la gestion des dépendances : ses paquets partagés doivent être installés à la main et les mises à jour ne l'atteignent jamais. Utilisez Composer pour toute boutique que vous exploitez, démo comprise.

Pour toute question sur l'installation, contactez notre support technique.

Canada Post se configure depuis le menu Extmag de l'administration Adobe Commerce (Magento). Ajoutez le compte transporteur, l'adresse canadienne d'où vous expédiez, les cartons dans lesquels vous emballez et les méthodes d'expédition que voient vos clients, puis affinez la configuration du transporteur.

Compte Canada Post

1. Si vous n'avez pas encore d'identifiants API Canada Post, inscrivez-vous au Canada Post Developer Program. L'inscription délivre une clé API — un nom d'utilisateur et un secret — et la rattache à votre numéro de client.
2. Allez dans Admin Main Menu -> Extmag -> Shipper Accounts.
   
3. Cliquez sur le bouton « Add New Shipper Account ».
4. Choisissez Canada Post comme transporteur, saisissez le nom d'utilisateur de la clé API, le secret et votre numéro de client comme Shipper Number, puis cliquez sur « Save ». Laissez Live Account sur No pendant vos tests — Canada Post délivre des clés distinctes pour la passerelle de développement et pour la production, et elles ne sont pas interchangeables. Créez un compte par clé et passez de l'une à l'autre depuis la configuration.
   

Adresses

1. Allez dans Admin Main Menu -> Extmag -> Settings -> Addresses.
2. Cliquez sur le bouton « Add New Address ».
3. Renseignez la raison sociale, le contact, le téléphone et l'adresse complète, puis cliquez sur « Save ». L'origine doit être canadienne — Canada Post expédie depuis le Canada — avec un code de province à deux lettres valide et un code postal au format A1A1A1. Deux adresses sont utilisées par transporteur : la Shipper Address imprimée sur l'étiquette, et la Ship From Address où le colis est collecté, qui sert aussi de point d'expédition du manifeste lorsque les deux diffèrent.

Package Boxes

1. Allez dans Admin Main Menu -> Extmag -> Settings -> Package Boxes.
2. Cliquez sur le bouton « Add New Box ».
3. Saisissez les dimensions intérieures et extérieures, le poids à vide et la charge maximale, puis cliquez sur « Save ». L'algorithme d'emballage répartit une commande entre les colis à partir de ces cartons : plus vos cartons réels sont décrits, plus le tarif proposé se rapproche de celui qui vous sera facturé. Canada Post accepte jusqu'à 30 kg par colis.

Méthodes d'expédition

1. Allez dans Admin Main Menu -> Extmag -> Shipping Methods.
2. Cliquez sur le bouton « Add New Shipping Method ».
3. Choisissez Canada Post comme transporteur, décidez quels services afficher — tous, une liste précise, ou seulement le moins cher ou le plus cher — et restreignez la méthode par site et par groupe de clients si nécessaire. Cliquez sur « Save ». La liste des services est filtrée par le pays d'origine : une origine canadienne propose les groupes national, États-Unis et international.
   

Configuration

1. Allez dans Admin Main Menu -> Extmag -> Settings -> Canada Post Configuration.
2. Ouvrez d'abord l'onglet General et sélectionnez le compte expéditeur, la Shipper Address et la Ship From Address créées ci-dessus. Ajoutez votre numéro de contrat commercial si vous en avez un — sans lui, la tarification et l'expédition retombent sur les tarifs publiés.
   
3. Parcourez les onglets restants et remplissez ce qui s'applique à votre compte.

Les onglets couvrent :

• General — compte, adresses, numéro de contrat, numéros de client Mailed By et Mailed On Behalf Of, type de destination et description de l'envoi.
• Packaging — les unités de poids et de dimensions. Canada Post encode l'emballage dans le code de service et calcule lui-même le poids volumétrique.
• Returns — Authorized Returns ou Open Returns, le service de retour, le bouton de création d'un modèle Open Return, le quota d'étiquettes et ce que le client peut faire depuis son espace.
• References — le centre de coûts et les deux références client inscrites sur un envoi sous contrat.
• Payments — devise, qui paie le transport et qui paie les droits, le mode de paiement, la valeur assurée, le contre-remboursement et la clé de compte Zonos exigée pour les destinations aux États-Unis.
• Notification — les événements notifiés par e-mail par Canada Post, leur langue et les destinataires.
• Printing — format de papier (8.5x11, 4x6, 3x5), encodage PDF ou ZPL, et ce qui est imprimé sur l'étiquette.
• Pickups — comment l'enlèvement est facturé, où le chauffeur doit se présenter, les indicateurs camion et quai, et le planning hebdomadaire suivi par le cron.
• Tracking — si le suivi s'ouvre dans une fenêtre à l'intérieur de Magento ou vers le site de Canada Post.
• Post Office Locator — le retrait en bureau au checkout, le rayon de recherche, l'affichage en liste ou sur carte et la clé Google ou Bing.
• International Invoice — le bloc douanier : devise, motif d'exportation, droits prépayés, numéros de licence et de certificat, immatriculation IOSS, identifiant de déclaration pour les États-Unis et le destinataire « sold to ».
• Manifest / Closeout — transmettre chaque envoi à sa création, clôturer à la main, ou laisser faire le cron quotidien, ainsi que l'adresse imprimée sur le manifeste.
• Automatic, Mass Actions et Manual Actions — quand les étiquettes sont créées sans opérateur, en masse depuis la grille des commandes, ou une à une.
• Other Options — envois sans contrat, type de cotation, durée de mise en cache d'un tarif, numéro de suivi dans l'e-mail de commande, traitement des colis non distribuables et options de livraison par défaut.

Chaque réglage s'applique par site, par direction et par pays de destination : une règle qui n'a de sens que pour un marché n'affecte pas les autres.

Retours

L'onglet Returns décide lequel des deux flux de retour Canada Post la boutique utilise. Un Authorized Return émet une étiquette par colis. Un Open Return est un modèle permanent : cliquez sur « Create Template » et l'extension l'enregistre auprès de Canada Post, conserve l'identifiant du modèle, puis y puise des étiquettes jusqu'à épuisement du quota. Le même onglet contrôle si un client peut demander ou réimprimer une étiquette de retour depuis son espace, et quel modèle d'e-mail la transporte.

Étiquettes d'expédition

Une fois le transporteur configuré, chaque étiquette créée par la boutique apparaît sous Admin Main Menu -> Extmag -> Shipping Labels -> Canada Post, avec son numéro de suivi, son coût, son état de manifeste et les documents qui lui sont attachés. Les étiquettes se créent depuis la vue commande, en masse depuis la grille des commandes, ou automatiquement — ce que règlent les onglets Automatic, Mass Actions et Manual Actions.