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.
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). |
| Recipient not found | Warn and send (default) / Block the send — invoice stops at validation failed | Comportement quand le contrôle ne trouve pas le destinataire. Warn : l'absence est enregistrée comme anomalie de niveau avertissement DIRECTORY_CHECK et la facture part. Block : sur une facture destinée à la plateforme, une réponse définitive — destinataire non inscrit, ou trouvé mais non joignable — ou une adresse électronique absente (EndpointID) est une anomalie bloquante ; la facture s'arrête en échec de validation (9905) et n'est pas envoyée. Une erreur de connecteur ou de réseau reste un avertissement dans les deux modes, et les factures paramétrées pour ne pas être envoyées ne sont jamais bloquées. |
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. |
Recherche Peppol
Réglages de la recherche Peppol de la page E-Directory, pour les serveurs placés sur un réseau restreint (voir Flux réseau).
| Champ | Défaut | Description |
|---|---|---|
| Resolve platform via SMP | Y | Y lit le nom et l'identifiant de siège de la plateforme dans le certificat de son SMP — HTTPS vers le SMP de chaque plateforme. N s'arrête à la réponse du SML : la colonne Plateforme affiche l'hôte SMP (par ex. smp.pennylane.com), sans appel à attendre. Choisir N quand le réseau n'autorise pas le HTTPS vers les SMP des plateformes. |
| Public DNS fallback | N | N n'utilise que le résolveur du serveur. Y relance les interrogations SML via 8.8.8.8 / 1.1.1.1 quand ce résolveur ne répond pas. Garder N quand le réseau interdit les résolveurs externes. |
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 utilise 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 utilise 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.