API, connecteurs et formats supportés par la Plateforme Agréée Hubtimize e-Invoicing

Mis à jour en octobre 2026

Réponse courte. Hubtimize e-Invoicing, la Plateforme Agréée d’EsaLink, se connecte à un système d’information par API (dont les API de la norme AFNOR XP Z12-013), par échanges de fichiers sécurisés, par connecteurs ou par EDI, souvent en combinant plusieurs modes. Elle reçoit les données dans le format interne de votre logiciel et les convertit vers les formats de la réforme : Factur-X, UBL et CII.

À retenir

• Une Plateforme Agréée est avant tout une plateforme d’intégration : sa valeur se mesure à la facilité avec laquelle elle se connecte à votre SI.
• Quatre modes de connexion : API, fichiers, connecteurs et EDI, combinables en approche hybride.
• Votre logiciel peut garder son format interne : la plateforme convertit vers Factur-X, UBL ou CII.
• L’API AFNOR XP Z12-013 est recommandée mais non obligatoire : elle évite de développer une connexion par plateforme.
• Les capacités techniques ci-dessous sont à valider avec votre interlocuteur avant tout engagement.

• Pourquoi la connectivité est l’enjeu technique d’une Plateforme Agréée
• Les quatre modes de connexion
• L’API : ce qu’elle permet
  • Une norme de référence : AFNOR XP Z12-013
  • Les opérations typiques
  • Pourquoi l’API est souvent le premier choix
• Fichiers et connecteurs
• Les formats gérés
  • Votre logiciel garde son format
  • Formats d’entrée et de sortie
• Statuts, e-Reporting et archivage
• Sécurité et exploitation
• Multi-entités et environnement complexes
• Mettre en place une intégration : 6 étapes
• Prérequis côté client
• Les questions techniques à poser à toute Plateforme Agréée
• Pour les éditeurs de logiciel
• FAQ
• Conclusion

Pourquoi la connectivité est l’enjeu technique d’une Plateforme Agréée

Depuis le 1er septembre 2026, toutes les entreprises assujetties à la TVA doivent pouvoir recevoir des factures électroniques via une Plateforme Agréée, et les grandes entreprises et ETI doivent émettre. Les PME et micro-entreprises suivent le 1er septembre 2027. Dans la pratique, très peu de systèmes d’information sont standardisés :

• plusieurs applications et plusieurs filiales ;
• plusieurs formats et plusieurs méthodes d’échange ;
• des environnements anciens et cloud qui cohabitent ;
• des partenaires qui n’utilisent pas les mêmes standards.

Une PA doit donc s’adapter à votre existant, pas l’inverse. Voir Se mettre en conformité sans refondre son SI ni son ERP et Comment connecter son ERP à une Plateforme Agréée.

Les quatre modes de connexion

Mode	Principe	Atouts	Limites	Pour qui ?
API	Échange en temps réel via des interfaces sécurisées	Mise en œuvre rapide, statuts en temps réel, évolutif	Suppose un logiciel ouvert et des ressources techniques	Environnements modernes, SaaS, éditeurs
Échange de fichiers	Dépôt et récupération de fichiers structurés (SFTP, AS2…)	Compatible avec les systèmes anciens ou on-premise, effort limité	Moins réactif que l’API	ERP on-premise, environnements industriels
Connecteurs	Connecteur existant entre l’ERP et la PA	Le plus rapide s’il existe	Dépend de la version et de l’éditeur	ERP et logiciels répandus
EDI	Messages normalisés (EDIFACT, XML…)	Cohérent avec des flux existants	Réservé aux entreprises déjà équipées	Groupes avec des flux EDI historiques

Ces modes se combinent : une approche hybride utilise l’API pour le temps réel, l’EDI pour les flux historiques et les fichiers pour les applications anciennes. Pour un groupe multi-ERP ou international, cette flexibilité est un levier de robustesse.

Voir Pourquoi choisir une PA spécialisée dans l’EDI et EDI : définition, fonctionnement et cas d’usage.

L’API : ce qu’elle permet

Une norme de référence : AFNOR XP Z12-013

La norme XP Z12-013 standardise l’API entre les PA et les logiciels. Elle comprend deux briques :

