Guide d’intégration

Intégrer Livraison Facile dans votre parcours client

Ce guide permet aux équipes produit, transport et développement de choisir le bon niveau d’intégration, puis de transmettre au livreur un lien, un code ou un QR exploitable.

Comparer les options Documentation technique

Choisir le bon niveau

Quatre parcours qui peuvent évoluer avec vos besoins

1

Réutilisation, sans clé API

Accepter un code déjà créé par le client

Ajoutez un champ facultatif « Code Livraison Facile » au carnet d’adresses, au compte client ou à la commande. Le destinataire peut ainsi utiliser une fiche qu’il administre déjà et la corriger une seule fois pour ses futurs achats.

Enregistrez uniquement un code normalisé de 4 à 12 caractères
Construisez le lien de lecture sur le domaine officiel Livraison Facile
Le marchand ne devient pas propriétaire de la consigne et n’accède pas à son statut API
Ne collectez jamais le code PIN dans un champ non prévu ou dans les journaux

<label>
  Code Livraison Facile (optionnel)
  <input name="lf_code"
         pattern="[A-Za-z0-9]{4,12}"
         autocomplete="off">
</label>

2

Sans clé API

Lien simple vers la création

Ajoutez un lien dans votre espace client, votre suivi de commande ou un message envoyé avant la livraison. Le client crée ensuite sa fiche de manière autonome.

Idéal pour valider l’intérêt auprès d’un premier groupe de clients
Aucune donnée de commande transmise automatiquement
Le client vous communique ensuite le lien ou le code selon votre processus

<a href="https://www.livraison-facile.fr/creer">Préparer mes consignes de livraison</a>

3

Option recommandée pour débuter

Préremplissage sécurisé

Votre backend envoie les informations déjà connues à POST /api/v1/prefills. L’API renvoie une URL temporaire vers le formulaire prérempli. Le client vérifie, complète et crée sa consigne.

Référence de commande et URL de retour conservées dans le parcours
Adresse, nom et téléphone préremplissables
Le client reste responsable des instructions finales

Serveur à serveurPOST /api/v1/prefillsRéponse : URL sécurisée vers /creer

4

Automatisation complète

Création directe depuis votre backend

Votre système appelle POST /api/v1/consignes après avoir recueilli l’accord et les données du client. La réponse fournit les ressources nécessaires à votre parcours.

Code et lien de lecture immédiatement disponibles
URL du QR récupérable avec la même clé partenaire
Code PIN et validité modifiables par les endpoints dédiés
Confirmation de consultation disponible par l’endpoint de statut

Serveur à serveurPOST /api/v1/consignesRéponse : code, lien, QR et informations de validité

Intégration avec une IA

Un serveur MCP utile, sans confier les secrets à l’IA

Un assistant IA autorisé peut vérifier les consignes, suivre les accès et préparer une livraison. L’adresse, les instructions privées, les IP et les codes PIN restent exclus de ses réponses.

Activation accompagnée

Authentification OAuth 2.1 par compte entreprise
Isolation par entreprise et autorisation explicite du particulier
Droits séparés pour la lecture, la préparation et les demandes d’action
Activation, rotation et révocation soumises à une confirmation humaine
Le code PIN est affiché uniquement dans l’interface connectée, jamais à l’IA

Point d’accès : https://www.livraison-facile.fr/app/mcp/livraison-facile. Chaque entreprise doit disposer d’un compte et de droits OAuth validés.

Parcours recommandé

Du panier jusqu’au livreur

1

Proposer

Affichez l’option après la commande ou avant l’expédition.

2

Recueillir

Le client vérifie l’adresse et ajoute les informations réellement utiles.

3

Associer

Conservez le code ou le lien avec votre référence de commande.

4

Transmettre

Envoyez le lien ou le QR au livreur selon vos outils habituels.

5

Protéger

Si un code PIN est utilisé, transmettez-le séparément du lien.

Données utiles

Préremplissez uniquement ce que vous connaissez

Une intégration robuste laisse le client corriger l’adresse et compléter les détails d’accès. Ne transformez pas une donnée supposée en consigne définitive.

Champs disponibles

Référence de commandeNom du destinataireTéléphoneAdresseCoordonnées GPSCode portailCode porteInterphoneAutre accèsPoint de dépôtConsigne prioritaireDurée de validitéCode PIN optionnel

Voir tous les champs API

Sécurité

Règles d’intégration à respecter

Conserver la clé API uniquement côté serveur
Ne jamais journaliser le code PIN en clair
Limiter les domaines autorisés du partenaire
Utiliser une validité cohérente avec la livraison
Transmettre le code PIN séparément du lien ou du QR

Recette avant ouverture

Checklist du pilote

Tester une consigne temporaire et une sans expiration
Tester la lecture mobile avec et sans code PIN
Vérifier le lien d’itinéraire et l’appel téléphonique
Contrôler le QR obtenu depuis votre backend
Prévoir qui désactive ou met à jour une consigne

Étape suivante

Demandez une clé pour votre environnement partenaire

Indiquez votre société, votre site et les domaines autorisés. La documentation fournit ensuite les requêtes et réponses de référence.

Demander une clé API Lire la documentation