# Customers Inbound Sync ## Introduction Xsync permet la synchronisation entrante des clients depuis Netsuite. La configuration de cette synchronisation est possible depuis le groupe **Customers** dans l'onglet **Inbound Sync** du **Remote System**. ## Configuration ![Exemple de paramétrage pour la synchronisation entrante des Customers](/files/u9kuQf29MME2pZq1ra4P) Pour sélectionner les clients à synchroniser, XSync utilise le champ **Customers Saved Search scriptId** qui correspond à l'identifiant de la saved search créée dans Netsuite ([Configuration Netsuite](/cn285-documentation/menu-xsync/xsync-for-netsuite/configuration-netsuite.md#creation-de-la-saved-search-customer)) ainsi que le champ **Sync Customers modified since** en tant que critère de recherche pour interroger Netsuite. {% hint style="info" %} Si le champ **Sync Customers modified since** n'est pas défini: * La saved search de Netsuite renverra tous les clients à synchroniser avec Cn285 * La valeur du champ prendra le timestamp de cette synchronisation Si le champ est défini, la saved search de Netsuite ne renverra que les clients dont la date de modification est postérieure à cette valeur. {% endhint %} Le résultat de la saved search est ensuite synchronisé avec Cn285 en une ou plusieurs pages. La taille de ces pages est paramétrable par le champ **Synced Customers Page Size,** par défaut définie à **30**. {% hint style="danger" %} Nous vous recommandons de ne pas modifier la valeur du champ **Synced Customers Page Size**. Elle permet de garantir les performances optimales pour une synchronisation avec Netsuite. {% endhint %} Plusieurs paramètres peuvent aussi être configurés dans cette rubrique : * **Sync Customers using search Results**: Si cette option est cochée, XSync synchronisera toutes les données que retourne la **Saved Search** de Netsuite. Dans ce cas là, la **Saved Search** doit contenir toutes les informations nécessaires à la synchronisation. Si l'option n'est pas cochée, XSync fera un appel pour chaque client pour la récupération des données. * **Force Refresh of Sync Customers**: Lorsque cette option est cochée, XSync forcera le rafraichissement des données client. * **User Mapper**: XSync possède de base un driver permettant de faire correspondre un champ standard Netsuite avec un champ Cn285. Pour synchroniser des champs Netsuite personnalisés il convient de surcharger le driver standard avec un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers.md). * **Don’t Update ‘Modified Since’**: Lorsque cette option est cochée, le champ **Sync Customers modified since** ne sera pas mis à jour avec le timestamp de la synchronisation et conservera la valeur de la précédente. * **Local Customers Search**: Il est possible de spécifier à XSync les entités locales à mettre à jour depuis Netsuite via une recherche Cn285. On peut, par exemple, sélectionner les clients par pays, par ville, etc ... ## Synchronisation entrante des clients La synchronisation des clients depuis Cn285 peut être lancée via deux modes : * Mode manuel * Mode automatique ### Mode manuel Il est possible de lancer une synchronisation globale des clients en cliquant sur le bouton ![](/files/aYwTjmdbJc0co01zlJXN)situé dans l'onglet **Inbound Sync** du formulaire du **Remote System**. Cette synchronisation globale prend les critères de recherche définis dans l'onglet **Inbound Sync** pour sélectionner les clients à synchroniser. Il est également possible de lancer une synchronisation unitaire en cliquant sur le bouton ![](/files/Y23DHdrSUiFCPsYyJRqS)situé dans l'onglet **XSync** du formulaire **Customer**. La synchronisation unitaire est uniquement possible lorsque le customer a déjà été synchronisé par XSync. {% hint style="info" %} La synchronisation unitaire permet de mettre à jour rapidement un client sans avoir à resynchroniser tous les clients déjà existants. Cette synchronisation est synchrone et se fait donc en direct, contrairement à la synchronisation globale qui elle est asynchrone. {% endhint %} ### Mode automatique Cn285 permet aussi une synchronisation automatique des clients. Cette synchronisation se lance via un CRON (tâche) qui s'exécute périodiquement. Pour configurer ou visualiser ce CRON, veuillez vous référer à la [Workers](/cn285-documentation/menu-qs/workers.md#actions-planifiees-cron-1). ![Exemple de configuration du Daemon](/files/647fROT8ruDxBf8dwsVS) ## Visualiser l'avancement de la synchronisation Lorsque la synchronisation est manuelle via le bouton ![](/files/aYwTjmdbJc0co01zlJXN)ou automatique (via le CRON), celle-ci est lancée en mode asynchrone. XSync génère un message "**Syncs all 'customers'**" qui va être traité par un worker. Comme expliqué lors de la configuration, XSync synchronise les données avec Cn285 en plusieurs pages. Une page va générer un message "**Sync page 1/X**" qui lui même va générer plusieurs messages "**Sync Customer**" en fonction de la taille définie par le champ **Synced Customers Page Size**. Pour visualiser ces messages et ainsi suivre l'avancement de la synchronisation, rendez-vous dans le menu **Cn / Qs / Messages**. ![](/files/JYe1uIofpnamy13hM13Z) ![Exemple de message généré par XSync pour synchroniser une page de 30 Customers.](/files/t017QUn7Wbr3BpeUKzz1) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.cn285.app/cn285-documentation/menu-xsync/xsync-for-netsuite/customers-inbound-sync.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.