Aller au contenu principal

DoliFalco - Facturation électronique Peppol via Falco pour Dolibarr

DoliFalco est un module Dolibarr qui permet d'envoyer et de recevoir des factures électroniques via le réseau Peppol en passant par le fournisseur d'accès belge Falco. Il s'intègre directement dans votre interface Dolibarr et offre une synchronisation complète avec la plateforme Falco pour la gestion de vos factures Peppol.

Introduction

Qu'est-ce que Falco ?

Falco (falco-app.be) est un fournisseur d'accès Peppol belge. La plateforme Falco permet aux entreprises d'envoyer et de recevoir des factures électroniques conformes au standard Peppol. L'abonnement Expert de Falco inclut un accès API, indispensable pour l'utilisation de DoliFalco.

Qu'est-ce que Peppol ?

Peppol est un réseau international standardisé pour l'échange de documents commerciaux électroniques (factures, notes de crédit, etc.). Il est utilisé dans plus de 30 pays et est obligatoire pour la facturation électronique B2G (Business-to-Government) dans de nombreux pays européens, dont la Belgique.

Pourquoi DoliFalco ?

  • Intégration native : Envoyez et recevez vos factures Peppol directement depuis Dolibarr, sans quitter votre ERP
  • Synchronisation Falco : Connexion directe à l'API Falco pour une gestion fluide et automatisée
  • Découverte automatique : Recherche automatique des identifiants Peppol de vos clients par numéro de TVA
  • Cache Peppol ID : Mise en cache des identifiants Peppol pour accélérer les envois récurrents
  • Suivi des statuts : Polling automatique pour suivre l'état de vos factures envoyées
  • Réception de factures : Recevez et intégrez les factures fournisseurs dans Dolibarr
  • Rapprochement : Outils de réconciliation entre les factures Dolibarr et les documents Peppol
  • Mode sandbox : Testez en toute sécurité avant de passer en production
  • Multi-entité : Compatible avec les installations multi-entités de Dolibarr

Prérequis

Avant d'installer DoliFalco, vérifiez que votre environnement remplit les conditions suivantes :

Élément Version minimum
Dolibarr 18.0 ou supérieur
PHP 8.0 ou supérieur
Extensions PHP json, curl

Vous aurez également besoin d'un compte Falco avec un abonnement Expert (nécessaire pour l'accès API). Rendez-vous sur falco-app.be pour créer votre compte et souscrire à l'abonnement adapté.

Note : DoliFalco est compatible avec les installations multi-entités de Dolibarr. Chaque entité peut avoir sa propre connexion Falco.

Installation

Depuis le DoliStore

  1. Rendez-vous sur le DoliStore et recherchez DoliFalco
  2. Achetez le module (300 EUR) et téléchargez l'archive ZIP
  3. Décompressez l'archive dans le dossier htdocs/custom/ de votre installation Dolibarr
  4. Le dossier final doit être htdocs/custom/dolifalco/

Activation dans Dolibarr

  1. Connectez-vous à Dolibarr en tant qu'administrateur
  2. Allez dans Accueil -> Configuration -> Modules/Applications
  3. Recherchez "DoliFalco" dans la liste des modules
  4. Cliquez sur le bouton Activer

Une fois le module activé, un nouveau menu DoliFalco apparaît dans votre barre de navigation.

Configuration

La configuration de DoliFalco s'effectue en plusieurs étapes accessibles via les pages d'administration du module.

Connexion API Falco (setup.php)

La connexion à l'API Falco s'effectue en 3 étapes simples :

Étape 1 : Lier l'application

  1. Accédez à DoliFalco -> Configuration
  2. Cliquez sur Lier l'application pour initier la connexion avec Falco
  3. Le système génère un lien d'autorisation vers la plateforme Falco
  4. Autorisez DoliFalco à accéder à votre compte Falco

Étape 2 : Saisir la clé API

  1. Connectez-vous à votre espace Falco (falco-app.be)
  2. Accédez aux paramètres de votre compte et copiez votre clé API
  3. Collez la clé API dans le champ prévu dans DoliFalco
  4. Validez la saisie

Astuce : L'accès API nécessite un abonnement Falco Expert. Si vous ne voyez pas de clé API dans votre espace Falco, vérifiez votre niveau d'abonnement.

Étape 3 : Tester la connexion

  1. Cliquez sur le bouton Tester la connexion
  2. DoliFalco effectue un appel à l'API Falco pour vérifier que les identifiants sont corrects
  3. Un message de confirmation s'affiche en cas de succès
  4. En cas d'échec, vérifiez votre clé API et votre abonnement Falco

Important : Tant que la connexion n'est pas validée, les autres fonctionnalités du module ne seront pas accessibles.

Configuration d'envoi (sending.php)

Dans DoliFalco -> Configuration -> Envoi, configurez le mode d'envoi de vos factures :

  • Mode manuel : Vous déclenchez l'envoi manuellement depuis chaque facture. C'est le mode recommandé pour commencer
  • Mode automatique : Les factures sont envoyées automatiquement via Peppol dès leur validation dans Dolibarr

