Shippo : calculer les frais de livraison et préparer les expéditions

Les frais de livraison dépendent notamment de la destination et du colis. Vous pouvez définir vos propres règles dans CrocoClick ou utiliser Shippo pour proposer des tarifs de transporteurs au paiement, selon les services disponibles et votre configuration.

Cet article décrit la connexion de Shippo, le calcul des frais au checkout et la préparation des étiquettes dans Shippo. Le tarif présenté au client peut différer du coût final facturé pour l’envoi, notamment si les caractéristiques réelles du colis changent ou si un supplément s’applique.

À quoi sert Shippo, concrètement

Shippo regroupe plusieurs transporteurs dans une plateforme d’expédition. L’intégration avec votre boutique CrocoClick relie le calcul de livraison et les données de commande ; la disponibilité dépend notamment du pays d’origine, de la destination, des services du compte et des caractéristiques du colis.

Tarifs calculés ou tarifs manuels : lequel choisir

CrocoClick propose aussi des règles de livraison manuelles par zone et selon des paliers, avec notamment des tarifs fixes ou la livraison offerte. Choisissez une méthode adaptée à vos produits et destinations ; le prix de livraison que vous facturez au client reste une décision commerciale distincte du coût du transporteur.

Le calcul par transporteur peut être utile lorsque :

• vos produits ont des poids et des volumes très différents
• vous expédiez vers plusieurs destinations avec des conditions de transport différentes
• vous voulez proposer plusieurs services ou vitesses de livraison, sous réserve de leur disponibilité

Des règles manuelles et des intégrations peuvent coexister selon les profils et zones de livraison. Contrôlez l’affectation des produits et le résultat d’un panier mixte ; ne supposez pas qu’une règle manuelle s’appliquera automatiquement à toute erreur de calcul.

Avant de commencer

Préparez les éléments suivants avant la connexion :

• un compte Shippo actif dont l’offre et les services conviennent à votre usage ; vérifiez ses conditions, les frais applicables et les conditions de l’intégration CrocoClick
• une boutique E-Commerce déjà créée sur votre site CrocoClick, avec au moins un produit physique
• des données de colis et de produits cohérentes, notamment le poids et les dimensions demandés par votre configuration

Étape 1 : générer votre token Shippo

Le token autorise CrocoClick à utiliser votre compte Shippo. Dans le portail API Shippo, ouvrez API Configuration > Developer keys, puis Live keys. Selon votre interface, l’ancien chemin indiqué par l’intégration est Settings > Advanced > API > Live Token.

1. Dans Live keys, choisissez Create new live key ; dans l’ancienne interface, utilisez la génération du Live Token.
2. Copiez la valeur dans un gestionnaire de secrets ; vous l’utiliserez dans le champ de connexion à l’étape 4. Ne la partagez pas dans un message ou une capture.

Étape 2 : configurer Shippo côté transporteurs et colis

Configurez d’abord Shippo : modèle de colis, adresse d’expédition et options de livraison. Une configuration incomplète peut empêcher l’activation ou le retour de tarifs.

Créer un modèle de colis

Shippo a besoin de savoir dans quoi vous expédiez. Allez dans Settings > Shipping > Packages, puis ajoutez un nouveau modèle.

• Soit vous saisissez vos dimensions personnalisées, ce qui correspond au cas le plus courant si vous utilisez vos propres cartons.
• Soit vous sélectionnez un emballage standard fourni par un transporteur, et vous renseignez alors le poids du colis.

Définissez le modèle par défaut si c’est le colis habituel de votre boutique. Vérifiez le poids, les dimensions et l’unité utilisés pour le calcul ; ajustez-les pour les envois qui diffèrent.

Renseigner votre adresse d'expédition

Dans Settings > Address book > Sender & return, ajoutez votre adresse complète. C'est le point de départ à partir duquel les distances et donc les tarifs sont calculés. Définissez-la comme adresse d'expéditeur et de retour par défaut.

Choisir vos transporteurs et vos options de livraison

C'est ici que vous décidez ce que le client verra au moment de payer. Rendez-vous dans Settings > Rates at Checkout (ou Settings > Shipping > Rates at Checkout selon l’interface) et ajoutez une option de livraison.

