Connecter Dokos à vos autres outils

Quand les flux de base fonctionnent, reliez Dokos à vos autres outils. Chaque connexion supprime une ressaisie. Commencez par la banque : c'est elle qui fait gagner le plus de temps.

Prérequis

• Le rôle Gestionnaire système pour configurer une intégration.
• Les identifiants du service à connecter : banque, plateforme de paiement, outil tiers.

Banque

Dokos importe ou synchronise vos relevés bancaires, puis vous aide à rapprocher chaque transaction d'un paiement.

1. Créez le Compte bancaire de la société et liez-le à son compte comptable (512…). Voir Compte bancaire.
2. Connectez la banque, ou importez les relevés. Voir Open Banking et Synchronisation bancaire.
3. Rapprochez les transactions. Voir Nouveau module bancaire.

Facturation électronique

Pour émettre et recevoir des factures électroniques par une plateforme agréée, suivez Facturation électronique. La référence technique est dans E-transactions.

Paiements en ligne

Vos clients peuvent payer une facture ou une commande en ligne. Dokos envoie une Demande de paiement avec un lien vers la plateforme. Le paiement reçu crée l'écriture de paiement.

• Plateformes disponibles : Stripe, GoCardless, PayPal, Stancer, HelloAsso, SumUp. Voir Payments.
• Envoi du lien : voir Demande de paiement.
• Prélèvement : voir Prélèvement SEPA.

Boutique et caisse

• Site marchand WooCommerce : voir WooCommerce.
• Caisse Hiboutik : voir Hiboutik.

Intégrations sans code

Pour relier Dokos à un outil qui n'a pas de connecteur dédié (CRM, e-mailing, tableur en ligne) :

• Make et Zapier déclenchent des scénarios à partir des événements Dokos ;
• les webhooks envoient les données d'un document à une adresse web dès qu'il change.

Créer un utilisateur API

Un outil externe se connecte à Dokos avec une clé API. Ne réutilisez pas le compte d'une personne : créez un utilisateur dédié, avec les seuls rôles nécessaires.

Exemple : un outil d'e-mailing qui lit les clients de Dokompany.

1. Créez l'utilisateur integration-emailing@dokompany.fr, de type Utilisateur système.
2. Dans l'onglet Rôles & Autorisations, donnez-lui seulement un rôle qui lit les clients, par exemple Commercial. Pour aller plus loin, limitez-le avec les restrictions utilisateur.
3. Enregistrez, puis dans l'onglet Paramètres, section Accès API, cliquez sur Générer des clés.
4. Une fenêtre affiche la Clé API et le Secret API. Copiez le secret ou téléchargez-le tout de suite et conservez-le dans un coffre-fort de mots de passe.
5. Saisissez la clé et le secret dans l'outil externe.

Si le secret est perdu ou exposé, cliquez à nouveau sur Générer des clés : l'ancien secret cesse de fonctionner. Pour les appels eux-mêmes, voir API REST.

Vérifier

• Les transactions bancaires de la veille apparaissent dans le module bancaire.
• Une demande de paiement de test, payée en mode test de la plateforme, passe la facture à « Payé ».
• L'outil externe lit la liste des clients avec la clé API, et reçoit une erreur d'autorisation s'il tente de lire les factures d'achat.