Aller au contenu principal

Rapport quotidien

L'écran Rapport quotidien planifie un email récurrent qui regroupe toutes les erreurs d'intégration de la journée et joint la liste complète des évènements au format Excel. Le corps de l'email résume la période et les compteurs ; la pièce jointe contient exactement les mêmes données que l'export de l'onglet Vue détaillée de la page Erreurs d'intégration — mêmes colonnes, même structure.

L'objectif est opérationnel : au lieu de demander à une équipe d'ouvrir la SPA chaque matin pour vérifier les factures en échec, le rapport pousse les erreurs du jour vers leur boîte mail à heure fixe. Plusieurs rapports peuvent coexister pour que des équipes différentes reçoivent des coupes différentes des mêmes données — l'équipe comptabilité pour la société ACME, l'équipe opérations pour l'activité VRAC, l'équipe développement pour tout ce qui est de sévérité FATAL.

Cette page s'applique quel que soit le système source — JD Edwards, SAP, NetSuite ou un ERP personnalisé. Les erreurs proviennent du pipeline de validation et sont enregistrées dans F564236, le format source est donc transparent ici.

Nouveauté 2026.06.02

Cette page est entièrement nouvelle. Elle remplace le flux Export ad hoc de la page Erreurs d'intégration pour les destinataires planifiés — les opérateurs qui n'ouvrent pas la SPA chaque jour mais qui ont quand même besoin des données. Le flux d'export reste disponible pour un tri ponctuel.

Ouvrir l'éditeur​

  • Barre latérale → Configuration → Système → Rapport quotidien.
  • Ou directement depuis la page Erreurs d'intégration → barre d'outils → Envoyer au rapport… quand l'opérateur veut câbler un email récurrent sur le jeu de filtres courant.

Vue d'ensemble​

Rapport quotidien＋ AjouterSévérité ▾☑ Activés uniquement↻ RafraîchirComptabilité · ACMEaccounting@acme.example · ops-acme@acme.exampleChaque jour · 07:00 Europe/Paris · sur 1 jour · sévérité = ERROR / FATALFiltres : KCO = 00070 · Activité = ISCACTIVÉdernier envoi 02/06ModifierOpérations · VRACoperations@example.comChaque jour · 06:30 Europe/Paris · sur 2 jours · sévérité = allFiltres : Activité = VRACACTIVÉDev — FATAL uniquementdev-oncall@example.comChaque jour · 08:00 Europe/Paris · sur 1 jour · sévérité = FATALFiltres : (aucun — toutes sociétés)DÉSACTIVÉPlanning d'envoi06:30 Opérations · VRAC → operations@example.com · 12 évènements · 4 factures07:00 Comptabilité · ACME → accounting@acme + ops-acme · 7 évènements · 3 facturesAjouter un rapportUn par groupe de destinatairesPlanningcron + fuseauFiltres d'égalitéKCO, Activité, Source, Règle, …Activer / désactiverPause sans suppressionPlanning d'envoiPlan du jour + compteurs

Champs du rapport​

Chaque rapport est une ligne du catalogue. Le panneau d'édition comporte quatre sections.

1. Identification​

ChampObligatoireDescription
NomouiTexte libre. Affiché dans la liste du catalogue et en tête du corps de l'email. Exemple : Comptabilité · ACME.
DestinatairesouiUne ou plusieurs adresses email, séparées par virgule ou point-virgule. Chaque adresse reçoit le même email — il n'y a pas de personnalisation par adresse ici ; créez un autre rapport si les destinataires doivent voir des coupes différentes.
Activéoui (défaut : on)Quand il vaut off, le rapport est conservé dans le catalogue mais ignoré au moment de l'envoi. Pratique pour mettre en pause un rapport pendant une fenêtre de maintenance sans perdre la configuration.

2. Planning​

