Dépannage et questions fréquentes
« La facture électronique n'a pas pu être générée en raison de problèmes de configuration »
Lire la liste des erreurs (SIREN manquant ou invalide, TVA manquante ou au mauvais format, adresse ou ville vide, avoir sans facture source, IBAN manquant pour un virement, lignes sans description…). Corriger la fiche société, la fiche tiers ou la facture, puis « Générer ».
« Motif inconnu d'exemption de TVA pour la ligne … »
Renseigner le code VATEX du taux à 0 % concerné.
« Le format recommandé est CII, et non Factur-X »
Le PDF Dolibarr n'est pas en PDF/A-3b : passer le « Format des documents PDF » sur PDF/A-3b (Accueil > Configuration > PDF) ou choisir CII.
« Cette facture utilise un modèle ODT/ODS, mais aucune version PDF n'a été générée »
Factur-X exige un PDF : activer MAIN_ODT_AS_PDF ou utiliser un modèle PDF.
Facture envoyée mais aucun statut ne progresse
Vérifier que la tâche planifiée EInvoicingDocumentSync est active, ou lancer « Synchroniser ». Dans la section « À surveiller », un motif NON_TRANSMISE indique que le destinataire n'a pas d'adresse active : vérifier l'adresse de routage (annuaire) et contacter le client.
« Erreur technique » sur une facture
La PA a refusé le dépôt (voir « Commentaires de validation » et le journal des appels). Corriger, « Régénérer », puis « Retransmettre ». Les encaissements ne sont pas déclarés tant que le dépôt n'est pas accepté.
« Cette facture a déjà été transmise … et ne peut plus être modifiée »
Comportement normal : émettre un avoir ou une facture rectificative, ou dupliquer la facture.
Impossible d'obtenir le jeton d'accès
Vérifier les identifiants (mode réel / test correspondant), le type d'authentification, et pour SuperPDP que l'application est de type « Confidentiel ». Le test en ligne de commande scripts/testconnect.php permet de diagnostiquer.
Aucune facture fournisseur n'arrive alors que la PA en affiche
Sur SuperPDP, vérifier le « Format de conversion AFNOR préféré » de l'application (doit être CII). Vérifier ensuite la file d'attente et le résumé de synchronisation : un flux bloqué (tiers ou produit inconnu) y est expliqué avec les actions à mener.
Facture fournisseur importée sur le mauvais tiers
Supprimer le brouillon puis « Importer à nouveau le document » depuis la fiche du flux, après avoir corrigé les identifiants des tiers.
« Le montant total de cette facture ne correspond pas à celui indiqué sur la facture électronique »
Corriger la facture d'après le document (aperçu XML), ou refuser le document au fournisseur avec le motif adapté.
Le nom du fournisseur diffère du tiers trouvé
Le rapprochement s'est fait sur le SIREN / la TVA : vérifier et mettre à jour la fiche tiers si nécessaire.
L'e-mail de notification n'arrive pas
Vérifier MAIN_MAIL_EMAIL_FROM, les adresses saisies, puis utiliser le bouton « Envoyer un e-mail de test ». Un relais SMTP peut réécrire l'expéditeur.
Besoin d'aide du support
Activer le mode débogage, reproduire, puis exporter les flux ou appels concernés en archive ZIP (chapitres 10 et 11) et joindre le journal du module (onglet Débogage).
Relire l'archive avant envoi : elle contient les données des documents.
Manuel d'utilisation du module EInvoicing — Facturation électronique française pour Dolibarr — Chapitre 18
Glossaire
Termes et sigles
Terme | Définition |
|---|---|
AFNOR XP Z12-012 / 013 / 014 | Normes françaises : modèle sémantique et statuts, annuaire, cas d'usage. |
BT-xx / BG-xx | Identifiants des données de la norme EN 16931 (BT = terme, BG = groupe). |
BR-xx | Règles métier de la norme (BR-CO calculs, BR-FR règles françaises, BR-AE autoliquidation). |
CDAR | Message d'accusé et de réponse portant un statut de cycle de vie. |
CII | Syntaxe XML UN/CEFACT Cross Industry Invoice. |
EN 16931 | Norme européenne de la facture électronique. |
Factur-X | PDF/A-3 avec XML CII embarqué. |
Flux | Un échange unitaire avec la PA. |
KYB / KYC | Vérification d'identité de l'entreprise / de l'utilisateur par la PA. |
OAuth | Protocole d'authentification par jetons. |
PA / PDP | Plateforme Agréée / Plateforme de Dématérialisation Partenaire (ancien nom). |
Peppol | Réseau international d'échange, utilisé par certaines PA. |
SIREN / SIRET | Identifiants d'entreprise (9 chiffres) et d'établissement (14 chiffres). |
VATEX | Liste des codes de motif d'exonération de TVA. |
VIES | Service européen de vérification des numéros de TVA intracommunautaires. |
Principaux identifiants BT cités dans ce manuel
Identifiant | Donnée |
|---|---|
BT-1 | Numéro de facture |
BT-8 | Code de date d'exigibilité de la TVA |
BT-10 | Référence acheteur |
BT-13 | Référence de commande |
BT-34 / BT-49 | Adresses électroniques vendeur / acheteur |
BT-121 | Code d'exonération |