Aller au contenu principal
Aller sur nevuto.com

Connecter MyParcel à Nevuto

Publié le 29 avril 20268 min de lectureMis à jour il y a 1 semaine

Qu'est-ce que MyParcel ?

MyParcel est un agrégateur d'expédition multi-transporteurs basé aux Pays-Bas. Via une seule API, tu peux expédier avec PostNL, DPD et bpost aussi bien à l'intérieur de NL/BE qu'à travers l'UE. Plutôt que de gérer un contrat séparé avec chaque transporteur, tu te connectes une fois à MyParcel et tu imprimes toutes les étiquettes depuis un seul endroit.

Comment Nevuto gère MyParcel

  • Dès que tu colles ta clé API et que tu cliques sur Submit, Nevuto crée automatiquement l'abonnement webhook dans MyParcel — aucune étape manuelle.
  • L'adresse d'expéditeur est récupérée depuis ton compte MyParcel (Nevuto ne peut pas la surcharger — l'API MyParcel ne l'autorise pas).
  • Tu imprimes les étiquettes MyParcel directement depuis la ligne de commande avec Print label ; le PDF s'ouvre dans un nouvel onglet.
  • Sur les comptes post-payment, l'étiquette est générée instantanément et facturée en fin de période. Sur les comptes pre-payment, le coût est prélevé sur ton wallet MyParcel.
  • Quand le transporteur scanne le colis, le webhook met à jour shipping_status et remplace automatiquement la référence temporaire par le vrai code-barres transporteur.

1. Prérequis

  • Un compte MyParcel actif. Si tu n'en as pas, ouvre-le sur myparcel.nl (immatriculation business NL requise).
  • Une adresse d'expéditeur enregistrée dans ton compte MyParcel. Account → Settings → Sender address. Cette adresse est utilisée pour toutes les expéditions (Nevuto ne peut pas surcharger l'expéditeur par commande — l'API MyParcel ne l'autorise pas).
  • L'adresse d'expéditeur doit être en NL ou BE. MyParcel n'expédie que depuis les Pays-Bas et la Belgique.
  • La devise de ta boutique doit être EUR. MyParcel n'accepte que l'EUR pour les valeurs douanières ; les boutiques dans une autre devise voient "Not available" dans la liste des providers.
  • Un wallet approvisionné (obligatoire sur les comptes pre-payment). Les comptes post-payment sont facturés a posteriori.

2. Clé API MyParcel

  1. Connecte-toi à ton compte MyParcel.
  2. Ouvre Account → Settings → API.
  3. Clique sur Generate API key pour créer un nouveau token.
  4. Copie le token — tu vas le coller dans Nevuto à l'étape suivante.

⚠️ Il suffit de coller le token tel quel — Nevuto gère pour toi le format d'authentification spécifique à MyParcel.

3. Connecter MyParcel dans Nevuto

  1. Depuis le panel admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Sélectionne MyParcel dans la liste.
  3. Colle le token copié depuis MyParcel dans le champ API key.
  4. Active le toggle Enable shipping method.
  5. Clique sur Submit.

Au clic sur Submit, Nevuto :

  • enregistre la clé API de manière sécurisée,
  • crée automatiquement l'abonnement webhook dans ton compte MyParcel — aucune étape manuelle,
  • commence à recevoir les mises à jour de statut des commandes.

4. Preferred carrier (transporteur préféré)

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

  1. Dans le dropdown Preferred carrier, choisis un ou plusieurs transporteurs (PostNL / DPD / bpost).
  2. Clique sur Submit.

Comportement :

  • Lors de la création d'une expédition, Nevuto utilise le premier transporteur de ta liste de préférence (MyParcel n'accepte qu'un seul transporteur par expédition).
  • Si tu en sélectionnes plusieurs, c'est celui en tête de liste qui est utilisé.
  • Si tu n'en sélectionnes aucun, PostNL est utilisé par défaut (transporteur local NL avec la couverture la plus large).

5. Adresse d'expéditeur

MyParcel n'autorise pas la surcharge de l'expéditeur par commande — configure ton adresse dans le panel MyParcel :

  1. Compte MyParcel → Account → Settings → Sender address.
  2. L'adresse doit être en NL ou BE (obligatoire).
  3. Téléphone, e-mail et nom de société doivent être complets (le transporteur ne rejette pas, mais certains cas limites posent problème).

Nevuto utilise cette adresse automatiquement sur chaque expédition.

6. Shipping packages (modèles de colis)

MyParcel demande les dimensions et le poids du colis à chaque expédition. Nevuto les récupère dans cet ordre :

  1. Variant LWH — si renseigné sur la variante produit (le plus précis).
  2. Référence ShippingPackage.
  3. Colis par défaut de la boutique.
  4. Dernier recours : les dimensions sont omises → MyParcel utilise sa propre estimation (qui sous-évalue généralement le tarif).

É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

On recommande de saisir les vraies dimensions sur chaque variante :

  1. Products → éditer le produit → onglet Variants.
  2. Remplis Length / Width / Height / Weight.
  3. Unité cm ou in, poids g ou kg.