ChampObligatoireDescription
Heure d'envoioui (défaut : 07:00)Heure de la journée à laquelle le rapport s'exécute. Heures / minutes ; les secondes sont ignorées.
Fuseau horaireoui (défaut : fuseau du serveur)Un fuseau IANA (par exemple Europe/Paris). Chaque rapport tourne dans son propre fuseau, ce qui permet à une installation multi-régions d'envoyer un rapport à 07:00 Paris et un autre à 07:00 New York.
Fenêtre d'analyseoui (défaut : hier et aujourd'hui = 1 jour)Profondeur de la collecte d'évènements. Valeurs : today (jour courant), 1 day (hier + aujourd'hui — la valeur par défaut), 7 days, 30 days, ou une valeur personnalisée N days. La fenêtre est glissante et se termine à l'heure d'envoi.

3. Filtre de sévérité​

Un petit groupe de pastilles identique à la barre d'outils des Erreurs d'intégration :

SévéritéQuand l'utiliser
AllL'équipe veut toutes les erreurs.
FATALUniquement les arrêts critiques du pipeline — typiquement le canal dev / astreinte.
ERRORLe jeu standard de production — échecs Schematron, rejets PA.
WARNINGAnomalies de moindre gravité qui ne bloquent pas la transmission (codes de TVA obsolètes, champs optionnels manquants).
INFOVerbeux — utilisé typiquement pour les rapports de diagnostic en gestion d'incident.

Choisissez une seule sévérité (ou All). Un rapport multi-sévérités correspond à deux lignes de rapport distinctes dans le catalogue.

4. Filtres d'égalité par colonne​

Le rapport porte une liste de paires (colonne, valeur) qui restreignent le jeu d'évènements. Les colonnes prises en charge sont les mêmes que celles disponibles à l'égalité depuis les List Views de la page Erreurs d'intégration :

ColonneExemple de valeurUsage courant
Société (KCO)00070Un rapport par société sur une installation multi-sociétés.
Code d'activitéISC, VRAC, BIPUn rapport par activité métier.
SourceEN16931, CIUSFR, FREXTIC, CPRO, XSD, UBL, INTEGEnvoyer le jeu de validations UBL à l'équipe template, le jeu d'intégration à l'équipe ops.
RègleBR-CL-23, UBL_CREATIONSurveiller une règle en échec précise.
Business unitMU-LYO, MU-PARRoutage par BU.

Les filtres se combinent en ET. Filtres vides = toutes les lignes. Ajouter deux valeurs sur la même colonne demande deux rapports.

À quoi ressemble l'email​

Le corps résume la période, les compteurs et un top 5 des règles en échec :

Corps de l'email du rapport quotidien
Subject: NomaUBL rapport quotidien — Comptabilité · ACME — 7 erreurs, 3 factures

Période :      sur 1 jour (2026-06-01 07:00 → 2026-06-02 07:00 Europe/Paris)
Filtres :      société = 00070, activité = ISC, sévérité = ERROR / FATAL
Évènements :   7
Factures :     3

Règles les plus en échec
  BR-CL-23    Le code devise doit suivre ISO 4217.                         5
  BR-FR-12    Le SIRET BT-46 doit être présent sur une facture B2B FR.     1
  PA_SEND     Soumission PA rejetée au niveau HTTP (timeout / 4xx / 5xx).  1

La liste complète des évènements est jointe (errors-2026-06-02.xlsx).

La pièce jointe est le même fichier Excel que celui exporté depuis l'onglet Vue détaillée des Erreurs d'intégration — chaque évènement de chaque facture dans le périmètre, avec des colonnes alignées sur le tableau.

Quand la période contient zéro erreur, le rapport est envoyé quand même avec un corps court aucune erreur sur cette période (sans pièce jointe). Les opérateurs ont demandé ce signal positif — savoir que le rapport s'est exécuté sans incident est en soi une information.

Comment il s'exécute​

Le planificateur est un démon interne à NomaUBL qui se réveille chaque minute et interroge le catalogue pour repérer les rapports dont la prochaine heure d'envoi vient de passer. La requête est rapide (le catalogue est petit) et sans état — l'horodatage du dernier envoi est enregistré sur la ligne elle-même.

ÉtatDescription
Activé = onLe prochain déclenchement de <heure d'envoi> dans <fuseau> collecte les évènements, construit l'Excel et envoie. Le badge dernier envoi de la ligne se met à jour.
Activé = offLa ligne du catalogue est ignorée à chaque tick.
Échec SMTPL'envoi est retenté au tick suivant (une minute plus tard) jusqu'à 5 tentatives ; au-delà, l'échec est enregistré dans le Journal de traitement avec l'erreur SMTP, et le rapport est marqué échec pour la journée. Renvoi manuel possible à tout moment via le bouton Envoyer maintenant.

