Aller au contenu principal
Aller sur nevuto.com

Connecter The Courier Guy à Nevuto

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

Qu'est-ce que The Courier Guy ?

The Courier Guy est l'un des plus grands transporteurs sud-africains. Il s'appuie sur la plateforme ShipLogic — c'est cette API que Nevuto utilise en coulisses. Tu peux expédier en Afrique du Sud avec les niveaux de service ECO/OVN/STD/SDX.

Comment Nevuto gère The Courier Guy

  • Nevuto se connecte à TCG via l'API ShipLogic avec un seul token qui représente ton compte sandbox ou production.
  • Les deux environnements sandbox (test) et production (live) sont supportés ; le bouton Test mode dans Nevuto choisit lequel utiliser.
  • Les webhooks se configurent manuellement dans le portail TCG/ShipLogic — TCG n'autorise pas l'enregistrement des webhooks via l'API.
  • La devise de ta boutique doit être ZAR, sinon TCG apparaît comme "Not available" dans la liste des transporteurs.
  • L'adresse expéditeur doit se trouver en ZA — TCG n'expédie qu'au départ de l'Afrique du Sud.

1. Prérequis

  • Un compte The Courier Guy actif (live) ou un compte Sandbox Couriers (test) :
  • La devise de ta boutique doit être ZAR — dans toute autre devise, TCG s'affiche comme "Not available" dans la liste.
  • Le pays de ton adresse expéditeur doit être ZA — TCG n'expédie qu'au départ de l'Afrique du Sud.
  • Solde de compte ou facilités de crédit — en production, chaque étiquette est facturée.

2. Clé API The Courier Guy / Sandbox

Pour les tests (sandbox) :

  1. Va sur sandbox.shiplogic.com/register → inscris-toi gratuitement.
  2. Vérifie ton e-mail → connecte-toi.
  3. Settings → API Keys → crée une clé.
  4. Copie le token.

Pour l'usage live :

  1. Connecte-toi au portail TCG (portal.thecourierguy.co.za).
  2. Settings → API Keys → crée une clé.
  3. Copie le token.

⚠️ Les comptes test et live sont des systèmes séparés. Utilise le bouton "Test mode" ci-dessous pour passer de l'un à l'autre.

3. Connecter The Courier Guy dans Nevuto

  1. Depuis l'admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Choisis The Courier Guy dans la liste.
  3. Colle ton token dans le champ API key.
  4. Active l'interrupteur Enable shipping method.
  5. Interrupteur Test mode : si tu utilises une clé sandbox, active-le ; avec une clé live, laisse-le désactivé. Il détermine avec quel environnement TCG Nevuto communique.
  6. Clique sur Submit.

Au moment du Submit, Nevuto :

  • enregistre ta clé API de manière sécurisée,
  • attend que tu configures les webhooks TCG manuellement (voir ci-dessous) — TCG n'accepte pas l'enregistrement des webhooks via l'API, tu dois les ajouter dans le portail.

4. Configurer le webhook manuellement (obligatoire)

TCG n'autorise la configuration des webhooks que dans son portail, pas via l'API. Ne saute pas cette étape, sinon les mises à jour de statut n'arriveront jamais à Nevuto :

  1. Connecte-toi au portail TCG / Sandbox.
  2. Va dans Settings → Webhook subscriptions.
  3. Add webhook subscription → choisis le topic :
    • Tracking event — changements de statut de commande (obligatoire)
    • Les autres topics sont optionnels (Shipment note, Parcel dimension changes, etc.)
  4. Colle cette URL : 
    https://core-api.nevuto.com/v1/admin/shipping/status/webhook/{shopID}/thecourierguy
    Remplace {shopID} par l'identifiant à 32 caractères trouvé dans Nevuto admin → Settings → General → Shop ID.
  5. Save.

💡 Ne partage pas cette URL avec des personnes non autorisées — elles pourraient modifier le statut de tes commandes.

5. Service level

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

  1. Dans le menu déroulant Service level, choisis un ou plusieurs codes de service TCG :
    • ECO — Economy (le moins cher, par défaut, 3-5 jours ouvrés)
    • OVN — Overnight Express (1 jour ouvré)
    • STD — Standard (2-3 jours ouvrés)
    • SDX — Same Day Express (même jour dans les grandes villes)
  2. Submit.

Comportement :

  • À la création de l'expédition, Nevuto utilise le premier service level que tu as sélectionné (TCG n'accepte qu'un seul service level par envoi).
  • Si tu ne choisis rien, c'est ECO qui est utilisé par défaut.

💡 Si TCG ajoute un nouveau service level, il apparaîtra dans le menu déroulant après la prochaine mise à jour de Nevuto.

6. Adresse expéditeur

TCG utilise ton adresse expéditeur pour chaque envoi. Nevuto la récupère depuis l'emplacement par défaut de ta boutique :

  1. Settings → Locations.
  2. Remplis l'emplacement par défaut avec une adresse ZA :
    • Street, City, Province (par ex. Gauteng ou code court GP), ZIP (code postal), Country (ZA), Phone

💡 Champ Province : TCG accepte aussi bien le nom complet (Gauteng) que le code court (GP).

