---
title: "Introduction"
description: "Connectez votre SIRH à Puncto, ou interrogez votre paie depuis un assistant IA."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

L’[API publique](/developpeurs/authentification), 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](/developpeurs/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](/developpeurs/guides/contrats), renseigner l’identifiant de votre système et le manager |
| Contrats | Lister, consulter, [créer](/developpeurs/guides/contrats) (nouvelle embauche ou réembauche) |
| Avenants | [Créer ou modifier un avenant](/developpeurs/guides/avenants) à une date d’effet, changer l’établissement ou le lieu de travail |
| Périodes d’essai | [Consulter, renouveler ou valider](/developpeurs/guides/avenants) |
| Absences | Lister, consulter, créer, modifier, accepter, refuser ou annuler, hors arrêts de travail |
| Variables de paie | Lister, consulter, [importer](/developpeurs/guides/imports), 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](/developpeurs/guides/astreintes) |
| Variables récurrentes | Lister, [importer](/developpeurs/guides/astreintes), arrêter ou supprimer les primes et avantages versés chaque mois |
| Documents | [Envoyer](/developpeurs/guides/documents) 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](/developpeurs/guides/synchronisation) |
| 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](/developpeurs/guides/index-egalite) d’une période de référence |

## Premier appel

```bash
curl https://api.puncto.fr/public/v1/collaborators \
  -H "Authorization: Bearer $PUNCTO_TOKEN"
```

Pour obtenir une clé d’API, voir [Authentification](/developpeurs/authentification). Pour générer un client,
téléchargez la <a href="/openapi.json">spécification OpenAPI</a>.

Source: https://docs.puncto.fr/developpeurs/index.mdx