L'exécution du rapport lit la configuration SMTP depuis la section smtp de Système → Global à l'échelle de la plateforme — le même SMTP qui alimente les Règles de notification et les notifications par facture. Vérifiez que ces identifiants fonctionnent avant de câbler un rapport quotidien.

Bouton Envoyer maintenant​

Chaque ligne du catalogue dispose d'un bouton Envoyer maintenant qui déclenche le rapport immédiatement, indépendamment de l'heure planifiée. La fenêtre, les filtres et la sévérité de la ligne sont utilisés tels quels. Pratique pour :

  • Vérifier un rapport après l'avoir créé ou modifié.
  • Pousser un envoi ponctuel après un incident — les mêmes données, envoyées maintenant au lieu d'attendre le tick suivant.

L'exécution Envoyer maintenant met aussi à jour le badge dernier envoi, ce qui n'empêche pas l'envoi planifié du jour de partir si l'horaire n'a pas encore été atteint.

Conseils et bonnes pratiques​

  • Un rapport par équipe, pas par destinataire. Un seul rapport avec trois adresses en copie coûte moins cher à maintenir que trois rapports avec une adresse chacun — les coupes s'alignent en général par équipe, pas par individu.
  • Gardez la fenêtre d'analyse courte. La valeur par défaut 1 day est habituellement la bonne. Une fenêtre 7 days revient à relire les mêmes erreurs chaque matin, ce qui dilue le signal.
  • Servez-vous du bouton Activé pour les fenêtres de maintenance. Mettre un rapport en pause pendant une coupure planifiée évite qu'un flot d'erreurs attendues n'atteigne les destinataires. Réactivez quand la fenêtre se ferme.
  • Envoyer maintenant est le test fumée. Après avoir créé ou modifié un rapport, cliquez sur Envoyer maintenant. L'email arrive en quelques secondes et confirme la configuration avant le prochain tick planifié.
  • Le routage par sévérité protège l'astreinte. Un rapport FATAL-uniquement vers le canal d'astreinte + un rapport ERROR vers l'équipe production est la configuration habituelle — l'astreinte n'est pas noyée sous le bruit Schematron.

Dépannage​

SymptômeCause probableCorrection
La ligne du rapport dans le catalogue est marquée échec.Rejet SMTP (authentification, relais refusé, rebond destinataire).Ouvrez le Journal de traitement, filtrez sur daily-digest, lisez l'erreur SMTP. Corrigez les identifiants Global → SMTP, puis cliquez sur Envoyer maintenant.
L'email est arrivé mais la pièce jointe est vide.Le jeu de filtres ne trouve aucun évènement correspondant dans la fenêtre d'analyse.Détendez un filtre (par exemple, retirez le code d'activité) ou étendez la fenêtre à 7 days ; cliquez sur Envoyer maintenant pour revérifier.
La pièce jointe contient des erreurs plus anciennes que la fenêtre d'analyse.La fenêtre d'analyse sélectionne d'abord les factures qui ont au moins une erreur dans la fenêtre, puis exporte toutes les erreurs de ces factures — c'est le même comportement que la Vue détaillée. C'est intentionnel.S'il vous faut un export strict à la fenêtre, faites-le manuellement depuis l'onglet Par évènement.
Deux destinataires reçoivent le même rapport en double.Deux lignes de rapport dans le catalogue ont des listes de destinataires qui se recoupent.Auditez le catalogue ; fusionnez ou dédoublonnez.
Le rapport part à la mauvaise heure.Le fuseau horaire pointe sur la mauvaise zone.Ouvrez le rapport, renseignez le bon fuseau IANA (Europe/Paris, Africa/Casablanca, …) et enregistrez.
Le formulaire a perdu les valeurs après Enregistrer. (2026.05.x)Corrigé en 2026.06.02.Mettez à jour vers la build courante — le formulaire se rafraîchit désormais depuis l'enregistrement fraîchement sauvegardé.

Pour aller plus loin​