Comment utiliser l’API Combo ? | Centre d'aide Combo

Prérequis :

Plan requis : People.
Configuration préalable : La clé API (token) est générée par l'équipe Combo — demandez à contacter notre équipe support via pour en faire la demande.
Ressource technique : L'API n'est pas clé en main. Sa mise en place nécessite un développement de votre côté.

Qu'est-ce que l'API Partenaire Combo ?

L'API (Application Programming Interface) Partenaire est une interface qui permet à deux logiciels de communiquer et d'échanger des données de façon automatisée.

Notre API Combo permet de récupérer les données Combo pour les analyser, les retravailler, les connecter à d'autres outils (dashboards, BI, logiciels de paie…).

Comment obtenir sa clé API ?

La clé API (aussi appelée "token") est générée par notre équipe Combo.

Pour obtenir votre clé, rendez-vous sur partner.combohr.com/swagger :

Cliquez sur le bouton Authorize.
Saisissez votre clé API dans le champ Value.
Cliquez de nouveau sur Authorize, puis sur Close.
Vous êtes maintenant connecté et pouvez exécuter des requêtes en lecture (GET) et en écriture (POST).

💡Le Swagger est la référence exhaustive de tous les endpoints disponibles. Transmettez directement ce lien à votre équipe technique ou développeur — ils sauront quoi en faire.

Quelles données sont accessibles en lecture (GET) ?

Les données suivantes peuvent être exportées de Combo vers votre outil :

Planning : date du shift, heures planifiées de début/fin, heures réelles de début/fin, temps de pause planifié et réel, note planifiée et réelle, nom et prénom de l'employé, équipe planifiée, étiquette.
Contrats : ID salarié, prénom, nom, numéro de sécurité sociale, dates de début et fin de contrat, temps de travail hebdomadaire, nombre de jours travaillés par semaine, type de contrat, équipe de rattachement, rôle, salaire mensuel brut ou taux horaire brut, e-mail, adresse postale, nationalité, poste de travail, statut forfait jour, motif de fin de contrat.
Historique des contrats : historique complet d'un contrat et de ses avenants.
Contrats terminés : contrats clôturés sur une période donnée.
Chiffre d'affaires : CA prévisionnel et CA réel par établissement pour la semaine en cours.

💡 La masse salariale chargée n'est pas exposée directement via l'API. Elle reste calculable à partir des données de salaire brut transmises.

Quelles données sont accessibles en écriture (POST) ?

Les données suivantes peuvent être envoyées vers Combo depuis votre outil :

Chiffre d'affaires : remontée du CA prévisionnel et réel dans le rapport d'analyse Combo — utile si votre logiciel de caisse n'est pas intégré nativement. Le location ID (identifiant de l'établissement) est obligatoire pour chaque envoi.
Matricule employé : mise à jour de l'identifiant employé pour faciliter le matching avec votre logiciel de paie.

💡 L'API ne permet pas de créer des shifts, de publier un planning, ni de créer ou modifier des fiches employés.

Que ne permet pas l'API Combo ?

L'API Partenaire Combo est une API principalement en lecture. Elle ne permet pas :

L'import ou la création de plannings depuis un outil externe.
La création ou modification de fiches employés.
La synchronisation bidirectionnelle automatique.
La connexion native à des logiciels de paie — ces connecteurs fonctionnent via des exports dédiés, distincts de l'API Partenaire.

Comment connecter un logiciel de caisse pour remonter le CA ?

Combo propose des intégrations natives avec les principales caisses du marché, gratuites et réservées aux Admins.

Rendez-vous dans Configuration > Intégrations > Caisse :

Cliquez sur la carte de votre logiciel de caisse.
Authentifiez-vous selon le mode propre à chaque caisse (voir ci-dessous).
Associez chaque caisse à l'établissement Combo correspondant.

Caisses disponibles et mode d'authentification :

Zelty — token récupéré depuis l'interface Zelty, à saisir lors de l'activation. Uniquement disponible en France métropolitaine. Une seule clé API Zelty par compte Combo.
Lightspeed K (iKentoo) — connexion avec vos identifiants Lightspeed. La version L de Lightspeed n'est pas prise en charge.
L'Addition — connexion via UID de compte.
Innovorder, Tiller (Sumup), Despi, CarréPOS, Izi Pass — connexion avec identifiants utilisateur.
Menlog — token fourni par Menlog, à saisir lors de l'activation.
PI Electronique — clés (Secret Key, API Key, Code CDPF) à récupérer auprès de votre référent PI Electronique.

Une fois la caisse connectée, le CA HT remonte automatiquement chaque nuit entre 3h30 et 4h30 (selon le fuseau horaire du compte), à condition que les caisses soient correctement clôturées.

💡

Si votre logiciel de caisse n'est pas dans la liste, utilisez l'API Partenaire (requête POST avec le location ID) pour remonter le CA manuellement.
L'intégration caisse remonte uniquement le CA — elle ne transfère aucune autre donnée vers Combo.

FAQ

Comment vérifier que ma clé API est valide ?

Effectuez une requête GET sur le Swagger. Une réponse 200 OK confirme que votre clé fonctionne. Une erreur 401 Unauthorized indique une clé incorrecte ou expirée — contactez [email protected].

Ma clé API fonctionne-t-elle pour tous mes établissements ?

Oui, un seul token couvre l'ensemble du compte. Utilisez le location ID pour filtrer les données par établissement.

Puis-je importer des plannings ou créer des employés via l'API ?

Non. L'API ne permet pas la création de shifts, la publication de plannings ou la création de fiches employés.

Combien de tokens dois-je demander si je veux connecter deux outils ?

Un token par outil.