Consulter les factures

Récupère les factures certifiées par votre TCC Server, avec pagination et filtres.

Authentification : clé API — voir Authentification.

Endpoint


GET /api/v1/invoices
Authorization: ApiKey ak_votre_cle_ici

Paramètres de requête

Paramètre	Type	Défaut	Contraintes	Description
`page`	integer	`0`	≥ 0	Numéro de page (commence à 0).
`size`	integer	`20`	1–100	Nombre d’éléments par page.
`status`	string	—	`CERTIFIED`, `PROCESSING`, `FAILED`, `CANCELLED`	Filtre par statut.
`startDate`	string	—	`YYYY-MM-DD`	Date de début (incluse).
`endDate`	string	—	`YYYY-MM-DD`	Date de fin (incluse).
`branchCode`	string	—	—	Filtre par code de branche/agence.

Note : le champ status (majuscules, ex. CERTIFIED) correspond au certificationStatus renvoyé à la certification (minuscules, ex. certified) — même statut, deux représentations.

Réponse


{
  "content": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "invoiceId": "FAC-2026-001234",
      "invoiceType": "salesInvoice",
      "status": "CERTIFIED",
      "recipientType": "business",
      "recipientName": "Société XYZ SARL",
      "totalAmount": 1250000.00,
      "currency": "XAF",
      "certificationDate": "2026-04-24T14:30:45.123",
      "certificationShortSignature": "A1B2C3D4E5F6A1B2C3D4",
      "branchCode": "PNR-001",
      "createdAt": "2026-04-24T14:30:44.000"
    }
  ],
  "totalElements": 150,
  "totalPages": 8,
  "size": 20,
  "number": 0
}

La réponse suit le format paginé standard : content[], totalElements, totalPages, size et number (page courante, commençant à 0).

Étape suivante → Synchronisation SFEC