Aller au contenu principal
Aller sur nevuto.com

Connecter Shippo à Nevuto

Publié le 22 mai 20268 min de lecture

Qu'est-ce que Shippo ?

Shippo est un agrégateur d'expédition multi-transporteurs centré sur l'Amérique du Nord. Via une seule API, tu peux expédier avec USPS, UPS, FedEx, DHL Express, Canada Post et bien d'autres transporteurs — aussi bien aux États-Unis et au Canada qu'à l'international. Pour les boutiques Nevuto qui vendent aux États-Unis ou au Canada, c'est l'un des moyens les plus simples d'ajouter une expédition fiable sans négocier individuellement avec chaque transporteur.

Comment Nevuto gère Shippo

  • Nevuto se connecte à Shippo via son API officielle et configure le webhook automatiquement — aucune étape manuelle.
  • Au moment de traiter une commande, Shippo récupère les tarifs en direct de tous les transporteurs et sélectionne le moins cher.
  • Pour chaque commande Nevuto, un PDF d'étiquette prêt à imprimer est généré en un clic.
  • Les numéros de suivi et les changements de statut se synchronisent automatiquement via les webhooks Shippo.
  • Tu peux passer en production avec un token live ou tester l'ensemble du flux en toute sécurité avec les Test tokens.

1. Prérequis

  • Un compte Shippo actif. Si tu n'en as pas, inscris-toi sur goshippo.com.
  • Au moins un compte transporteur connecté dans Shippo (USPS est activé par défaut ; pour UPS/FedEx tu dois connecter ton propre compte).
  • La devise de ta boutique doit être USD ou CAD — dans toute autre devise, Shippo apparaît comme "Not available" dans la liste des providers.
  • Le pays de ton adresse d'expéditeur doit être US ou CA (cas le plus courant) ; la couverture est limitée ailleurs.
  • Financement du compte : recharge ton wallet Shippo ou enregistre une carte. Chaque étiquette est débitée en temps réel.

2. Token API Shippo

  1. Connecte-toi au dashboard Shippo.
  2. En haut à droite → Settings → API.
  3. Crée un token dans l'onglet Live tokens (ou Test tokens pour les tests).
  4. Copie le token — tu vas le coller dans Nevuto à l'étape suivante.

⚠️ Un token live génère de vraies étiquettes et débite ton compte. Pour tester, utilise le Test mode (voir plus bas).

3. Connecter Shippo dans Nevuto

  1. Dans l'admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Choisis Shippo dans la liste.
  3. Colle ton token Shippo dans le champ API key.
  4. Active le toggle Enable shipping method.
  5. (Optionnel) Test mode : active-le si tu utilises un token de test. Laisse-le désactivé avec un token live.
  6. Clique sur Submit.

Au submit, Nevuto :

  • Enregistre la clé API en toute sécurité
  • Configure le webhook automatiquement sur ton compte Shippo — pas d'étape manuelle
  • Supprime un webhook existant et en enregistre un nouveau (un nouveau Submit le rafraîchit de la même façon)

4. Preferred carriers (transporteurs préférés)

Après l'enregistrement, une carte Settings s'ouvre en dessous :

  1. Choisis un ou plusieurs IDs de comptes transporteurs dans le dropdown Preferred carriers.
  2. Le dropdown est chargé en direct depuis ton compte Shippo — tu ne vois que les transporteurs actifs chez toi.
  3. Submit.

Comportement :

  • Lors de l'expédition, Shippo demande un devis à tous les transporteurs → filtre selon tes préférés → choisit le moins cher.
  • Si tu n'en choisis aucun, Shippo utilise sa recommandation "best value".
  • Si ton transporteur préféré ne dessert pas la route, l'option la moins chère parmi toutes est utilisée (ta commande n'est pas bloquée).

💡 Le dropdown affiche tes transporteurs avec leurs noms lisibles (USPS, UPS, DHL Express, etc.).