1. Sélectionnez le mode tarif en temps réel (live rate).
2. Choisissez les services disponibles que vous souhaitez proposer. Vérifiez leurs pays, formats de colis et conditions ; la présence d’un transporteur chez Shippo ne garantit pas l’affichage de tous ses services à chaque checkout.
3. Définissez si nécessaire une majoration, en pourcentage ou en montant fixe. Elle s’ajoute au tarif calculé, par exemple pour intégrer des frais de préparation. Contrôlez le montant total affiché au client.
4. Renseignez un tarif de repli (fallback) adapté : cette option sert lorsque les tarifs en direct ne sont pas récupérés. Vérifiez son application dans votre configuration avant de vous y fier.
5. Nommez l’option clairement : ce libellé apparaît sur la page de paiement. N’annoncez un délai que s’il correspond aux conditions du service concerné ; distinguez préparation et transport.

Étape 3 : déclarer votre origine d'expédition dans CrocoClick

CrocoClick a besoin de sa propre copie de l'adresse d'expédition, car c'est elle qui sera transmise comme adresse d'expéditeur lorsqu'une commande sera créée dans Shippo.

Dans votre compte, allez dans Paiements > Paramètres > Origine d'expédition, renseignez l'adresse complète et enregistrez.

Étape 4 : installer Shippo et coller votre token

1. Ouvrez la page Paramètres > Intégrations de votre compte, ou passez par la marketplace.
2. Recherchez Shippo et cliquez sur Installer.
3. Collez le token généré à l'étape 1, puis validez.

Si un message d’erreur apparaît, vérifiez d’abord le modèle de colis, l’adresse d’expéditeur et les options en tarif temps réel. Contrôlez également le token, les services disponibles et le détail de l’erreur ; ces trois réglages ne couvrent pas toutes les causes possibles.

Étape 5 : activer les tarifs calculés

Une fois le token accepté, une case permet d'activer les tarifs de livraison en temps réel. Cochez-la, puis enregistrez.

Pour désactiver les tarifs en temps réel, décochez la case puis enregistrez. Avant de compter sur des tarifs manuels, vérifiez vos profils, zones et règles de livraison ainsi que le résultat au paiement. La désactivation ne garantit pas à elle seule un tarif de remplacement valide pour chaque panier.

Ce que le client voit au moment de payer

Sur la page de paiement, l’adresse et les données du panier permettent de demander les tarifs. Les options éligibles sont présentées avec leur prix et l’éventuelle majoration configurée. Le montant de l’option choisie s’ajoute au total de la commande.

Une adresse de destination suffisamment complète est nécessaire au calcul. Une absence d’option peut aussi provenir du service, du colis, des zones, des profils ou de la connexion.

Générer une étiquette d'expédition

Retrouvez dans Shippo la commande synchronisée depuis CrocoClick. Vérifiez sa référence, les articles, les adresses et le service choisi avant de poursuivre ; ne créez pas un doublon si elle n’apparaît pas immédiatement.

1. Ouvrez la commande dans Shippo.
2. Vérifiez le colis proposé et ajustez le poids ou les dimensions si l'envoi réel diffère de votre modèle par défaut.
3. Contrôlez le prix final, puis achetez l’étiquette uniquement lorsque vous êtes prêt à engager la dépense. La facturation dépend de votre compte Shippo et du transporteur ; ne supposez pas qu’elle utilise nécessairement un solde prépayé.
4. Imprimez le bordereau et collez-le sur le colis.

Transmettre le numéro de suivi à votre client

Commencez par vérifier si le suivi et le statut ont déjà été synchronisés sur la commande CrocoClick. Des événements d’exécution peuvent remonter de Shippo ; ne ressaisissez pas systématiquement le suivi et n’envoyez pas une deuxième notification sans contrôler ce qui existe déjà.

1. Ouvrez la commande dans Paiements > Commandes et contrôlez le suivi déjà présent.
2. Si nécessaire et si les commandes proposées le permettent, complétez le transporteur et le numéro de suivi manquants.
3. Ne marquez une commande comme honorée qu’au stade d’exécution approprié ; la création d’une étiquette ne prouve pas la livraison.
4. Vérifiez les notifications de Shippo, de CrocoClick et de vos automatisations avant de choisir un envoi au client, afin d’éviter les doublons.

