KOMPTO API

Connectez votre ERP à la FNE ivoirienne via l'API Kompto

Si votre logiciel de gestion ne dispose pas encore d'une intégration FNE, l'API Kompto vous permet de l'ajouter rapidement — sans accréditation DGI, sans gestion de certificats, sans maintenance réglementaire. Vos utilisateurs génèrent leurs factures normalisées électroniques directement depuis l'interface qu'ils connaissent déjà.

Une intégration pensée pour ceux qui en ont besoin

Kompto est éditeur FNE agréé par la DGI. Que vous soyez éditeur de logiciel ERP, développeur d'une application métier, ou simplement une entreprise dont le logiciel actuel ne propose pas encore de connexion FNE native, l'API Kompto vous donne accès à cette conformité sans avoir à construire vous-même l'intégration avec le système fiscal.

Concrètement, vous envoyez à Kompto les données brutes de la vente — client, articles, quantités, prix, remises, codes TVA. Kompto vérifie, calcule tous les montants, et soumet la facture au système FNE. Vous récupérez une facture légalement valide, certifiée et prête à être remise à votre client. Tout est contrôlé par Kompto en amont — vous n'avez pas à gérer chaque détail technique du système fiscal vous-même.

Ce que l'API Kompto vous apporte

Une étape de vérification à la demande. Avant de soumettre une facture, vous avez la possibilité de demander à Kompto de vous retourner tous les montants calculés — HT, TVA, remises, TTC — pour validation. Utile pour tester vos scénarios ou vérifier un cas particulier avant tout engagement fiscal.

Une documentation complète et maintenue. Démarrage rapide, exemples curl fonctionnels, chapitres autonomes par cas d'usage, index des erreurs avec causes et corrections. Et lorsque la DGI fait évoluer ses règles, Kompto vous accompagne : nous mettons à jour la documentation, vous guidons sur les ajustements nécessaires, et veillons à ce que l'intégration technique continue de fonctionner.

Une API simple, sans complexité inutile. Vous envoyez les données de la vente, vous récupérez une facture certifiée. Toute la complexité du système fiscal est gérée côté Kompto — vous travaillez avec une interface claire, documentée en français, sans avoir à vous soucier de ce qui se passe en dessous.

La liberté de présenter l'intégration comme vous le souhaitez. Kompto gère la conformité en arrière-plan, vous laissant toute latitude sur la façon dont vous intégrez et présentez la fonctionnalité dans votre logiciel.

Pour qui ?

L'API Kompto s'adresse :

• aux éditeurs de logiciels ERP qui souhaitent proposer la conformité FNE à leurs clients ;
• aux développeurs d'applications métier gérant des ventes en Côte d'Ivoire ;
• à toute entreprise dont le logiciel actuel ne dispose pas d'une intégration FNE et pour qui en développer une serait trop complexe ou trop coûteux.

Prêt à intégrer ?

Contactez-nous pour accéder à la documentation technique et démarrer votre intégration.

Nous contacter

L'API en bref

L'API Kompto est une API REST, en JSON sur HTTPS. Les noms de champs sont en anglais, l'authentification se fait par clé API, et l'intégration se fait depuis n'importe quel langage disposant d'un client HTTP — Python, PHP, JavaScript, C#, Java.

URL de base : https://app.kompto.com
Authentification : Authorization: Bearer {votre_clé_api}

Les appels disponibles

Sept appels couvrent l'intégralité du cycle de vie d'une facture normalisée.

Deux façons d'émettre une facture

Vérifier puis confirmer. /verify vous renvoie tous les montants calculés — HT, remises, TVA, TTC — sans aucun engagement fiscal. Vous les affichez, vous les contrôlez, puis /confirm génère la FNE. Si quelque chose ne va pas, /delete annule. C'est le parcours recommandé pour démarrer et pour les factures inhabituelles.

Créer directement. /create valide, calcule et soumet en une seule transaction, une fois votre intégration éprouvée.

À noter : une FNE confirmée par la DGI est un document légal irréversible. Une erreur se corrige par un avoir, qui constitue lui-même une facture déclarée à la DGI.

Un exemple d'appel

curl -X POST "https://app.kompto.com/api/invoice/verify" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer {votre_clé_api}" \
  -d '{
        "clientType": "B2B",
        "clientName": "KOUAME ET FRERES SARL",
        "clientNCC": "8200001A",
        "clientTelephone": "2721212121",
        "clientEmail": "[email protected]",
        "paymentMethod": "transfer",
        "items": [
          {
            "itemName": "Prestation de conseil",
            "itemQuantity": 2,
            "itemUnitPrice": 50000,
            "itemTVAName": "TVA"
          }
        ]
      }'

Vous envoyez les données brutes de la vente. Vous n'envoyez jamais de montants calculés — Kompto et la DGI s'en chargent.

Types de client et codes de TVA

Quatre types de client : B2B (entreprise ivoirienne, NCC obligatoire), B2C (particulier), B2G (administration publique) et B2F (client étranger, avec devise et taux de change).

Cinq codes de TVA : TVA 18 % (taux normal), TVAB 9 % (taux réduit), TVAC, TVAD et TVAE à 0 % (exonération par convention, exonération légale, export).

Modes de paiement acceptés : espèces, carte, chèque, mobile money (Wave, Orange Money, MTN Money), virement et paiement différé.

Tester avant de passer en production

Obtenir un environnement de test auprès de la DGI est une démarche lourde et propre à chaque entreprise. Kompto met à disposition un environnement de test commun, accessible immédiatement, exposant exactement les mêmes appels que la production et produisant des factures de test sans valeur fiscale. Le cycle complet y est testable, avoirs compris.

Le passage en production ne change que trois choses : l'URL de base, la clé API, et les identifiants d'établissement et de point de vente.

La documentation complète — description de chaque champ, index des erreurs avec causes et corrections, cas particuliers — vous est remise à l'ouverture de votre accès.

Questions fréquentes