Intégration MyUnisoft
Intégration MyUnisoft
MyUnisoft est un logiciel de comptabilité en ligne utilisé par de nombreux cabinets d'expertise comptable. L'intégration relie une société Dokos au dossier MyUnisoft de votre comptable :
- Export : Dokos envoie ses écritures comptables validées dans le dossier MyUnisoft.
- Import : Dokos récupère les écritures saisies par le comptable dans MyUnisoft. Une personne les accepte ou les rejette avant qu'elles deviennent des écritures Dokos.
- Rapprochement : Dokos compare les soldes des deux comptabilités à une date donnée et explique chaque écart.
Les écrans de l'intégration ne sont pas encore traduits : cette page cite leurs libellés en anglais.
Prérequis
- Un dossier MyUnisoft pour la société, et un jeton API généré dans MyUnisoft (Paramètres > Connecteurs).
- Le secret partenaire (« Third Party Secret ») délivré par MyUnisoft.
- Le rôle Responsable comptable ou System Manager dans Dokos.
- Des journaux comptables Dokos. Dokos regroupe les lignes d'une pièce en une écriture numérotée, l'unité que MyUnisoft importe.
1. Créer la connexion
Il y a une MyUnisoft Connection par société.
- Ouvrez la liste MyUnisoft Connection et cliquez sur Créer.
- Remplissez l'onglet Connection :
| Champ | Rôle |
|---|---|
| Company | La société Dokos liée à ce dossier MyUnisoft. |
| Base URL | L'adresse de l'API. https://api.myunisoft.fr/api/v1 par défaut. |
| Access Type | Société : la clé donne accès à un seul dossier. Cabinet : la clé couvre tous les dossiers du cabinet. |
| API Token | Le jeton généré dans MyUnisoft. |
| Third Party Secret | Le secret partenaire délivré par MyUnisoft. |
| Enabled | Active la connexion. |
- Enregistrez.
- Dans le menu Connection, cliquez sur Test connection. Ce test active aussi la clé API côté MyUnisoft.
- Dans le même menu, cliquez sur Fetch society. Dokos remplit MyUnisoft Society ID et Establishment ID.
2. Préparer les référentiels
L'ordre des étapes compte. Une écriture ne peut pas être envoyée si son exercice, son journal ou ses comptes n'existent pas dans MyUnisoft.
- Menu Setup > Create exercices : Dokos crée dans MyUnisoft un exercice pour chaque exercice fiscal Dokos qui a des écritures.
- Menu Setup > Sync journals : Dokos associe chaque Journal comptable à un journal MyUnisoft. Le résultat s'affiche dans l'onglet Mappings, tableau Journal Mappings. Un journal bloqué dans MyUnisoft ne peut pas recevoir d'écritures.
- Menu Setup > Reconcile chart of accounts : Dokos compare les deux plans comptables. Créez les comptes manquants d'un côté ou de l'autre. L'import d'écritures dans MyUnisoft ne crée pas les comptes.
3. Envoyer les écritures à MyUnisoft
Dans l'onglet Push :
| Champ | Rôle |
|---|---|
| Enable Scheduled Push | Envoie une fois par jour les écritures validées. |
| Sync From Date | Les écritures antérieures à cette date ne sont jamais envoyées. |
| Push Attachments | Joint les pièces sources (factures d'achat scannées, PDF des factures de vente) aux écritures MyUnisoft. |
| Push Opening Entries | Quand envoyer les à-nouveaux : Never, When previous exercice is closed (par défaut) ou Always (provisional). |
| Use Auxiliary Accounts For Parties | Passe les lignes de tiers sur un compte auxiliaire au nom du tiers, au lieu du compte collectif. Coché par défaut. |
Le menu Export propose aussi : Preview export (aperçu sans envoi), Push now, Retry failed, Tracked entries, Opening entry et Push attachments.
Chaque écriture a une ligne de suivi MyUnisoft Entry Sync, avec son statut (Pending, Sent, Failed, Skipped), le nombre de tentatives et le message d'erreur. Dokos vérifie dans MyUnisoft qu'une écriture n'existe pas déjà avant de l'envoyer. Un second envoi ne crée donc pas de doublon.
4. Importer les écritures du comptable
Dans l'onglet Import, cochez Enable Scheduled Import et choisissez Import From Date. Une fois par jour, Dokos récupère les écritures saisies dans MyUnisoft et crée une ligne MyUnisoft Import Log au statut Pending Review. Vous pouvez aussi lancer Preview import ou Stage import depuis le menu Import.
Dokos ne crée aucune écriture sans votre accord.
- Ouvrez Import queue (menu Import), ou la liste MyUnisoft Import Log.
- Contrôlez chaque écriture : journal, comptes, montants et problèmes de correspondance.
- Sélectionnez les écritures, puis cliquez sur Accept ou Reject. Un rejet demande un motif.
Pour chaque écriture acceptée, Dokos crée et valide une Écriture de journal. Il la marque aussi comme déjà envoyée, pour ne pas la renvoyer à MyUnisoft.
5. Rapprocher les soldes
Dans l'onglet Reconciliation :
| Champ | Rôle |
|---|---|
| Enable Scheduled Reconciliation | Lance le rapprochement automatiquement. |
| Frequency | Daily, Weekly ou Monthly (par défaut). |
| Tolerance | Écart en dessous duquel un compte est considéré comme rapproché. 0,01 par défaut. |
| Notify On Discrepancy | Adresses e-mail, séparées par des virgules, prévenues seulement en cas d'écart. |
Pour un rapprochement immédiat, cliquez sur Reconcile balances (menu Reconciliation). Le rapport MyUnisoft Reconciliation compare les soldes cumulés depuis le début de l'exercice et les mouvements de la période. Il classe chaque écart : à-nouveaux différents, écriture non envoyée, journal non associé, écriture du comptable, arrondi… Le rapport MyUnisoft Chart of Accounts Reconciliation détaille les écarts de plan comptable.
Tâches planifiées
Une fois par jour, Dokos enchaîne pour chaque société : l'envoi des écritures, l'envoi des pièces jointes, l'import des écritures du comptable, le rapprochement, puis la vérification de la connexion. Une connexion en erreur ne bloque pas les autres sociétés.
Exemple fictif : Maison Verte SARL
- Maison Verte SARL crée sa connexion avec une clé
Société, puis clique sur Test connection et Fetch society. - Elle crée les exercices 2025 et 2026, associe ses journaux VE, AC et BQ, puis crée dans MyUnisoft les trois comptes de charges qui manquaient.
- Elle coche Enable Scheduled Push avec Sync From Date au 1er janvier 2026. Le lendemain, les 412 écritures validées de 2026 ont le statut
Sent. - Le comptable passe une écriture d'amortissement dans MyUnisoft. Elle arrive dans la file d'import. La responsable comptable l'accepte.
- Le rapprochement mensuel affiche un écart de 0,00 € sur tous les comptes.
En cas d'erreur
- Une écriture est en
Failed: ouvrez sa ligne MyUnisoft Entry Sync. Lisez Error Code et Error Message, corrigez la cause (compte manquant, exercice absent, journal bloqué), puis cliquez sur Retry failed. Communiquez le Request ID au support MyUnisoft si besoin. - Une écriture est en
Skipped: elle est hors périmètre, par exemple parce qu'aucun exercice MyUnisoft ne couvre sa date. Créez l'exercice, puis relancez l'envoi. - La connexion échoue : vérifiez le jeton et le secret partenaire, puis relancez Test connection. L'onglet Connection affiche le dernier état dans la section Health.