Automatiser l'email de suivi

Le déclencheur Commande honorée / Order Fulfilled peut réagir aux événements d’exécution, y compris ceux transmis par Shippo. Sélectionnez la bonne source et les filtres adaptés. Préparez vos notifications selon les données disponibles et évitez de cumuler des envois identiques.

Une confirmation d’expédition peut être utile lorsque l’expédition est effectivement confirmée. Une relance plusieurs jours après ne prouve pas que le colis est arrivé : vérifiez le suivi ou une confirmation de livraison avant d’en tirer cette conclusion ou de demander un avis sur la réception.

Les limites à connaître avant de vous lancer

• Disponibilité variable des services. Vérifiez les transporteurs proposés pour votre pays d’origine, votre compte et les caractéristiques de vos envois. Le catalogue mondial Shippo ne vaut pas confirmation de disponibilité dans CrocoClick.
• Données d’expédition. Poids, dimensions, unités, colis par défaut et adresses doivent correspondre à vos envois. Des données manquantes ou incohérentes peuvent empêcher ou fausser le calcul.
• Achat et suivi. Le parcours présenté utilise Shippo pour acheter l’étiquette. Contrôlez ensuite la remontée des données dans CrocoClick plutôt que de supposer une saisie manuelle toujours obligatoire.
• Dépendance à la disponibilité des API transporteurs. C'est exactement le rôle du tarif de repli configuré à l'étape 2. Ne le laissez pas vide.
• Prix présenté au client. La majoration et le tarif de repli modifient le montant demandé au checkout. Ils ne garantissent pas que ce montant couvrira les coûts finaux de chaque expédition.
• Formalités internationales. Vérifiez dans Shippo et auprès du transporteur les données et documents requis pour votre destination. La connexion technique ne valide pas les obligations douanières ou fiscales applicables.

Références : connexion et réglages de Shippo, transporteurs pris en charge par Shippo et moyens de paiement Shippo. Les libellés et services peuvent évoluer selon votre compte.

Questions fréquentes

Shippo est-il utilisable pour une boutique qui livre uniquement en France ?

Shippo mentionne notamment Colissimo et Chronopost dans son catalogue de transporteurs français. Vérifiez toutefois leur disponibilité effective et leurs services dans votre compte et dans le parcours CrocoClick. Comparez les conditions et coûts de vos envois réels ; ne supposez pas qu’un service de point relais est disponible.

Faut-il payer Shippo en plus de mon abonnement CrocoClick ?

Vérifiez l’offre Shippo, ses frais d’usage ou de service et le coût des étiquettes, ainsi que les conditions de l’application et de votre offre CrocoClick. Ce guide ne garantit ni gratuité ni inclusion de l’intégration et ne fixe aucun prix tiers.

Puis-je conserver mes frais de livraison manuels en parallèle ?

Des règles manuelles peuvent être configurées selon vos profils et zones. L’activation ou la désactivation des tarifs calculés ne prouve pas qu’un panier donné utilisera les règles souhaitées : contrôlez l’affectation des produits, les zones et les options effectivement proposées.

Pourquoi aucun tarif ne s'affiche sur ma page de paiement ?

Vérifiez l’adresse de destination, les données de colis, le modèle par défaut, l’origine d’expédition, le token, les services disponibles, les profils et les zones. Consultez le message d’erreur et le compte Shippo ; cette liste n’est pas exhaustive.

Le client reçoit-il automatiquement son numéro de suivi ?

Cela dépend de la remontée du suivi et des notifications configurées dans Shippo, CrocoClick ou vos workflows. Contrôlez la commande et les réglages avant de compléter les données manquantes ou de déclencher un nouvel envoi. Un événement d’exécution peut déjà avoir lancé une automatisation.

Puis-je facturer la livraison plus cher que le tarif transporteur ?

Le paramètre de majoration Shippo permet d’ajouter un montant fixe ou un pourcentage au tarif calculé. Vérifiez son effet sur le prix final affiché au client et les conditions applicables à votre boutique.