Intégrations & API

C’est quoi ?

Les Intégrations & API, c’est la possibilité de connecter Capnio à vos autres logiciels. Par exemple, connecter votre caisse enregistreuse, votre logiciel de comptabilité ou votre système de commande fournisseur.

C’est comme brancher des appareils entre eux pour qu’ils se parlent. Votre caisse dit à Capnio “j’ai encaissé 25 euros”, et Capnio enregistre tout automatiquement sans que vous ayez à taper quoi que ce soit.

À quoi ça sert ?

Automatiser les tâches : les données passent d’un logiciel à l’autre sans intervention manuelle
Éviter les erreurs : pas de double saisie, pas de copier-coller qui se trompe
Gagner du temps : tout est synchronisé automatiquement
Centraliser vos données : toutes les informations sont dans Capnio, même si elles viennent d’autres logiciels
Développer des outils sur mesure : si vous êtes développeur, vous pouvez créer vos propres intégrations

Comment ça marche ?

Pour les managers (sans code)

Allez dans le menu Paramètres → Intégrations
Parcourez la liste des intégrations disponibles :
- Systèmes de caisse (POS)
- Logiciels de comptabilité
- Outils de commande fournisseur
- Services de notification
Cliquez sur l’intégration que vous souhaitez activer
Suivez les instructions de connexion (en général, il suffit de se connecter à l’autre service et d’autoriser Capnio)
Configurez les options (quelles données synchroniser, à quelle fréquence)
Testez la connexion en cliquant sur “Tester”

Pour les développeurs (avec code)

Capnio propose une API REST complète pour interagir avec toutes les données de votre établissement.

Clé API

Allez dans Paramètres → Intégrations → API
Cliquez sur “Générer une clé API”
Donnez un nom à la clé (par exemple : “Intégration comptabilité”)
Copiez la clé générée et conservez-la en lieu sûr (elle ne sera plus affichée après)

Exemples d’appels API

curl -X GET https://api.capnio.pro/v1/employees \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json"

Réponse :

{
  "data": [
    {
      "id": "emp_abc123",
      "firstName": "Marie",
      "lastName": "Dupont",
      "position": "Cuisinière",
      "email": "marie@example.com",
      "status": "active"
    }
  ],
  "total": 12,
  "page": 1
}

curl -X POST https://api.capnio.pro/v1/cash-movements \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "withdrawal",
    "amount": 50.00,
    "reason": "supplier_purchase",
    "comment": "Achat de farine chez Metro"
  }'

Réponse :

{
  "id": "mov_xyz789",
  "type": "withdrawal",
  "amount": 50.00,
  "reason": "supplier_purchase",
  "comment": "Achat de farine chez Metro",
  "createdAt": "2025-01-15T14:30:00Z",
  "createdBy": "api"
}

curl -X GET https://api.capnio.pro/v1/equipment/eq_frigo01/readings \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -G -d "from=2025-01-15T00:00:00Z" \
     -d "to=2025-01-15T23:59:59Z"

Réponse :

{
  "equipmentId": "eq_frigo01",
  "equipmentName": "Frigo viandes cuisine",
  "readings": [
    {
      "temperature": 3.2,
      "recordedAt": "2025-01-15T08:00:00Z",
      "source": "manual"
    },
    {
      "temperature": 3.5,
      "recordedAt": "2025-01-15T18:00:00Z",
      "source": "iot_sensor"
    }
  ]
}

Webhooks

Les webhooks permettent à Capnio d’envoyer des données automatiquement vers votre serveur quand un événement se produit.

Allez dans Paramètres → Intégrations → Webhooks
Cliquez sur + Nouveau webhook
Entrez l’URL de votre serveur (par exemple : https://monserveur.com/capnio-webhook)
Sélectionnez les événements qui déclenchent le webhook :
- employee.clocked_in : un employé a pointé son arrivée
- employee.clocked_out : un employé a pointé son départ
- cash.closure_completed : une clôture de caisse est validée
- haccp.alert_triggered : une alerte HACCP est déclenchée
- equipment.temperature_alert : dépassement de température
Testez le webhook en cliquant sur Envoyer un test
Enregistrez

Limites de l’API

Paramètre	Valeur
Requêtes par minute	60
Requêtes par jour	10 000
Taille maximale du body	1 Mo
Formats supportés	JSON
Authentification	Bearer Token
Versioning	v1 (actuel)

Logs API

Capnio enregistre toutes les requêtes API pour vous aider à débuguer :

Date et heure de la requête
Méthode et URL (GET /v1/employees)
Code de réponse (200, 400, 401, 500)
Temps de réponse (en millisecondes)
Clé API utilisée

Les logs sont conservés pendant 30 jours.

Les boutons et options

Bouton / Option	Ce que ça fait
Intégrations disponibles	Liste des services connectables sans code
Générer une clé API	Créer une nouvelle clé pour l’API
Gérer les clés	Voir, renommer ou supprimer vos clés API
Webhooks	Configurer les envois automatiques de données
Logs API	Voir l’historique des requêtes API
Documentation API	Lien vers la documentation technique complète

Questions fréquentes

J’ai besoin d’être développeur pour utiliser les intégrations ? Non. Les intégrations “sans code” (caisse, comptabilité) se configurent en quelques clics. L’API et les webhooks sont destinés aux développeurs ou aux prestataires techniques.

Combien d’intégrations puis-je activer ? Autant que vous voulez. Il n’y a pas de limite sur le nombre d’intégrations ou de clés API.

L’API est-elle gratuite ? L’accès à l’API est inclus dans tous les abonnements Capnio. Les limites de requêtes varient selon votre plan.

Mon intégration ne fonctionne pas, que faire ? Vérifiez les logs API pour identifier l’erreur. Les codes courants sont : 401 (clé invalide), 429 (trop de requêtes), 500 (erreur serveur). Contactez le support si le problème persiste.

Astuce

Si vous utilisez un logiciel de caisse (POS), connectez-le en premier. C’est l’intégration qui vous fera gagner le plus de temps car les ventes seront enregistrées automatiquement dans Capnio, sans aucune saisie manuelle.