Synchronisation avec Frappe CRM

Dokos permet de synchroniser les données entre votre instance Frappe CRM et Dokos pour centraliser la gestion de vos prospects et clients.

Cette fonctionnalité est particulièrement utile si vous utilisez déjà Frappe CRM pour suivre vos opportunités commerciales et souhaitez éviter la double saisie des informations.

Activer la synchronisation

Pour activer la synchronisation avec Frappe CRM :

1. Allez dans CRM > Paramètres > Paramètres CRM.
2. Dans la section Frappe CRM, activez l'option Activer la synchronisation des données Frappe CRM.

      
flowchart TD
    A[Accéder aux Paramètres CRM] --> B[Activer la synchronisation]
    B --> C[Ajouter des utilisateurs autorisés]
    C --> D[Sauvegarder]

    

Une fois activée, Dokos créera automatiquement les champs personnalisés suivants :

• crm_deal sur le document Devis pour lier un devis à une opportunité Frappe CRM.
• crm_deal sur le document Client pour lier un client à une opportunité Frappe CRM.

::: info Si vous désactivez la synchronisation, les champs personnalisés seront automatiquement supprimés. :::

Gérer les utilisateurs autorisés

Seuls les utilisateurs listés dans la table Utilisateurs autorisés pour Frappe CRM peuvent pousser des données depuis Frappe CRM vers Dokos.

Pour ajouter un utilisateur :

1. Dans les Paramètres CRM, allez dans la section Frappe CRM.
2. Dans la table Utilisateurs autorisés pour Frappe CRM, cliquez sur Ajouter une ligne.
3. Sélectionnez l'utilisateur dans la liste.
4. Sauvegardez les modifications.

      
flowchart TD
    A[Ouvrir Paramètres CRM] --> B[Accéder à la section Frappe CRM]
    B --> C[Ajouter un utilisateur dans la table]
    C --> D[Sélectionner l'utilisateur]
    D --> E[Sauvegarder]

    

::: warning Si la synchronisation est activée mais qu'aucun utilisateur n'est autorisé, Dokos bloquera toute tentative de synchronisation. :::

Fonctionnement de la synchronisation

Création d'un prospect depuis Frappe CRM

Lorsqu'un utilisateur autorisé envoie une requête depuis Frappe CRM pour créer un prospect dans Dokos :

1. Dokos vérifie que la synchronisation est activée.
2. Dokos vérifie que l'utilisateur est autorisé.
3. Si les deux conditions sont remplies, Dokos crée un prospect dans Dokos et lie l'opportunité Frappe CRM via le champ crm_deal.

Création d'un client depuis Frappe CRM

Lorsqu'un utilisateur autorisé envoie une requête depuis Frappe CRM pour créer un client dans Dokos :

1. Dokos vérifie que la synchronisation est activée.
2. Dokos vérifie que l'utilisateur est autorisé.
3. Si les deux conditions sont remplies, Dokos crée un client dans Dokos et lie l'opportunité Frappe CRM via le champ crm_deal.

      
flowchart TD
    A[Requête depuis Frappe CRM] --> B[Vérifier synchronisation activée]
    B -- Non --> C[Erreur 417]
    B -- Oui --> D[Vérifier utilisateur autorisé]
    D -- Non --> E[Erreur 403]
    D -- Oui --> F[Créer prospect/client]

    

Exemple d'utilisation

Scénario : Vous utilisez Frappe CRM pour suivre une opportunité avec le client Maison Verte SARL. Vous souhaitez créer un devis dans Dokos pour cette opportunité.

1. Depuis Frappe CRM, un utilisateur autorisé envoie une requête pour créer un prospect dans Dokos.
2. Dokos crée le prospect Maison Verte SARL et lie l'opportunité Frappe CRM via le champ crm_deal.
3. Vous créez un devis dans Dokos pour ce prospect.
4. Le champ crm_deal du devis est automatiquement rempli avec l'identifiant de l'opportunité Frappe CRM.

Cette synchronisation permet de suivre facilement le lien entre vos opportunités Frappe CRM et vos documents Dokos (devis, clients).