Brique	Rôle
API Flux	Déposer et recevoir des factures, échanger les statuts du cycle de vie
API Annuaire	Interroger l’Annuaire central pour localiser la PA d’un destinataire

Elle n’est pas imposée par un texte réglementaire, mais elle évite de développer une connexion spécifique pour chaque plateforme. Les normes voisines sont la XP Z12-012 (formats et statuts du cycle de vie) et la XP Z12-014 (cas d’usage métier). EsaLink participe aux travaux de normalisation de l’AFNOR.

Les opérations typiques

Opération	Sens	Utilité
Déposer une facture (émission)	Logiciel → PA	Transmettre la facture avec ses données ou son fichier
Recevoir une facture	PA → Logiciel	Intégrer automatiquement les factures fournisseurs
Lire les statuts	PA → Logiciel	Suivre l’avancement (déposée, rejetée, encaissée…)
Émettre un statut	Logiciel → PA	Signaler un refus, une approbation, un encaissement
Interroger l’Annuaire	Logiciel → PA	Vérifier l’adresse d’un client avant l’envoi
Transmettre des données d’e-reporting	Logiciel → PA	Données B2C, international, paiements

Pourquoi l’API est souvent le premier choix

• mise en œuvre rapide ;
• automatisation des échanges et statuts en temps réel ;
• bonne montée en charge ;
• architecture évolutive.

L’impact sur le code existant dépend de votre logiciel. Voir Comment circule une facture électronique.

Fichiers et connecteurs

Toutes les entreprises n’ont pas d’applications ouvertes aux API. Les échanges par fichiers restent souvent la voie la plus réaliste.

Élément	Détail
Protocoles	SFTP, AS2, OFTP2, autres
Formats de fichiers acceptés	CSV, XML, JSON, formats de l’ERP, EDIFACT
Fréquence	Temps réel, par lots planifiés
Sécurité	Chiffrement, authentification, accusés de réception
Retour de statuts	Fichiers de retour, API, notifications

Les modes de connexion courants selon l’ERP (indicatifs) :

ERP	Modes courants
SAP	IDoc, BAPI, RFC
Microsoft Dynamics	Web services, OData
Sage X3	Fichiers plats, API REST
Oracle	XML Gateway, connecteurs

Voir Intégrer l’EDI à vos ERP, WMS et TMS (dont multi-ERP).

Les formats gérés

Votre logiciel garde son format

Le principe : votre ERP ou logiciel produit son format habituel ; la plateforme reçoit les données, les interprète, les convertit, les enrichit si nécessaire, les rend conformes et les transmet dans le bon format au bon destinataire. Cela évite de modifier vos applications pour produire directement les formats réglementaires.

Formats d’entrée et de sortie

Famille	Formats	Rôle
Formats de la réforme	Factur-X, UBL, CII	Émission et réception des factures réglementaires
Formats de votre SI	CSV, XML, JSON, IDoc, fichiers plats	Entrée depuis votre logiciel
Formats EDI	EDIFACT, ANSI X12, ODETTE, VDA	Flux commerciaux et logistiques
Autres	Formats métiers ou partenaires spécifiques	Sur étude

La conversion repose sur le socle sémantique commun EN 16931 : quel que soit le format, les informations transportées sont les mêmes. Elle ne corrige pas des données manquantes : un champ absent de votre fichier d’origine n’apparaîtra pas dans la facture convertie.

Pour Factur-X, visez au moins le profil EN 16931. Voir Factur-X, UBL, CII : quel format choisir et Anatomie d’une facture électronique.

Statuts, e-reporting et archivage

Fonction	Ce que la plateforme gère	Où en savoir plus
Cycle de vie	Statuts obligatoires et optionnels, suivi, remontée vers votre SI	Comment circule une facture électronique
E-reporting	Données de transaction et de paiement (B2C, international)	E-reporting : définition, qui est concerné, obligations
Annuaire	Consultation et gestion des adresses de facturation	L’Annuaire dans la réforme
Auto-facturation	Émission au nom du fournisseur, validation tacite ou explicite	Auto-facturation et réforme
Archivage	Conservation sur 10 ans, option probante certifiée NF 461 via un partenaire	Archivage des factures électroniques

