FAQ

Le fichier XML n'est pas généré à la validation de la facture

Vérifiez que les informations de votre société sont complètes dans Accueil > Configuration > Société : numéro de TVA, adresse, code postal, ville et pays. Vérifiez également que le client dispose d'un nom, d'une adresse complète et d'un numéro de TVA ou d'un identifiant Peppol.

Consultez les messages d'erreur affichés sur la facture pour identifier précisément le champ manquant.

Le message "la version de votre module n'est pas cohérente" s'affiche

Ce message signifie que la version du module installé ne correspond pas à la version enregistrée en base de données. Désactivez le module dans Accueil > Configuration > Modules/Applications, puis réactivez-le. Cette opération applique les mises à jour de structure de base de données.

Mon client n'a pas de numéro de TVA

Deux options sont possibles :

• Attribuer un identifiant Peppol spécifique sur la fiche du tiers via le bouton PeppolFinder
• Activer l'option "Forcer la création d'un fichier XML sans numéro de TVA" dans la configuration. Le fichier généré utilise alors le code ZZ00000000 et n'est pas conforme à la norme Peppol, mais il peut être utilisé pour la dématérialisation interne.

Le bouton "Envoyer" est grisé sur ma facture

Plusieurs causes possibles :

• La facture a déjà été envoyée et l'option Autoriser le renvoi d'un document est désactivée dans la configuration du point d'accès
• Le fichier XML Peppol n'existe pas pour cette facture (vérifiez les documents liés)
• Aucun point d'accès n'est configuré

L'envoi échoue avec une erreur de connexion

1. Rendez-vous dans l'onglet Vérification de la configuration du module
2. Cliquez sur Test de connexion avec votre serveur Peppol
3. Vérifiez que la clé d'API, le mot de passe et l'identifiant client sont corrects
4. Si vous êtes en mode test, vérifiez que votre fournisseur Peppol a bien activé votre compte de test

Les erreurs d'arrondi empêchent la génération du fichier XML

La norme Peppol impose que les montants de ligne aient au maximum 2 décimales et que la somme des lignes corresponde au total de la facture avec une tolérance de 0,02 EUR.

Si vous avez des prix unitaires avec beaucoup de décimales (par exemple des calculs au prorata), arrondissez-les avant de valider la facture. Le module signale précisément quelles lignes posent problème.

Comment configurer l'envoi automatique ?

1. Activez l'option Envoyer automatiquement les factures vers PEPPOL dans l'onglet Envoi auto
2. Activez la tâche planifiée Peppol dans Accueil > Configuration > Tâches programmées
3. Configurez la fréquence d'exécution de la tâche (par défaut : toutes les 24 heures)

Seules les factures validées disposant d'un fichier XML et d'un client avec identifiant Peppol sont envoyées automatiquement. Les particuliers sont toujours ignorés.

Comment trouver l'identifiant Peppol d'un client ?

Utilisez l'outil PeppolFinder depuis la fiche du tiers, ou consultez directement l'annuaire public Peppol à l'adresse directory.peppol.eu.

Vous pouvez également utiliser l'onglet Tiers dans la configuration du module pour attribuer en masse les identifiants Peppol à partir des numéros de TVA.

L'identifiant Peppol de mon tiers est refusé

L'identifiant Peppol doit respecter le format XXXX:YYYYYYYYYYYYYY où XXXX est un code ICD (International Code Designator) conforme à la liste ISO 6523. Les codes les plus courants sont :

• 0002 -- SIRENE (France)
• 0009 -- SIRET (France)
• 0088 -- EAN/GTIN
• 0208 -- Numéro de TVA belge
• 9925 -- Numéro de TVA intracommunautaire (format européen)

Si le code ICD utilisé n'est pas reconnu, vérifiez auprès de votre point d'accès quel identifiant utiliser.

Comment gérer les exonérations de TVA ?

Lorsqu'une facture comporte des lignes à TVA nulle, sélectionnez le code d'exonération approprié dans le champ Code d'exonération de TVA de la facture. Les codes disponibles sont gérés dans l'onglet Exonération TVA de la configuration.

Les codes les plus utilisés sont :

• VATEX-EU-IC -- Livraison intracommunautaire
• VATEX-EU-AE -- Autoliquidation (reverse charge)
• VATEX-EU-G -- Exportation hors UE
• VATEX-EU-O -- Non soumis à la TVA
• VATEX-FR-FRANCHISE -- Franchise en base de TVA (France)

La facture du fournisseur n'a pas de compte bancaire lié

Le fichier Peppol inclut les coordonnées bancaires du vendeur si un compte bancaire est lié à la facture. Si le compte bancaire n'a pas de code IBAN renseigné, un avertissement est affiché. Modifiez le compte bancaire pour y ajouter l'IBAN, puis régénérez la facture.

Le mode production et le mode test

Par défaut, le module fonctionne en mode test (bac à sable). Les documents envoyés en mode test ne sont pas transmis aux destinataires réels. Une fois vos tests validés, activez le mode production dans l'onglet Configuration du point d'accès.

Attention : en mode production, chaque envoi peut générer des frais selon votre contrat avec votre fournisseur Peppol.

Comment recevoir des factures fournisseurs ?

1. Configurez votre point d'accès pour la réception (clé d'API et identifiant)
2. Accédez à la page Import AP Peppol via le menu Facturation > Factures fournisseurs
3. Les factures disponibles sur le point d'accès s'affichent dans la liste
4. Cliquez sur un document pour le consulter et créer la facture fournisseur correspondante

Si le webhook est activé, votre Dolibarr est automatiquement notifié de l'arrivée de nouveaux documents.

Ma société a deux numéros de TVA (BE + LU), comment configurer ?

Si votre société dispose d'un numéro de TVA principal et d'un numéro secondaire (par exemple succursale dans un autre pays), suivez cette procédure :

1. Saisissez uniquement le numéro principal dans Configuration > Société > Numéro de TVA. C'est ce numéro qui est lié à votre identifiant Peppol enregistré dans le SMP (réseau).
2. Saisissez le numéro secondaire dans la configuration du module Peppol, champ Numéro de TVA secondaire (ex: LU98765432).
3. Sur les factures clients, une liste déroulante Numéro de TVA Peppol apparaîtra alors automatiquement. Choisissez le numéro à utiliser dans le XML Peppol pour chaque facture (par défaut : Principal).

Important : ne saisissez jamais deux numéros séparés par un tiret dans le champ TVA principal (ex: BE0123456789 - LU98765432). Cela génère un numéro de TVA invalide dans le XML Peppol et fait rejeter la facture par le réseau. Le module détecte ce cas erroné et n'utilise que le premier numéro, mais la bonne pratique est de configurer correctement le numéro secondaire dans le module.

Note : le routage Peppol reste toujours lié à votre identifiant principal. Cette option ne change que le numéro de TVA inscrit dans le corps du XML, pour respecter la cohérence fiscale de la facture émise.