Connecteur générique AFNOR pour toute PA

La réforme de la facturation électronique a fait émerger un écosystème de plus de 137 Plateformes Agréées (PA) immatriculées par la DGFiP. Aucun logiciel de facturation ne peut raisonnablement maintenir un connecteur dédié pour chacune. Facturino résout le problème autrement : un connecteur générique conforme à la norme AFNOR XP Z12-013 qui se branche sur n'importe quelle PA exposant l'API standard d'interopérabilité — sans une ligne de code, sans attendre un connecteur dédié.

Le problème : 137+ PA, une seule à connecter (la vôtre)

Dans le modèle BYOPA (Bring Your Own PA) de Facturino, vous gardez la maîtrise de votre compte chez la Plateforme Agréée de votre choix, et Facturino s'y connecte en votre nom. Nous maintenons des connecteurs dédiés pour les PA developer-first les plus utilisées :

• Super PDP — API-first, tarifs publics
• Iopole — certifié SecNumCloud
• B2Brouter — multi-format, staging ouvert
• Seqino — certifié SecNumCloud

Mais que se passe-t-il si votre PA n'est pas dans cette liste ? Historiquement, la réponse d'un éditeur serait « attendez qu'on développe le connecteur ». Chez Facturino, la réponse est : connectez-la vous-même.

La solution : une norme d'interopérabilité commune

Pour que les Plateformes Agréées puissent s'échanger des factures entre elles, elles doivent parler un langage commun. Ce langage, c'est la norme AFNOR XP Z12-013 : elle définit l'API standard qu'une PA expose pour recevoir, transmettre et suivre des factures électroniques.

C'est exactement là-dessus que s'appuie le connecteur générique de Facturino. Là où un connecteur dédié parle le dialecte propriétaire d'une PA, le connecteur AFNOR parle la langue commune — la même API partout. Résultat : toute PA conforme XP Z12-013 est connectable, et le vivier grandit à mesure que les plateformes publient leur API normée (l'interopérabilité étant obligatoire, elles y viennent toutes).

Sous le capot : deux services normés

La norme XP Z12-013 organise l'API d'une PA autour de deux services, que le connecteur Facturino implémente intégralement :

Flow Service — l'échange de documents

C'est le cœur : déposer un flux (facture, avoir, événement de cycle de vie), rechercher les flux entrants, et télécharger un document par son type. Facturino dépose chaque facture finalisée via un appel POST /v1/flows multipart combinant les métadonnées du flux (flowInfo) et le fichier Factur-X / CII généré.

Directory Service — l'annuaire

Avant d'émettre, il faut résoudre l'identité du destinataire dans l'annuaire des entreprises (par SIREN ou SIRET). Le connecteur interroge le Directory Service de votre PA pour valider que le destinataire est bien joignable sur le réseau.

L'authentification suit le référentiel : OAuth 2.0 en client_credentials. Facturino négocie un jeton bearer, l'utilise pour tous les appels, et le renouvelle automatiquement à expiration.

Comment ça se configure (2 minutes, dans l'interface)

La connexion d'une PA se gère depuis Paramètres → Facturation électronique. Les identifiants sensibles ne transitent jamais par l'API publique et sont chiffrés au repos en AES-256-GCM.

1. Choisissez Autre PA (AFNOR XP Z12-013) dans la liste.
2. Renseignez les trois champs de base :
   • Base URL — l'URL racine de l'API AFNOR de votre PA
   • Client ID (OAuth2) ou clé API — fourni par votre PA
   • Client Secret — optionnel (vide si votre PA utilise une simple clé API en bearer)
3. Cliquez sur Tester la connexion, puis Connecter.

La norme laisse chaque PA libre de monter ses services où elle veut. Facturino expose donc quatre champs de configuration avancée, en self-service — aucun ticket au support :

Champ avancé	Valeur par défaut (normative)
Endpoint OAuth2 (token)	{base}/auth-service/token
Segment Flow Service	/flow-service
Segment Directory Service	/directory-service
Scope OAuth2	vide (seulement si votre PA l'exige)

Vides, ces champs retombent sur les chemins normatifs. Renseignés, ils permettent de coller à n'importe quelle implémentation. Exemple concret avec Super PDP : endpoint https://api.superpdp.tech/oauth2/token, segment Flow /afnor-flow, segment Directory /afnor-directory. Trois valeurs, et la PA est connectée.

Le suivi du cycle de vie

Une fois la facture envoyée (POST /v1/invoices/:id/send), le connecteur mappe les 14 codes du cycle de vie (fr:200 à fr:213) remontés par votre PA vers les statuts internes Facturino. Les codes obligatoires DGFiP sont garantis :

• fr:200 — Déposée
• fr:210 — Refusée
• fr:212 — Encaissée
• fr:213 — Rejetée

Les remontées se font en temps réel via un webhook signé : Facturino génère un secret HMAC-SHA256 à la connexion et affiche l'URL à configurer sur votre PA (https://facturino.com/api/v1/webhooks/pa-flow/{companyId}).

Pourquoi c'est un vrai argument, pas un gadget

Sans connecteur générique	Avec le connecteur AFNOR de Facturino
« Votre PA n'est pas supportée »	Toute PA conforme XP Z12-013 est connectable
Attendre le développement d'un connecteur dédié	Connexion immédiate, config-only
Enfermement dans une PA imposée	Vous changez de PA à tout moment, sans perdre vos données
Développement d'intégration à votre charge	Zéro développement — base URL + identifiants

Ce qu'il faut retenir

• Facturino maintient 4 connecteurs dédiés (Super PDP, Iopole, B2Brouter, Seqino) plus un connecteur générique AFNOR
• Le connecteur générique se branche sur n'importe quelle PA conforme XP Z12-013 — la norme d'interopérabilité que toutes les PA adoptent
• La configuration est 100 % self-service : base URL, identifiants, et si besoin les segments de service — aucun développement, aucun ticket support
• Le cycle de vie DGFiP (14 statuts) est synchronisé en temps réel via webhook signé
• Vous n'êtes jamais enfermé dans une PA : vous en changez quand vous voulez