Soumission TFC (Terminal fiscal certifié)

Utilisez cet endpoint pour synchroniser des factures déjà certifiées localement par votre terminal fiscal certifié (TFC).

Authentification : mTLS (certificats clients) - voir Authentification
Processus : Identique au TCC avec des contraintes de sécurité renforcées

Endpoint

URL : POST /api/invoices/report/tfc
Authentification : mTLS (certificats clients)


POST https://dev-pgsfec.akieni.tech/api/invoices/report/tfc
Content-Type: application/json
Accept: application/json

Paramètres de requête

Le format des données est identique au TCC. Consultez la documentation TCC pour tous les détails des paramètres.

Différences spécifiques au TFC

Aspect	TCC	TFC
Certification matérielle	Non requise	Terminal certifié par les autorités fiscales
Contraintes de sécurité	Standard	Renforcées
Endpoint	`/invoices/report/tcc`	`/invoices/report/tfc`
Format des données	Identique	Identique
Authentification mTLS	Requise	Requise

Paramètres identiques au TCC

Tous les paramètres de requête sont identiques au TCC :

✅ Identification et statut de la facture
✅ Informations destinataire
✅ Montants et totaux
✅ Informations de paiement
✅ Certification locale
✅ Structure des articles

Référez-vous à la documentation TCC pour la liste complète des paramètres et leurs descriptions.

Exemple de requête

Le format de la requête est identique au TCC, seul l’endpoint change :


{
  "invoice_id": "INV-TFC-2025-20",
  "invoice_type": "salesInvoice",
  "invoice_subject": null,
  "invoice_due_date": null,
  "invoice_status": "certified",
  "reference_invoice_id": null,
  "sciet": "SFEC-TFC-0045",
  "terminal_identifier": "TFC-POINT-001",
  "subtotal": 13280,
  "total_tax_t_amount": 2390.4,
  "total_tax_r_amount": 0,
  "total_exempt_amount": 0,
  "total_tax_amount": 2390.4,
  "discount_amount": 4000,
  "amount_due": 15670.4,
  "total_line_discount_amount": 4000,
  "additional_cent_tax": 0,
  "electronic_stamp_duty": 0,
  "total_amount": 15670.4,
  "currency": "XAF",
  "recipient_type": "1",
  "recipient_name": "Test Buyer Company",
  "recipient_niu": "BUYER123456789",
  "recipient_rccm": null,
  "recipient_address": "123 Buyer Street, City",
  "recipient_phone": "+237123456789",
  "recipient_email": null,
  "is_recipient_taxable": true,
  "payment_method": "2",
  "payment_reference": null,
  "payment_date": null,
  "notes": "Test invoice for TFC API",
  "items": [
    {
      "designation": "iphones 16",
      "classification_code": "C01",
      "discount_amount": 2000,
      "discount_type": "fixed",
      "net_amount": 7835.2,
      "quantity": 12,
      "subtotal": 8640,
      "tax_amount": 1195.2,
      "tax_rate": "18",
      "total_amount": 7835.2,
      "type": "product",
      "unit_price": 720
    },
    {
      "designation": "mac book pro",
      "classification_code": "C01",
      "discount_amount": 2000,
      "discount_type": "fixed",
      "net_amount": 7835.2,
      "quantity": 12,
      "subtotal": 8640,
      "tax_amount": 1195.2,
      "tax_rate": "18",
      "total_amount": 7835.2,
      "type": "product",
      "unit_price": 720
    }
  ],
  "certification_date": "2024-01-15T10:30:00Z",
  "certification_status": "certified",
  "certification_signature": "_SIGNATURE_PLACEHOLDER",
  "certification_short_signature": "_SHORT_SIGNATURE",
  "certification_qr_code": "_QR_CODE"
}

Réponse

Réponse de succès

La structure de la réponse est identique au TCC :

Paramètre	Type	Description
`sfec_certification_number`	string	Numéro de certification SFEC officiel
`invoice_number`	string	Numéro de facture confirmé
`certification_date`	string	Date/heure de certification au format ISO 8601
`sfec_identifier`	string	Identifiant SFEC du terminal certifié
`sfec_qr_code`	string	URL de vérification de la facture

Exemple de réponse


{
  "sfec_certification_number": "SFEC-TFC-2025-0000123456",
  "invoice_number": "INV-TFC-2025-20",
  "certification_date": "2025-01-15T10:30:00Z",
  "sfec_identifier": "SFEC-TFC-0045",
  "sfec_qr_code": "https://verify.sfec.cg/invoice/SFEC-TFC-2025-0000123456"
}

Codes d’erreur

Les codes d’erreur sont identiques au TCC :

Code	Description
`400`	Données invalides (format incorrect, champs manquants)
`401`	Authentification mTLS échouée
`409`	Facture déjà soumise
`422`	Erreur de validation des données métier
`500`	Erreur interne du serveur

Spécificités TFC

Certification matérielle

Les terminaux TFC doivent être certifiés par les autorités fiscales avant utilisation :

✅ Validation du matériel par les services fiscaux
✅ Installation des certificats de sécurité renforcés
✅ Configuration des paramètres de synchronisation automatique
✅ Tests de conformité réglementaire

Sécurité renforcée

Stockage sécurisé : Les clés de certification sont stockées dans un module sécurisé
Audit automatique : Toutes les opérations sont automatiquement auditées
Synchronisation obligatoire : La synchronisation avec PGSFEC est automatique et obligatoire
Traçabilité complète : Toutes les transactions sont tracées et horodatées

⚠️

Les terminaux TFC sont soumis à des contrôles de conformité réguliers. Assurez-vous que votre terminal maintient sa certification à jour.

Pour toute question spécifique aux terminaux TFC, contactez le service de certification des terminaux fiscaux.