Module Peppol - Tâche planifiée

Vue d'ensemble

La tâche planifiée Peppol effectue trois opérations principales :

Réception : Récupération des factures fournisseurs depuis le point d'accès
Envoi automatique : Envoi des factures clients validées vers le réseau Peppol
Vérification de statut : Mise à jour du statut des documents récemment envoyés

Activation

1. Activer la tâche dans Dolibarr

Accédez à Accueil > Configuration > Modules/Applications > Tâches planifiées.

Recherchez la tâche "Traitement automatique PEPPOL (import/export)" et activez-la.

Par défaut, la tâche est configurée pour s'exécuter quotidiennement.

2. Configurer le module

Accédez à Configuration > Modules > Peppol > Envoi automatique pour paramétrer le comportement de la tâche.

Configuration

Paramètres généraux

Paramètre	Description
Activer l'envoi automatique	Active/désactive l'envoi automatique des factures. La réception des factures fournisseurs reste active même si ce paramètre est désactivé.
Email de rapport	Adresse email recevant le rapport d'exécution après chaque traitement.
Rapport uniquement en cas d'erreur	Si activé, le rapport n'est envoyé que si des erreurs surviennent.

Filtres d'envoi

Paramètre	Description	Valeur par défaut
Date minimum	Seules les factures validées à partir de cette date seront envoyées (format AAAA-MM-JJ).	Aucune restriction
Exclure les factures payées	Les factures déjà payées ne seront pas envoyées.	Non
Délai après validation	Nombre d'heures à attendre après la validation d'une facture avant de l'envoyer. Permet de laisser un délai pour d'éventuelles corrections.	24 heures

Limites et performance

Paramètre	Description	Valeur par défaut
Nombre maximum de factures	Nombre maximum de factures à traiter par exécution. Évite une surcharge du système.	50

Plage horaire d'exécution

Paramètre	Description
Heure de début	Heure à partir de laquelle l'envoi est autorisé (0-23).
Heure de fin	Heure jusqu'à laquelle l'envoi est autorisé (0-23).

Les plages nocturnes sont supportées. Par exemple, pour autoriser l'envoi uniquement entre 22h et 6h, configurez :

Heure de début : 22
Heure de fin : 6

Si aucune heure n'est configurée, l'envoi est autorisé à tout moment.

Critères de sélection des factures

Une facture client est sélectionnée pour l'envoi automatique si elle remplit tous les critères suivants :

Statut : Validée ou classée
Non encore envoyée : Pas d'identifiant Peppol enregistré
Client éligible : Le client n'est pas un particulier (type "Particulier" exclu)
Identifiant Peppol client : Le client possède un identifiant Peppol valide
Fichier XML présent : Le fichier XML Peppol existe pour cette facture
Filtres respectés : Respecte les filtres configurés (date, délai, paiement, plage horaire)

Rapport d'exécution

Après chaque exécution, un rapport est envoyé par email (si configuré) contenant :

Réception

Nombre de factures fournisseurs importées
Erreurs éventuelles

Envoi

Succès : Liste des factures envoyées avec succès
Erreurs : Liste des factures en erreur avec le message d'erreur
Ignorées : Factures non envoyées, classées par raison :
- Client sans identifiant Peppol
- Fichier XML manquant
- Client particulier
- Délai non écoulé
- Déjà payée
- Avant date minimum
- Hors plage horaire

Vérification de statut

Nombre de documents vérifiés
Nombre de statuts mis à jour

Fonctionnement détaillé

1. Réception des factures fournisseurs

La tâche interroge le point d'accès configuré pour récupérer les nouvelles factures fournisseurs. Ces factures sont importées dans Dolibarr et disponibles dans la liste des imports Peppol.

2. Envoi automatique des factures clients

Pour chaque facture répondant aux critères :

Vérification de l'identifiant Peppol du client
Vérification de l'existence du fichier XML ({ref}_peppol.xml)
Envoi au point d'accès
Enregistrement du statut et de l'identifiant Peppol retourné

3. Vérification de statut

Pour les factures envoyées dans les 7 derniers jours et dont le statut n'est pas final :

Interrogation du point d'accès pour obtenir le statut actuel
Mise à jour du statut dans Dolibarr

Cette fonctionnalité n'est disponible que si le point d'accès la supporte.

Bonnes pratiques

Délai après validation

Il est recommandé de conserver un délai de 24 heures après validation. Cela permet :

De corriger d'éventuelles erreurs avant l'envoi
D'annuler une facture validée par erreur
De vérifier les informations du client

Plage horaire

Si votre point d'accès a des limitations de débit ou de disponibilité, configurez une plage horaire en dehors des heures de pointe.

Nombre maximum de factures

Ajustez ce paramètre selon :

La capacité de votre point d'accès
Le volume de factures à traiter
La fréquence d'exécution de la tâche

Surveillance

Configurez l'email de rapport pour être alerté des erreurs. Consultez régulièrement les factures ignorées pour identifier d'éventuels problèmes de configuration (clients sans identifiant Peppol, fichiers XML manquants).

Dépannage

La tâche ne s'exécute pas

Vérifiez que la tâche est activée dans Dolibarr
Vérifiez que le cron Dolibarr est correctement configuré sur votre serveur
Consultez les logs Dolibarr

Aucune facture n'est envoyée

Vérifiez que l'envoi automatique est activé dans la configuration
Vérifiez qu'il existe des factures validées répondant aux critères
Vérifiez la plage horaire configurée
Consultez le rapport d'exécution pour identifier les factures ignorées et leur raison

Erreurs d'envoi

Vérifiez la configuration du point d'accès
Vérifiez la connectivité réseau
Consultez les logs du point d'accès
Vérifiez que le fichier XML est valide

Fichier XML manquant

Le fichier XML Peppol doit être généré avant l'envoi. Vérifiez :

Que le modèle ODT/PDF avec génération XML est configuré
Que la facture a été régénérée après configuration du modèle