Aller au contenu principal
Aller sur nevuto.com

Connecter EasyPost à Nevuto

Publié le 22 mai 20268 min de lecture

Qu'est-ce qu'EasyPost ?

EasyPost est un agrégateur multi-transporteurs basé aux États-Unis. Une seule API te donne accès à USPS, UPS, FedEx, DHL Express, OnTrac et plus de 100 transporteurs pour des envois domestiques US et internationaux. L'usage est centré sur le domestique américain, mais l'international est aussi pris en charge.

Comment Nevuto gère EasyPost

  • Tu colles une seule clé API ; Nevuto met en place la connexion webhook automatiquement.
  • Les nouveaux comptes EasyPost passent par une revue manuelle anti-fraude — on te le rappelle dès le départ.
  • À chaque expédition, Nevuto récupère les tarifs en direct et achète le plus économique, filtré par tes transporteurs préférés.
  • Tous les webhooks arrivent signés et Nevuto en vérifie la signature pour toi.
  • Test Key et Production Key sont supportées toutes les deux ; tu bascules en Test mode avec un seul toggle.

1. Prérequis

  • Un compte EasyPost actif. Si tu n'en as pas encore, inscris-toi sur easypost.com.
    • ⚠️ EasyPost effectue une revue manuelle anti-fraude sur les nouveaux comptes. Dans les 1 à 3 jours ouvrés après l'inscription, tu recevras un mail demandant une vérification d'identité et des détails business. Tant que ton compte n'est pas activé, l'onglet API key peut rester invisible.
  • Au moins un carrier account doit être connecté côté EasyPost. Le free tier inclut un compte de test USPS par défaut ; en production tu peux brancher tes propres contrats USPS/UPS/FedEx.
  • La devise de ta boutique doit être USD — EasyPost ne gère que l'USD.
  • L'adresse d'expéditeur doit idéalement être aux États-Unis ; les autres pays restent limités.
  • Tu dois alimenter ton EasyPost Wallet (le coût du label est débité par envoi). Settings → Billing.

