Soumission TCC (Module de contrôle)

Utilisez cet endpoint pour synchroniser des factures déjà certifiées localement par votre module TCC.

Authentification : mTLS (certificats clients) - voir Authentification

Endpoint

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


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

Paramètres de requête

Identification et statut

Paramètre	Type	Description	Obligatoire
`invoice_id`	string	Identifiant unique de la facture dans votre système	✅
`invoice_type`	string	Type de facture (`salesInvoice`, `creditNote`)	✅
`invoice_subject`	string\|null	Objet ou description de la facture	❌
`invoice_due_date`	string\|null	Date d’échéance au format ISO 8601	❌
`invoice_status`	string	Statut de la facture (`certified`, `cancelled`)	✅
`reference_invoice_id`	string\|null	ID de la facture de référence (pour avoirs)	❌
`sciet`	string	Identifiant SCIET du terminal	✅
`terminal_identifier`	string	Identifiant du point de vente	✅

Informations destinataire

Paramètre	Type	Description	Obligatoire
`recipient_type`	string	Type de destinataire (`1` = Particulier, `2` = Entreprise)	✅
`recipient_name`	string	Nom ou raison sociale du destinataire	✅
`recipient_niu`	string\|null	NIU du destinataire si assujetti	❌
`recipient_rccm`	string\|null	Numéro RCCM du destinataire	❌
`recipient_address`	string\|null	Adresse physique du destinataire	❌
`recipient_phone`	string\|null	Numéro de téléphone du destinataire	❌
`recipient_email`	string\|null	Adresse e-mail du destinataire	❌
`is_recipient_taxable`	boolean	Indique si le destinataire est assujetti à la TVA	✅

Montants et totaux

Paramètre	Type	Description	Obligatoire
`subtotal`	number	Sous-total général hors taxe	✅
`total_tax_t_amount`	number	Total TVA collectée	✅
`total_tax_r_amount`	number	Total TVA déductible	✅
`total_exempt_amount`	number	Montant exonéré	✅
`total_tax_amount`	number	Total des taxes	✅
`discount_amount`	number	Remise globale sur facture	✅
`total_line_discount_amount`	number	Total des remises sur lignes	✅
`additional_cent_tax`	number	Taxe centimes additionnels	✅
`electronic_stamp_duty`	number	Droit de timbre électronique	✅
`total_amount`	number	Montant total TTC	✅
`amount_due`	number	Montant à payer	✅

Paiement

Paramètre	Type	Description	Obligatoire
`currency`	string	Code de devise (ex: `XAF`)	✅
`payment_method`	string	Mode de paiement (`1` = Espèces, `2` = Mobile Money, `3` = Chèque, `4` = Virement)	✅
`payment_reference`	string\|null	Référence du paiement	❌
`payment_date`	string\|null	Date du paiement au format ISO 8601	❌

Certification locale

Paramètre	Type	Description	Obligatoire
`certification_date`	string	Date/heure de certification au format ISO 8601	✅
`certification_status`	string	Statut de certification (`certified`)	✅
`certification_signature`	string	Signature numérique complète	✅
`certification_short_signature`	string	Signature courte pour affichage	✅
`certification_qr_code`	string	Code QR de vérification	✅

Articles (`items`)

Chaque article de la facture doit contenir :

Paramètre	Type	Description	Obligatoire
`designation`	string	Description de l’article	✅
`classification_code`	string	Code de classification fiscale du produit	❌
`type`	string	Type d’article (`product`, `service`)	✅
`unit_price`	number	Prix unitaire hors taxe	✅
`quantity`	number	Quantité	✅
`subtotal`	number	Sous-total (unit_price × quantity)	✅
`discount_amount`	number	Montant de remise	✅
`discount_type`	string	Type de remise (`fixed`, `percentage`)	✅
`net_amount`	number	Montant net après remise	✅
`tax_rate`	string	Taux de taxe (`0`, `18`)	✅
`tax_amount`	number	Montant de la taxe	✅
`total_amount`	number	Montant total TTC	✅

Exemple de requête


{
  "invoice_id": "INV-2025-20",
  "invoice_type": "salesInvoice",
  "invoice_subject": null,
  "invoice_due_date": null,
  "invoice_status": "certified",
  "reference_invoice_id": null,
  "sciet": "SFEC-0045",
  "terminal_identifier": "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 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

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-2025-0000123456",
  "invoice_number": "INV-2025-20",
  "certification_date": "2025-01-15T10:30:00Z",
  "sfec_identifier": "SFEC-0045",
  "sfec_qr_code": "https://verify.sfec.cg/invoice/SFEC-2025-0000123456"
}

Codes d’erreur

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

⚠️

Assurez-vous que tous les montants sont cohérents et que la certification locale a été effectuée avant la soumission.