API & intégrations
Une API complète pour relier Kordeos à tout ce que vous utilisez déjà
Chaque donnée de Kordeos se lit et s'écrit par une API REST documentée. Portail client maison, site marchand, outil métier, automatisation, tableau de bord externe : vous décidez de ce qui se branche, et Kordeos reste le référentiel.
Ce que l'API ouvre
Sociétés, contacts, opportunités, devis, factures, avoirs, paiements, produits, stock et mouvements, commandes, projets, interventions, temps, documents, messages, utilisateurs et droits. Les données sensibles (paie, dossiers salariés) ne sont accessibles qu'avec une portée dédiée, accordée explicitement par l'administrateur de l'instance.
Comment elle est conçue
REST, JSON, OpenAPI, webhooks signés
Une API prévisible, documentée et rétrocompatible, pensée pour être branchée par vos équipes ou votre prestataire.
- REST en JSON, référence OpenAPI 3.1, versionnée (/v1), rétrocompatible pendant au moins 18 mois après l'annonce d'un changement
- Authentification par clé d'application ou OAuth 2.0 ; droits par portée (invoices:read, stock:write…) et par société
- Webhooks signés sur chaque événement : facture payée, commande créée, stock sous le seuil, intervention terminée ; relecture possible depuis la console
- Pagination par curseur, filtres et tri sur chaque liste, écritures idempotentes, erreurs explicites en français et en anglais
- Limitation de débit annoncée dans les en-têtes, journal des appels consultable par application
- Environnement de test gratuit, avec des données de démonstration, pour développer avant la mise en production
- Import et export dans tous les formats courants : CSV, Excel, OFX, PDF, Factur-X
GET https://api.kordeos.fr/v1/invoices?status=overdue&company=atelier-morel
Authorization: Bearer kd_live_…
{
"data": [
{
"id": "inv_01J9Z4",
"number": "F-2026-0412",
"customer": { "id": "cus_8F2K", "name": "Menuiserie Lacombe" },
"total_ttc": 3480.00,
"due_date": "2026-10-10",
"status": "overdue",
"days_overdue": 15
}
],
"next_cursor": "eyJpZCI6ImludjAxSjlaNCJ9"
}Cas d'usage
Ce que nos clients branchent sur l'API
Portail client existant
Un espace adhérent ou un portail client alimenté par les factures et les documents de Kordeos.
Site marchand grand public
Un site qui pousse ses commandes dans le stock et la facturation, sans ressaisie.
Outil métier spécifique
Planning de production, logiciel de pesée, caisse : relié au référentiel.
Automatisations
Scénarios n8n, Make ou Zapier déclenchés par les webhooks.
Tableaux de bord externes
Metabase, Power BI ou Looker Studio par export planifié ou lecture directe.
Import et export
Tous les formats courants, pour entrer et sortir vos données librement.
Connecteurs
Les connecteurs reliés aux services que vous utilisez déjà. Le statut de chaque connecteur est tenu à jour ici.
| Besoin | Connecteur | Ce qu'il fait | Statut |
|---|---|---|---|
| Facturation électronique | Plateforme agréée de chaque société | Dépose, reçoit et suit les factures électroniques (Pennylane et autres plateformes agréées). | Bientôt |
| Banques | Agrégateur bancaire agréé (connexion DSP2) | Synchronise les comptes et les opérations de toutes vos banques. | Bientôt |
| Paie | Logiciel de paie de votre cabinet ou le vôtre | Exporte les variables de paie et les absences. | Sur demande |
| Paiement | Prélèvement SEPA et carte bancaire | Encaisse les factures et les commandes en ligne. | Disponible |
| SMS | Service d'envoi de SMS (option) | Envoie rappels et confirmations depuis le dossier. | Disponible |
| Courrier | Service de courrier postal (option) | Poste les lettres de relance et les documents. | Disponible |
| Signature électronique | Service de signature (option) | Fait signer devis et contrats avec preuve. | Disponible |
| Bureautique en ligne | Suite bureautique intégrée (option) | Modifie les documents sans les télécharger. | Disponible |
| Expéditions | Compte transporteur à votre nom | Imprime les étiquettes et suit les colis. | Disponible |
| Écrans | Lecteur Kordeos | Affiche vos indicateurs sur vos téléviseurs. | Disponible |
| Vos applications | API et webhooks | Relient n'importe quel outil au référentiel. | Disponible |
Documentation
- Référence OpenAPI complète, guides de démarrage et collection Postman sur developers.kordeos.fr (ouverture avec les premiers accès à l'environnement de test)
- Journal des changements de l'API, avec date d'effet et période de compatibilité
Questions fréquentes
L'API est-elle incluse ?
Oui, l'accès à l'API et aux webhooks est compris dans la plateforme. Seul le volume d'appels très élevé fait l'objet d'un échange préalable.
Puis-je garder mon site marchand ?
Oui. Il se branche par l'API pour les produits, le stock, les commandes et les factures.
Qui développe l'intégration ?
Vous, votre prestataire, ou nos équipes dans le cadre d'un développement sur mesure (voir Services).
Demander un accès à l'environnement de test
Un environnement gratuit, avec des données de démonstration, pour développer avant la mise en production.