Conseil : Commencez en mode manuel pour vous familiariser avec le processus, puis passez en mode automatique une fois que tout fonctionne correctement.

Options avancées (options.php)

La page des options permet de configurer des fonctionnalités avancées :

  • Découverte automatique des Peppol ID : DoliFalco peut rechercher automatiquement l'identifiant Peppol d'un client à partir de son numéro de TVA. Cette fonctionnalité interroge l'annuaire Peppol (SMP/SML) pour trouver l'identifiant correspondant
  • Cache des Peppol ID : Active la mise en cache des identifiants Peppol trouvés, évitant ainsi de refaire la recherche à chaque envoi. Le cache accélère significativement les envois récurrents vers les mêmes clients
  • Polling des statuts : DoliFalco peut interroger automatiquement l'API Falco pour mettre à jour le statut de vos factures envoyées (envoyée, délivrée, erreur)

Configuration de réception (receiving.php)

Dans DoliFalco -> Configuration -> Réception, paramétrez la réception des factures fournisseurs :

  1. Activez la réception de documents Peppol
  2. Configurez les paramètres de traitement :
    • Création automatique : Créer automatiquement les factures fournisseurs dans Dolibarr à la réception
    • Tiers par défaut : Associer un tiers fournisseur par défaut si l'expéditeur est inconnu dans Dolibarr
    • Rapprochement automatique : Activer le rapprochement automatique avec les commandes fournisseurs existantes

Utilisation

Envoyer une facture via Peppol

Préparer une facture pour l'envoi

Pour qu'une facture puisse être envoyée via Peppol, elle doit remplir certaines conditions :

  • La facture doit être validée (statut "Non payée" ou supérieur)
  • Le client doit avoir un identifiant Peppol renseigné (ou la découverte automatique doit être activée)
  • Les informations de votre société (expéditeur) doivent être correctement configurées

