FAQ — TCC Server
Questions fréquentes sur l’intégration TCC Server (middleware auto-hébergé). Pour les autres modes, voir API, TCC SFEC Terminal et TCC Datamega Terminal ; pour une vue d’ensemble, la FAQ générale.
Déploiement et disponibilité
Que se passe-t-il si le TCC Server est hors ligne ?
Le système de facturation reçoit une erreur de connexion et la facture n’est pas certifiée ; elle devra être resoumise une fois le serveur rétabli. Aucune facture ne peut être émise sans certification.
Quelle disponibilité est requise ?
Le TCC Server doit être disponible pendant toutes les heures d’activité du contribuable. Prévoyez une alimentation de secours (onduleur ≥ 30 min, groupe électrogène en zone à coupures fréquentes) et une surveillance active.
Quels systèmes d’exploitation sont supportés ?
Linux (recommandé en production : Ubuntu 22.04 LTS+, Debian 12+, RHEL 9+), Windows (10/11, Server 2019+) et macOS 12+ (développement uniquement).
Authentification et sécurité
Comment créer une clé API ?
Depuis le tableau de bord (/dashboard/clients) : nommez la clé, définissez éventuellement un branchCode et des restrictions d’IP, puis copiez-la immédiatement — elle n’est plus affichée ensuite. Voir Installation.
Puis-je restreindre une clé API à certaines adresses IP ?
Oui. Les clés API peuvent être limitées à des adresses IP ou des plages CIDR spécifiques.
Comment gérer plusieurs sites ou agences ?
Associez un branchCode à chaque clé API, et filtrez par branchCode lors de la consultation des factures.
Faut-il exposer le port 23109 sur Internet ?
Non. Le port 23109 doit rester interne ; exposez le service via un reverse proxy HTTPS (Nginx, Caddy) et restreignez l’accès par IP.
Certification
La certification est-elle synchrone ?
Oui. POST /api/v1/invoices/certify est synchrone : la réponse contient directement la signature et le QR code. Aucun callback ni polling n’est nécessaire.
Dois-je générer moi-même la signature et le QR code ?
Non — le TCC Server les génère (signature HMAC-SHA256, QR code, horodatage NTP sécurisé) et les renvoie dans la réponse.
Peut-on resoumettre une facture rejetée ?
Oui : corrigez les champs indiqués dans errors[] et resoumettez avec le même invoiceId. Si la facture est déjà certifiée (409), vous ne pouvez pas la resoumettre — émettez un avoir (creditNote) pour l’annuler.
Que dois-je imprimer sur la facture ?
Au minimum : la signature abrégée (certificationShortSignature), le QR code (certificationQrCode) et la date de certification (certificationDate).
Synchronisation
Que faire si la synchronisation SFEC échoue ?
La facture reste valide et certifiée localement. Le serveur réessaie automatiquement pendant 7 jours ; vous pouvez aussi déclencher une synchronisation manuelle (POST /api/v1/sync/trigger). Si le statut passe à SYNC_ABANDONED, contactez le support.
Comment vérifier l’état de la synchronisation ?
Appelez GET /api/v1/sync/status. Voir Synchronisation SFEC.
Comparaison
Quelle différence avec les autres modes ?
- TCC Server : middleware auto-hébergé (clé API
ApiKey), certification locale + synchronisation automatique vers SFEC. - API : clé API, certification en ligne en temps réel (cloud SFEC).
- TCC SFEC Terminal / TCC Datamega Terminal : intégration sur dispositif fiscal via port série.