Aller au contenu principal
Aller sur nevuto.com

Connecter Sendcloud à Nevuto

Publié le 22 mai 20268 min de lecture

Qu'est-ce que Sendcloud ?

Sendcloud est l'agrégateur multi-transporteurs européen — via une seule API, tu peux expédier avec DHL, DPD, PostNL, UPS, GLS, Bpost et bien d'autres transporteurs, à l'intérieur de l'UE comme à l'international. Sendcloud couvre l'UE, le Royaume-Uni, l'Irlande et la Scandinavie et prend en charge le multi-devise : c'est l'un des moyens les plus rapides d'ajouter une logistique fiable si tu vends à travers l'Europe.

Comment Nevuto gère Sendcloud

  • Sendcloud utilise l'authentification HTTP Basic, Nevuto s'authentifie donc avec un couple de clés : Public Key + Secret Key.
  • Au moment de la sauvegarde, Nevuto enregistre automatiquement le webhook dans ton compte Sendcloud — aucune étape manuelle.
  • Lors de l'expédition, Nevuto choisit en direct l'offre la moins chère parmi tes transporteurs préférés.
  • Les étiquettes sont retournées en PDF et s'impriment en un clic depuis l'écran de commande ; le coût est débité de ton wallet Sendcloud.
  • Pour les expéditions hors UE, la déclaration de douane est ajoutée automatiquement (item value + origin country + currency).

1. Prérequis

  • Un compte Sendcloud actif. Si tu n'en as pas encore, inscris-toi sur sendcloud.com.
  • Au moins une adresse d'expéditeur (sender) définie dans le panneau Sendcloud. Settings → Shipping → Addresses.
  • Au moins un contrat transporteur — un contrat broker Sendcloud ou ton contrat direct. Active-le sous Settings → Carriers ; les contrats broker démarrent immédiatement, et tu peux aussi brancher ton propre compte DHL/UPS si tu en as un.
  • La devise de ta boutique doit être EUR/GBP/USD/DKK/NOK/SEK/CHF/PLN/CZK — dans d'autres devises, Sendcloud n'apparaît pas dans la liste des providers.
  • Le pays de l'expéditeur doit être UE + UK + Irlande + Scandinavie (NL/BE/DE/FR/GB/AT/ES/IT/PT/CH/DK/SE/NO/PL/CZ/IE/FI).
  • Un wallet approvisionné. Sendcloud débite automatiquement chaque étiquette ; un compte à zéro échoue au moment de l'annonce.

2. Public + Secret key Sendcloud

Sendcloud utilise HTTP Basic auth et demande deux clés : une Public Key et une Secret Key.

  1. Connecte-toi au panneau Sendcloud.
  2. Va dans Settings → Integrations → + Add integration → choisis "Sendcloud API".
  3. Donne un nom à l'intégration (par ex. "Nevuto").
  4. Clique sur Submit → Sendcloud génère automatiquement une Public Key et une Secret Key.
  5. Copie les deux — tu vas les coller dans Nevuto à l'étape suivante.

⚠️ La Secret Key n'est affichée qu'une seule fois. Si tu la rates, il faudra supprimer l'intégration et en recréer une.

3. Connecter Sendcloud dans Nevuto

  1. Dans ton panneau admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Sélectionne Sendcloud dans la liste.
  3. Colle la public key Sendcloud dans le champ Public key.
  4. Colle la secret key dans le champ Secret key.
  5. Active le toggle Enable shipping method.
  6. Clique sur Submit.

Au moment du Submit, Nevuto :

  • Enregistre tes clés Public et Secret de manière sécurisée
  • Enregistre automatiquement le webhook sur ton compte Sendcloud — aucune étape manuelle
  • Commence à recevoir les mises à jour de statut des commandes

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

Après la sauvegarde, une carte Settings s'ouvre en dessous. C'est là que se trouvent les options propres à Sendcloud :

  1. Dans le dropdown Preferred carriers, ajoute les codes courts des transporteurs actifs sur ton compte Sendcloud (par ex. dhl_de, dpd, postnl, ups, gls).
  2. Submit.

