> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Champs synchronisés avec le CRM

> Référence des champs Qwoty qui peuvent être synchronisés avec un CRM connecté (HubSpot, Salesforce, Pipedrive), en plus de la correspondance des objets de base propre à chaque intégration.

En plus des objets de base décrits sur la page de chaque intégration CRM (client, contact principal, projet/devis, lignes, produit), Qwoty expose un ensemble commun de champs supplémentaires qui peuvent être associés à un champ de votre CRM connecté. Cette référence s’applique de la même façon à [HubSpot](https://docs.qwoty.io/fr/developers/integrations/crm/hubspot.md), [Salesforce](https://docs.qwoty.io/fr/developers/integrations/crm/salesforce.md) et [Pipedrive](https://docs.qwoty.io/fr/developers/integrations/crm/pipedrive.md).

> [!NOTE]
>
> La correspondance des champs se configure pour chaque CRM dans **Paramètres › Développeur › Intégrations** : cliquez sur l’icône des paramètres de la carte du CRM pour ouvrir sa page **Configuration de l'intégration**, celle décrite dans [Correspondance CRM](https://docs.qwoty.io/fr/user-guide/data-model/reference/crm-mapping.md). Une correspondance a l’un des trois sens suivants :
>
> * **↔ Bidirectionnel** : les modifications faites dans l’un des systèmes sont répercutées dans l’autre
> * **CRM → Qwoty** : le CRM fait référence
> * **Qwoty → CRM** : Qwoty fait référence
>
> Le sens ne peut être choisi que pour les champs **client** et **contact** et pour les **champs personnalisés** : ces lignes affichent un sélecteur de sens. Les champs standard **devis** et **produit** sont toujours en **Qwoty → CRM**.
>
> Un champ sans correspondance reste propre à Qwoty.

## Correspondance des objets Qwoty dans chaque CRM

| Objet Qwoty | HubSpot | Salesforce | Pipedrive |
| - | - | - | - |
| Client | Company | Account | Organization |
| Contact principal | Contact | Contact | Person |
| Projet (devis) | Deal | Opportunity | Deal |
| Produit | Product | Product2 | Product |

Les tableaux ci-dessous listent les champs disponibles pour chaque objet, avec la terminologie de Qwoty. Le champ équivalent côté CRM est celui que vous sélectionnez dans la liste déroulante de correspondance de ce CRM.

## Champs du devis (projet)

Tous les champs standard du devis sont synchronisés en **Qwoty → CRM** (sens fixe).

| Champ | Description |
| - | - |
| Project ID | Identifiant interne du devis dans Qwoty |
| Project number | Numéro du devis lisible |
| Status | Statut actuel du devis (brouillon, envoyé, accepté, expiré, perdu…) |
| Title | Titre du devis |
| Issue date (share date) | Date de partage du devis |
| Expiration date | Date d’expiration du devis |
| MRR | Revenu mensuel récurrent généré par le devis |
| ARR | Revenu récurrent annualisé généré par le devis |
| TCV | Valeur totale du contrat sur l’ensemble de l’engagement |
| One-off total | Total des frais ponctuels (non récurrents) du devis |
| First payment total due | Montant dû au premier paiement ou à la première échéance |
| Gross margin | Marge brute calculée sur le devis (renseignée uniquement si la fonctionnalité de marge brute est activée pour votre organisation) |
| Discount rate | Taux de remise global appliqué au devis |
| Number of views | Engagement dans la Dealroom : nombre d’ouvertures du devis par l’acheteur |
| Last active | Engagement dans la Dealroom : dernière interaction de l’acheteur avec le devis |

> [!NOTE]
>
> Le pilotage de l’**étape du deal ou de l’opportunité** par le **statut** est géré séparément de la correspondance des champs : consultez la section dédiée à l’automatisation des étapes sur la page d’intégration de chaque CRM.

## Champs du client

Le nom du client et le lien entre le client et l’entreprise du CRM sont synchronisés avec l’objet de base. Les champs configurables sont :

| Champ | Description | Sens par défaut |
| - | - | - |
| Adresses | Bloc d’adresse de facturation. Ses sous-champs (ligne 1, ligne 2, ville, région, code postal, pays) sont associés automatiquement aux champs d’adresse standard du CRM ; vous ne choisissez que le sens de l’ensemble du bloc. | CRM → Qwoty (configurable) |
| Tax ID | Numéro(s) d’identification fiscale ; les valeurs multiples sont concaténées | CRM → Qwoty (configurable) |

Une adresse n’est créée dans Qwoty que si les champs d’adresse requis du CRM sont renseignés : survolez l’icône d’information à côté du groupe d’adresses pour savoir lesquels.

Pour associer des identifiants fiscaux, cliquez sur **Ajouter un identifiant fiscal** dans le bloc **Identifiants fiscaux**, choisissez un type de taxe, puis le champ du CRM. Les lignes incomplètes ne sont pas enregistrées.

## Champs du contact

Ces champs s’appliquent au contact principal du client (Contact ou Person selon le CRM, voir le tableau ci-dessus). Le nom, l’e-mail et le téléphone du contact sont synchronisés avec l’objet de base.

| Champ | Description | Sens par défaut |
| - | - | - |
| Role | Rôle ou fonction du contact | CRM → Qwoty (configurable) |
| ERP ID | Identifiant externe issu d’un ERP connecté | CRM → Qwoty (configurable) |
| Accounting ID | Identifiant externe issu d’un logiciel de comptabilité connecté | CRM → Qwoty (configurable) |

## Champs du produit

Tous les champs standard du produit sont synchronisés en **Qwoty → CRM** (sens fixe).

| Champ | Description |
| - | - |
| Product ID | Identifiant interne du produit dans Qwoty |
| Product parent ID | Identifiant du produit parent |
| Reference | Référence interne du produit |
| SKU | Unité de gestion de stock |
| Description | Description du produit |
| Category | Catégorie du produit |
| Active | Indique si le produit est actif |
| Recurrence type | Ponctuel ou récurrent |
| Product type | Type de produit |
| Unit of measure | Unité de vente du produit (par exemple licence, heure, unité) |
| Unit per pack | Nombre d’unités par lot, le cas échéant |
| Catalog IDs | Catalogues auxquels appartient le produit |
| ERP ID | Identifiant externe issu d’un ERP connecté |
| Accounting ID | Identifiant externe issu d’un logiciel de comptabilité connecté |
| Ledger account | Compte comptable |

> [!WARNING]
>
> Le **prix**, la **quantité**, la **taxe** et la **remise de ligne** d’un produit sur un devis donné sont toujours synchronisés avec la ligne elle-même (deal product ou opportunity line item selon le CRM) : ils ne se configurent pas via la correspondance des champs.

## Champs personnalisés

Les champs personnalisés créés sur l’objet **Devis** ou **Client** dans Qwoty peuvent aussi être associés à un champ du CRM. Dans l’écran de correspondance, ils sont listés avec le préfixe `Custom:`, sont **bidirectionnels** par défaut et leur sens peut être modifié. Les champs personnalisés des contacts et des produits ne sont pas disponibles pour la correspondance.

Consultez [Correspondance CRM](https://docs.qwoty.io/fr/user-guide/data-model/reference/crm-mapping.md) pour le processus complet, les types de champs compatibles et la gestion des valeurs manquantes.

## Montant du deal

Dans le bloc **Paramètres généraux** de la page Configuration de l’intégration, **Montant à mettre à jour dans le Deal CRM** définit quel montant du devis Qwoty écrit dans le montant du deal ou de l’opportunité :

| Option | Montant écrit dans le CRM |
| - | - |
| **Aucun** | Qwoty ne met pas à jour le montant du deal |
| **TCV** | Valeur totale du contrat |
| **MRR** | Revenu mensuel récurrent |
| **ARR** | Revenu annuel récurrent |
| **Premier paiement** | Montant du premier paiement |

Les paramètres qui ne s’appliquent pas à un fournisseur sont masqués.

## Synchronisation statut × pipeline

La section **Synchronisation Statut X pipeline** fait passer le deal ou l’opportunité à une étape du pipeline lorsque le statut du devis change.

**1. Sélectionner le pipeline**

Dans **Sélectionner un pipeline**, choisissez le pipeline du CRM utilisé par vos deals.

**2. Associer chaque statut**

Dans **Correspondance des statuts**, sélectionnez une étape pour chaque statut Qwoty listé.

**3. Enregistrer**

Cliquez sur **Enregistrer**.

## Problèmes de connexion

Si la connexion au CRM a expiré ou n’est plus valide, la page Configuration de l’intégration affiche « Connexion CRM expirée ou invalide. Merci de reconnecter l'intégration. » Cliquez sur **Reconnecter** et autorisez à nouveau Qwoty.

## Voir aussi

> **[Pipedrive](https://docs.qwoty.io/fr/developers/integrations/crm/pipedrive.md)**
>
> Connectez Pipedrive et découvrez la synchronisation des objets de bout en bout.

> **[Salesforce](https://docs.qwoty.io/fr/developers/integrations/crm/salesforce.md)**
>
> Connectez Salesforce et découvrez la synchronisation des objets de bout en bout.

> **[HubSpot](https://docs.qwoty.io/fr/developers/integrations/crm/hubspot.md)**
>
> Connectez HubSpot et découvrez la synchronisation des objets de bout en bout.

> **[Correspondance CRM](https://docs.qwoty.io/fr/user-guide/data-model/reference/crm-mapping.md)**
>
> Où configurer la correspondance des champs, sens de synchronisation et types de champs compatibles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.