Configurer le module
Ouvrez la page de configuration : Accueil → Configuration → Modules/Applications, ligne E-Facture, icône de réglages.
Les réglages
| Réglage | Valeur à saisir | Obligatoire pour |
|---|---|---|
| Clé d’activation | votre clé gratuite efl_… (Obtenir sa clé) | tout le module |
| Adresse du service de facturation électronique | https://efacture.odoip.cloud (déjà rempli) | tout le module |
| Clé d’accès | la clé d’accès à la passerelle remise par ODOIP (efk_…) | l’envoi des factures |
| Secret de notification | le secret remis avec la clé d’accès | le suivi des statuts |
Cliquez sur Enregistrer. Le module contacte aussitôt ODOIP pour activer la clé et affiche le résultat en haut de la page :
- Clé active : tout fonctionne ;
- Module inactif : la clé est absente, inconnue, suspendue ou révoquée. Le message précise la cause et propose le lien Obtenir une clé gratuite.
Une fois enregistrés, la clé d’activation, la clé d’accès et le secret ne sont plus jamais affichés (mention « (inchangé) »). Pour les modifier, saisissez simplement la nouvelle valeur et enregistrez.
L’adresse de notification
En bas de la page, le module affiche l’adresse de notification à déclarer, de la forme :
https://votre-dolibarr.fr/custom/efacture/public/webhook.php
C’est par cette adresse que la passerelle informe Dolibarr de chaque changement de statut. Communiquez-la à ODOIP lors de l’ouverture de votre accès : nous la déclarons pour vous.
Si votre Dolibarr est protégé par une liste d’adresses autorisées, autorisez l’adresse 217.22.14.21 (passerelle ODOIP) sur le dossier custom/efacture/public/ uniquement.
Ce que le module envoie à ODOIP
À l’enregistrement de la configuration, puis une fois par jour, le module se signale à ODOIP avec :
- la clé d’activation ;
- une empreinte de l’identifiant de votre Dolibarr (jamais l’identifiant lui-même) ;
- l’adresse de votre Dolibarr ;
- les versions du module, de Dolibarr et de PHP.
Aucune donnée de facture ni de tiers n’est transmise par ce signal. Les factures, elles, ne partent qu’à la passerelle, avec votre clé d’accès.
Si la passerelle est momentanément injoignable, une activation réussie reste valable 14 jours : votre activité n’est pas interrompue.
Étape suivante : transmettre et suivre une facture.