E-Invoicing
L'écran E-Invoicing est la page principale de NomaUBL — le point d'entrée du workflow officiel de la Réforme de la Facturation Électronique (RFE). Il liste toutes les factures traitées par la plateforme et propose des filtres complets, une vue détaillée selon le statut, et les actions du quotidien : éditer, copier, supprimer, changer manuellement un statut, envoyer le PDF au client par e-mail, redéposer sur la Plateforme Agréée.
La page fonctionne quel que soit le système source — JD Edwards, SAP, NetSuite ou ERP personnalisé. Toutes les factures visibles ici ont été enregistrées dans la base NomaUBL locale après passage dans le pipeline de traitement.
Vue d'ensemble
Barre d'outils
La barre d'outils au-dessus du tableau combine filtre de dates, recherche texte, puces de statut et raccourcis.
Plage de dates
Le filtre de dates à gauche restreint la liste à une fenêtre de dates. Préréglage par défaut : Hier. Autres préréglages : Aujourd'hui, 7 derniers jours, Ce mois, Mois dernier et Plage personnalisée (saisie manuelle des dates de début et de fin).
La colonne sur laquelle la plage de dates est lue est choisie par le sélecteur Base de date — voir ci-dessous.
Base de date
Un sélecteur, à côté du filtre de période, choisit sur quelle colonne de date la période s'applique.
| Valeur | Colonne de date | Quand l'utiliser |
|---|---|---|
| Date de mise à jour (par défaut) | Dernière modification de la facture dans NomaUBL. | Exploitation au quotidien — comportement historique de la liste. |
| Date d'émission | Celle imprimée sur la facture (BT-2 du document UBL). | Rapprochement avec la page Déclaration de TVA ou avec un système externe indexé sur la date d'émission. |
| Date d'archivage | La date à laquelle le document a été traité dans l'archive. | Rapprochement avec la page Rapports et le Tableau de bord, qui proposent la même base Date d'archivage. |
Le choix est conservé pendant la session en cours — fermer la modale d'une facture et rouvrir la liste maintient la position du sélecteur. Le sélecteur est aussi positionné automatiquement quand la liste Factures est ouverte depuis un drill-down de la page TVA, donc le nombre affiché correspond à celui d'où l'on vient.
Filtres texte
Chaque champ filtre la liste à la saisie — la recherche se déclenche après une courte pause :
| Champ | Critère |
|---|---|
| Doc | Numéro de document interne (par ex. 12345). |
| Dct | Code du type de document (par ex. RI, RN). |
| Kco | Code société (par ex. 00070). |
| Contrat | Référence du contrat porté par la facture. |
| Nom du client | Nom de la partie acheteur. |
| Pays | Code pays ISO 3166 à deux lettres de la contrepartie (par ex. FR, DE). Pré-rempli automatiquement quand la page est ouverte depuis un drill-down de la Déclaration de TVA. |
Un filtre texte correspond depuis le début de la valeur et utilise l'index de la colonne : la liste reste rapide sur une grande table. Pour chercher un texte n'importe où dans la valeur, encadrez-le de signes pourcent — %acme% trouve acme où qu'il apparaisse, au prix d'un parcours complet. Le filtre Doc prend un raccourci : une valeur entièrement numérique recherche le numéro de document directement au lieu de parcourir. Les filtres sur les colonnes adossées à une liste de référence (statut, routage…) acceptent plusieurs valeurs à la fois — sélectionnez-en plusieurs et la liste affiche les lignes qui correspondent à l'une d'elles.
Sélecteur de routage BAR
Une déroulante distincte filtre par code BAR (B2B, B2G, B2BINT, B2C, OUTOFSCOPE, ARCHIVEONLY, DOCUMENT) — la classification de canal documentée dans UBL Defaults → Document Type / BAR Routing.
Puces de statut
À droite, une rangée de puces de statut affiche un badge par statut présent dans la plage de dates. Chaque puce indique le libellé du statut, son compteur et une couleur de famille. Cliquer sur une puce active un filtre sur la liste ; un nouveau clic le retire.
Effacer les filtres
Quand au moins un filtre est actif, une puce ✕ Effacer le filtre apparaît en fin de rangée. Elle efface tous les filtres sauf la plage de dates.
Débordement des pastilles de statut
La ligne de pastilles de statut est plafonnée à 5 pastilles inline ; le reste se replie dans un menu +N more avec un point coloré par code. Les drill-throughs multi-statuts depuis les tableaux de bord (par ex. En vol = 5 codes) remontent la valeur active dans le groupe inline quand elle tombe au-delà du plafond, donc le filtre actif reste visible.
Filtres avancés
Un panneau Filtres avancés pliable se trouve sous la rangée de pastilles. Il propose une ligne par colonne filtrable de la spec Vues de liste active — avec un sélecteur d'opérateur par colonne (contains, equals, ≠, <, ≤, >, ≥, between, empty, not empty). Les modifications restent en brouillon tant que Exécuter ne les valide pas, donc taper dans le panneau ne sature pas le back-end.
L'ensemble des colonnes filtrables est défini par la liste blanche filter: true de la spec — les opérateurs choisissent quelles colonnes ils interrogent réellement et retirent les autres du panneau sans les perdre dans la grille. Voir Vues de liste pour l'éditeur.
Depuis 2026.05.12, la page fonctionne en mode hybride client-side : chaque Exécuter charge une tranche capée depuis le serveur (spec.maxRows, 5000 par défaut) et TanStack gère filter / sort / paginate / group dans cette tranche — pas d'aller-retour quand on tape dans la ligne de filtre par colonne, les filtres survivent à la pagination. Quand le cap de la tranche est atteint, un message X / Y lignes à côté de Exécuter indique d'affiner la plage de dates ou les Filtres avancés.
Depuis 2026.05.13, les colonnes refList (Statut, statut e-reporting, listes personnalisées) reçoivent un picker multi-sélection dans le panneau Filtres avancés et dans la ligne de filtre par colonne — choisir un nombre quelconque de codes, le déclencheur affiche N sélectionné(s) au-delà du plafond inline, et un ✕ à droite réinitialise la sélection en un clic. Le serveur applique une clause IN (?,?,?) — choisir trois statuts renvoie l'union.
Chip Direction
Une nouvelle rangée de chips s'installe à côté des chips Statut : Toutes / Émises / Reçues.
| Chip | Effet |
|---|---|
| Toutes (défaut) | Aucun filtre direction — les factures émises au client (UHDRIN = '2') et reçues du fournisseur (UHDRIN = '1') sont listées ensemble. |
| Émises | Seules les factures envoyées par l'opérateur aux clients. Même périmètre que la liste avant 2026.05.17. |
| Reçues | Seules les factures fournisseur récupérées depuis la PA (voir Synchronisation → Fetch Input → PA entrante et le modèle de document livré received-ubl). |
Le chip s'appuie sur l'indicateur UHDRIN enregistré sur chaque ligne — un changement de Direction sur un modèle ne re-classe pas les lignes historiques, le résultat reste donc stable dans le temps.
Sur une ligne Reçue, la colonne Contrepartie lit depuis AccountingSupplierParty (le fournisseur), pas depuis AccountingCustomerParty — la colonne affiche donc le nom du fournisseur sur les factures entrantes et le nom du client sur les sortantes. Le cycle de vie, la modale de détail et le catalogue de colonnes sont par ailleurs identiques ; seules les actions vendeur (Renvoyer à la PA, Marquer envoyée, Avoir…) sont masquées sur les lignes Reçues.
Exclure les erreurs traitées
Le bouton Exclure les erreurs traitées, à côté du sélecteur de direction, masque les lignes déjà marquées Traité qui restent dans un statut en erreur (groupes errorTech / errorBusiness du modèle des statuts) : la liste ne garde que les erreurs que personne n'a encore regardées. Les lignes traitées dans tout autre statut restent affichées. Le bouton est activé automatiquement quand la liste s'ouvre depuis une tuile du Tableau de bord où il l'était. L'endpoint GET /api/invoices accepte le même filtre avec excludeReviewedErrors=true.
Rafraîchir et Nouvelle facture
Deux boutons sont placés à droite :
| Bouton | Comportement |
|---|---|
| Rafraîchir (flèche circulaire) | Relance la requête courante sans modifier les filtres. |
| + Nouvelle facture | Ouvre la modale de création / d'édition de facture. Masqué pour les sessions en lecture seule. |
Liste des factures
Le tableau affiche une ligne par facture. Tri par défaut : numéro de document décroissant. Cliquer sur un en-tête de colonne pour trier.
Depuis 2026.05.10, la grille passe par DataTableV2 en mode piloté par spec : la forme des colonnes — libellés, format, alignement, largeur et la liste blanche de filtres — vient de la spec view.invoices stockée sur db-nomaubl (avec un défaut embarqué dans le JAR). Ajouter ou retirer des colonnes se fait depuis l'éditeur Vues de liste — aucune modification de code n'est nécessaire quand la colonne vit déjà dans le catalogue.
La valeur Mise à jour porte l'heure : une colonne Mise à jour au format datetime dans la spec affiche 2026-09-15 15:23:45 au lieu de la seule date. (La date d'émission reste sans heure — JDE n'en stocke pas pour elle.)
Colonnes par défaut
| Colonne | Description |
|---|---|
| Doc | Numéro de document interne. |
| Dct | Type de document. |
| Kco | Code société. |
| Numéro UBL | Numéro de facture tel qu'il apparaît dans le document UBL généré. Filtrable depuis le panneau Filtres avancés et via le paramètre d'URL ?ublNumber=, en plus de la zone de recherche texte. |
| Date d'émission | BT-2 issu du document UBL. |
| Client | Nom de la partie acheteur. |
| Pays | Code pays ISO 3166 à deux lettres de la contrepartie (FR, DE, BE, US…). Capturé à l'insertion depuis le UBL — pays de l'acheteur pour les ventes, du fournisseur pour les achats. Pilote la classification par zone utilisée par la page Déclaration de TVA. |
| Total HT | Montant total hors taxes. |
| Total TTC | Montant total toutes taxes comprises. |
| Devise | Code ISO 4217. |
| Statut | Badge de statut — code + libellé, coloré par famille. |
| Suivi | Badge de suivi coloré — En attente (du service client) ou Traité. Allumé quand la ligne demande une attention opérateur — un statut que le dispatcher n'a pas su résoudre tout seul, une édition manuelle marquée à l'enregistrement, ou un système aval qui a balisé la ligne pour vérification. Il s'allume aussi pour une facture Déposée (200) avec le motif NON_TRANSMISE : pas une erreur, mais le destinataire n'a pas d'adresse de réception active, l'opérateur doit donc la transmettre manuellement — les autres 200 gardent un tiret discret. Une facture corrigée à la main — enregistrée depuis la fenêtre facture ou réparée avec Corriger destinataire — passe à Traité dès que la validation qui suit ne signale aucune erreur, quel que soit son statut. Vide quand rien n'est en attente : quelques badges dans une page sinon nette indiquent précisément par où commencer. |
Un sélecteur de taille de page en bas du tableau est réglé sur 50 par défaut ; des valeurs jusqu'à 500 sont acceptées. Le nombre total de factures correspondant aux filtres apparaît à côté de la pagination.
Colonnes du catalogue
La requête SQL de la vue Factures joint maintenant F564231 (UH) et F564230 (FE) sur doc / dct / kco via un LEFT JOIN, donc le catalogue de colonnes comporte 16 colonnes archive / journal supplémentaires. Toutes peuvent être ajoutées à la spec depuis le picker + Ajouter une colonne de l'éditeur Vues de liste — la jointure gauche préserve les lignes factures sans entrée de journal.
| Colonne catalogue | Contenu |
|---|---|
logSourceFile | Nom du fichier source qui a produit la facture. |
logActivityCode / logSubType | Code d'activité et sous-type enregistrés à l'ingestion. |
logAlphaKey | Alias alpha-key utilisé par certains systèmes amont. |
logAmount | Montant porté par la ligne de journal (brut, sans rebase de devise). |
logInvoiceDate / logDueDate | Date de facture et date d'échéance enregistrées à l'ingestion. |
logCreated | Horodatage de création (composite UPMJ + UPMT). |
logUser / logJobn / logPid / logVersion | Tampons utilisateur, job, PID et version JDE. |
logBusinessUnit | Unité d'activité enregistrée à l'ingestion. |
logRouting | Routage BAR enregistré à l'ingestion. |
logSendToPaFlag | Flag capturé à l'ingestion qui indique l'éligibilité de la ligne au dépôt PA. |
logPaUuid | UUID côté PA assigné à la facture au moment du dépôt. |
Navigation au clic
Cliquer sur une ligne ouvre la modale de détail de la facture. La plupart des actions sont unitaires, mais la liste permet aussi un renvoi groupé — voir ci-dessous.
Renvoi groupé
Chaque ligne porte une case à cocher, et un bouton Renvoyer la sélection (N) apparaît dans la barre d'outils dès qu'au moins une ligne est cochée. Il renvoie tout le lot vers la Plateforme Agréée en une seule action, via la même fenêtre de progression qu'ailleurs (compteurs en direct, Annuler, Continuer en arrière-plan). Seules les factures réellement transmissibles sont sélectionnables — les lignes dont le type de document est réglé sur Ne pas envoyer sont désactivées, pour qu'une facture non transmissible ne se glisse pas dans un lot par erreur. Pour la même raison, l'action Renvoyer unitaire est masquée sur les lignes Ne pas envoyer.
Retraitement
Un bouton Retraiter la sélection (N) apparaît à côté de Renvoyer la sélection quand les lignes cochées comprennent des factures concernées par le retraitement. Le retraitement reconstruit une facture à partir du XML JDE archivé lors du premier dépôt — en régénérant la facture électronique, le PDF et le XML — pour une facture déposée sans être transmise par la plateforme (statut 200, motif NON_TRANSMISE). La facture conserve son statut, une entrée Retraitement est ajoutée à son historique, rien n'est renvoyé à la plateforme, et chaque facture n'est retraitée qu'une fois. Seules les factures d'un modèle avec Allow reprocess activé (un modèle à source XML — voir Documents) sont concernées ; les autres sont ignorées dans la sélection. Le même traitement est disponible depuis le Tableau de bord IT et la ligne de commande.
Export
Un bouton Exporter dans la barre d'outils exporte la vue courante (filtres compris) au format CSV sous le nom invoices.csv.
Modale de détail
Cliquer sur une ligne ouvre une modale qui contient sept onglets en haut : Résumé, Parties, Lignes, TVA, Notes, Historique, PDF. Le titre de la modale affiche le triplet DOC / DCT / KCO. Un bouton plein écran dans l'en-tête bascule entre vue fenêtrée et vue plein écran.
Des flèches précédent / suivant (et les touches ← →) dans l'en-tête passent d'une facture à l'autre de la liste sans fermer la fenêtre — même ordre et mêmes filtres que le tableau affiché — avec un indicateur de position (par ex. 3 / 50). Après la dernière facture, la navigation reboucle sur la première.
Onglet Résumé (défaut)
L'onglet Résumé affiche un badge de statut coloré en haut, suivi des boutons d'action (Modifier l'UBL, Copier, Supprimer) à droite. Juste sous le badge, quand la plateforme les a renvoyés, le motif de rejet, l'action attendue et la note de statut courants s'affichent en ligne, et le message de statut complet se trouve dans un groupe replié — à déplier pour le texte d'erreur long de la plateforme. Ces mêmes valeurs alimentent les actions personnalisées via les variables {message}, {reasonLabel}, {actionLabel} et {actionNote} (voir Actions), sans colonne de vue de liste à configurer.
Corriger destinataire
Les rejets PA les plus fréquents portent sur les identifiants de l'acheteur — SIREN (BT-47), SIRET (BT-46), TVA intracommunautaire (BT-48) et adresse électronique (BT-49). Un bouton Corriger destinataire ouvre un formulaire compact pré-rempli depuis l'UBL stocké, avec la recherche d'entreprises INSEE et le sélecteur d'adresses électroniques du PPF, pour corriger uniquement ces champs sans rééditer toute la facture. Seuls les identifiants modifiés sont remplacés dans l'UBL stocké — le reste du document est intact — puis la facture est revalidée immédiatement, un événement d'audit trace les anciennes et nouvelles valeurs dans l'historique, et une option renvoie à la PA si la validation réussit. Le bouton n'apparaît que tant que la facture est encore corrigeable — avant sa prise en charge par la PA, ou quand elle a été rejetée (213) pour un motif d'adressage : ADR_ERR, REJ_ADR (contrôle d'adressage de la plateforme) ou DEST_INC (destinataire inconnu de l'annuaire). Dans ces trois cas, la facture n'est jamais parvenue au client, le renvoi est donc sans risque ; tout autre statut traité par la PA reste verrouillé. Une réparation dont la validation ne signale aucune erreur marque aussi la facture Traité dans la liste. L'adresse électronique de l'acheteur (BT-49) conserve le schéma déjà présent dans le document — 0225 à défaut. La correction est tracée par une simple entrée d'historique (Identifiants acheteur corrigés), sans redéclencher la règle de notification du statut courant, et le résultat de la nouvelle validation (9901 / 9902) s'ajoute à l'historique dès qu'il diffère du dernier événement. Les clés client enregistrées sur la ligne (clé alpha, numéro client) sont conservées ; il en va de même pour un enregistrement depuis la fenêtre de modification. Des garde-fous de format (longueur et cohérence SIREN/SIRET, forme de la TVA) et la règle de protection PA s'appliquent — les mêmes contrôles que l'endpoint POST /api/invoices/{doc}/{dct}/{kco}/fix-buyer de la référence API.
Sous le statut, quand la facture est dans un statut qui demande une action côté vendeur (par ex. 205, 206, 207, 208, 210, 213, 9904, 9907), un bandeau bleu Actions vendeur propose les actions recommandées :
Correspondance statut → actions :
| Statut | Actions suggérées |
|---|---|
| 205 Payée | Marquer paiement reçu |
| 206 Approuvée partiellement / 207 En litige | Émettre un avoir, Émettre une facture rectificative |
| 208 Suspendue | Marquer envoi terminé |
| 210 Refusée | Annuler comptable |
| 213 Rejetée | Annuler comptable, Émettre une nouvelle facture |
| 9904 Erreur d'envoi / 9907 Rejet PA | Redéposer sur PA |
Chaque action est rattachée à un endpoint de connecteur API configuré dans Configuration → API Connectors. Un clic exécute le connecteur avec les données de la facture. Une action grisée signifie que le connecteur n'est pas configuré sur ce déploiement.
Depuis 2026.05.15 un second groupe se trouve sous le groupe réglementaire — Actions personnalisées. Boutons toujours visibles configurés sur la page Actions ; chacun déclenche sa propre chaîne d'appels connecteur et reste indépendant du statut courant de la facture. Le bandeau de résultat est rattaché au groupe dont le bouton a déclenché la chaîne — un échec d'action personnalisée n'écrase pas le bandeau d'une action réglementaire affichée en même temps, et les bandeaux périmés sont effacés automatiquement quand la modale se ferme ou change de facture.
Le reste de l'onglet Résumé se présente sous forme de groupes dépliables :
- Document — DOC / DCT / KCO, numéro UBL, type de facture, profile ID, références contrat / acheteur / commande / projet, référence comptable.
- Dates et devise — date d'émission, date d'échéance, devise, période de début / fin.
- Montants — total HT, total TTC, montant à payer.
- Paiement — code de moyen de paiement, IBAN, nom du compte, BIC, identifiant de paiement, conditions de paiement.
- Remises / charges au niveau document — remises ou charges au niveau du document avec type, motif, montant, catégorie de TVA.
Onglet Parties
Trois groupes dépliables remplis à partir du document UBL :
- Fournisseur — nom, SIREN, SIRET, identifiant à la TVA, adresse électronique, adresse postale, contact (nom, téléphone, e-mail).
- Client — nom, identifiant société, adresse électronique, TVA, adresse, contact.
- Agent Party (facultatif) — pour l'extension française — nom, adresse, pays.
- Livraison (facultatif) — date, nom de la partie, identifiant de lieu, adresse.
Un groupe sans donnée n'apparaît pas.
123 456 789123 456 789 00012FR121234567890009:1234567890001275001 Paris · FR
987 654 321FR989876543210009:9876543210001569002 Lyon · FR
2026-04-260088:301234560000369800 Saint-Priest · FR
Onglet Lignes
Tableau des lignes de facture : une ligne principale par ligne, plus des sous-lignes qui détaillent les compléments présents dans le document UBL.
| Colonne | Description |
|---|---|
| Description | Texte libre décrivant l'élément facturé. |
| Item | Identifiant article (code, SKU). |
| Quantité | Quantité facturée. |
| Unité | Code unité de mesure (par ex. EA pièce, H87 unité, DAY jour, KGM kilogramme). |
| Prix unitaire | Prix unitaire hors taxes. Affiché à sa précision réelle — jusqu'à 6 décimales (BT-146), au plus près de la source. La norme EN 16931 autorise une précision plus fine sur le prix que sur les totaux monétaires, qui restent à 2 décimales. |
| Montant ligne | Quantité × prix unitaire (hors taxes). |
| Catégorie de taxe | Code de catégorie TVA UBL (S standard, AE autoliquidation, E exonéré, Z taux zéro, O hors champ, K intra-UE, G export, L Canaries, M Ceuta/Melilla). |
| Taux de taxe | Taux de TVA applicable, en pourcentage. |
Des sous-lignes apparaissent sous chaque ligne principale pour :
- Description de l'article
- Période (début → fin)
- Identifiants article acheteur / standard / classification
- Note de ligne (
BT-127) - Remise / charge au niveau prix (
BT-147) - Remises / charges au niveau ligne (
BG-27/BG-28) - Propriétés additionnelles d'article (
BG-32)
Quand plusieurs lignes partagent la même livraison, les mêmes références documentaires (BT-128) ou le même numéro de commande client (EXT-FR-FE-135), un en-tête de livraison, un en-tête de référence documentaire ou un en-tête Référence Cde Client apparaît une seule fois en haut du groupe, au lieu d'être répété sur chaque ligne.
Onglet TVA
Tableau des sous-totaux TVA présents dans le document UBL : code de catégorie, taux, base imposable, montant de TVA, devise, code et libellé d'exonération (le cas échéant).
Onglet Notes
Notes au niveau document (BT-22). Chaque note s'affiche sous forme de carte avec un badge de préfixe (par ex. PMD, PMT, REG) suivi du texte libre. Le libellé du préfixe vient de la liste de référence note-types ; survoler le badge l'affiche.
Onglet Historique
Trois sections dans cet onglet :
Barre d'actions en haut
| Bouton | Comportement |
|---|---|
| Valider l'UBL | Relance la validation XSD + Schematron sur le document UBL stocké en base. Le résultat (valide / avertissement / erreur) s'affiche en ligne, avec le détail si nécessaire. |
| Modifier le statut | Ouvre la modale de modification de statut — voir plus bas. |
| Renvoyer | Redépose le document UBL sur la Plateforme Agréée. Une confirmation est demandée avant exécution. |
Groupe Cycle de vie
Le cycle de vie est la trace d'audit de tous les statuts traversés par la facture. Chaque événement affiche :
- Le badge de statut (code + couleur de famille).
- Le libellé du statut et le message renvoyé par la plateforme.
- Pour les refus, détails facultatifs : code et libellé du motif de rejet, code et libellé de l'action attendue, note de statut additionnelle.
Le cycle de vie est en mode ajout seul — les événements sont créés par le job Synchronisation → Récupérer les statuts et ne sont jamais modifiés. Chaque événement porte toutefois un bouton supprimer (avec confirmation) : retirer un événement réaligne le statut de la facture sur le dernier restant — la correction manuelle propre quand la plateforme a livré un statut parasite (une Refusée qu'elle a ensuite dépassée, par exemple). Réservé par une action dédiée Supprimer l'événement de cycle de vie dans les rôles.
Les trois champs de refus — motif de rejet, action attendue et note de statut — figurent aussi dans le catalogue de colonnes : on peut les épingler comme colonnes de liste et les filtrer depuis l'éditeur de Vues de liste quand une équipe doit balayer ou trier par motif de refus sans ouvrir chaque facture.
RR-016 — Quantité non conforme à la livraisonAC-04 — Émettre une facture rectificativeGroupe Erreurs de validation
Liste les erreurs de validation (XSD / Schematron) enregistrées sur cette facture. Chaque ligne donne la sévérité, l'identifiant de la règle et le message correspondant. Vide quand la facture passe sans erreur.
Onglet PDF
L'onglet PDF affiche un PDF de la facture généré à la volée (vue <iframe>). En bas de l'onglet :
| Bouton | Comportement |
|---|---|
| Ouvre la modale d'envoi d'e-mail avec le PDF déjà attaché. | |
| Télécharger | Télécharge le PDF sur l'ordinateur local. |
Modales d'action
Modale de modification de statut
Ouverte depuis le bouton Modifier le statut de l'onglet Historique. Permet de placer manuellement la facture sur un statut donné — utile pour corriger une erreur ou pour forcer une transition que la plateforme n'a pas remontée.
| Champ | Description |
|---|---|
| Cible | PA (envoie une mise à jour de statut à la Plateforme Agréée) ou DB (écrit le nouveau statut directement en base locale, sans notification PA). |
| Statut | Liste déroulante de tous les statuts de la liste de référence statuses, avec code + libellé. |
| Date du statut (PA uniquement) | Date / heure de l'événement. Défaut : maintenant. |
| Motif | Motif libre. Pré-rempli avec le libellé du statut ; modifiable. |
| Code et libellé du motif de rejet (le cas échéant) | Code issu de la liste rejection-reason-codes, plus sa traduction. |
| Code et libellé de l'action (le cas échéant) | Code issu de la liste action-codes, plus sa traduction. |
Quand Cible = DB est sélectionné, un encart orange rappelle que la modification est locale uniquement et ne sera pas propagée vers la PA.
Cliquer sur Soumettre pour appliquer. Un bandeau vert confirme le succès et la modale se ferme peu après.
Modale d'envoi d'e-mail
Ouverte depuis l'onglet PDF. Permet d'envoyer le PDF de la facture au client par SMTP, avec les identifiants configurés dans le template global.
| Champ | Description |
|---|---|
| À (obligatoire) | Adresse e-mail du destinataire. |
| Cc | Copie facultative. |
| Objet | Pré-rempli avec Invoice <ublNumber> ; modifiable. |
| Corps | Pré-rempli avec un modèle français ou anglais selon la langue de l'utilisateur : salutation, ligne principale qui référence le numéro de facture et le total, ligne de contact, signature. Entièrement modifiable. |
Le PDF affiché dans l'onglet PDF est attaché automatiquement. Si le PDF n'a pas été pré-chargé, le serveur le récupère depuis la base avant l'envoi.
Pendant l'envoi, la modale est désactivée par un voile jusqu'à la confirmation du serveur SMTP. Un bandeau vert confirme l'envoi ; la modale se ferme automatiquement après ~2 s.
Modale de création / édition de facture
Ouverte depuis + Nouvelle facture dans la barre d'outils, ou depuis les boutons Modifier l'UBL / Copier de l'onglet Résumé. Permet de créer une facture vierge ou de modifier une facture existante. La modale prend l'apparence d'une facture imprimable. L'utilisateur remplit le formulaire ; à l'enregistrement, NomaUBL génère le document UBL correspondant.
Depuis 2026.05.10, modifier une facture existante ne réinitialise plus son cbc:CustomizationID au défaut EN16931. Le formulaire porte maintenant la valeur customizationId du UBL source et l'écrit verbatim — les nouvelles factures restent par défaut à urn:cen.eu:en16931:2017.
La modale est divisée en sections verticales :
- Document — numéro, type de facture, profile ID, références contrat / acheteur / commande.
- En-tête — dates d'émission / échéance, devise, période de début / fin, ainsi qu'un bloc Factures antérieures (BG-3, 0..n) : chaque ligne un numéro de référence (BT-25) et une date d'émission facultative (BT-26), avec ＋ Ajouter une facture antérieure (BG-3). Sur un avoir, c'est la référence à la facture corrigée.
- Fournisseur — alimenté depuis l'annuaire des fournisseurs (UBL Defaults → Suppliers / Companies) ; modifiable par facture.
- Client — renseigné de bout en bout depuis la recherche d'entreprise : les résultats affichent le badge, le nom et l'identifiant sur une ligne, l'adresse en dessous ; une recherche par SIREN ou SIRET seul liste tous les établissements (même seconde interrogation INSEE que l'E-Directory), et un champ SIRET facultatif complète le SIREN. L'adresse électronique n'est pas déduite du SIREN/SIRET — une liste d'adresses électroniques du PPF (ouverte automatiquement après le choix d'une entreprise, ou à tout moment via le bouton à côté du champ identifiant) présente les adresses enregistrées pour le SIREN avec leur état actif/désactivé ; en choisir une renseigne l'identifiant et son schéma, puis la liste se referme. Un bloc Autres id. (BT-46) ajoute autant d'identifiants acheteur supplémentaires que voulu, chacun avec son schéma de la liste EAS — un code de routage ou un second SIRET porté par le document devient visible, modifiable et supprimable au lieu de voyager de façon invisible.
- Livraison — groupe livraison facultatif au niveau du document (BG-13). Seule la livraison saisie au niveau document y apparaît ; les livraisons portées par les lignes restent sur les lignes et ne remontent jamais dans l'en-tête.
- Paiement — code de moyen de paiement, IBAN, BIC, mandat, conditions.
- Remises / charges — remises / charges au niveau document.
- Notes — notes libres par préfixe
BT-22. - Lignes — lignes de facture avec article, quantité, unité, prix, remises, propriétés. Le champ Prix unitaire accepte une précision fine (jusqu'à 6 décimales), pour les prix qui en portent plus de 2 à la source. Un bloc Prix (BG-29) par ligne fixe le prix unitaire brut (BT-148) et la remise sur prix (BT-147) ; le prix net en est déduit et pilote le montant de ligne, lequel divise par la quantité de base (BT-149) — un prix pour 100 ou 1 000 unités est ainsi calculé correctement. Le bloc Références de la ligne porte aussi des références de facture antérieure par ligne (EXT-FR-FE-136) — numéro, date facultative et un DocumentStatusCode choisi parmi
INFORMATION/DETAIL/GROUP. Trois boutons rapides du même bloc renseignent les références de commande de la ligne, toutes portées parcac:OrderLineReference: Référence Cde Client (numéro de commande de l'acheteur, EXT-FR-FE-135 — la clé de regroupement des lignes sur le PDF), Numéro de commande (numéro de commande du vendeur, EXT-FR-FE-144) et N° ligne client (numéro de la ligne dans la commande de l'acheteur, BT-132). - Récapitulatif TVA — calculé automatiquement depuis les lignes (lecture seule — les modifications de ligne s'y reflètent).
- Totaux — calculés automatiquement (lecture seule).
Le bouton Enregistrer en bas valide la saisie, écrit en base, génère le document UBL et le dépose sur la PA selon les paramètres du template e-invoicing. La modale se ferme après un enregistrement réussi.
Un bouton plein écran dans l'en-tête bascule entre fenêtré et plein écran — pratique pour les factures qui ont beaucoup de lignes.
Confirmation de redépôt
Le bouton Renvoyer (dans l'onglet Historique, ou via le bandeau Actions vendeur sur les statuts 9904 / 9907) ouvre une confirmation avant de redéposer le document UBL sur la Plateforme Agréée. Après confirmation, la facture est redéposée. Un bandeau en ligne affiche le succès ou l'erreur renvoyée par la PA. Le cycle de vie est mis à jour pour refléter le nouveau dépôt.
Conseils & bonnes pratiques
- Commencer par la plage de dates. Hier (défaut) convient au pointage du matin ; Plage personnalisée couvre la clôture mensuelle. Les autres filtres s'appliquent en plus.
- Les puces de statut sont le filtre le plus rapide. Une puce rouge à compteur non nul est en général le bon point de départ pour traiter les exceptions.
- Le cycle de vie (onglet Historique) est la source de vérité. Il enregistre tous les statuts traversés, avec messages, motifs de rejet et actions attendues — c'est l'endroit pour instruire un litige ou retrouver une décision côté PA.
- Utiliser le bandeau Actions vendeur. Les actions proposées sur
205/206/207/208/210/213/9904/9907sont les étapes recommandées par la plateforme. Elles ramènent un workflow multi-étapes (retrouver le client, rédiger l'avoir, etc.) à un seul clic, à condition que le connecteur soit configuré. - N'utiliser Modifier le statut qu'en cas de besoin. Un Modifier le statut → DB manuel désynchronise le dossier local de la PA. À réserver aux nettoyages après restauration de sauvegarde ou aux statuts non couverts par le job de cycle de vie.
- Modifier l'UBL puis Enregistrer est la méthode standard pour corriger une facture — l'enregistrement réécrit la facture en base et la redépose sur la PA. Éviter d'éditer directement le XML source via Outils UBL → XML Viewer, sauf si le fichier sur disque est la source de référence.
- Utiliser Copier pour la facturation récurrente. La modale est pré-remplie avec toutes les parties, les lignes et la TVA ; seuls le numéro, les dates et les éventuels écarts restent à modifier.