5. Sender address (adresse d'expéditeur)

Shippo utilise ton adresse d'expéditeur sur chaque envoi. Nevuto la récupère depuis le lieu par défaut de ta boutique :

  1. Va dans Settings → Locations.
  2. Renseigne ta default location avec une adresse US/CA :
    • Street, City, State (code court : CA, NY, etc.), ZIP, Country (US/CA), Phone

⚠️ Utilise le code court pour State (ex. CA, NY, TX) — Shippo n'accepte pas le nom complet de l'État.

6. Shipping packages (modèles de colis)

Shippo demande les dimensions et le poids du colis à chaque expédition. Nevuto les résout dans cet ordre :

  1. Valeurs LWH du variant
  2. Référence ShippingPackage
  3. Colis par défaut de la boutique
  4. Fallback : valeur par défaut de Shippo (souvent inadaptée)

Étapes :

  1. Va dans Settings → Shipping → Packages.
  2. Add package → Nom, Type, L/l/H/unité, poids.
  3. Set as default → fallback à l'échelle de la boutique.

7. Variant LWH

Renseigne les vraies dimensions et le poids sur chaque variant :

  1. Products → modifier le produit → Variants.
  2. Remplis Length / Width / Height / Weight.
  3. Unité : cm/in, poids : g/kg/oz/lb.

8. Customs declaration (international)

Pour un envoi depuis US/CA vers un autre pays, Nevuto ajoute automatiquement la déclaration douanière :

  • Items : lignes de commande (description produit, quantité, poids, valeur, pays d'origine)
  • Exigences douanières US : les indicateurs d'exemption nécessaires sont ajoutés automatiquement
  • Currency : devise de la boutique (USD/CAD)
  • Contents type : MERCHANDISE

Code HS : non stocké par produit dans Nevuto → envoyé vide. Tu peux le renseigner manuellement dans le dashboard Shippo si besoin.

9. Expédier une commande

Après le paiement, la commande apparaît dans ton admin avec le bouton "Mark as shipped".

  1. Ouvre la page de détail de la commande.
  2. Clique sur Mark as shipped.
  3. Dans la modale, choisis Shippo comme provider et submit.
  4. En quelques secondes, la ligne de commande affiche le numéro de suivi, le lien de tracking et le bouton "Print label". Au même moment, Shippo débite ton compte du coût de l'étiquette.
  5. Clique sur Print label pour ouvrir l'étiquette en PDF, l'imprimer et la coller sur le colis.
  6. Remets le colis au transporteur choisi — la suite du suivi est automatique.

💡 Le client peut suivre le colis depuis le lien de tracking dans sa page de commande et reçoit des e-mails à chaque changement de statut.

10. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Étiquette imprimée, le transporteur n'a pas encore collecté
    │
    ▼   Le transporteur scanne le colis
[shipping_status: SHIPPED]         ← Le webhook Shippo se déclenche
    │
    ▼   Livré au client
[shipping_status: DELIVERED]       ← Webhook

Le webhook est branché automatiquement à l'installation — les mises à jour de tracking Shippo reviennent à Nevuto et le statut de commande est mis à jour automatiquement.

11. Test mode

Shippo propose un vrai environnement de test :

  1. Dashboard Shippo → API → onglet Test tokens → récupère un token.
  2. Dans Nevuto, Settings → Shipping → Shippo → active Test mode et remplace l'API key par le token de test.
  3. Submit.
  4. Les envois de test :
    • Retournent un numéro de suivi
    • Génèrent un PDF d'étiquette (page de test brandée Shippo)
    • Aucun débit réel sur ton compte
    • Des webhooks de test sont envoyés
  5. Avant de passer en production, désactive Test mode et remplace l'API key par le token live.

12. Problèmes fréquents

A. Étiquette créée mais le tracking ne se met pas à jour

  • Il peut y avoir un souci de sélection de tarif Shippo. Causes fréquentes :
    • Problèmes de validation d'adresse expéditeur/destinataire (mauvais code court d'État, etc.)
    • Code HS manquant sur un envoi international
    • Ton compte transporteur est en pause
  • Dans le dashboard Shippo, va à Shipments → l'envoi concerné → consulte le message d'erreur.

B. "Customs declaration is required for international shipments via the USPS"

  • L'info douanière n'est pas attachée à l'envoi international. Vérifie que les codes pays sur l'adresse de ta boutique et l'adresse client sont corrects.

C. Le nom d'État est refusé

  • Shippo veut le code court : CA (pour California), NY, etc. Le nom complet (California) est refusé. Dans Settings → Locations, saisis l'État sous forme de code court.

D. N'apparaît pas dans la liste des providers

  • Si la devise de ta boutique n'est pas USD/CAD, tu vois "Not available in your store currency". Vérifie Settings → General → Currency.
  • Si le pays de l'adresse de ta boutique n'est pas US/CA, tu vois "Doesn't ship from your shop location".

E. Le webhook n'arrive pas

  • Dans l'admin Nevuto, retourne dans les paramètres Shippo et clique à nouveau sur Submit — le webhook est ré-enregistré.

13. Étapes suivantes

  • La première semaine, réconcilie le dashboard Shippo avec Nevuto pour vérifier la cohérence.
  • Ajoute une marge à tes tarifs d'expédition — le tarif le moins cher de Shippo est ton coût ; facture au client ce qui te convient.
  • Si tu utilises des services internationaux comme USPS Priority Mail Express International, n'oublie pas de remplir les codes HS.

Aide

Articles connexes