> ## 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.

# Intégrations ERP

> Connectez Qwoty à votre système ERP pour synchroniser automatiquement les commandes, les clients et les produits

{/* AUDIT NOTE: No ERP integrations found in the app. Confirmed integrations at Settings → Developer → Integrations (/settings/integrations): Google Chat, HubSpot, Microsoft Teams, Pennylane, Pipedrive, Slack, Stripe Invoice, Stripe Payment Link. None of the listed ERP systems (NetSuite, SAP S/4HANA, Microsoft Dynamics 365, Sage Intacct, Odoo) are available. The entire "Supported ERP systems" table and all [MENU PATH] / [BUTTON LABEL] / [FIELD NAME] TODOs are unverified and likely incorrect. */}

Qwoty s'intègre à votre système ERP (Enterprise Resource Planning) pour automatiser la circulation des données entre les ventes et les opérations. Lorsqu'un devis atteint le statut Accepté et génère une commande, l'intégration peut envoyer cette commande directement à votre ERP pour le traitement, la facturation et la comptabilité.

Les intégrations ERP éliminent la saisie de données en double, réduisent les erreurs et garantissent que vos équipes financières et opérationnelles travaillent à partir des mêmes données de devis que celles négociées par votre équipe commerciale.

## Fonctionnement des intégrations ERP

Qwoty prend en charge la synchronisation bidirectionnelle entre votre instance CPQ et votre système ERP :

* **Les commandes sont envoyées** : lorsqu'un devis est accepté, Qwoty génère une commande et la transmet à votre ERP avec les lignes d'article, la tarification, les informations client et les conditions de paiement
* **Les produits sont synchronisés en entrée** : le catalogue produits de votre ERP se synchronise avec Qwoty, en maintenant les SKU, descriptions et prix de base à jour
* **Les clients se synchronisent dans les deux sens** : les enregistrements clients créés dans Qwoty peuvent être envoyés à votre ERP, et les clients ERP existants peuvent être importés pour éviter les doublons
* **Les factures sont référencées en retour** : les factures créées dans votre ERP peuvent être liées au devis et à la commande Qwoty d'origine pour la traçabilité

<Tip>
  Les commandes sont automatiquement créées lorsqu'un devis atteint le statut Accepté. L'intégration ERP écoute cet événement et déclenche la synchronisation.
</Tip>

## Systèmes ERP pris en charge

Qwoty propose des intégrations natives et des connecteurs API pour les plateformes ERP courantes :

| Système ERP            | Type d'intégration | Fréquence de sync | Envoi de commandes | Sync produits | Sync clients |
| ---------------------- | ------------------ | ----------------- | ------------------ | ------------- | ------------ |
| NetSuite               | Native             | Temps réel        | ✓                  | ✓             | ✓            |
| SAP S/4HANA            | Connecteur API     | Planifiée         | ✓                  | ✓             | ✓            |
| Microsoft Dynamics 365 | Native             | Temps réel        | ✓                  | ✓             | ✓            |
| Sage Intacct           | Connecteur API     | Planifiée         | ✓                  | ✓             | ✓            |
| Odoo                   | Connecteur API     | Planifiée         | ✓                  | ✓             | ✓            |
| ERP personnalisé       | API REST           | Personnalisée     | ✓                  | ✓             | ✓            |

<Note>
  Si votre ERP n'est pas répertorié, vous pouvez créer une intégration personnalisée à l'aide de l'API REST et des webhooks de Qwoty. Contactez votre équipe d'implémentation pour obtenir des conseils.
</Note>

## Configuration d'une intégration ERP

<Steps>
  <Step title="Activer l'intégration">
    Accédez à **\[MENU PATH]** > **Intégrations** > **ERP**. Sélectionnez votre système ERP dans le menu déroulant et cliquez sur **\[BUTTON LABEL]**.
  </Step>

  <Step title="Authentifier la connexion">
    Fournissez vos identifiants ERP ou votre clé API. Pour les ERP basés sur OAuth comme NetSuite, vous serez redirigé pour autoriser Qwoty à accéder à votre compte.
  </Step>

  <Step title="Configurer les paramètres de synchronisation">
    Choisissez les données à synchroniser :

    * **Sync des commandes** : activer la création automatique des commandes lorsque les devis sont acceptés
    * **Sync des produits** : importer les produits de votre catalogue ERP dans Qwoty
    * **Sync des clients** : synchroniser les enregistrements clients dans les deux sens ou dans un seul sens
    * **Fréquence de synchronisation** : définir en temps réel ou planifiée (toutes les heures, quotidiennement)
  </Step>

  <Step title="Mapper les champs">
    Faites correspondre les champs Qwoty aux champs de votre ERP. Les mappages courants incluent :

    * Lignes d'article du devis → Lignes d'article de commande ERP
    * Total du devis → Montant de la commande ERP
    * Conditions de paiement → Conditions de paiement ERP
    * Nom du client → Nom du compte ERP
  </Step>

  <Step title="Tester l'intégration">
    Créez un devis de test, publiez-le dans un Dealroom et acceptez-le. Vérifiez que la commande apparaît correctement dans votre ERP avec les lignes d'article et la tarification exactes.
  </Step>
</Steps>

<Warning>
  Testez toujours dans un environnement sandbox ou de préproduction avant d'activer l'intégration en production. Des mappages de champs incorrects peuvent créer des enregistrements en double ou mal formés dans votre ERP.
</Warning>

## Mappage de champs et attributs personnalisés

