Aller au contenu principal
Aller sur nevuto.com

Connecter Geliver à Nevuto

Publié le 20 mai 202611 min de lectureMis à jour il y a 1 semaine

Qu'est-ce que Geliver ?

Geliver est un agrégateur d'expédition multi-transporteurs basé en Turquie, axé sur la livraison rapide et traçable pour les boutiques en ligne. Via une seule API, tu peux expédier avec Aras Kargo, Yurtiçi Kargo, MNG, PTT, Sürat Kargo, HepsiJet, Kolay Gelsin et Paket Taksi. Pour les marchands Nevuto qui vendent en Turquie, Geliver est l'un des moyens les plus rapides d'ajouter une expédition domestique fiable sans négocier avec chaque transporteur individuellement.

Comment Nevuto gère Geliver

  • Nevuto se connecte à Geliver via son API d'expédition officielle en utilisant un token API généré depuis ton portail marchand Geliver.
  • Lors du traitement d'une commande, Geliver choisit l'offre la moins chère parmi tes transporteurs sélectionnés.
  • Pour chaque commande Nevuto, une étiquette d'expédition Geliver est générée en un clic depuis l'écran de la commande — prête à imprimer au format PDF.
  • Les numéros de suivi sont automatiquement réécrits dans la commande et le client reçoit le lien de suivi dans l'e-mail de confirmation d'expédition.
  • Les mises à jour de statut (en transit / livré) arrivent automatiquement via le webhook Geliver — aucune intervention manuelle requise.

1. Prérequis

  • Un compte Geliver actif. Si tu n'en as pas, inscris-toi sur geliver.io.
  • Au moins une adresse d'expéditeur enregistrée dans ton compte Geliver. Ajoute-la depuis la section Adresses du portail Geliver.
  • Au moins un contrat transporteur actif dans ton compte Geliver. Choisis dans le Geliver Marketplace les transporteurs que tu veux utiliser.
  • La devise de ta boutique doit être TRY. Geliver renvoie des prix en TL ; tu ne peux pas importer de tarifs depuis une boutique utilisant une autre devise (le système le bloquera).

2. Token API Geliver

  1. Connecte-toi au portail Geliver.
  2. Va dans Compte → API & Intégrations.
  3. Génère un nouveau token API (ou utilise un token existant).
  4. Copie le token — tu le colleras dans Nevuto à l'étape suivante.

⚠️ Le token est confidentiel, ne le partage avec personne. Si tu soupçonnes une fuite, révoque-le dans le portail Geliver et génères-en un nouveau.

3. Connecter Geliver dans Nevuto

  1. Dans ton panneau d'admin Nevuto, va dans Settings → Shipping → Shipping providers.
  2. Sélectionne Geliver dans la liste.
  3. Colle le token copié depuis Geliver dans le champ API key.
  4. Active le toggle Enable shipping method.
  5. (Facultatif) Active Test mode pour envoyer des expéditions de test à Geliver sans acheter de vraies étiquettes. Recommandé avant la mise en production.
  6. Clique sur Submit.

Une fois la clé API enregistrée, une carte Settings apparaît en dessous pour configurer les options spécifiques à Geliver.

4. Adresse d'expéditeur

  • Auto-resolve (par défaut) : utilise automatiquement l'adresse "default sender" de ton compte Geliver.
  • Choisir une adresse précise : sélectionne dans le dropdown l'une de tes adresses enregistrées dans Geliver.

Si ton compte Geliver contient plusieurs adresses d'expéditeur (ex. entrepôt principal + deuxième succursale) et que tu veux expédier depuis une adresse précise, configure-le ici.

5. Transporteurs préférés

Cette étape contrôle parmi quels transporteurs Geliver choisira lors de l'expédition.

  1. Sélectionne un ou plusieurs transporteurs dans le dropdown (Aras, Yurtiçi, MNG, PTT, Sürat, HepsiJet, Kolay Gelsin, Paket Taksi).
  2. Submit.

Comportement :

  • Lors du traitement, Geliver choisit l'offre la moins chère parmi tes transporteurs sélectionnés.
  • Si tu n'en choisis aucun, Geliver utilise sa propre recommandation "cheapest" par défaut.
  • Si aucun des transporteurs sélectionnés ne dessert l'itinéraire, le système se replie automatiquement sur "cheapest" (ta commande n'est pas bloquée).

💡 Conseil : Ne sélectionne que les transporteurs avec lesquels tu as un contrat et qui sont actifs dans ton compte Geliver. Les transporteurs inactifs n'apparaîtront pas dans le tableau de référence des prix.

