Liste des factures TCC/TFC

Utilisez cet endpoint pour récupérer les factures certifiées par votre module TCC (Module de contrôle) ou votre terminal fiscal certifié (TFC). Il retourne les factures associées à votre terminal avec pagination, filtrage par type et par période.

Authentification : mTLS (certificats clients) - voir Authentification
Portée : uniquement les factures du terminal_identifier lié au certificat.
Compatible avec : Modules TCC et terminaux TFC

OpenAPI / Swagger

Visualiser dans Swagger UI

Endpoint

URL : GET /api/terminals/invoices
Authentification : mTLS (certificats clients)


GET https://{baseUrl}/api/terminals/invoices?page=1&pageSize=10
Accept: application/json

Paramètres de requête

Paramètre	Type	Description	Obligatoire	Valeur par défaut
`page`	integer ≥ 1	Numéro de page	❌	`1`
`pageSize`	integer 1-20	Nombre de factures par page	❌	`10`
`invoice_type`	string	Filtre par type de facture (`salesInvoice`, `creditNote`, etc.)	❌	—
`date_start`	string (ISO 8601)	Début de période (inclus)	❌	—
`date_end`	string (ISO 8601)	Fin de période (inclus, 23:59:59 automatiquement)	❌	—

Exemple de requête (cURL)


curl --request GET \
  --cert /path/to/client.crt \
  --key /path/to/client.key \
  --url "https://{baseurl}/api/terminals/invoices?page=2&pageSize=15&invoice_type=salesInvoice&date_start=2025-01-01&date_end=2025-01-31" \
  --header "Accept: application/json"

Structure de réponse


{
  "invoices": [
    {
      "id": "f0b6ad2d-bd0e-4c5a-9559-e2d7c4156c90",
      "invoice_number": "INV-2025-000145",
      "invoice_date": "2025-01-15T10:30:00.000Z",
      "invoice_type": "salesInvoice",
      "invoice_status": "certified",
      "currency": "XAF",
      "total_ht": "13280.00",
      "total_tax18": "2390.40",
      "total_ttc": "15670.40",
      "payment_method": "2",
      "notes": "Facture terminal janvier",
      "buyer_name": "Test Buyer Company",
      "buyer_niu": "BUYER123456789",
      "items_json": [
        {
          "designation": "iphones 16",
          "quantity": 12,
          "unit_price": 720,
          "tax_rate": "18",
          "total_amount": 7835.2
        }
      ],
      "Buyer": {
        "id": "4bd77f16-833a-4c4e-ac0b-4d0664720c77",
        "niu": "BUYER123456789",
        "name": "Test Buyer Company",
        "buyer_type": "company"
      },
      "StatusInvoice": {
        "status_id": 3,
        "name": "certified"
      }
    }
  ],
  "totalPages": 12,
  "page": 2,
  "pageSize": 15
}

Codes de réponse

Code	Description
`200`	Requête réussie
`400`	Paramètres invalides (certificat manquant, paramètres de pagination invalides)
`403`	Authentification mTLS échouée ou certificat non vérifié
`404`	Certificat non trouvé ou terminal identifier manquant
`500`	Erreur interne (voir champ `details` dans la réponse)

Notes importantes

Certificat client requis : Vous devez fournir un certificat client valide lors de la requête. Le certificat doit être associé à un terminal TCC ou TFC actif.
Filtrage par terminal : Les factures retournées sont automatiquement filtrées par le terminal_identifier associé au certificat utilisé.
Ordre de tri : Les factures sont triées par date de facture (plus récentes en premier).
Pagination : Le pageSize maximum est de 20 factures par page.

Différences entre TCC et TFC

Aspect	TCC	TFC
Type de terminal	Module de contrôle logiciel	Terminal fiscal certifié matériel
Certification matérielle	Non requise	Terminal certifié par les autorités fiscales
Endpoint	`/api/terminals/invoices`	`/api/terminals/invoices`
Format de réponse	Identique	Identique
Authentification	mTLS	mTLS

⚠️

Assurez-vous que votre certificat client est valide et associé à un terminal TCC ou TFC actif avant d’utiliser cet endpoint.