Qwoty vous permet de mapper des champs de devis personnalisés à des champs ERP personnalisés à l'aide de **\[FIELD NAME]**. Cela est utile lorsque votre ERP suit des attributs tels que les codes de projet, les centres de coûts ou les dates de livraison qui n'existent pas dans le schéma standard de Qwoty.

Pour créer un mappage personnalisé :

1. Accédez à **\[MENU PATH]** > **Mappages de champs**
2. Cliquez sur **\[BUTTON LABEL]**
3. Sélectionnez le champ Qwoty ou l'attribut personnalisé
4. Saisissez le nom d'API du champ ERP correspondant
5. Choisissez le type de données (texte, nombre, date, liste de sélection)
6. Définissez le sens de synchronisation : Qwoty → ERP, ERP → Qwoty, ou bidirectionnel

<Info>
  Les mappages de champs personnalisés nécessitent les autorisations du rôle Administrateur.
</Info>

## Journaux de synchronisation et gestion des erreurs

Qwoty enregistre chaque événement de synchronisation et offre une visibilité sur les échecs. Accédez aux journaux de synchronisation depuis **\[MENU PATH]** > **Historique de synchronisation**.

Chaque entrée du journal indique :

* **Horodatage** : date et heure de la synchronisation
* **Direction** : Qwoty → ERP ou ERP → Qwoty
* **Type d'objet** : commande, produit ou client
* **Statut** : succès, avertissement ou erreur
* **Détails** : requête et réponse API complètes pour le débogage

### Erreurs de synchronisation courantes

| Erreur                   | Cause                                               | Résolution                                                                                               |
| ------------------------ | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `Invalid customer ID`    | L'enregistrement client n'existe pas dans l'ERP     | Créez le client dans votre ERP ou activez la création automatique de clients                             |
| `Missing required field` | L'ERP requiert un champ non mappé dans Qwoty        | Ajoutez le champ requis à votre modèle de devis et mappez-le                                             |
| `Duplicate order number` | L'ID de commande existe déjà dans l'ERP             | Vérifiez si la commande a déjà été synchronisée, ou ajustez les paramètres de numérotation des commandes |
| `Authentication failed`  | Les identifiants API ont expiré ou ont été révoqués | Réauthentifiez l'intégration depuis la page des paramètres                                               |

<Tip>
  Configurez des notifications par e-mail ou Slack pour les erreurs de synchronisation afin que votre équipe puisse réagir immédiatement. Configurez les alertes dans **\[MENU PATH]** > **Notifications**.
</Tip>

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Puis-je synchroniser les devis avant qu'ils soient acceptés ?">
    Non. Qwoty synchronise uniquement les commandes vers votre ERP, et les commandes sont créées lorsque les devis atteignent le statut Accepté. Synchroniser des devis en brouillon ou en attente encombrerait votre ERP avec des données incomplètes.

    Si vous avez besoin d'une visibilité sur les devis en cours, utilisez les rapports de Qwoty ou une intégration CRM à la place.
  </Accordion>

  <Accordion title="Que se passe-t-il si un devis est annulé après la synchronisation de la commande ?">
    Qwoty envoie une mise à jour à l'ERP pour marquer la commande comme annulée ou nulle, selon les capacités de votre ERP. Vous pouvez configurer ce comportement dans **\[MENU PATH]** > **Paramètres de synchronisation** > **\[FIELD NAME]**.

    Certains ERP ne prennent pas en charge l'annulation des commandes après leur création. Dans ce cas, vous devrez annuler ou supprimer manuellement la commande dans votre ERP.
  </Accordion>

  <Accordion title="Puis-je déclencher manuellement une synchronisation pour une commande spécifique ?">
    Oui. Ouvrez la page de détail de la commande et cliquez sur **\[BUTTON LABEL]** dans le coin supérieur droit. Cela renvoie la commande à votre ERP, ce qui est utile lorsqu'une synchronisation échoue ou que vous avez corrigé une erreur de mappage.
  </Accordion>

  <Accordion title="L'intégration synchronise-t-elle les données historiques ?">
    Par défaut, l'intégration ne synchronise que les nouveaux enregistrements créés après l'activation. Pour importer des commandes, des produits ou des clients historiques, utilisez l'outil d'importation en masse ou contactez le support pour une migration de données.
  </Accordion>

  <Accordion title="Puis-je désactiver temporairement l'intégration sans perdre ma configuration ?">
    Oui. Utilisez le bouton **\[BUTTON LABEL]** sur la page des paramètres de l'intégration. Cela met en pause toutes les synchronisations mais conserve vos mappages de champs et votre authentification. Réactivez à tout moment en le réactivant.
  </Accordion>
</AccordionGroup>

## Voir aussi

<CardGroup cols={2}>
  <Card title="Commandes" icon="box" href="/user-guide/orders-contracts/introduction">
    Découvrez comment les commandes sont automatiquement générées à partir des devis acceptés
  </Card>

  <Card title="Contrats" icon="file-contract" href="/user-guide/orders-contracts/introduction">
    Comprenez comment les contrats regroupent les devis et les commandes pour une même affaire
  </Card>

  <Card title="Référence API" icon="code" href="/api-reference/quotes/list">
    Créez des intégrations ERP personnalisées à l'aide de l'API REST de Qwoty
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developers/core-concepts/webhooks">
    Configurez des webhooks pour notifier votre ERP lorsque des commandes sont créées ou mises à jour
  </Card>
</CardGroup>