Comportement :

  • Lors de l'expédition, Nevuto choisit l'offre la moins chère parmi tes transporteurs préférés.
  • Si tu n'en choisis aucun, le moins cher parmi tous les transporteurs actifs sur ton compte est utilisé.
  • Si ton transporteur préféré ne dessert pas la route, c'est l'option suivante la moins chère qui est utilisée (ta commande n'est pas bloquée).

💡 La liste se met à jour automatiquement — dès que tu signes un nouveau contrat transporteur sur ton compte Sendcloud, il apparaît dans le dropdown.

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

L'adresse d'expéditeur est définie dans le panneau Sendcloud ; Nevuto la résout automatiquement :

  1. Panneau Sendcloud → Settings → Shipping → Addresses → ajoute au moins un sender.
  2. Si tu en as plusieurs, Nevuto prend le premier comme adresse par défaut.

Si tu veux utiliser un autre sender, change l'adresse par défaut dans le panneau Sendcloud ; Nevuto prendra la nouvelle adresse au prochain envoi.

6. Shipping packages (gabarits de colis)

Sendcloud demande les dimensions du colis à chaque envoi : length × width × height + poids. Nevuto peut récupérer ces données depuis trois endroits, dans cet ordre de priorité :

  1. Variant LWH — saisies directement sur la variante produit.
  2. Référence ShippingPackage — si la variante est liée à un gabarit de colis, ce sont ses dimensions qui sont utilisées.
  3. Colis par défaut de la boutique — le colis marqué "Default" sous Settings → Shipping → Packages.
  4. Fallback : Sendcloud applique son propre algorithme d'estimation (qui sous-évalue généralement).

Étapes :

  1. Va dans Settings → Shipping → Packages.
  2. Add package → nom, type (Box/Envelope/Soft pack), L/W/H/unité, poids.
  3. Set as default → désigne un colis comme fallback pour toute la boutique.

7. Variant LWH (dimensions de la variante)

Pour le prix le plus juste, on recommande de saisir les vraies dimensions sur chaque variante :

  1. Products → édite le produit → onglet Variants.
  2. Remplis Length / Width / Height / Weight sur chaque ligne.
  3. Choisis cm ou in comme unité.

8. Customs declaration (expédition internationale)

Pour les envois hors UE, Sendcloud ajoute automatiquement la déclaration de douane :

  • HS code : non stocké par produit dans Nevuto → envoyé vide. Tu peux le compléter manuellement dans le panneau Sendcloud.
  • Item value : récupéré depuis le prix de l'order line item.
  • Origin country : le pays du sender.
  • Currency : le code devise de la commande (Sendcloud gère le multi-devise).
  • Contents type : commercial_goods (1).

💡 Si tu expédies régulièrement hors UE, on te recommande de renseigner les HS codes — ça minimise les blocages en douane.

9. Expédier une commande

Une fois que le client a payé, la commande apparaît dans ton admin avec un 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 Sendcloud comme provider et fais Submit.
  4. En quelques secondes, le numéro de tracking, le lien de tracking et un bouton "Print label" apparaissent sur la commande. Au même moment, le coût de l'étiquette est débité de ton wallet Sendcloud.
  5. Clique sur Print label pour ouvrir le PDF, imprime-le et colle-le sur le colis.
  6. Remets le colis au transporteur choisi — le reste est suivi automatiquement.

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

10. Status lifecycle (cycle de vie du statut)

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Étiquette imprimée, colis pas encore remis
    │
    ▼   Quand le transporteur scanne le colis
[shipping_status: SHIPPED]         ← Le webhook v3 event-subscriptions est déclenché
    │
    ▼   Livré au client
[shipping_status: DELIVERED]       ← Webhook

Comment ça marche :

  1. À la sauvegarde des réglages Sendcloud, Nevuto installe automatiquement un webhook sur ton compte Sendcloud.
  2. Quand le transporteur scanne le colis, Sendcloud envoie une notification à Nevuto.
  3. Nevuto retrouve la commande par le numéro de tracking et met à jour son statut automatiquement.

Aucune intervention manuelle nécessaire — le webhook est branché dès le setup.

11. Mode test

Sendcloud n'a pas de vrai environnement de test — chaque expédition produit une étiquette réelle et débite le wallet.

Approche de test pratique :

  1. Fais une expédition à faible montant avec ton compte de production (par ex. l'option mailbox la moins chère, autour de 1-2 €)
  2. Vérifie que le numéro de tracking arrive, que le bouton "Print label" ouvre bien le PDF et que les mises à jour de statut arrivent automatiquement
  3. Bascule ensuite sur le flux normal

12. Problèmes courants

A. Erreur "User not allowed to announce"

  • Aucune méthode de paiement n'est configurée sur ton compte, ou ton wallet est à zéro. Panneau Sendcloud → Settings → Financial → recharge ton wallet.

B. Webhook qui n'arrive pas / statut qui ne se met pas à jour

  • Panneau Sendcloud → Settings → Integrations → vérifie l'onglet "Event subscriptions" de ton intégration. Il doit y avoir au moins une subscription "Parcels event".
  • Dans l'admin Nevuto, refais Submit — le webhook est ré-enregistré.

C. Avertissement douane sur une commande internationale

  • Les HS codes ne sont pas stockés par produit dans Nevuto → ils sont envoyés vides. Tu peux les renseigner manuellement dans le panneau Sendcloud et réimprimer l'étiquette.

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

  • Si la devise de ta boutique sort de EUR/GBP/USD/… ou si le pays du sender sort de l'UE/UK/Scandinavie, Sendcloud apparaît en "Not available". Ajuste Settings → General → Currency ou Settings → Locations → Country sur une valeur supportée.

13. Étapes suivantes

  • Surveille les commandes de production la première semaine — croise le dashboard Sendcloud avec Nevuto pour vérifier la cohérence.
  • Ajoute une marge à tes shipping rates — le prix retourné par Sendcloud est le coût ; ajuste Settings → Shipping → Rates selon ce que tu veux facturer au client.
  • Pendant les périodes de pointe / fêtes, garde le dashboard Sendcloud ouvert — pratique pour suivre le failover multi-transporteurs.

Besoin d'aide ?

Articles connexes