6. Référence des prix transporteur

Une fois les transporteurs préférés enregistrés, un tableau de référence des prix s'ouvre en dessous.

Que montre-t-il ?

  • Les prix desi-basés publiés par Geliver pour tes transporteurs sélectionnés.
  • Pour des valeurs desi fixes (1, 2, 3, 5, 10, 15, 20, 30), le prix en TL TTC de chaque transporteur.
  • "—" signifie que le transporteur ne renvoie pas de prix pour ce desi (généralement parce qu'il n'est pas actif dans ton compte ou n'accepte pas ce poids).

Comment l'utiliser ?

  1. Examine le tableau — quel transporteur est le plus avantageux à chaque palier desi ?
  2. Utilise ces prix comme référence lorsque tu construis tes propres tarifs d'expédition. Ajoute une marge par-dessus pour fixer le tarif facturé au client.
  3. Coche la checkbox en bout de chaque ligne → au submit, des règles de tarif d'expédition sont créées automatiquement :
    • min_desi → max_desi : tarifs en paliers à partir des valeurs desi cochées (ex. cocher 1, 5, 10 crée les paliers 0–1, 1–5, 5–10 desi).
    • Prix : le prix le plus élevé parmi les transporteurs sélectionnés de la ligne (worst-case, pour que tu ne perdes pas d'argent).
    • Nom : transporteur au prix max + desi (ex. "Aras Kargo — up to 5 desi").
    • Les règles sont ajoutées à la première zone du default shipping profile de ta boutique.
  4. Tu peux ensuite éditer ces règles manuellement dans Settings → Shipping → Rates (par exemple pour ajouter une marge).

⚠️ Cette fonctionnalité ne fonctionne que si la devise de ta boutique est TRY. Pour les boutiques en USD/EUR etc., un avertissement s'affiche et les checkboxes sont désactivées.

7. Paquets d'expédition

Pour expédier via Geliver, des dimensions de colis (longueur × largeur × hauteur + poids) sont nécessaires. Elles sont résolues dans cet ordre de priorité :

  1. Variant LWH — saisies directement sur la variante du produit.
  2. Référence ShippingPackage — si la variante est liée à un template de paquet, ses dimensions.
  3. Paquet par défaut de la boutique — le paquet marqué "Default" dans Settings → Shipping → Packages.
  4. Dernier recours : fallback 20×20×20 cm.

Étapes :

  1. Va dans Settings → Shipping → Packages.
  2. Add package → nom, type (Box/Envelope/Soft pack), L/l/H/unité, poids.
  3. Un "Standard package" a été créé automatiquement à la création de la boutique ; il te suffit de mettre à jour ses dimensions.
  4. Set as default → marque un paquet comme fallback à l'échelle de la boutique.

💡 Si tu vends une large gamme de produits : définis plusieurs templates de paquets (Small box, Medium box, Large box) et affecte-les à tes variantes.

8. Dimensions variante (LWH)

Pour obtenir le prix le plus précis, nous recommandons de saisir les vraies dimensions sur chaque variante :

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

Si aucune dimension n'est définie sur la variante, le système se rabat sur ShippingPackage, puis sur le paquet par défaut de la boutique, puis sur 20×20×20 cm.

9. Flux de traitement (fulfilment)

Une fois que le client a payé, la commande apparaît dans ton admin avec un bouton "Mark as shipped" et elle est prête à être expédiée.

  1. Ouvre la page de détail de la commande.
  2. Clique sur le bouton Mark as shipped.
  3. Dans la modale qui s'ouvre, choisis Geliver comme provider et clique sur Submit.
    • Pour les rares cas où tu expédies en dehors de Geliver, tu peux choisir Manual et saisir le numéro de suivi à la main — cette option ne crée pas d'expédition Geliver.
  4. En quelques secondes, la ligne de commande affiche le numéro de suivi, le lien de suivi et un bouton "Print label". Au même moment, le coût de l'étiquette est débité de ton solde Geliver.
  5. Clique sur Print label pour ouvrir le PDF du bordereau, imprime-le et colle-le sur le colis.
  6. Remets le colis au transporteur choisi — le reste est suivi automatiquement. Tu verras sur la page de détail de la commande l'indication "Shipping status is updated automatically by the carrier".

💡 Ton client peut suivre l'expédition via le lien de suivi depuis sa propre page de commande, et il reçoit une notification par e-mail à chaque changement de statut.

10. Cycle de statut

Une fois la commande expédiée, les mises à jour de statut arrivent automatiquement :

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Étiquette imprimée, le transporteur n'a pas encore récupéré
    │
    ▼   Le transporteur scanne le colis
[shipping_status: SHIPPED]         ← Webhook déclenché, e-mail "Expédié" au client
    │
    ▼   Livré au client
[shipping_status: DELIVERED]       ← Webhook, e-mail "Livré" au client

Comment ça marche :

  1. Lorsque tu enregistres l'intégration Geliver, Nevuto enregistre automatiquement un webhook sur ton compte Geliver.
  2. Quand le transporteur scanne le colis, Geliver notifie Nevuto.
  3. Nevuto le reçoit, retrouve la commande via le numéro de suivi et met à jour le statut.
  4. SHIPPED → OrderShippedEvent → le stock est décrémenté, e-mail envoyé au client.
  5. DELIVERED → OrderDeliveredEvent → e-mail de livraison envoyé au client.

Aucune intervention manuelle nécessaire. Ne change pas le statut de commande toi-même — le webhook écrasera ta modification.

11. Notifications SMS

  • Nevuto envoie les notifications par e-mail (Order shipped / Order delivered).
  • Nevuto n'envoie pas de SMS.
  • Geliver ou le transporteur sous-jacent envoie des SMS au client (comportement standard en TR — les transporteurs envoient automatiquement un SMS au numéro du destinataire).
  • Vérifie les paramètres de notification SMS dans le portail Geliver s'ils sont disponibles.

12. Mode test

Teste toujours avant la mise en production :

  1. Dans les paramètres Geliver, active Test mode et enregistre.
  2. Passe une vraie commande sur le storefront (en TRY, petit montant — un produit à 1 ₺).
  3. Complète le paiement (carte de test Stripe ou autre gateway de test).
  4. Dans l'admin : Mark as shipped → sélectionne Geliver → Submit.
  5. Résultat :
    • Apparaît dans ton portail Geliver comme expédition de test.
    • Aucune vraie étiquette n'est achetée.
    • Un numéro de suivi est renvoyé, mais sans transporteur réel.
  6. Une fois le flux validé, désactive Test mode et passe en production.

13. Problèmes fréquents

Erreur "Geliver API key missing" Tu as enregistré une clé API vide. Saisis à nouveau le token dans Settings → Shipping → Geliver → API key.

Erreur Geliver "City not found / district not found" La province/district de l'adresse client ne correspond pas au format attendu par Geliver. Nevuto mappe automatiquement (province_code → il, city → ilçe), mais certains cas limites échouent. Vérifie l'adresse du client — en particulier le champ "ilçe" doit être clair (nom complet, pas une abréviation).

Le tableau de référence des prix revient vide

  • Aucune checkbox sélectionnée : ajoute au moins un transporteur dans les transporteurs préférés et enregistre.
  • "—" partout : les transporteurs sélectionnés ne sont pas actifs dans ton compte Geliver. Vérifie l'état du contrat/de l'activation dans le portail Geliver.
  • Avertissement devise : ta boutique n'est pas en TRY. Les prix sont affichés mais les checkboxes sont désactivées — pas d'import possible.

Les commandes partent automatiquement vers Geliver (sans cliquer sur Mark as shipped) Ce comportement a été corrigé le 2026-05-20. Si cela se produit encore, le worker PHP queue n'a peut-être pas été redémarré. Redémarre les workers.

L'URL de suivi n'arrive pas / affiche "—" Le champ trackingUrl de Geliver peut rester vide jusqu'à ce que le transporteur récupère le colis. En fallback, Nevuto utilise https://app.geliver.io/tracking/{shipmentId} — ce lien renvoie au portail Geliver.

Le webhook n'arrive pas / le statut ne se met pas à jour

  • Vérifie qu'un webhook est enregistré dans ton compte Geliver (portail Geliver → API → Webhooks).
  • Dans l'admin Nevuto, va dans les paramètres Geliver et clique à nouveau sur Submit — le webhook sera réenregistré automatiquement.

14. Étapes suivantes

  • Surveille les commandes en production la première semaine — vérifie la cohérence entre le portail Geliver et Nevuto.
  • Ajoute une marge à tes tarifs d'expédition — les tarifs importés depuis le tableau de référence sont des prix coûtants ; mets-les à jour pour refléter le montant que tu veux facturer au client.
  • En période de pointe / vacances, garde le portail Geliver ouvert — suis aussi les retards/retours depuis là-bas.

Besoin d'aide ?

Pour les problèmes liés à l'API Geliver ou à l'intégration Nevuto :

Articles connexes