E-Directory
L'éditeur E-Directory configure deux services complémentaires que NomaUBL utilise pour valider les informations destinataire avant de produire une facture électronique :
- Annuaire PPF (Portail Public de Facturation) — vérifie que le code adressage électronique porté par le document existe et est actif dans l'annuaire public de la facturation électronique.
- Recherche INSEE — interroge une entreprise par raison sociale, SIREN ou SIRET pour récupérer ses données d'identification officielles (raison sociale, adresse, statut d'immatriculation…).
Les deux opérations s'enchaînent généralement : une recherche INSEE résout les identifiants du client, puis la vérification dans l'annuaire PPF confirme que le code adressage figurant sur le document est valide pour ce client.
La page fonctionne quel que soit le système source — JD Edwards, SAP, NetSuite ou ERP personnalisé — une fois la source mappée vers UBL.
La configuration PA est désormais homogène entre e-invoicing, e-directory et e-reporting — chaque modèle système référence un api-connecteur réutilisable au lieu de porter ses propres champs d'authentification et endpoints. Les anciens groupes inline API Connection et Credentials sont supprimés (sans repli). L'éditeur passe à deux onglets : Directory (Enable Check + INSEE Search) et Connector (sélecteur api-connecteur + surcharges d'endpoint par tâche). L'ppf-directory embarqué couvre le flux standard.
L'éditeur comporte deux onglets :
- Directory — sélecteur Enable Check et paramètres de recherche INSEE.
- Connector — choix de l'api-connecteur qui porte le transport PPF, plus surcharges de noms d'endpoint par tâche.
Accès à l'éditeur
- Paramètres → modèle e-directory (la ressource au niveau système).
Vue d'ensemble
Onglet 1 — Directory
Vérification d'annuaire (Directory Check)
| Champ | Valeurs | Description |
|---|---|---|
| Enable Check | Y / N | Quand cette option est activée, NomaUBL interroge l'annuaire PPF avant l'envoi de chaque facture pour vérifier que le code adressage électronique du document existe et est actif dans l'annuaire public. À désactiver pour ignorer la vérification (utile en test). |
Recherche INSEE
| Champ | Défaut | Description |
|---|---|---|
| Results per page | 10 | Nombre maximal de résultats renvoyés par requête de recherche INSEE. Augmenter pour élargir chaque page de résultats, diminuer pour limiter la taille des réponses réseau. |
Onglet 2 — Connector
Le transport HTTP de l'annuaire PPF — flux d'authentification, base URL, endpoints — vit dans un api-connecteur réutilisable. Cette page le référence par son nom uniquement et ne porte jamais de champ d'auth ni d'endpoint HTTP en ligne. L'ppf-directory embarqué couvre le flux standard ; choisir un connecteur personnalisé quand l'annuaire expose un schéma d'auth non standard ou route via une passerelle tenant.
api-connecteur
| Champ | Description |
|---|---|
| Connector | Liste déroulante des templates api-connector. Le connecteur sélectionné porte le baseUrl de l'annuaire, l'authType, les identifiants, l'endpoint de jeton et le catalogue d'endpoints HTTP. Modifier le connecteur lui-même sous Connecteurs API. |
Surcharges d'endpoint par requête
Quand l'api-connecteur expose des noms d'endpoint différents des défauts, saisir une surcharge ci-dessous. Laisser vide pour utiliser le nom par défaut affiché.
| Champ | Défaut | Utilisé par |
|---|---|---|
| Directory check | directory-check | Vérification générique (quand le document porte déjà l'identifiant de routage). |
| Directory check (SIREN) | directory-check-siren | Branche de recherche quand seul un SIREN est connu. |
| Directory check (SIRET) | directory-check-siret | Branche de recherche quand un SIRET est connu. |
Conseils & bonnes pratiques
- Garder Enable Check activé en production. L'envoi d'une facture avec un code adressage inactif ou inconnu provoque un rejet en aval par la Plateforme Agréée destinataire.
- Utiliser la recherche INSEE pour amorcer les fiches clients. Une requête par SIREN / SIRET évite les erreurs de saisie et aligne les données NomaUBL sur le registre officiel.
- Modifier les timeouts et les paramètres TLS sur l'api-connecteur lui-même. Les paramètres au niveau HTTP vivent sur la page Connecteurs API, pas ici — un même connecteur peut servir plusieurs pages, le timeout et le drapeau SSL Verify se règlent une seule fois.
- Ne jamais désactiver SSL Verify en production. Cette désactivation expose les identifiants et les métadonnées des documents à des attaques man-in-the-middle. À régler sur l'api-connecteur, pas ici.
- Le connecteur PPF est embarqué. Une installation neuve ship déjà un connecteur
ppf-directoryqui pointe sur les endpoints standards — choisir le connecteur dans la liste déroulante suffit. Les connecteurs personnalisés ne sont utiles que pour des transports non standards.