Prérequis

Avant de pouvoir utiliser l’API SFEC, vous devez respecter certaines conditions générales et choisir le type d’intégration adapté à votre système.

Conditions générales

Avant de pouvoir utiliser l’API SFEC, vous devez :

Être inscrit au fichier des contribuables congolais
Disposer d’un NIU (Numéro d’Identification Unique) valide
Avoir accès au portail e-Facture du contribuable

Types d’intégration disponibles

1. ERP en ligne

Utilisation : Systèmes de gestion en ligne nécessitant une certification en temps réel

Caractéristiques :

Authentification via clé API (X-API-Key)
Certification directe des factures
Réponse immédiate avec numéro de certification SFEC

Prérequis :

Demande de clé API dans le portail e-Facture
Validation par les services fiscaux
Réception de la clé d’authentification

L’intégration ERP est idéale pour les systèmes connectés en permanence nécessitant une validation en temps réel.

2. Module de contrôle (TCC)

Utilisation : Applications nécessitant une certification locale avec synchronisation différée

Caractéristiques :

Authentification via mTLS (certificats clients)
Clés de chiffrement pour certification locale
Synchronisation périodique avec PGSFEC

Prérequis :

Demande de certificat TCC dans e-Facture
Installation des certificats clients
Configuration de l’authentification mTLS

Flux d’authentification :

Demande de certificat TCC via le portail
Réception du token d’authentification
Échange token + NIU contre certificats
Configuration mTLS pour les appels API

3. Terminal fiscal certifié (TFC)

Utilisation : Points de vente et terminaux de caisse certifiés

Caractéristiques :

Authentification via mTLS (identique au TCC)
Certification locale des factures
Synchronisation automatique avec PGSFEC
Conformité réglementaire complète

Prérequis :

Certification du terminal par les autorités fiscales
Installation des certificats de sécurité
Configuration des paramètres de synchronisation

⚠️

Le processus TFC suit le même modèle que le TCC mais avec des contraintes de sécurité renforcées et une certification préalable du matériel.

Environnements API

Environnement	Usage principal	Base URL
Sandbox	Tests d’intégration,	`https://sandbox-pgsfec.akieni.tech/api`
Production	Trafic réel, émission officielle des factures certifiées	`https://sfec.gouv.cg/api`

Utilisez toujours le même environnement pour l’ensemble de vos appels (récupération des certificats, soumission des factures, vérifications) afin de garantir la cohérence des données de votre environnement.

Endpoints principaux

Base URL : {baseUrl}
Authentification TCC/TFC : /certificates/claim-with-token
Certification ERP : /invoices/report/api
Liste des factures ERP : /invoices
Soumission TCC : /invoices/report/tcc
Soumission TFC : /invoices/report/tfc