7. Colis d'expédition

TCG attend les dimensions en cm et le poids en kg. Nevuto lit ces infos 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 : 20×20×20 cm + 0,5 kg en fallback

Étapes :

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

8. Variant LWH

Saisis les vraies dimensions + le poids sur chaque variante (la tarification TCG est sensible au poids volumétrique) :

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

9. Customs declaration (international)

TCG ne livre actuellement qu'en ZA. Ne te sers pas de cette intégration pour de l'international — choisis un autre fournisseur comme Shippo ou EasyPost.

10. Expédier une commande

Une fois le paiement client validé, la commande apparaît dans l'admin avec le bouton "Mark as shipped".

  1. Ouvre la page détail de la commande.
  2. Clique sur Mark as shipped.
  3. Dans la fenêtre qui s'ouvre, choisis The Courier Guy comme transporteur et clique sur Submit.
  4. En quelques secondes, la ligne de commande affiche un numéro de suivi TCG (par ex. S7GL...), un lien de suivi et le bouton "Print label".
  5. Clique sur Print label pour ouvrir le PDF du waybill, imprime-le et colle-le sur le colis.
  6. Remets le colis à un coursier TCG ou dépose-le dans un point relais TCG le plus proche.

💡 Le client peut suivre l'envoi depuis sa page commande grâce au lien de tracking ; il reçoit aussi des e-mails à chaque changement de statut.

11. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Étiquette imprimée, le transporteur n'a pas encore récupéré
    │
    ▼   "collected" → le transporteur a récupéré le colis
[shipping_status: SHIPPED]         ← Webhook
    │
    ▼   "in-transit", "at-hub", "out-for-delivery" — en route
    │
    ▼   "delivered" → chez le client
[shipping_status: DELIVERED]       ← Webhook

Mapping des statuts TCG (Nevuto) :

  • Avant la collecte : submitted, collection-assigned, awaiting-dropoff → aucun changement
  • En transit : collected, at-hub, manifested, ready-for-dispatch, in-transit, at-destination-hub, delivery-assigned, out-for-delivery, returned-to-hub → Shipped
  • Livré : delivered, ready-for-pickup → Delivered
  • Échec de livraison : cancelled, undeliverable, returned-to-sender et autres états d'exception → ignorés

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

Un clic sur Print label ouvre le PDF de l'étiquette dans un nouvel onglet. S'il te faut une étiquette de type autocollant, tu peux aussi la télécharger depuis le portail TCG.

13. Mode test

On te recommande de commencer par la sandbox :

  1. Va sur sandbox.shiplogic.com → crée un compte, récupère une clé API.
  2. Dans Nevuto, active Test mode, colle la clé sandbox puis clique sur Submit.
  3. Envois de test :
    • Tu reçois un numéro de suivi
    • Un PDF d'étiquette est généré (estampillé test)
    • Aucun mouvement réel du transporteur — l'environnement de test simule tout ça
    • Des webhooks de test sont envoyés (si tu es abonné·e au topic Tracking event)
  4. Avant de passer en prod, désactive Test mode et colle ta clé API live.

14. Problèmes fréquents

A. Le numéro de suivi arrive, mais le statut n'est pas mis à jour

  • Vérifie TCG portal → Webhook subscriptions. L'URL webhook Nevuto est-elle enregistrée pour le topic Tracking event ? Sans cette inscription, les mises à jour de statut n'arrivent jamais à Nevuto (voir section 4).

B. Erreur "401 Unauthorized"

  • Tu utilises probablement une clé sandbox sur l'environnement live (ou l'inverse). Aligne le bouton Test mode avec la clé.

C. Le service level "OVN" est refusé

  • OVN n'est pas actif sur ton compte TCG. Vérifie dans TCG portal → Account → Services. ECO est dispo par défaut sur tous les comptes.

D. Les dimensions du colis affichent 20×20×20

  • Aucune dimension n'est renseignée sur la variante produit, Nevuto retombe sur les valeurs par défaut. Renseigne LWH sur tes variantes pour une tarification plus juste.

E. Le nom de la province est refusé

  • TCG accepte Gauteng comme GP. S'il est refusé, c'est probablement une faute de frappe dans le champ Province.

F. Le transporteur n'apparaît pas dans la liste

  • Si la devise de ta boutique n'est pas ZAR, tu verras "Not available in your store currency". Modifie-la dans Settings → General → Currency.
  • Si le pays de l'adresse de ta boutique n'est pas ZA, tu verras "Doesn't ship from your shop location".

G. Les webhooks ne fonctionnent plus après le passage en live

  • Les comptes sandbox et live utilisent des inscriptions webhook séparées. Recrée l'abonnement webhook dans le portail TCG live.

15. Prochaines étapes

  • Fais un test end-to-end en sandbox — création de commande → fulfillment → téléchargement étiquette → webhook de tracking simulé
  • Après le passage en live, surveille pendant la première semaine la cohérence entre le portail TCG et Nevuto
  • Ajoute les service levels OVN/SDX comme règles d'expédition flat-rate pour des segments clients spécifiques

Besoin d'aide ?

Articles connexes