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.
Endpoints principaux
- Base URL :
https://dev-pgsfec.akieni.tech/api - Authentification TCC/TFC :
/certificates/claim-with-token - Certification ERP :
/invoices/report/api - Soumission TCC :
/invoices/report/tcc - Soumission TFC :
/invoices/report/tfc