Documentation
Intégrations

Intégration MyUnisoft

Connectez Dokos à MyUnisoft pour synchroniser automatiquement vos écritures comptables françaises.

:::dokos Les fonctionnalités décrites sur cette page sont disponibles dans la version 5 et supérieure de Dokos. :::

Présentation

MyUnisoft est un logiciel de comptabilité français en ligne. L'intégration avec Dokos vous permet de :

  • Exporter vos écritures comptables Dokos vers MyUnisoft pour qu'elles soient traitées par votre comptable.
  • Importer dans Dokos les écritures de centralisation et de lettrage saisies par votre comptable dans MyUnisoft.
  • Réconcilier automatiquement les écritures Dokos et MyUnisoft via un système de correspondances.

Cette intégration s'adresse aux entreprises françaises qui utilisent MyUnisoft comme logiciel de comptabilité et souhaitent automatiser l'échange de données avec leur ERP.

Prérequis

Pour configurer l'intégration, vous devez disposer :

  1. D'un compte MyUnisoft avec accès API.
  2. Des identifiants API fournis par MyUnisoft (client ID, client secret).
  3. De droits d'administrateur sur votre site Dokos.

Configuration

1. Créer la connexion MyUnisoft

La connexion contient les informations d'authentification qui permettent à Dokos de communiquer avec MyUnisoft.

  1. Allez dans Recherche → MyUnisoft Connection.
  2. Cliquez sur Ajouter.
  3. Renseignez :
    • Nom de la connexion : un nom de votre choix (ex. MyUnisoft - Maison Verte).
    • Client ID et Client Secret : vos identifiants MyUnisoft.
    • Environnement : choisissez Production ou Test selon votre configuration MyUnisoft.
  4. Enregistrez, puis cliquez sur Tester la connexion pour vérifier que Dokos peut communiquer avec MyUnisoft.

:::tip Si le test échoue, vérifiez que vos identifiants sont corrects et que l'API MyUnisoft est activée sur votre compte. :::

2. Configurer les correspondances de comptes

Chaque compte comptable Dokos doit être associé à son équivalent MyUnisoft. Les correspondances permettent à Dokos de savoir vers quel compte MyUnisoft envoyer chaque écriture.

  1. Allez dans Recherche → MyUnisoft Account Mapping.
  2. Cliquez sur Ajouter.
  3. Sélectionnez :
    • Connexion MyUnisoft : la connexion créée à l'étape précédente.
    • Compte Dokos : le compte de votre plan comptable Dokos.
    • Compte MyUnisoft : le compte correspondant dans le plan comptable MyUnisoft.
  4. Répétez l'opération pour chaque compte que vous souhaitez synchroniser.

:::example Pour Maison Verte SARL, le compte Dokos 411000 - Clients sera associé au compte MyUnisoft 411000 - Clients. :::

3. Configurer les correspondances de journaux

De la même façon, chaque journal Dokos (ventes, achats, banque, etc.) doit être associé au journal MyUnisoft correspondant.

  1. Allez dans Recherche → MyUnisoft Journal Mapping.
  2. Cliquez sur Ajouter.
  3. Associez chaque journal Dokos à son équivalent MyUnisoft.
  4. Enregistrez.

Utilisation

Exporter des écritures vers MyUnisoft

Une fois la configuration terminée, les écritures comptables validées dans Dokos peuvent être envoyées vers MyUnisoft.

  1. Allez dans Recherche → MyUnisoft Entry Sync.
  2. Cliquez sur Ajouter pour créer une nouvelle synchronisation d'écritures.
  3. Sélectionnez la connexion MyUnisoft et la période concernée.
  4. Lancez la synchronisation. Dokos transmet les écritures à MyUnisoft.
  5. Un journal d'import est automatiquement créé pour chaque écriture envoyée, afin de garder une trace de l'opération.

Vous pouvez consulter l'historique des synchronisations depuis la liste MyUnisoft Entry Sync List.

Importer les écritures MyUnisoft vers Dokos

Votre comptable peut saisir dans MyUnisoft des écritures de centralisation ou de lettrage (amortissements, provisions, etc.) qui n'existent pas dans Dokos. L'intégration permet de les rapatrier automatiquement.

  1. Allez dans Recherche → MyUnisoft Entry Sync.
  2. Créez une synchronisation en mode Import.
  3. Sélectionnez la connexion et la période.
  4. Lancez la synchronisation. Dokos importe les écritures MyUnisoft manquantes.

Suivre l'historique des imports

Chaque opération d'import ou d'export est tracée dans un journal d'import MyUnisoft.

  1. Allez dans Recherche → MyUnisoft Import Log.
  2. Vous y retrouvez, pour chaque écriture :
    • Le statut de l'envoi ou de la réception (Succès, Échec).
    • La date de l'opération.
    • Le message éventuel renvoyé par MyUnisoft.

Cette liste est également accessible depuis le menu MyUnisoft Import Log List.

Gestion des erreurs

Écriture en échec

Lorsqu'une écriture ne peut pas être envoyée ou reçue (compte non mappé, journal inconnu, erreur API), elle apparaît en statut Échec dans le journal d'import avec un message explicatif.

Actions correctives :

  1. Ouvrez le journal d'import correspondant pour lire le message d'erreur.
  2. Complétez les correspondances de comptes ou de journaux manquantes.
  3. Relancez la synchronisation.

Connexion indisponible

Si la connexion à MyUnisoft échoue, vérifiez dans MyUnisoft Connection que :

  • Les identifiants sont toujours valides.
  • L'environnement sélectionné correspond bien à votre abonnement MyUnisoft.
  • Le bouton Tester la connexion renvoie un résultat positif.

Exemple complet : Maison Verte SARL

Maison Verte SARL utilise Dokos pour la facturation et les achats, et MyUnisoft pour la comptabilité.

  1. Le comptable configure la connexion MyUnisoft avec les identifiants fournis.
  2. Il crée les correspondances de comptes et de journaux.
  3. Chaque mois, il lance une synchronisation d'export pour envoyer les écritures de ventes et d'achats du mois écoulé.
  4. En fin d'exercice, il lance une synchronisation d'import pour récupérer les écritures d'amortissement et de provisions saisies dans MyUnisoft.
  5. Il consulte le journal d'import pour vérifier qu'aucune écriture n'est en échec.

Points de vigilance

  • Période de synchronisation : choisissez toujours une période close pour éviter d'envoyer des écritures modifiables.
  • Comptes non mappés : toute écriture contenant un compte sans correspondance échouera à l'envoi.
  • Environnement : un environnement Test ne doit pas être utilisé pour des exports réels.
  • Réconciliation : les écritures importées de MyUnisoft apparaissent comme des écritures normales dans Dokos et peuvent être réconciliées manuellement.