2. EasyPost API key

  1. Connecte-toi au dashboard EasyPost.
  2. Account Settings → API Keys (https://app.easypost.com/account/settings?tab=api-keys).
  3. Copie ta Test Key ou ta Production Key.
  4. Si ton compte n'est pas encore actif, l'onglet "API Keys" peut apparaître vide. Cela signifie que la revue anti-fraude est en cours ; réponds au mail d'inscription ou contacte le support.

⚠️ Une test key génère des labels de test (sans facturation). Une production key imprime de vrais labels carrier et débite ton wallet.

3. Connexion dans Nevuto

  1. Dans le panneau admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Choisis EasyPost dans la liste.
  3. Colle ton token EasyPost dans le champ API key.
  4. Active le toggle Enable shipping method.
  5. (Optionnel) Toggle Test mode : active-le si tu utilises une Test Key.
  6. Clique sur Submit.

Au moment du Submit, Nevuto :

  • Enregistre la clé API en sécurité
  • Établit la connexion webhook automatiquement sur ton compte EasyPost — aucune étape manuelle
  • Reçoit chaque webhook signé ; Nevuto vérifie l'authenticité pour toi

4. Preferred carrier accounts

Une fois enregistré, une carte Settings s'ouvre en dessous :

  1. Sélectionne un ou plusieurs carrier account IDs depuis le dropdown Preferred carriers.
  2. Le dropdown est chargé en direct depuis ton compte EasyPost — seuls les carriers actifs sur ton compte apparaissent.
  3. Submit.

Comportement :

  • Pour chaque envoi, Nevuto récupère la liste de tarifs EasyPost, la filtre par tes carriers préférés et achète le tarif le moins cher.
  • Sans préférence, Nevuto choisit le moins cher parmi tous les carriers actifs.

💡 Dans le dropdown, les carriers apparaissent avec leur nom lisible (USPS, UPS, FedEx, etc.).

5. Adresse d'expéditeur

EasyPost utilise ton adresse d'expéditeur sur chaque envoi. Nevuto la récupère depuis la default store location :

  1. Settings → Locations.
  2. Remplis la default location en tant qu'adresse US :
    • Street, City, State (code court : CA, NY), ZIP, Country (US), Phone

⚠️ On recommande de saisir le numéro de téléphone au format international : +12125551234. Le format local est accepté aussi mais l'international reste le plus fiable.

6. Shipping packages

EasyPost demande les dimensions du colis à chaque envoi. Nevuto les résout dans cet ordre :

  1. Variant LWH
  2. Référence ShippingPackage
  3. Paquet par défaut du shop
  4. Fallback : 12×9×1 inch (USPS Flat Rate Envelope)

Étapes :

  1. Va dans Settings → Shipping → Packages.
  2. Add package → Nom, Type, L/W/H/unité, poids.
  3. Set as default.

7. Variant LWH

Saisis les vraies dimensions et le poids sur chaque variante :

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

💡 Aux États-Unis, les unités standards sont in (inch) et oz (ounce). EasyPost accepte les deux ; Nevuto convertit automatiquement.

8. Déclaration en douane (international)

Pour les envois des États-Unis vers d'autres pays, Nevuto ajoute la déclaration douanière automatiquement :

  • Items : lignes de commande (description du produit, quantité, poids, valeur, pays d'origine)
  • Exigences douanières US : les indicateurs d'exemption requis sont ajoutés automatiquement
  • Currency : USD
  • Contents type : merchandise
  • Non-delivery option : return (retour si non livrable)

Code HS : Nevuto ne le stocke pas par produit → il est envoyé vide. Tu peux le saisir manuellement dans le panneau EasyPost.

9. Expédier une commande

Une fois le paiement effectué, la commande apparaît dans le panneau 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 modal, choisis EasyPost comme provider et clique sur Submit.
  4. En quelques secondes, la ligne de commande affiche un numéro de tracking, un lien de tracking et un bouton "Print label". En même temps, ton EasyPost Wallet est débité du coût du label.
  5. Clique sur Print label pour ouvrir l'étiquette en PDF, imprime-la et colle-la sur le colis.
  6. Remets le colis à ton carrier préféré — la suite est trackée automatiquement.

💡 Le client peut suivre l'envoi depuis sa propre page de commande via le lien de tracking et reçoit des notifications email à chaque changement de statut.

10. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Label imprimé, le carrier n'a pas encore récupéré
    │
    ▼   Quand le carrier scanne le colis
[shipping_status: SHIPPED]         ← Webhook EasyPost déclenché (tracker.updated)
    │
    ▼   Livré au client
[shipping_status: DELIVERED]       ← Webhook

Correspondance des statuts EasyPost (Nevuto) :

  • En route, en transit, en cours de livraison → Shipped
  • Livré, prêt pour pickup → Delivered
  • Retour, échec, annulation → ignoré

La connexion webhook est mise en place automatiquement à l'installation et chaque notification est vérifiée via signature — aucune intervention manuelle nécessaire.

11. Test mode

EasyPost dispose d'un véritable environnement de test :

  1. Dashboard EasyPost → API Keys → copie ta Test Key.
  2. Dans Nevuto admin → Settings → Shipping → EasyPost → colle la test key dans le champ API key et active le toggle Test mode.
  3. Submit.
  4. Les envois de test :
    • Renvoient un numéro de tracking (format EZ100…)
    • Génèrent un PDF de label (estampillé test)
    • Ne débitent pas ton wallet
    • Envoient des notifications de test
  5. Avant de passer en production, désactive Test mode et bascule sur ta Live key.

12. Problèmes fréquents

A. Mail "We need a bit more information about your account"

  • EasyPost applique une revue manuelle aux nouveaux comptes. Réponds aux questions du mail et complète le lien de vérification Stripe ID ; ton compte est activé en 1 à 3 jours ouvrés.

B. L'onglet API key n'apparaît pas

  • Le compte n'est pas encore activé (voir A ci-dessus). Ou tu as choisi le type de compte "Personal" alors que les détails business sont demandés.

C. Pas de solde dans le wallet, impossible d'imprimer un label

  • Dashboard EasyPost → Account → Billing → Add funds pour recharger le wallet. En Test mode, rien n'est débité.

D. Erreur "Customs declaration is required for international"

  • Les envois internationaux nécessitent des informations douanières. Vérifie que le champ country de l'adresse client est correctement renseigné.

E. Nom de state refusé

  • EasyPost attend un code state court : CA, NY. Le nom complet (California) est refusé. Saisis le state en code court dans Settings → Locations.

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

  • Si la devise de ta boutique n'est pas USD, tu verras l'avertissement "Not available in your store currency".
  • Si le pays de ton adresse de boutique n'est pas US, tu verras l'avertissement "Doesn't ship from your shop location".

G. Pas de webhook reçu / erreur "Unauthorized"

  • Si tu as changé la clé API, clique de nouveau sur Submit dans l'admin Nevuto — la connexion webhook est rétablie et la clé de signature rafraîchie.

13. Prochaines étapes

  • Dès la validation anti-fraude EasyPost reçue, connecte la clé API et lance une petite expédition de test
  • Saisis les codes HS une fois par produit dans le panneau EasyPost — critique pour les commandes internationales
  • Ajoute une marge à tes tarifs d'expédition

Aide

Articles connexes