Sécurité et exploitation

Sujet	Ce qu’il faut vérifier
Immatriculation	Numéro et date, liste officielle de la DGFiP
Certifications	ISO/IEC 27001 (attestation exigée pour l’immatriculation), périmètre de la certification
Hébergement	Localisation, qualification SecNumCloud ou procédure en cours
Authentification	Mécanisme d’accès à l’API
Chiffrement	Échanges et stockage
Traçabilité	Journalisation, horodatage
Supervision	Tableau de bord, alertes sur factures bloquées
Disponibilité	Engagement de service (SLA)
Support	Niveaux, horaires, délais

Voir ISO 27001, SecNumCloud, RGPD : comprendre ces labels.

Multi-entités et environnements complexes

Hubtimize e-Invoicing prend en charge les organisations à plusieurs entités juridiques, plusieurs ERP ou plusieurs pays :

• centralisation des flux dans un environnement unique ;
• gouvernance consolidée et conformité homogène ;
• adaptation locale selon les contraintes de chaque entité ;
• gestion des mailles d’adressage (SIREN, SIRET, suffixe, code de routage). Voir L’Annuaire dans la réforme.

Mettre en place une intégration : 6 étapes

Étape	Action
1. Cadrage	Cartographier flux, systèmes, formats, volumes
2. Choix du mode	API, fichiers, connecteur, EDI ou hybride
3. Accès aux environnements	Obtenir les accès de test et la documentation
4. Développement ou paramétrage	Émission, réception, statuts, Annuaire
5. Recette	Tester les cas courants et les cas limites (avoirs, rejets, e-reporting)
6. Mise en production et suivi	Démarrage progressif, suivi des rejets

Voir Réussir son projet de facturation électronique : méthodologie en 7 étapes.

Prérequis côté client

☐ Un interlocuteur technique et un sponsor métier identifiés.
☐ La liste des systèmes concernés (ERP, comptabilité, caisse, GED) et leurs versions.
☐ Les formats actuellement utilisés en émission et en réception.
☐ Des données de qualité : SIREN, SIRET, TVA, adresses, mentions obligatoires. Voir Quelles sont les mentions obligatoires ?
☐ Un jeu de test représentatif (factures, avoirs, cas particuliers).
☐ Une procédure de traitement des rejets. Voir Facturation électronique : les erreurs à éviter.
☐ Un circuit d’accès à l’environnement de test et à la documentation.

Les questions techniques à poser à toute PA

Utiles pour comparer Hubtimize e-Invoicing et ses concurrents :

1. Quelles API proposez-vous ? L’API XP Z12-013 est-elle implémentée, dans quelle version ?
2. Quelle est la documentation et existe-t-il un environnement de test ?
3. Quels formats acceptez-vous en entrée et émettez-vous en sortie ? Quels profils Factur-X ?
4. Quels protocoles de transfert de fichiers sont pris en charge ?
5. Quels connecteurs natifs existent pour mon ERP, dans quelle version ?
6. Comment les statuts remontent-ils vers mon système ?
7. Comment sont gérés les rejets, et comment suis-je alerté ?
8. Quelle est la gestion du multi-entités et des adresses de facturation ?
9. Quels engagements de disponibilité et de support ?
10. Comment changer de plateforme plus tard ? Voir Portabilité entre PA.

Voir aussi Comment choisir sa Plateforme Agréée : le guide complet.

Pour les éditeurs de logiciel

Si vous êtes éditeur et envisagez la marque grise, cette page est le complément technique de l’article stratégique : Marque grise PA : le guide complet pour les éditeurs et Nos Solutions Compatibles.

FAQ

Conclusion

Pour une PA, le sujet technique décisif n’est pas la conformité de principe mais la qualité de l’intégration : modes de connexion, formats, statuts, documentation et accompagnement. Hubtimize e-Invoicing vise à se connecter à votre système d’information tel qu’il est, par API, fichiers, connecteurs ou EDI, et à gérer les formats de la réforme sans que votre logiciel doive les produire lui-même. Comparez toujours les capacités concrètes avant de choisir.