Clés API & Intégrations — Guide complet
Vue d'ensemble
Le hub API Sync est le centre de contrôle pour connecter vos services tiers à Comptab. Toutes les clés API sont chiffrées dans AWS Secrets Manager (jamais en clair dans la base de données). Une fois connectée, chaque intégration synchronise automatiquement vos revenus et dépenses dans le bon compte du grand livre.
Pour accéder au hub :
- Dans le menu de gauche (sidebar), section Gestion, cliquez sur API sync
- Ou allez directement sur
/integrations
Vous verrez les cartes de chaque service avec leur statut : Connecté (vert ✅) ou À configurer (orange ⚠️).
Étape 1 — Connecter Lodgify (Airbnb, Vrbo, Booking.com)
Lodgify synchronise vos réservations et revenus de location courte durée dans le compte 4100 Revenus location.
Comment obtenir votre clé API Lodgify
- Connectez-vous sur app.lodgify.com
- Cliquez sur votre avatar (coin supérieur droit) → Account Settings
- Dans le menu gauche, cliquez sur API Keys (ou allez dans Settings → Integrations → API)
- Cliquez Generate New API Key — copiez la clé générée (elle ne sera plus visible après)
Saisir la clé dans Comptab
- Dans le hub API Sync, trouvez la carte Lodgify
- Cliquez sur Clé (icône crayon) pour ouvrir le formulaire
- Collez votre clé API dans le champ prévu
- Cliquez Sauvegarder — le statut passe à Connecté ✅
- Cliquez Synchroniser pour lancer la première importation de réservations
Ce qui se passe automatiquement
- Chaque réservation confirmée crée une écriture dans le journal :
DÉBIT 1000 Encaisse / CRÉDIT 4100 Revenus location - Les annulations génèrent une écriture de contrepassation automatique
- La sync nocturne s'exécute à 3h00 UTC chaque nuit via EventBridge
Étape 2 — Connecter Nayax (Buanderie commerciale)
Nayax synchronise les revenus de vos machines à laver et sécheuses dans le compte 4200 Revenus buanderie.
Comment obtenir votre clé API Nayax
- Connectez-vous sur connect.nayax.com
- Dans le menu, allez dans Settings → API Management → API Keys
- Cliquez Create New Key — copiez la clé et notez l'ID de votre opérateur
Saisir la clé dans Comptab
- Dans le hub API Sync, trouvez la carte Nayax
- Cliquez sur Connecter Nayax
- Entrez votre clé API et votre Operator ID
- Cliquez Sauvegarder — le statut passe à Connecté ✅
Ce qui se passe automatiquement
- Chaque transaction de machine (lavage ou séchage) crée une micro-écriture :
DÉBIT 1020 Fonds non déposés — Nayax / CRÉDIT 4200 Revenus buanderie— le dépôt Nayax au compte règle ensuite 1020 - Les transactions sont identifiées par machine (
NAYAX-{terminal_id}) — idempotentes (pas de doublons) - Le rapport Buanderie par machine (
/rapports/nayax) affiche les revenus mensuels par appareil
Étape 3 — Connecter Turno (Ménages post-checkout Airbnb)
Turno automatise la création des factures de ménage dans Comptab dès qu'un nettoyage est planifié dans votre channel manager.
Comment obtenir votre token Turno
- Connectez-vous sur app.turno.com
- Allez dans Settings → API → Personal Access Token
- Cliquez Generate Token — copiez le token JWT
Saisir le token dans Comptab
- Dans le hub API Sync, trouvez la carte Turno
- Cliquez sur Connecter Turno
- Collez votre token dans le champ Bearer Token
- Cliquez Sauvegarder — le statut passe à Connecté ✅
Ce qui se passe automatiquement
- Dès qu'un ménage est confirmé dans Turno, une facture fournisseur est créée dans Comptab
- L'écriture générée :
DÉBIT 6120 Entretien / CRÉDIT 2100 Comptes fournisseurs - La propriété concernée est automatiquement liée à la facture
Étape 4 — Configurer Stripe (Paiements en ligne)
Stripe permet d'encaisser vos factures clients directement depuis Comptab.
Stripe est déjà configuré côté serveur
Pour la plupart des utilisateurs, Stripe est pré-configuré (statut Connecté ✅ visible dans Paramètres). Aucune action n'est requise.
Si vous devez mettre à jour les clés Stripe
- Connectez-vous sur dashboard.stripe.com
- Allez dans Developers → API keys
- Copiez la Publishable key et la Secret key (mode Live)
- Contactez info@groupeb.ca pour mettre à jour les clés — cette opération est effectuée de façon sécurisée côté serveur
Comment utiliser Stripe pour encaisser
- Créez une vente dans
/ventes/nouvelle - Cliquez Générer lien de paiement Stripe
- Envoyez le lien à votre client par courriel
- Dès le paiement reçu, le journal entry est créé automatiquement :
DÉBIT 1000 Encaisse / CRÉDIT 4300 Revenus directs
Étape 5 — Connecter Plaid (Compte bancaire)
Plaid importe automatiquement vos transactions bancaires (Desjardins, BNC, TD, RBC, etc.) pour faciliter la réconciliation.
Comment connecter votre banque via Plaid
- Dans le sidebar, section Bancaire, cliquez sur Comptes bancaires (Plaid)
- Cliquez Connecter une banque
- Une fenêtre Plaid s'ouvre — choisissez votre institution financière
- Entrez vos identifiants bancaires (ils ne sont jamais stockés dans Comptab — Plaid est une tierce partie certifiée)
- Sélectionnez les comptes à synchroniser et confirmez
Ce qui se passe automatiquement
- Les transactions bancaires apparaissent dans Réconciliation bancaire (
/banque) - L'algorithme de matching les associe automatiquement aux écritures du journal
- Les transactions non matchées sont signalées pour validation manuelle
Étape 6 — Importer Wealthsimple (Manuel CSV)
Wealthsimple n'offre pas d'API publique. L'import se fait manuellement.
- Dans Wealthsimple, exportez vos transactions en CSV (Compte → Historique → Exporter)
- Dans Comptab, allez dans Comptes bancaires (Plaid) → Importer CSV
- Sélectionnez votre fichier CSV et confirmez l'import
- Les transactions apparaissent dans la réconciliation pour validation
Vérifier l'état d'une intégration
Pour confirmer qu'une intégration fonctionne :
- Allez dans le hub API Sync — le badge Connecté ✅ doit être vert
- Vérifiez la Dernière synchronisation — elle doit être récente (< 24h pour les intégrations actives)
- Dans Journal & Grand livre (
/comptabilite), vérifiez que des entrées récentes apparaissent avec la bonne source (lodgify, nayax, turno, stripe)
FAQ rapide sur les intégrations
Q : Mes données Airbnb n'apparaissent pas. Que faire ? R : Vérifiez que votre clé API Lodgify est valide (générez-en une nouvelle si besoin). Cliquez Synchroniser manuellement dans la carte Lodgify.
Q : La sync Nayax montre des transactions en double. R : Impossible — le système est idempotent (chaque transaction est identifiée par un ID unique Nayax). Contactez le support si vous voyez des doublons.
Q : Puis-je connecter plusieurs propriétés Lodgify ? R : Oui — une seule clé API Lodgify suffit pour synchroniser toutes vos propriétés associées au compte.
Q : Mes clés API sont-elles sécurisées ? R : Oui. Toutes les clés sont chiffrées dans AWS Secrets Manager (AES-256 via KMS) avec audit complet via CloudTrail. Elles ne sont jamais visibles en clair dans la base de données.
Q : Que se passe-t-il si je change ma clé API chez le fournisseur ? R : Retournez dans le hub API Sync, cliquez sur la carte concernée et collez la nouvelle clé. L'ancienne est automatiquement remplacée.