Envoi manuel

  1. Ouvrez la facture dans Dolibarr
  2. Cliquez sur l'onglet Peppol (ou le bouton DoliFalco)
  3. Vérifiez le résumé de la facture et les informations du destinataire
  4. Si l'identifiant Peppol du client n'est pas renseigné, DoliFalco tentera de le découvrir automatiquement (si l'option est activée)
  5. Cliquez sur Envoyer via Peppol
  6. Le système transmet la facture à Falco, qui l'envoie sur le réseau Peppol

Envoi automatique

Lorsque le mode automatique est activé (voir Configuration d'envoi), les factures sont envoyées automatiquement dès leur validation. Aucune action manuelle n'est requise.

Suivre les statuts d'envoi

Statut Description
En attente La facture est prête mais n'a pas encore été envoyée
Envoyée La facture a été transmise avec succès à Falco
Délivrée Le destinataire a accusé réception de la facture sur le réseau Peppol
Erreur L'envoi a échoué (consultez le message d'erreur pour les détails)

Le polling automatique (si activé dans les options) met à jour ces statuts régulièrement sans intervention manuelle.

Recevoir des factures fournisseurs

  1. Accédez à DoliFalco -> Réception
  2. La liste affiche tous les documents reçus via Peppol avec leur statut
  3. Cliquez sur un document pour voir les détails et la facture fournisseur associée

Lorsqu'un document est reçu :

  1. DoliFalco vérifie si l'expéditeur correspond à un tiers fournisseur existant dans Dolibarr
  2. Si oui, une facture fournisseur est créée et liée au tiers
  3. Si non, le document est placé en attente pour association manuelle (ou utilise le tiers par défaut)
  4. Les lignes de facture sont créées avec les montants, taux TVA et descriptions du document Peppol

Rapprochement (reconciliation.php)

La page de rapprochement permet de mettre en correspondance les factures Dolibarr avec les documents Peppol :

  1. Accédez à DoliFalco -> Rapprochement
  2. La page affiche les factures envoyées/reçues et leur correspondance dans Dolibarr
  3. Vous pouvez manuellement associer des documents non rapprochés
  4. Le rapprochement automatique (si activé) effectue ces associations en se basant sur les références de factures

Découverte Peppol (peppol_discovery.php)

La page de découverte Peppol vous permet de rechercher manuellement l'identifiant Peppol d'une entreprise :

  1. Accédez à DoliFalco -> Découverte Peppol
  2. Saisissez le numéro de TVA de l'entreprise recherchée
  3. DoliFalco interroge l'annuaire Peppol et affiche les résultats
  4. Vous pouvez directement associer l'identifiant Peppol trouvé au tiers correspondant dans Dolibarr

Astuce : Cette fonctionnalité est particulièrement utile pour vérifier si un client ou fournisseur est enregistré sur le réseau Peppol avant de tenter un envoi.

Options avancées

Mode sandbox / production

DoliFalco propose deux environnements :

  • Sandbox : Environnement de test pour valider votre configuration sans envoyer de vraies factures sur le réseau Peppol. Utilisez ce mode pour vos premiers tests
  • Production : Environnement réel pour l'envoi et la réception de factures Peppol. Passez en production uniquement après avoir validé le bon fonctionnement en sandbox

Important : Les factures envoyées en mode sandbox ne sont pas transmises aux destinataires réels. Elles sont traitées dans l'environnement de test de Falco.

Multi-entité

DoliFalco supporte les installations multi-entités de Dolibarr. Chaque entité peut avoir :

  • Sa propre connexion API Falco
  • Sa propre configuration d'envoi et de réception
  • Son propre cache de Peppol ID
  • Ses propres paramètres de découverte automatique

Page de debug (debug.php)

La page de debug fournit des informations techniques détaillées pour le diagnostic :

  • Logs des appels API vers Falco
  • Détail des requêtes et réponses
  • Historique des erreurs
  • Informations sur la configuration active

Maintenance et diagnostic

Page de maintenance (maintenance.php)

Accédez à DoliFalco -> Maintenance pour effectuer des opérations de maintenance :

  • Test de connexion API : Vérifiez que la connexion avec Falco est opérationnelle
  • Vider le cache Peppol ID : Supprimez les identifiants Peppol mis en cache pour forcer une nouvelle recherche
  • Vérification des prérequis : Contrôlez que votre environnement PHP remplit toutes les conditions requises
  • Statistiques d'utilisation : Consultez le nombre de factures envoyées/reçues et les taux de succès

Logs et debug

Quand le mode debug est activé (voir page Debug) :

  1. Les logs détaillés sont écrits dans le répertoire documents/dolifalco/logs/ de Dolibarr
  2. Chaque envoi/réception génère un fichier de log avec les requêtes/réponses API
  3. Les documents transmis sont conservés pour inspection

Problèmes courants

L'envoi échoue avec une erreur de connexion API

  • Vérifiez votre clé API dans la configuration
  • Testez la connexion depuis la page de maintenance
  • Vérifiez que votre serveur peut accéder à l'API Falco (pas de blocage pare-feu)
  • Vérifiez que votre abonnement Falco Expert est actif

Le Peppol ID du destinataire n'est pas trouvé

  • Vérifiez que le numéro de TVA du client est correctement renseigné dans Dolibarr
  • Utilisez la page Découverte Peppol pour rechercher manuellement l'identifiant
  • Vérifiez que le destinataire est bien enregistré sur le réseau Peppol

Les factures reçues ne créent pas de tiers

  • Vérifiez la configuration de réception (création automatique activée ?)
  • Vérifiez qu'un tiers par défaut est défini si souhaité

Le statut d'une facture reste "En attente"

  • Vérifiez que le polling des statuts est activé dans les options
  • Consultez la page de debug pour identifier d'éventuelles erreurs
  • Testez la connexion API depuis la page de maintenance

Erreur en mode sandbox

  • Vérifiez que vous utilisez les identifiants sandbox de Falco et non les identifiants de production
  • Consultez la documentation Falco pour les limitations du mode sandbox

FAQ

Qu'est-ce que Falco ?

Falco est un fournisseur d'accès Peppol belge accessible sur falco-app.be. Il propose différents abonnements pour l'envoi et la réception de factures Peppol. L'abonnement Expert est requis pour utiliser DoliFalco car il inclut l'accès API nécessaire à la synchronisation.

Combien coûte DoliFalco ?

Le module DoliFalco est disponible au prix de 300 EUR sur le DoliStore. Ce prix n'inclut pas l'abonnement Falco, qui est facturé séparément par Falco.

Quels pays sont supportés ?

DoliFalco fonctionne dans tous les pays connectés au réseau Peppol via Falco, incluant la plupart des pays de l'UE, le Royaume-Uni et d'autres pays membres du réseau Peppol.

DoliFalco fonctionne-t-il en multi-entité ?

Oui, DoliFalco supporte les installations multi-entités de Dolibarr. Chaque entité peut avoir sa propre configuration et connexion Falco indépendante.

Quelle est la différence entre le mode sandbox et production ?

Le mode sandbox est un environnement de test fourni par Falco. Les factures envoyées en sandbox ne sont pas transmises aux destinataires réels. Le mode production envoie les factures sur le vrai réseau Peppol. Il est recommandé de toujours tester en sandbox avant de passer en production.

La découverte automatique de Peppol ID fonctionne-t-elle pour tous les pays ?

La découverte automatique interroge l'annuaire Peppol (SMP/SML) et fonctionne pour toutes les entreprises enregistrées sur le réseau Peppol, quel que soit leur pays. Cependant, toutes les entreprises ne sont pas encore enregistrées sur Peppol.

Comment mettre à jour le module ?

  1. Téléchargez la nouvelle version depuis le DoliStore
  2. Remplacez les fichiers dans htdocs/custom/dolifalco/
  3. Accédez à Dolibarr, le module détectera la mise à jour et appliquera les migrations nécessaires

Où trouver de l'aide ?

  • Support E-dem : Contactez-nous pour toute question technique
  • Documentation Peppol : peppol.eu pour les spécifications du réseau
  • Documentation Falco : falco-app.be pour les questions relatives à votre compte et abonnement Falco