L’API publique, en REST et JSON, relie votre SIRH ou votre ERP à Puncto. Vous pouvez y créer des embauches, des avenants, des absences, des variables de paie et des documents, et y lire toutes les données de la paie.
Le serveur MCP donne à Claude, ChatGPT ou Cursor un accès à la paie, avec les droits de la personne qui le connecte. L’assistant peut consulter les données et, si cette personne l’autorise, saisir des absences, des variables du mois, des avenants et des invitations.
Ce que permet l’API
| Ressource | Opérations |
|---|---|
| Collaborateurs | Lister, consulter, créer avec leur premier contrat, renseigner l’identifiant de votre système et le manager |
| Contrats | Lister, consulter, créer (nouvelle embauche ou réembauche) |
| Avenants | Créer ou modifier un avenant à une date d’effet, changer l’établissement ou le lieu de travail |
| Périodes d’essai | Consulter, renouveler ou valider |
| Absences | Lister, consulter, créer, modifier, accepter, refuser ou annuler, hors arrêts de travail |
| Variables de paie | Lister, consulter, importer, valider ou refuser, supprimer : primes, heures supplémentaires, retenues, avantages en nature, indemnités, télétravail |
| Astreintes | Lister les types, lister, créer, modifier ou supprimer les périodes |
| Variables récurrentes | Lister, importer, arrêter ou supprimer les primes et avantages versés chaque mois |
| Documents | Envoyer un contrat signé ou un avenant, lister, consulter, télécharger, supprimer |
| Entreprise | Consulter l’entreprise, ses établissements, postes, équipes, contrats de mutuelle et de prévoyance |
| Temps et congés | Lister les soldes de congés, jours de télétravail, feuilles de temps et relevés forfait jours |
| Déclarations | Lister les mois de paie et le suivi des DSN, DPAE et signalements |
| Bulletins de paie | Lister les bulletins validés avec leurs totaux, consulter leurs lignes telles qu’imprimées, télécharger le PDF |
| Rapports | Obtenir les données de l’index de l’égalité professionnelle d’une période de référence |
Premier appel
curl https://api.puncto.fr/public/v1/collaborators \
-H "Authorization: Bearer $PUNCTO_TOKEN"Pour obtenir une clé d’API, voir Authentification. Pour générer un client, téléchargez la spécification OpenAPI.