Que permet l'API Combo ?
📤 Lire des données depuis Combo
Établissements
Récupérer la liste de vos établissements et de leurs équipes.
Planning
Récupérer les shifts des plannings publiés sur une période donnée (filtrables par établissement, équipe, étiquette, jusqu'à 40 jours).
Consulter le détail d'un shift : horaires prévus, horaires réels, pauses, notes, pointages (entrée/sortie).
Récupérer les absences et congés de vos salariés sur une période donnée.
Contrats & employés
Lister les contrats actifs d'un établissement à une date donnée.
Consulter l'historique complet d'un contrat et de ses avenants.
Récupérer les contrats terminés sur une période (résultats paginés par 50).
Pour chaque contrat, les données disponibles incluent notamment : nom, prénom, nom de naissance, numéro de sécurité sociale, nationalité, adresse, type de contrat (CDI, CDD, apprentissage, intérim, saisonnier, stagiaire, extra…), temps de travail hebdomadaire, jours travaillés par semaine, forfait jours, salaire brut mensuel, salaire brut horaire, taux horaire chargé, motif de fin de contrat, poste, équipe, identifiants partenaires.
Chiffre d'affaires
Récupérer les CA prévisionnels et réels de tous les établissements pour une semaine donnée.
📥 Envoyer des données vers Combo
Chiffre d'affaires
Envoyer ou mettre à jour un CA (prévisionnel ou réel) pour un établissement et une date donnée.
Identifiants salariés
Créer ou mettre à jour le matricule d'un salarié pour un partenaire donné (utile pour faire le lien entre Combo et un logiciel de paie ou un outil tiers).
Comment activer et configurer l'API Combo ?
Étape 1 — Obtenir votre clé API
Contactez l'équipe support Combo via la bulle de tchat ou à [email protected] pour qu'elle vous fournisse votre token.
Conservez précieusement cette clé : elle est personnelle, ne peut pas être régénérée et donne accès à l'ensemble des données de votre compte Combo.
Pour chaque appel API, ajoutez ce header : Authorization: Bearer [VOTRE_TOKEN].
Chaque clé doit être utilisée pour un outil en particulier.
Étape 2 — Récupérer l'identifiant partenaire d'un établissement (optionnel)
Utile uniquement si vous souhaitez filtrer les données par établissement.
Rendez-vous dans Configuration > Établissements & Plannings :
Cliquez sur l'établissement souhaité.
Cliquez sur Modifier l'établissement.
Faites défiler jusqu'en bas et copiez l'identifiant partenaire.
Quelles sont les contraintes techniques de notre API ?
Limite de débit : 1 000 appels par minute. En cas de dépassement, l'IP est bloquée pendant 1 heure.
Format des dates : ISO 8601 obligatoire (ex.
2024-08-30).Chiffrement : HTTPS requis.
Timeout : 90 secondes.
Planning : seuls les plannings publiés sont accessibles via l'API.
FAQ
L'API est-elle disponible avec tous les abonnements ?
L'API est-elle disponible avec tous les abonnements ?
Non, elle est disponible uniquement avec l'abonnement People.
Comment obtenir ma clé API ?
Comment obtenir ma clé API ?
Contactez le support Combo par chat ou à l'adresse mail [email protected].
La clé API expire-t-elle ?
La clé API expire-t-elle ?
Non, la clé API ne expire pas et ne peut pas être régénérée. Conservez-la en sécurité.
À quoi sert l'identifiant partenaire d'un établissement ?
À quoi sert l'identifiant partenaire d'un établissement ?
Il permet de filtrer les données renvoyées par l'API par établissement.
La clé API donne-t-elle accès à tous mes établissements ?
La clé API donne-t-elle accès à tous mes établissements ?
Oui, elle donne accès à l'ensemble des données du compte, tous établissements confondus.
Où trouver la documentation technique complète ?
Où trouver la documentation technique complète ?
Prérequis :
Disposer de l'abonnement People.
Avoir contacté le support Combo pour obtenir votre clé API (token).