Aller au contenu

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.

BesoinConnecteurCe qu'il faitStatut
Facturation électroniquePlateforme agréée de chaque sociétéDépose, reçoit et suit les factures électroniques (Pennylane et autres plateformes agréées).Bientôt
BanquesAgrégateur bancaire agréé (connexion DSP2)Synchronise les comptes et les opérations de toutes vos banques.Bientôt
PaieLogiciel de paie de votre cabinet ou le vôtreExporte les variables de paie et les absences.Sur demande
PaiementPrélèvement SEPA et carte bancaireEncaisse les factures et les commandes en ligne.Disponible
SMSService d'envoi de SMS (option)Envoie rappels et confirmations depuis le dossier.Disponible
CourrierService de courrier postal (option)Poste les lettres de relance et les documents.Disponible
Signature électroniqueService de signature (option)Fait signer devis et contrats avec preuve.Disponible
Bureautique en ligneSuite bureautique intégrée (option)Modifie les documents sans les télécharger.Disponible
ExpéditionsCompte transporteur à votre nomImprime les étiquettes et suit les colis.Disponible
ÉcransLecteur KordeosAffiche vos indicateurs sur vos téléviseurs.Disponible
Vos applicationsAPI et webhooksRelient 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.