8. Déclaration en douane (international)

Pour les expéditions NL/BE → hors UE, Nevuto attache automatiquement une déclaration en douane :

  • Items : lignes de commande (description du produit, quantité, poids, pays d'origine)
  • Item value : prix unitaire de la ligne
  • Currency : toujours envoyée en EUR

⚠️ MyParcel n'accepte que l'EUR sur les déclarations douanières. Même si la devise de ta boutique est USD/GBP, la valeur est envoyée en EUR (la valeur numérique est conservée, aucune conversion de change n'est appliquée). Fais attention aux seuils d'exonération comme €22 pour les articles de faible valeur.

Code HS : non stocké par produit dans Nevuto → envoyé vide. Tu peux l'ajouter manuellement dans le panel MyParcel.

9. Expédier une commande

Une fois la cliente ou le client payé, la commande apparaît dans ton panel 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, sélectionne MyParcel comme provider et clique sur Submit.
  4. En quelques secondes, une référence de tracking temporaire et le bouton "Print label" apparaissent sur la ligne de commande. L'expédition est d'abord créée en statut "concept" (brouillon) dans MyParcel.
  5. Clique sur Print label :
    • Compte post-payment : le PDF s'ouvre instantanément, la facturation est faite en fin de période.
    • Compte pre-payment : le wallet est débité, puis le PDF s'ouvre. Si le wallet est vide, tu vois "Label not available yet — wallet may need funding". Approvisionne le wallet et clique à nouveau.
  6. Imprime l'étiquette, colle-la sur le colis et remets-le au transporteur sélectionné.

💡 Une fois l'étiquette imprimée, la référence de tracking temporaire est remplacée automatiquement par le vrai code-barres transporteur. La cliente ou le client peut aussi suivre le colis depuis le lien de tracking.

10. Cycle de vie du statut

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← statut concept, shipment_id comme tracking temporaire
    │
    ▼   MyParcel génère l'étiquette (status ≥2)
[tracking_number = barcode]        ← le webhook livre le vrai code-barres transporteur, tracking number est mis à jour
    │
    ▼   Le transporteur scanne le colis (status ≥3)
[shipping_status: SHIPPED]         ← webhook
    │
    ▼   Livré au client (status ≥7)
[shipping_status: DELIVERED]       ← webhook

Mapping des statuts MyParcel (Nevuto) :

  • Brouillon / enregistré → Processing (pas de changement)
  • Remis au transporteur, tri, distribution, douane → Shipped
  • Livré, prêt à être retiré, retiré, étapes de retour → Delivered
  • Imprimé, annulé, etc. → ignoré

L'abonnement webhook est mis en place automatiquement par Nevuto — aucune intervention manuelle.

11. Téléchargement de l'étiquette

Au clic sur "Print label", Nevuto télécharge l'étiquette depuis MyParcel et l'ouvre dans un nouvel onglet :

  • Compte post-payment : le PDF s'ouvre instantanément.
  • Compte pre-payment (wallet vide) : tu vois la notification "Label not available yet — your shipping wallet may need funding".

Dans ce cas, approvisionne le wallet dans ton compte MyParcel et réessaie.

12. Mode test

MyParcel n'offre pas de véritable environnement sandbox/test. Stratégies possibles :

  • Rester au stade concept : l'expédition est créée mais aucune étiquette n'est imprimée → coût nul. Tu peux ensuite supprimer l'expédition depuis le panel.
  • Test réel à faible coût : une expédition PostNL Pakketten Buitenland ou un envoi domestique à €4-5.

13. Problèmes fréquents

A. "Label not available yet — wallet may need funding"

  • Ton compte est en pre-payment et le wallet est vide. Connecte-toi à MyParcel, approvisionne le wallet, puis clique à nouveau sur "Print label".

B. Le numéro de tracking a changé

  • Comportement attendu. Nevuto affiche d'abord un identifiant temporaire ; quand le transporteur imprime l'étiquette, le vrai code-barres de tracking est mis à jour automatiquement.

C. Le provider n'apparaît pas dans la liste

  • La devise de ta boutique n'est pas EUR → "Not available in your store currency. Supports: EUR".
  • Le pays de l'adresse de ta boutique n'est pas NL/BE → "Doesn't ship from your shop location".
  • Ajuste Settings → General → Currency ou Settings → Locations → Country sur une valeur supportée.

D. Le webhook n'arrive pas / les statuts ne se mettent pas à jour

  • Vérifie l'enregistrement dans Webhook subscriptions de ton compte MyParcel. Dans Nevuto, va dans les réglages MyParcel et clique à nouveau sur Submit — l'abonnement webhook est recréé.

14. Étapes suivantes

  • Surveille les commandes en production durant la première semaine.
  • Ajoute les codes HS dans le panel MyParcel pour les expéditions hors UE.
  • Ajoute une marge sur tes shipping rates pour ne pas absorber les surcharges transporteur.

Aide

Articles connexes