Skip to Content
APIFAQ

FAQ — API (ERP)

Questions techniques fréquentes pour l’intégration API (ERP en ligne). Pour comparer tous les modes d’intégration, voir la FAQ générale.

Démarrage

Comment obtenir une clé API ?

Créez une demande d’intégration API (ERP) sur le portail e-Facture. Après validation par la DGID, vous recevez votre clé API. Voir Authentification.

Quelles sont les URLs de base ?

  • Production : https://api.sfec.gouv.cg
  • Sandbox : https://sandbox.api.sfec.gouv.cg

Utilisez toujours le même environnement pour l’ensemble de vos appels.

La clé API est-elle liée à mon entreprise ?

Oui. La clé identifie votre entreprise (business) et limite l’accès à vos propres factures uniquement.

Authentification

Comment transmettre ma clé API ?

Ajoutez l’en-tête HTTP X-API-Key à chaque requête :

X-API-Key: {votre_clé_api}

Que se passe-t-il si ma clé est absente, invalide ou inactive ?

L’API renvoie une réponse 401. Vérifiez que la clé est correcte et que son statut est active.

Certifier une facture

Quel endpoint utiliser pour certifier une facture ?

POST /api/v1/invoices. Voir Certifier une facture.

Dois-je générer moi-même la signature et le QR code ?

Non. Pour l’API (ERP), le SFEC génère le numéro de certification, la signature et le QR code, puis les renvoie dans la réponse. Vous n’avez pas à les calculer.

Que contient la réponse d’une certification réussie ?

Un statut 201 Created avec : certification_number, signature, short_signature, invoice_number, certification_date, identifier et qr_code.

Comment émettre une facture d’avoir (note de crédit) ?

Définissez invoice_type à creditNote et renseignez reference_invoice_id avec l’identifiant de la facture de vente d’origine.

Comment remplir le champ electronic_stamp_duty ?

Il doit être défini à 0. Depuis la signature du décret, le timbre électronique n’est plus calculé par le contribuable.

Sous quel format envoyer les montants ?

En valeur numérique simple, sans symbole de devise (ex. 15670.40). La devise est indiquée séparément dans le champ currency (ex. XAF).

Comment déclarer des taxes additionnelles ?

Via le tableau optionnel additional_taxes, où chaque élément contient tax_code, tax_label, tax_amount et tax_rate.

⚠️

Assurez-vous que les totaux sont cohérents et correspondent à la somme des articles avant soumission, sous peine d’une erreur 400/422.

Consulter les factures

Comment récupérer la liste de mes factures ?

GET /api/v1/invoices, avec pagination et filtrage. Voir Lister les factures.

Quelle est la taille de page maximale ?

pageSize accepte une valeur entre 1 et 20 (par défaut 10). Une valeur hors plage renvoie 400.

Comment récupérer une facture précise ?

GET /api/v1/invoices/{id}, où {id} est soit l’identifiant unique (UUID), soit le invoice_number (ex. INV-2025-000145).

Puis-je filtrer par date ou par type ?

Oui : invoice_type, date_start et date_end (format ISO 8601). La date de fin est automatiquement étendue à 23:59:59.

Erreurs et cas limites

Que signifie une erreur 409 ?

La facture a déjà été certifiée : le invoice_number existe déjà pour votre entreprise. Utilisez un numéro unique.

Quels sont les codes d’erreur possibles ?

CodeSignification
400Données invalides (format, champs manquants, pagination hors plage)
401Clé API absente, invalide ou inactive
404Facture introuvable (consultation par identifiant)
409Facture déjà certifiée (numéro en doublon)
500Erreur interne (voir le champ details de la réponse)

Que se passe-t-il si je soumets deux fois la même facture ?

La seconde soumission est rejetée avec un 409 (doublon de invoice_number). Conservez la réponse de la première certification.

Ressources

Où trouver la spécification OpenAPI ?

Sur la page Référence OpenAPI (explorateur interactif) ou en téléchargement direct : /openapi.yaml.

Référence OpenAPI