FAQ — Questions fréquentes

Cette FAQ générale couvre le choix d’un mode d’intégration et les questions transverses au SFEC. Chaque mode dispose également de sa propre FAQ détaillée :

Général

Quels prérequis sont communs à tous les modes ?

Quel que soit le mode : être inscrit au fichier des contribuables congolais, disposer d’un NIU (Numéro d’Identification Unique) valide, et avoir accès au portail e-Facture. Voir l’Introduction.

Quels environnements existent ?

Un environnement de production et un environnement de sandbox (préfixe sandbox.). Utilisez toujours le même environnement pour l’ensemble d’un flux. Le tableau complet des URLs figure dans l’Introduction.

Comment contacter le support ?

Support technique : support@sfec.gouv.cg.

Choisir un mode d’intégration

Quels sont les modes disponibles ?

• API (ERP en ligne) : clé API, certification en ligne en temps réel (cloud SFEC).
• TCC Server : middleware auto-hébergé (clé API ApiKey), certification locale + synchronisation automatique.
• TCC SFEC Terminal : dispositif fiscal (terminal Android) piloté via port série (JSON cadré par END_JSON).
• TCC Datamega Terminal : dispositif fiscal Datamega piloté via port série (protocole à trames binaires, CRC16).
• TFC : terminal fiscal certifié, utilisé tel quel (contactez le support pour le manuel).
• e-Facture : facturation en ligne dans le portail web, certification directe — sans développement.

Comment choisir rapidement ?

• Système connecté en permanence à Internet → API.
• Besoin d’une certification locale avec un serveur que vous hébergez → TCC Server.
• Vous intégrez un dispositif fiscal série déjà déployé → TCC SFEC Terminal (terminal Android) ou TCC Datamega Terminal (dispositif Datamega).
• Terminal fiscal matériel prêt à l’emploi → TFC.
• Émettre vos factures en ligne, sans logiciel ni matériel → e-Facture.

Voir le comparatif complet sur la page d’introduction.

API (ERP en ligne)

En bref ?

Certification synchrone via POST /api/v1/invoices, authentifiée par X-API-Key ; le SFEC génère la signature et le QR code. Prérequis, formats, codes d’erreur et pagination : FAQ API.

TCC Server

En bref ?

Middleware auto-hébergé qui certifie localement puis synchronise vers le SFEC (réessais automatiques pendant 7 jours). Déploiement, disponibilité, clés API et synchronisation : FAQ TCC Server.

TCC SFEC Terminal

Comment mon logiciel parle-t-il au terminal ?

Via un port COM série virtuel (COM10, 115200 8N1) exposé par un pont Windows fourni. Vous écrivez un objet JSON suivi du marqueur END_JSON et lisez la réponse de la même façon — pas de socket réseau, pas de heartbeat à gérer. Voir Connexion série.

Quels langages puis-je utiliser ?

Tout langage capable d’ouvrir un port COM. Des clients complets sont fournis en Python, C# et Java. Voir Exemples de code.

Que reçois-je à la certification ?

Une réponse success avec sfec_number et qr_code (une image PNG encodée en Base64, pas le texte du QR). Champs, erreurs et santé du lien : FAQ TCC SFEC Terminal.

TCC Datamega Terminal

Comment mon logiciel parle-t-il au dispositif ?

Via un port série en trames binaires SOH·LEN·SEQ·CMD·DATA·AMB·CRC16·ETX (somme de contrôle CRC16-Modbus), une commande à la fois. Voir Format des trames.

Quels langages puis-je utiliser ?

Tout langage avec accès au port série. Les utilitaires de cadrage et l’exemple de vente complet sont fournis en Python, C# et Java. Voir Exemples de code.

Comment se déroule une vente ?

Séquence C0h → C3h → 31h (par article) → 33h → 35h → 38h, chaque commande devant renvoyer result = 1. Codes de résultat et dépannage : FAQ TCC Datamega Terminal.

TFC

Ai-je besoin d’un développement pour le TFC ?

Le TFC est un terminal prêt à l’emploi. Pour connecter un logiciel de facturation au SFEC, utilisez plutôt l’un des modes d’intégration ci-dessus. Manuel et mise en service : page TFC (contactez le support).

e-Facture

e-Facture demande-t-il un développement ?

Non. e-Facture est un système de facturation en ligne : vous saisissez vos factures dans le portail web et elles sont certifiées immédiatement, sans code, sans clé API ni matériel. Pour connecter un logiciel existant, choisissez plutôt un mode d’intégration. Voir la page e-Facture.