Menu général de Cn285
Menu général de Cn285
,disponible à droite de l'écran, pour passer en vue liste. Depuis cette vue, il est possible d'accéder et de configurer les dashboards présents ou d'en créer de nouveaux.
{% hint style="danger" %}
La configuration peut nécessiter des compétences techniques dans le langage **Python.**
{% endhint %}
Différents champs sont alors visibles:
* **Nom**
* **Description**
* **Type**: Différents choix sont possibles et définissent le type du tableau de bord
* **Bar**: Permet d'afficher les données sous forme de 'barre'
* **Line**: Permet d'afficher les données sous forme de 'ligne'
* **Pie:** Permet d'afficher les données sous forme 'camembert'
* **Mix:** Permet de combiner deux types de graphiques pour afficher deux données distinctes
En fonction du type de tableau de bord définit, des paramètres supplémentaires peuvent apparaître:
* **Display Label Axis X**: Lorsque cette case est cochée, le label pour l'axe X sera affiché sur le graphique
* **Display Label Axis Y**: Lorsque cette case est cochée, le label pour l'axe Y sera affiché sur le graphique
* **Color**: Permet de définir la couleur des barres
* **Background Color**: Permet de définir la couleur de remplissage des lignes
* **Border Color**: Permet de définir la couleur de la bordure des lignes
Sous l'onglet **Inline Code**, renseigner le code Python nécessaire afin de récupérer les données voulues. Une aide est disponible directement dans cet onglet.
# Menu CRM
## Introduction
## Créer un contrat depuis un lead
# Menu Contracts
Le menu *Contracts* permet l'accès à :
* ***Contracts*** : Vue spécifique qui n'affiche que les contrats gérables par l'interface utilisateurs - au delà de 2500 ***items*** les contracts ne sont visibles que dans la vue ***Large Contracts***
* ***Large*** ***Contracts*** : C'est une vue spécifique qui permet d'afficher tous les contrats disponibles dans la base Cn285 y compris tous les contrats comportant plus de 2500 ***items***
* ***Contract Items :*** Ce menu permet d'accéder aux lignes de ***Contract items*** qui représentent le lien entre un contrat et un ***item***.
* ***Contract Changes*** : Accès au menu qui permet de réaliser les demandes de changements sur les contrats en cours. Un contrat en cours ne se modifie pas via "une modification" de champs dans l'interface : les changements sont demandés, appliqués et tracés via les ***Contract Changes***.
* ***Contact Items Renewals*** : Vue qui fait l'historique et comptabilise tous les renouvellements de période d'un ***Contract Item***.
* ***Contract Item Renewal Notices :** Vue qui permet de gérer l'envoi des mails lors des renouvellements de contrats*
* ***Create Contract From Template :** M*enu qui donne accès à la liste des modèles de contrat (***Contract Templates***) et permet la création rapide d'un contrat sur la base d'un modèle préalablement défini comme Template.
* ***Signature :*** Accès à la vue recensant l'ensemble des enregistrements des signatures des ***ContractItems*** gérés dans Cn285
##
# Contracts
## Introduction
Le Contrat est l'objet Cn285 qui permet de gérer la relation contractuelle et la facturation récurrente d'un ensemble de produits et services à un client.
Un contrat est composé d'un ou plusieurs "Contract Items" qui correspondent aux différents produits ou services achetés par le client.
Par exemple, le contrat pour un abonnement téléphonique pourrait avoir 3 Contract Items:
* Abonnement - à prix fixe
* Frais de mise en service - facturés qu'une seule fois
* Consommation Données (Go) - avec une facturation variable
{% hint style="info" %}
Dans Cn285, le contrat est à voir comme un contenant (de Contract Items), ce qui implique que :
* Les contrats ont une date de début, leur date de fin correspond à la date de fin du Contract Item le plus éloigné. Par extension, un contract est In progress tant qu'il contient un Contract Item encore actif.
* Le statut d'un contrat dépend du statut des Contract Items qui le composent
* Il n'y a pas de signature du contrat, mais des signatures de Contract Items, même s'il est possible de décider au niveau du contrat qu'on autorise le Bypass de signature (notamment en cas de création de Contract Items via l'API)
{% endhint %}
## Cycle de vie
Le statut du contrat est défini par le statut des ***ContractItems***.
Les différents statuts de l'objet ***Contract*** sont:
* Draft : tous les Items sont draft
* la ligne de facturation est au statut de brouillon, on peut la modifier et l’annuler.
* Signature : Les ***ContractItems*** sont en cours de signature.
* In Progress : Le contrat est en cours avec au moins un ***ContractItem*** en statut in Progress
* Finished : Le contrat est terminé.
* Terminated : Le contrat est résilié par le client
## Opérations
La création d'un contrat est réalisée en 2 étapes :
1. Saisie d'un en-tête
2. Saisie des éléments du contrat via l'objet ***ContractItems** qui représentent les items associés au **Contract***
### Création de l'en tête du Contrat
Choisir le Client dans la liste déroulante du **Customer.**
Les champs **Invoice Address / Delivery Address / Salesperson / Sales Team** sont des champs qui apparaissent automatiquement si le client est déjà connu dans la base.\
Voir document [Menu et écran Customers](/cn285-documentation/menu-et-ecran-customers).
Renseigner le **Customer Ref** si besoin.
Laisser le champ **Pricelist** en Liste de prix publique (EUR) par défaut ou sinon créer une **Pricelist** spécifique au Client [Pricelists](/cn285-documentation/menu-products/pricelists).
La **Start Date** est par défaut la date du jour mais on peut tout à fait la changer.
Cocher la case **Is Renewal Tacit** si le contrat est un abonnement par tacite reconduction.
Cliquer sur Save pour pouvoir créer les lignes de contrats “Contracts Items”.
Le système crée automatiquement une référence de contrat.
Les différents onglets du contrat permettent de spécifier si le contrat est renouvelable, résiliable etc…voir le document [Contract Changes](/cn285-documentation/menu-contracts/contract-changes) pour plus de détails.
### Création des Contracts Items
Cliquer sur Edit puis sur Add a line au niveau de la ligne du contrat.
Choisir **l’Item** du contrat dans la liste déroulante.
Toutes les informations renseignées sur **l’Item** sont remontées : **Duration, Item Type…**
Cn indique la date de fin du contract item suivant la Duration (in periods) renseignée.
Le système crée automatiquement une référence pour le contract item. Voir [Contract Items](/cn285-documentation/menu-contracts/contract-items).
En cliquant sur Generate Schedules, Cn détaille toutes les périodes de service et de facturation du contract item suivant les informations renseignées.
### Validation - Signature des contrats
Une fois l’en-tête et les lignes de contrats créées, le contrat est au statut Draft. Il faut donc signer les ContractItems pour valider le contrat.
Cliquer sur le bouton Sign. Par défaut, Cn285 va afficher dans l’onglet Items, tous les items qui sont au statut Draft.
Dans l’onglet Documents, Cn285 permet d’ajouter un ou plusieurs documents rattachés au contrat. Les documents qui se trouvent dans le Chat apparaissent automatiquement dans Documents (en haut à droite du contrat). Pour mettre des documents dans le chat du contrat (cliquer sur le trombone) et Drag\&Drop votre document dans le Chat.
Petite précision, le Chat peut être ajouté sur n’importe quel objet de Cn285, il permet de retracer l’historique du contrat du client.
Si on veut rattacher des documents signés au contrat, il suffit d’aller dans la fenêtre qui s’affiche quand on clique sur Sign.
Ensuite, on peut cliquer sur Confirm.
Le statut du contrat passe de Draft à Signature.
## Description des champs
**Pricelist** : permet la création d’une pricelist si le prix d’un produit varie en fonction des différents paliers de quantités consommées ou autres
**Start** **date** : par défaut c’est la date du jour mais on peut tout à fait changer la date de début du contrat
**Is** **Renewal** **Tacit** : en cochant cette case, on indique si le contrat est renouvelable
### Onglet Items
Il permet de sélectionner les Items à associer à ce contrat.
### Onglet Signature - WIP
Exemple de l'onglet "Autres Informations"
Exemple de l'onglet "Cn285"
Exemple de l'onglet "XSync"
Exemple d'Invoice Detail généré pour une facture
: L'interface de création de l'avoir vous permet d'insérer le % à créditer, 10% sur la ligne de facturation variable d'octobre et un motif éventuel.
{% hint style="info" %}
Le Discount (%) général s'applique par défaut à toutes les lignes du Credit Memo mais il est tout à fait possible de changer le % directement sur la ligne du Credit Memo.
{% endhint %}
{% hint style="info" %}
Il est possible de réaliser des Credit Memo en quantité, soit en appliquant un quantité à l'ensemble des lignes soit à chacune de façon indépendante via le champ qui accepte aussi bien des % que des quantités.
{% endhint %}
. L'écran de création de l'avoir vous permet d'insérer le % à créditer sur les 3 lignes de factures sélectionnées ainsi que la possibilité d'indiquer si besoin la raison de cette remise.
Pour activer le regroupement des lignes de factures sur la même ligne d'avoir, il faut cocher l'option “**Group Credit Lines”.**
Cn285 regroupera les 2 lignes d'IS (du même contrat et du même contract item) sur la même ligne d'avoir comme on peut le voir ci-dessous dans notre exemple : Abonnement à prix fixe du Contrat test 2.
# Menu Fulfillment
# Usage Data
Un Usage Data permet de gérer les données variables d'un Contract Item.
## Introduction
Dans Cn, les "Usage Data" désignent les données de consommation utilisées pour la Facturation des éléments variables d’une période à travers des Contract Item de type:
* Usage Based Recurring Pricing / Tarification Récurrente basée sur les Usages
* Usage Triggered Invoicing / Facturation déclenchée par les Usages
Ces Contract Item sont dits de type "variable".
A la fin de chaque période de facturation d'un Contrat Item de type variable, Cn :
1. collecte tous les Usage Data associés
2. utilise le Usage Data Calculator défini au niveau du Contract Item pour calculer la quantité à facturer sur la période.
Plus précisément une Usage Data est une valeur horodatée liée à un Contract ou un Contract Item.
Les Usages Data peuvent être créées et mises à jour au travers de plusieurs mécanismes:
* via l'interface Web de Cn
* via l'API
* par des imports CSV
Ce document décrit l'utilisation de l'interface Web de Cn et les règles métiers valables pour tous les mécanismes de saisie.
## Menu et Accès
Les Usage Data sont accessibles via le menu Cn / Usage Data / Usage Data
## Structure des Usage Data
L'écran des Usage Data est structuré en plusieurs parties:
* Statut
* Contract Reference
* Timestamp
* Value
* Notes
* Invoicing
### Statut
Le cycle de vie d'une Donnée de Consommation (DC) est le suivant:
* Draft :
* La Donnée (DC) est en cours de saisie
* Tous les champs sont modifiables
* Pending
* la Donnée (DC) est confirmée; elle est en attente de facturation
* Tous les champs sont bloqués sauf "Notes"
* Collected
* La Donnée (DC) est utilisée dans une facture. Le champ "Invoicing Schedule" permet d'y accéder.
* Excluded : Donnée non prise en compte
### Contract Reference
Les Usage Data doivent être associées à :
**Contract :** Lorsque que les Usage data sont affectées à un contract seulement, le champ ContractItem restant vide, les usage data seront associées à tous les contractitems et pourront être traitées par le Usage Data Calculator de chacun d'entre eux. La saisie du champ Contract est donc obligatoire.
Les Usage Data peuvent être associées à un ContractItem unique :
**ContactItem :** Il est possible d'associer les usages data à un seul ContractItem. \
Le champ **External Reference** permet à un système distant de définir une clef d'accès qui lui est propre. Cn permet de retrouver des Données de Consommation à partir des "External Reference".
### Value
**Start** permet d'horodater la "Donnée de Consommation".
**End** permet de gérer les données de consommation correspondantes à des périodes.
**Value :** valeur de la donnée d'usage saisie
* Usage Data Simple
* Usage Data Agrégée
Il existe 2 types de données agrégées :
* **Données agrégées Custom :** Ces données ont pour vocation à être manipulées par les utilisateurs Cn285. Elles doivent donc être présentées dans l'interface de façon intelligibles à travers des champs Custom \
Exemple de données agrégées custom "muppy.io" : le modèle ci-dessous permet de facturer des services d'une solution Devops en fonction de plusieurs critères : nb de CPU, GB de RAM et typologie (Core, LxC, PostgreSQL)
* **Données agrégées de type JSON :** Ces données de type complexes, sont issues d'un autre système et n'ont pas vocation à utiliser, visualiser ou interpréter par un utilisateur. Elles sont intégrées dans un JSON
**Qualifier :** permet de définir la donnée d'usage (kg, Km, Mo, GigaOctet, hits, clics, minutes, ...)
**Description :** en cas de besoin
### Analytics
permet d'affecter aux usage data des axes analytiques en vue de traitements BI futurs
Axis1 : Axe analytics
Axis2 : Axe analytics
### Invoicing
**Do not Invoice :** bloque la facturation de l'entrée de Usage Data
**Invoicing Schedule :** Lorsqu'une Donnée de Consommation a été "collectée", ce champ indique l 'IS dont la quantité inclut la Donnée de Consommation
**Invoicing Notes** : En cas de besoin
## **Cas d'utilisations**
### **Saisie d'une donnée de Consommation Simple**
Le cas le plus simple correspond à la saisie d'une Donnée de Consommation liée à un Contract Item de type variable.
Pour cela, il faut saisir:
* **Contract**
* **Contract Item** (optionnel)
* **Start**
* **Value** : valeurs simples qui permettent de gérer les données de consommation et qui peuvent être exprimées sous forme de quantités numérique.
* Par exemple:
* des kilo octets
* des minutes
* des kilowattheures
* Les valeurs simples sont transmises sous forme de listes de nombres à un **Usage Data Calculator** dont le rôle est de les transformer en quantité (à facturer).
* **State** = Pending
Rappel la Donnée sera ignorée tant que le State sera **Draft**
### **Saisie de données de Consommation Agrégées**
Les valeurs agrégées permettent de gérer les cas suivants:
* facturation de **plusieurs Contract Items d'un même Contract** dont les quantités proviennent du même Usage Data.
* Dans ce cas, les valeurs agrégées sont liées au Contract.
Ce cas correspond à la saisie d'une Donnée de Consommation composite utilisée pour calculer les quantités à facturer de plusieurs Contract Item de type variable.
Dans ce cas, il faut saisir les valeurs des champs:
* Contract
* Start
* JSON Data\
Ensemble de données (JSON) agrégées permettant de facturer sur la base de modèle plus complexe
* Les valeurs agrégées sont des objets JSON qui permettent de stocker des données composites ou complexes.
* State = Pending
Rappel la Donnée sera ignorée tant que le State sera **Draft**
* Exemple:
* {
* "espace\_disque\_go": 15,
* "cpu": 8,
* "espace\_disque\_backup": 13
* }
* facturation d'**un Contract Item dont la quantité** dépend de plusieurs paramètres.
* Dans ce cas les valeurs agrégées sont liées au Contract Item
* Exemple:
* {
* "espace\_disque\_utilisee\_go": 1599,
* "espace\_disque\_inclu\_go": 800,
* "tarif\_go\_supplementaire\_euro": 1,27
* }
* Dans ce magine que le Usage Data Calculator doit calculer le coût des Go en dépassement (espace\_disque\_utilisee\_go - espace\_disque\_inclu\_go) \* tarif\_go\_supplementaire\_euro
Actuellement, un Usage Data Calculator ne peut pas accéder en même temps aux valeurs des champs Values et aux valeurs des champs JSON Data.
Notes
Il s'agit d'un champ texte dont le contenu est disponible pour impression sur les "Relevés de consommations" joints aux factures dans le cas de facturation détaillées.
###
###
# Menu et écran Customers
Création d'un client
## Introduction
Un client est une personne physique ou morale qui achète un produit Cn285 ou une prestation de service Cn285 de façon récurrente à une entreprise en échange d’un paiement.
## Menu et Accès
Les Clients sont accessibles avec le menu Cn / Customers / Customers.
## Operations
### Type des Clients
Cn285 gère soit des clients de type **Particulier** ou **Société**.
Si vous cochez l’un ou l’autre de ces 2 types, certains champs apparaîtront ou pas.
Le siret et le numéro de tva sont des exemples de champs obligatoires si le client est une Société.
### Gestion des adresses
Par défaut, un Client a une adresse définie dans le formulaire principal. Il est possible d’en ajouter d’autres (de facturation, de livraison…) dans l’onglet Contacts & Adresses.
### Type d'adresses clients
Si vous ajoutez plusieurs adresses, vous devez préciser le type d'adresse (adresse de livraison etc…) pour que Cn285 puisse déterminer quelle adresse utiliser pour la facture.
## Description des Champs
Certains champs sont obligatoires pour pouvoir créer un client.
Dans l’onglet Ventes & Achats
**Achats / Conditions de paiement :** choisir les conditions de paiement du client (paiement immédiat, 30J FDM…)
Dans l'onglet Cn285
Le champ **Discount (%)** : permet d'ajouter une remise accordée à un client. Elle sera appliquée à tous les contrats de ce client.
# Menu Products
Création d'un produit Cn
## Introduction
Un produit ou un article Cn285 est un consommable ou un service qui va être vendu de façon récurrente.
{% hint style="info" %}
Un produit avec des caractéristique de récurrence est un **Item.**
Un item est lié à un contrat via un [Contract Items](/cn285-documentation/menu-contracts/contract-items).\
Selon la configuration choisie, il est possible ou non de modifier les caractéristiques de récurrence d'un item dans un Contract Item.
{% endhint %}
La base produits est soit:
* créer manuellement
* importée de votre système <\
pour générer les IS. Etant donné que le prix est fixe, les IS sont tous créé au statut "Calculated".
**Vue Liste**: Cette vue permet d'afficher les données sous formes de lignes.
* 
**Vue Graph**: Cette vue permet d'afficher les données sous forme de graphiques.
* 
**Vue Pivot**: Cette vue permet d'afficher les données sous forme de tableaux croisés dynamiques.
permet de générer les lignes de ce report et ainsi de visualiser les lignes concernées par la période / compte comptable.
Il est également possible d'ouvrir, individuellement ou globalement, les lignes qui ont générées cette balance en cliquant sur le bouton 
d'une ligne ou sur le bouton 
pour ouvrir toutes les lignes.
Depuis cette vue détaillée, il est possible d'exporter les données sous forme excel en cliquant sur le bouton situé en haut à gauche de la vue.
Il est également possible de visualiser les données sous forme de tableau croisé dynamique ou sous forme graphique en cliquant sur les boutons 
situés en haut à droite de la vue.
# RevRec Stock Report
## Introduction
Le RevRec Stock Report permet de visualiser le stock de FAE, de PCA ou les mouvements des OD de RevRec sur une date ou une période donnée.
## Menu et Accès
Le **RevRec Stock Report** est disponible depuis le menu **Accounting / Reports / RevRec Stock Report.**
## **Configuration**
Les champs disponibles dans cette interface sont :
* **Report level** : permet de sélectionner uniquement l'indicateur des Revenus à reconnaitre, ou celui des factures à émettre ou de visualiser les leur regroupement.
* **Ignore Entry With Zero Balance** : option permettant de ne pas afficher les écritures dont la balance est à 0 et dont le [Contract Item Renewals](/cn285-documentation/menu-contracts/contract-item-renewals) est dans le passé (Non disponible avec le report "All").
* **Date :** Permet d'établir le rapport à une date donnée.
Le bouton permet de générer les lignes de ce report et ainsi de visualiser les lignes concernées par la période / compte comptable.
Le boutonpermet de visualiser le rapport en vue liste afin de pouvoir utiliser les fonctions de filtres et de groupage.
Le bouton permet d'afficher le détail des lignes d'écritures.
# Summary Entities
# Summary Journals
## **Introduction**
Les journaux de synthèses sont des journaux regroupant des lignes de synthèse. Ces lignes sont générées à partir de lignes d'entrée d'un journal.
En cas de synchronisation avec un système distant ([Menu XSync](/cn285-documentation/menu-xsync)), cela permet de réduire les risque d'erreurs liés à cette synchronisation telle que la perte de connexion, le temps de réponse du système distant, etc..
## Configuration
Exemple de configuration d'un journal de synthèse
afin de visualiser soit les entrées soit les lignes d'entrées.
Depuis la vue liste des entrées synthétisées, sélectionner les entrées synthétisées dont vous souhaitez visualiser les entrées ou lignes d'entrée sources. Cliquer ensuite sur les boutons 
en fonction de ce que vous voulez afficher.
# Banks
# Menu Objects
## Introduction
Dans certaines activités, les abonnements portent sur des logiciels ou des services eux même contenus dans une offre plus large composé d'éléments physiques. C'est le cas des objets connectés (***IoT Objects***), où l'abonnement ne porte pas à proprement parler sur l'objet mais sur le service contenu (application, logiciel) et porté par l'objet.
A ces objets sont associés des évènements (***IoT Events***), dont la survenance et la prise en compte dans Cn285 permet de déclencher des actions. Les classiques étant l'activation et la désactivation.
Ces objets peuvent aussi être concernés par l'association de ***Usage Data*** dans le cadre de modèle de facturation.
# Objects
## Introduction
La vue Objects permet donc de gérer des objets qui portent les items.
## Menu et accès
La vue formulaire d'un objet contient **tous les champs obligatoires** suivants:
* **Nom de l'objet**
* **Key** : Clé de l'objet
* **Création date** : date de sa création de l'objet (d'un point de vue client) - si cette date n'est pas fournie par le client/l'API alors Cn285 prend la date de création system.
* *Contract* :
* Le contrat client concerné auquel est affecté l'objet.
* *Item* : Le produit d'abonnement associé à l'objet.
* D'autres champs sont disponibles et totalement paramètrables.
{% hint style="info" %}
A noter : Selon les cas métier, il est possible de créer directement un objet avec ou sans Contract / Item.
{% endhint %}
### Onglet ContractItems
L'onglet ContractItems liste tous les ***ContractItems*** auxquels a été associé l'objet.
### Onglet Events
L'onglet Events centralise l'historique des évènements associés à l'objet (activation, désactivation,...).
### Onglet Notes
Il permet d'ajouter une note associée à l'objet.
### Onglet Technical
Le client peut stocker des données en JSON via l'API et les relire ensuite dans ces process automatisés.
### Onglet Analytics
Lorsque l'option de comptes analytiques est activée, il est possible d'associer l'objet à 2 axes analytics. Ces champs sont particulièrement intéressants lorsque l'on ouvre les sujets d'analyse de la performance.
### Onglet Advanced
Contient des données utiles pour une utilisation plus avancée de l'outil Cn285 avec:
* ID dans la base de données Cn285 de l'objet
* Date de création (du point de vue du system Cn285)/ Utilisateur créateur
* ID du message de création de l'objet (lorsque ce dernier est créé par API)
* Date de dernière mise à jour / Utilisateur
## Gestion des objets
### Création
En général les objets sont créés en automatique via l'API toutefois il est possible de réaliser une création directement en manuel, en remplissant à minima les 3 champs obligatoires.
### Activation
Après avoir passer le statut de l'objet de "Draft" à "Pending", il est possible d'activer cet objet via le Bouton 
Cette fonction créé un ***ContractItem*** dans le contrat associé à cet objet via le Wizard - ***Activate Object***
Ce wizard propose d'activer l'objet à une date définie par le champ Timestamp.
Il est possible d'ajouter une description.
{% hint style="info" %}
Il est possible d'activer plusieurs objets simultanément (soit via "Ajouter une ligne" soit en sélectionnant plusieurs objets depuis la vue Liste).
{% endhint %}
{% hint style="danger" %}
Il n'est possible d'activer un objet que si ce dernier est préalablement associé à un contrat et un produit.
{% endhint %}
### Deactivation
La Désactivation via le bouton 
permet de désactiver un ou plusieurs objets à la date spécifiée dans le wizard.
# Events
## Introduction
Cn285 gère les objets et historise les évènements qui leur sont associés.
{% hint style="info" %}
Les Events permettent d'historiser les évènements liés à un objet à un objet lorsque l'Event concerne un Object géré dans Cn285 à des fins d'historisation et de traçabilité
{% endhint %}
## Menu et accès
On accède aux Events via le menu Objects > Events.
Cn285 gère différents types d'évènements.
# Menu QS
Cn285 contient son propre système de Queue.
## Introduction
Cn285 permet aux utilisateurs d'accéder aux **Messages** traités par la Queue et traiter les erreurs éventuelles.
Cn285 permet aussi d'accéder aux traitements effectués par les **Workers**.
# Message
## Introduction
Le Menu Message permet d'accéder à la liste de tous les messages générés par les traitements Cn285.
## Exploitation des Messages
Les Messages ont des statuts liés à la bonne fin ou non des traitements.
pour vérifier les informations et établir la connexion avec le système distant.
{% hint style="info" %}
Le résultat de la vérification de la connexion est affiché dans le champ **Connection Status**
Si la connexion entre les deux systèmes distant est réussie, le message "Connection Success !" sera affiché.
{% endhint %}
### Paramètres
Des paramètres supplémentaires sont nécessaires lors d'une synchronisation de factures ou de clients. Ces paramètres sont définis dans l'onglet Netsuite du **Remote System.**
Les différents paramètres sont:
* **Description Item Id**: L'identifiant de l'Item Description de Netsuite ([Configuration Netsuite](/cn285-documentation/menu-xsync/xsync-for-netsuite/configuration-netsuite#creation-de-litem-description)).
* **Synchronize Bank Account**: Permet d'activer ou de désactiver la synchronisation entrante et sortante des comptes bancaires. Si l'option est activée:
#### Configuration du Synchronize Bank Account
* **Payment File Format Id**: Correspond à un identifiant d'un payment file format créé dans Netsuite.
{% hint style="info" %}
Nous vous recommandons de créer un payment file format spécifique à Cn285 dans Netsuite pour permettre d'identifier lors d'une synchronisation de Cn285 vers Netsuite les comptes en banques, créés dans des systèmes tiers et dont le format devra être revu dans Netsuite.
{% endhint %}
En cliquant sur le bouton 
les champs **Bank Details CustomRecord Id**, **Payment File Format Type Id** ainsi que **Entity Bank Type Id** seront automatiquement configurés si les champs sont disponibles dans Netsuite. L'aide contextuelle permet d'indiquer le nom technique du champ Netsuite mappé.
Une fois que Netsuite et XSync sont correctement configurés, la configuration de la synchronisation (entrante ou sortante) pour les différentes entités à synchroniser est possible.
# 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
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#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).
* **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 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 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#actions-planifiees-cron-1).
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est manuelle via le bouton 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**. 
# Customers Outbound Sync
## Introduction
Xsync permet la synchronisation sortante des clients vers un autre système. La configuration de cette synchronisation est possible depuis le groupe **Customers** dans l'onglet **Outbound Sync** du **Remote System**.
## Configuration
XSync dispose d'un système de recherche permettant de définir les clients à synchroniser avec le **Remote System**. Cette recherche est paramétrable via le champ **Customer Selection.**
Le champ **Last Customers Outbound Sync** correspond au timestamp de la dernière synchronisation sortante effectuée. Ce timestamp est utilisé comme critère supplémentaire dans la recherche **Customer Selection** et permet de ne sélectionner que les clients de Cn285 qui ont une date de création / modification postérieure à ce timestamp.
Un critère supplémentaire sera automatiquement ajouté à la recherche. Ce critère permet de ne sélectionner que les clients dont le **Master System** est différent du **Remote System** sur lequel la synchronisation va être effectuée.
Les données renvoyées par la recherche seront ensuite synchronisées avec Netsuite en une ou plusieurs pages (appelé aussi batch). La taille de ces pages est paramétrable par le champ **Sync Batch Size,** par défaut défini à **10**.
{% hint style="danger" %}
Nous vous recommandons de ne pas modifier la valeur du champ **Sync Batch Size**. Elle permet de garantir les performances optimales pour une synchronisation vers Netsuite.
{% endhint %}
Plusieurs paramètres peuvent aussi être configurés dans cette rubrique:
* **User Mapper**: XSync possède de base un driver permettant de faire correspondre un champ Cn285 avec un champ standard Netsuite. Pour synchroniser des données Cn285 avec des champs Netsuite personnalisés il convient de surcharger le driver standard avec un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers).
* **Q for Outbound Customer sync**: Permet de définir une queue dédiée uniquement pour la synchronisation sortante des clients.
* **Run Outbound Sync synchronously**: Lorsque cette option est cochée, la synchronisation est effectuée de manière synchrone. Nous vous recommandons d'utiliser cette option uniquement en mode debug.
## Lancement de la synchronisation
La synchronisation sortante des clients depuis Cn285 peut être lancée via deux modes:
* Mode manuel
* Mode automatique
### Mode manuel
Le bouton 
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer la synchronisation sortante manuellement avec les critères définis ci-dessus.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
### Mode automatique
La synchronisation de manière automatique est effectuée par une action planifiée qui s'exécute périodiquement. La documentation concernant les [Workers](/cn285-documentation/menu-qs/workers) permet de visualiser cette tâche.
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est lancée de manière asynchrone (soit via le bouton 
avec la case **Run Outbound Sync synchronously** décoché, soit via la tâche planifiée), XSync génère un message "**Outbound sync on X 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 "**Outbound Sync a batch of 'customer()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**.
La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**. 
# Product Inbound Sync
## Introduction
Xsync permet la synchronisation entrante des produits depuis Netsuite. La configuration de cette synchronisation est possible depuis le groupe **Products** dans l'onglet **Inbound Sync** du **Remote System**.
## Configuration
Pour sélectionner les produits à synchroniser, XSync utilise le champ **Products 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#creation-de-la-saved-search-product)) ainsi que le champ **Sync Products modified since** en tant que critère de recherche pour interroger Netsuite.
{% hint style="info" %}
Si le champ **Sync Products modified since** n'est pas défini:
* La saved search de Netsuite renverra tous les produits à 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 produits dont la date de modification est postérieure à cette valeur.
{% endhint %}
Le résultat de la saved search est ensuite synchronisée avec Cn285 en une ou plusieurs pages. La taille de ces pages est paramétrable par le champ **Synced Products Page Size,** par défaut définie à **30**.
{% hint style="danger" %}
Nous vous recommandons de ne pas modifier la valeur du champ **Synced Products 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 Products using search Results**: \
Si cette option est cochée, XSync synchronisera toutes les données que retourne la **Saved Search** de Netsuite. **La** **Saved Search** doit alors contenir toutes les informations nécessaires à la synchronisation. \
Si l'option n'est pas cochée, XSync fera un appel pour chaque produit pour la récupération des données.
* **Force Refresh of Sync Products** : Lorsque cette option est cochée, XSync forcera le rafraichissement des données produits.
* **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).
* **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 Products 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 produits par prix, par catégorie, etc ...
## Synchronisation entrante des produits
La synchronisation des produits depuis Cn285 peut être lancée via deux modes :
* Mode manuel
* Mode automatique
### Mode manuel
Il est possible de lancer une synchronisation globale des produits en cliquant sur le bouton 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 produits à synchroniser.
Il est également possible de lancer une synchronisation unitaire en cliquant sur le bouton situé dans l'onglet **XSync** du formulaire produit. La synchronisation unitaire est uniquement possible lorsque le produit a déjà été synchronisé par XSync.
{% hint style="info" %}
La synchronisation unitaire permet de mettre à jour rapidement un produit sans avoir à resynchroniser tous les produits 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 produits. 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#actions-planifiees-cron-1).
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est manuelle via le bouton ou automatique (via le CRON), celle-ci est lancée en mode asynchrone. XSync génère un message "**Syncs all 'products'**" 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 Product**" en fonction de la taille définie par le champ **Synced Products Page Size**.
Pour visualiser ces messages et ainsi suivre l'avancement de la synchronisation, rendez-vous dans le menu **Cn / Qs / Messages**. 
# Invoice Outbound Sync
## Introduction
XSync permet de synchroniser des factures ou des éléments de facturation de Cn285 avec Netsuite.
{% hint style="info" %}
Avant de synchroniser une facture vers Netsuite, XSync s'assure que le client existe dans Netsuite et qu'il est bien à jour, notamment pour les clients dont des systèmes tiers sont les maîtres. Si les données ne sont pas à jour, XSync synchronisera ce client avant de synchroniser la facture.
{% endhint %}
## Configuration
### Synchronisation sortantes des factures
XSync dispose d'un système de recherche permettant de définir les factures (ou éléments de facturation) à synchroniser avec le **Remote System**. Cette recherche est paramétrable via le champ **Invoice Selection.**
Les données renvoyées par la recherche seront ensuite synchronisées avec Netsuite en une ou plusieurs pages (appelé aussi batch). La taille de ces pages est paramétrables par le champ **Sync Batch Size,** par défaut défini à **10**.
{% hint style="danger" %}
Nous vous recommandons de ne pas modifier la valeur du champ **Sync Batch Size**. Elle permet de garantir les performances optimales pour une synchronisation vers Netsuite.
{% endhint %}
Plusieurs paramètres sont aussi disponibles dans cette rubrique:
* **User Mapper**: XSync possède de base un driver permettant de faire correspondre un champ Cn285 avec un champ standard Netsuite. Pour synchroniser des données Cn285 avec des champs Netsuite personnalisés il convient de surcharger le driver standard avec un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers).
* **Q for Outbound Invoice sync**: Permet de spécifier une autre queue à utiliser pour la synchronisation sortante.
* **Run Outbound Sync synchronously**: Lorsque cette option est cochée, la synchronisation est effectuée de manière synchrone. Nous vous recommandons d'utiliser cette option uniquement lorsque vous souhaitez debugger.
* **Last Invoices Outbound Sync:** Correspond au timestamp de la dernière synchronisation sortante effectuée. Ce timestamp est utilisé comme critère supplémentaire dans la recherche **Invoice Selection** et permet de ne sélectionner que les factures de Cn285 qui ont une date de création / modification postérieure à cette date.
{% hint style="info" %}
Si le champ **Last Invoices Outbound Sync** n'est pas défini:
* La recherche du champ **Invoice Selection** renverra toutes les factures éligibles à la synchronisation
* La valeur du champ prendra le timestamp de cette synchronisation.
{% endhint %}
Un critère supplémentaire sera automatiquement ajouté à la recherche. Ce critère permet de ne sélectionner que les clients dont le **Master System** est différent du **Remote System** sur lequel la synchronisation va être effectuée.
Il est également possible de bloquer la synchronisation sortante d'une facture. Cette option est disponible depuis la rubrique **Outbound Sync** dans l'onglet XSync de la vue détaillée de la facture et elle est paramétrable avec le champ **Block Outbound Sync.** Lorsque ce champ est activé, XSync ignora automatiquement la synchronisation de cette facture.
### Etat de validation des factures
XSync permet aussi de créer une facture dans Netsuite dans différents états d'approbation, selon que l'on souhaite créer des factures validées ou non, ou qu'un workflow de validation est activé.
Sous **Cn / Configuration / Settings**, dans la rubrique **Netsuite by Cn285**, configurer les champs suivants:
* **Approval Status At Creation** : Définit le statut de la facture lors de sa création dans NetSuite
* **Pending Approval** : Crée la facture au statut “pending approval” dans NetSuite.
* **Open (without approval workflow\*)** : Crée la facture directement au statut “Approved” dans NetSuite (il n'y a pas de workflow de validation et on créait la facture validée).
* **Open (with approval workflow\*)** : Crée la facture au statut “pending approval” dans NetSuite puis la valide dans un second temps.
* **Next Approver** : SI ET SEULEMENT le module d'approbation des factures NetSuite est installé, ce champ permet de définir le **Next Approver.** L'utilisateur Cn285 doit donc avoir un **Remote Id** correspond à un identifiant d'employé dans Netsuite.
{% hint style="warning" %}
Dans Netsuite, lorsque le workflow de validation des factures est activé, celui-ci ne permet pas de créer une facture directement dans le statut ‘approved’. Dans ce cas là, XSync créera dans un premier temps la facture au statut 'Pending Approval' puis dans un second temps, validera cette facture.
{% endhint %}
Une fois la synchronisation sortante effectuée (avec ou sans workflow), XSync lancera une synchronisation entrante afin de récupérer la référence de la facture nouvellement crée dans NetSuite.
## Lancement de la synchronisation
La synchronisation sortante des factures depuis Cn285 peut être lancée via deux modes:
* Mode manuel
* Mode automatique
### Mode manuel
Le bouton 
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer la synchronisation sortante manuellement avec les critères définis ci-dessus.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
### Mode automatique
La synchronisation de manière automatique est effectuée par une action planifiée qui s'exécute périodiquement. La documentation concernant les [Workers](/cn285-documentation/menu-qs/workers) permet de visualiser cette tâche.
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est lancée de manière asynchrone (soit via le bouton 
avec la case **Run Outbound Sync synchronously** décoché, soit via la tâche planifiée), XSync génère un message "**Outbound sync on X all 'invoices'**" 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 "**Outbound Sync a batch of 'invoice()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**.
La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**. 
# Invoice Status Inbound Sync
## Introduction
Il est possible de suivre dans Cn285, l'avancement du statut d'une facture (ou élément de facturation) déjà synchronisée avec Netsuite.
## Configuration
Pour mettre à jour le statut de paiement des factures déjà synchronisées, il est nécessaire de configurer le champ **Local Invoice Search.**
Le résultat de cette recherche est ensuite découpé en une ou plusieurs pages. La taille de ces pages est paramétrable par le champ **Synced Invoice 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 %}
Il est également possible de définir un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers) via le champ **User Mapper**.
Les différents statuts visibles depuis la vue des Invoices sont:
* **Synced - Pending Approval** : En attente de validation de la facture
* **Synced - Open** : En cours de paiement
* **Synced - Paid In Full** : Payé
* **Synced - Refused** : Refusé
## Synchronisation entrante des clients
La synchronisation des statuts depuis Cn285 peut être lancée via deux modes :
* Mode manuel
* Mode automatique
### Mode manuel
Il est possible de lancer une synchronisation globale des statuts en cliquant sur le bouton
situé dans l'onglet **Inbound Sync** du formulaire du **Remote System**.Cette synchronisation se fera toujours de manière asynchrone.
### Mode automatique
Cn285 permet aussi une synchronisation automatique des statuts. 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 rubrique [Workers](/cn285-documentation/menu-qs/workers).
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est manuelle via le boutonou automatique (via le CRON), celle-ci est lancée en mode asynchrone. XSync génère un message "**Syncs all 'invoices'**" 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 Invoice**" en fonction de la taille définie par le champ **Synced Invoices Page Size**. Pour visualiser ces messages et ainsi suivre l'avancement de la synchronisation, rendez-vous dans le menu **Cn / Qs / Messages**.
# Bank Account Sync
## Introduction
XSync permet aussi de synchroniser les comptes bancaires avec Netsuite. La synchronisation entrante et sortante est activée lorsque l'option **Synchronize Bank Account** du **Remote System** est cochée et correctement configurée ([Configuration XSync](/cn285-documentation/menu-xsync/xsync-for-netsuite/configuration-xsync#configuration-du-synchronize-bank-account)).
## Configuration
### Synchronisation entrante
La synchronisation entrante des comptes bancaires est effectuée lorsque le client est synchronisé avec Cn285. Cette synchronisation ne nécessite aucune configuration supplémentaire.
### Synchronisation sortante
XSync dispose d'un système de recherche permettant de définir les comptes bancaires à synchroniser avec le **Remote System**. Cette recherche est paramétrable via le champ **Bank Account Selection.**
Le champ **Last Bank Account Outbound Sync** correspond au timestamp de la dernière synchronisation sortante effectuée. Ce timestamp est utilisé comme critère supplémentaire dans la recherche **Bank Account Selection** et permet de ne sélectionner que les comptes bancaires de Cn285 qui ont une date de création / modification postérieure à ce timestamp.
Les données renvoyées par la recherche seront ensuite synchronisées avec Netsuite en une ou plusieurs pages (appelé aussi batch). La taille de ces pages est paramétrable par le champ **Sync Batch Size,** par défaut défini à **10**.
{% hint style="danger" %}
Nous vous recommandons de ne pas modifier la valeur du champ **Sync Batch Size**. Elle permet de garantir les performances optimales pour une synchronisation vers Netsuite.
{% endhint %}
Plusieurs paramètres peuvent aussi être configurés dans cette rubrique:
* **User Mapper**: XSync possède de base un driver permettant de faire correspondre un champ Cn285 avec un champ standard Netsuite. Pour synchroniser des données Cn285 avec des champs Netsuite personnalisés il convient de surcharger le driver standard avec un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers).
* **Q for Outbound Customer sync**: Permet de définir une queue dédiée uniquement pour la synchronisation sortante des comptes bancaires.
* **Run Outbound Sync synchronously**: Lorsque cette option est cochée, la synchronisation est effectuée de manière synchrone. Nous vous recommandons d'utiliser cette option uniquement en mode debug.
Un compte bancaire synchronisé depuis Cn285 comportera la mention **(Created By Cn285)**. Cette mention permet d'indiquer dans Netsuite que ce compte bancaire nécessite une vérification. La mention est paramétrable avec le champ **Suffix Name Bank Account** disponible dans la rubrique **Netsuite by Cn285** du menu **Configuration / Settings.**
## Lancement de la synchronisation
La synchronisation sortante des comptes bancaires depuis Cn285 peut être lancée via deux modes:
* Mode manuel
* Mode automatique
### Mode manuel
Le bouton 
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer la synchronisation sortante manuellement avec les critères définis ci-dessus.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
### Mode automatique
Il n'existe pas de tâche planifiée pour la synchronisation sortante des comptes bancaire. Les comptes bancaires sont automatiquement synchronisés lorsque le client associé au compte bancaire est synchronisé avec Netsuite.
{% hint style="info" %}
Lorsqu'un compte bancaire est ajouté à un client, la date de modification de ce client est également modifié pour permettre de synchroniser ce client.
{% endhint %}
## Suivi de la synchronisation sortante
Lorsque la synchronisation est lancée de manière asynchrone, XSync génère un message "**Outbound sync on X all 'Bank Account'**" 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 "**Outbound Sync a batch of 'bank account()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**. La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**.
# Journal Entries Outbound Sync
## Introduction
XSync permet de synchroniser des entrées de journal avec Netsuite. Ces entrées de journal peuvent être issues d'un journal de synthèse ([Summary Journals](/cn285-documentation/menu-accounting/summary-entities/summary-journals)) ou d'un journal classique.
## Configuration
Lors de la synchronisation d'une entrée de journal, XSync synchronise le Mémo FEC ainsi qu'un mémo sur la ligne de l'entrée. Ces deux paramètres peuvent être personnalisables depuis la vue détaillée d'un journal dans l'onglet XSync
{% hint style="danger" %}
La modification de ces champs requiert des compétences techniques. L'aide contextuelle permet d'indiquer les champs accessibles.
{% endhint %}
### Synchronisation sortante
XSync permet de sélectionner le journal qui sera synchronisé avec NetSuite via le champ **Journal**.
Les entrées de ce journal sont ensuite découpées en une ou plusieurs pages. La taille de ces pages est paramétrable par le champ **Synced Batch Size**, par défaut définie à **10**.
{% hint style="danger" %}
Nous vous recommandons de ne pas modifier la valeur du champ **Synced Batch Size**. Elle permet de garantir les performances optimales pour une synchronisation avec NetSuite.
{% endhint %}
Plusieurs paramètres sont aussi disponibles dans cette rubrique:
* **User Mapper**: XSync possède de base un driver permettant de faire correspondre un champ Cn285 avec un champ standard NetSuite. Pour synchroniser des données Cn285 avec des champs NetSuite personnalisés il convient de surcharger le driver standard avec un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers).
* **Run Outbound Sync synchronously**: Lorsque cette option est cochée, la synchronisation est effectuée de manière synchrone. Nous vous recommandons d'utiliser cette option uniquement lorsque vous souhaitez debugger.
* **Last Journal Entries Outbound Sync:** Dernière date de synchronisation sortantes des Journal Entries
* **Generate Cn285 extended values**: Lorsque cette option est cochée, Cn285 va synchroniser des champs supplémentaires non standards à NetSuite, ces champs nécessitent donc une création dans celui-ci (voir [Cn285 extended values](/cn285-documentation/menu-xsync/xsync-for-netsuite/cn285-extended-values)).
## Bloquer la synchronisation sortante des écritures de synthèse
Il est possible de ne pas synchroniser avec le Remote System certaines écritures de synthèse via la case à cocher 'Block Outbound Sync' disponible dans la vue formulaire de l'entrée de l'écriture de synthèse 
.
Il est également possible de sélectionner plusieurs entrées d'écritures de synthèse et de les bloquer via le bouton 'Block Outbound Sync' disponible sous le menu 'Action'.
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer cette synchronisation sortante.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
## Suivi de la synchronisation sortante
Lorsque la synchronisation est lancée de manière asynchrone, XSync génère un message "**Outbound sync on 'X' all 'entries' of X'**" 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 "**Outbound Sync a batch of 'journal\_entry()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**. La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**.
# Cn285 extended values
## Introduction
Cn285 permet de synchroniser des champs dit "**extended**". Ces champs sont des champs non standards dans Netsuite et nécessite une création dans celui-ci.
{% hint style="info" %}
La synchronisation des champs extended est livrée en standard d'XSync et ne nécessite pas la création d'un [User defined Mappers](/cn285-documentation/menu-xsync/user-defined-mappers).
{% endhint %}
Afin de synchroniser ces champs il faut donc:
* Cocher la case **Generate Cn285 extended values** disponible dans les options de synchronisation des différentes entités
* Créer les champs dans Netsuite
## Invoice
Lors d'une synchronisation sortante, les champs **extended** suivants sont synchronisés (si l'option est activée):
* **custbody\_cn285InvoiceURL**: Identifiant du champ contenant un lien permettant d'ouvrir la facture synchronisée dans Cn285.
## Journal Entries
Lors d'une synchronisation des entrées d'un journal, les champs **extended** suivants sont synchronisées:
* **custbody\_cn285JournalEntryURL**: Identifiant du champ contenant un lien permettant d'ouvrir l'entrée synchronisée dans Cn285.
* **custbody\_cn285AccountJournalCode:** Identifiant du champ contenant le code du journal qui a été synchronisé. Cette information permet de définir depuis quel journal cette entrée à été synchronisé directement dans Netsuite.
## Création des champs dans Netsuite
Dans **Netsuite**, sous **Customization / Lists, Records & Fields / Transaction Body Fields**, cliquer sur **New**
Renseigner ensuite le nom du champ ainsi que son identifiant.
{% hint style="info" %}
Nous vous recommandons de nommer votre champ avec un préfix/suffix "**Cn285**", permettant de visualiser que ce champ est strictement rempli de Cn285.
{% endhint %}
Dans l'onglet "**Applies To**", cocher les cases dans lesquelles ce champ sera appliqué. Dans l'exemple ci-dessus, le champ crée concerne uniquement les journaux. La case **Journal** sera donc cochée.
L'onglet "**Display**" permet de sélectionner l'emplacement du champ dans la vue.
# XSync for Odoo
## Introduction
XSync for Odoo est un module d'XSync permettant la communication avec une instance Odoo. Ce module intègre des fonctionnalités permettant de synchroniser des données en entrée et en sortie (clients, produits, comptes en banque,...).
XSync for Odoo gère les synchronisations entrantes ou sortantes des versions d'Odoo ci-dessous:
* Odoo 14 Community / Enterprise
* Odoo 15 Community / Enterprise
# Configuration Odoo
## Introduction
La synchronisation entre les deux systèmes distants implique une configuration d'Odoo.
{% hint style="info" %}
La configuration de votre instance Odoo nécessite d'avoir un compte avec accès aux configurations de cette instance.
{% endhint %}
## Création d'un utilisateur dédié à XSync
XSync nécessite d'avoir un utilisateur actif dans votre instance Odoo afin de synchroniser les différentes entitées entre les 2 [Remote System](/cn285-documentation/menu-xsync/remote-system).
Dans le menu principal, cliquer sur **Paramètres / Utilisateurs et sociétés / Utilisateurs.** Cliquer ensuite sur '**Créer**'.
Configurer ensuite l'utilisateur:
* **Nom**: XSync Cn285
* **Adresse électronique**: XSync Cn285
* **Types d'utilisateur**: Utilisateur interne
* **Comptabilité**: Paramétrage facturation
* **Administration**: Droits d'accès
Cocher ensuite les cases suivantes:
* **Comptabilité analytique**
* **Création de contact**
Cliquer ensuite sur 'Sauver'. Modifier ensuite le mot de passe via le bouton **Action / Modifier le mot de passe**.
## Création des filtres personnalisés
XSync utilise deux filtres personnalisés afin de récuperer les données à synchroniser.
Pour accéder aux filtres personnalisés, il est nécessaire d'avoir activer le mode **Développeur** sur votre instance Odoo. Pour cela, cliquer sur le bouton **Activer le mode développeur** disponible en bas de la page dees paramètres généraux.
Une fois que le mode développeur est actif, il est nécessaire d'accéder aux filtres personnalisés disponible dans le menu **Paramètres / Technique / Filtres personnalisés**.
### Filtre Produit
Configuration du filtre personnalisé des Produits.
Configuration du filtre personnalisé des Clients.
Example de clé API
Exemple de configuration d'XSync vers un Odoo staging
pour vérifier les informations et établir la connexion avec le système distant.
{% hint style="info" %}
Le résultat de la vérification de la connexion est affiché dans le champ **Connection Status**
Si la connexion entre les deux systèmes distant est réussie, le message "Connection Success !" sera affiché.
{% endhint %}
### Paramètres
Des paramètres supplémentaires sont nécessaires lors d'une synchronisation de factures ou de clients.
Les différents paramètres sont:
* **Invoice Journal Id**: L'identifiant du journal des ventes dans Odoo.
* **Credit Memo Journal Id**: L'identifiant d'un journal permettant d'enregistrer les avoirs.
* **Journal Entries Id**: L'identifiant d'un journal permettant d'enregistrer les diverses opérations comptables. Ce journal sera, par exemple, utilisé lors de la synchronisation des opérations de reconnaissance de revenu.
Une fois qu'Odoo et XSync sont correctement configurés, la configuration de la synchronisation (entrante ou sortante) pour les différentes entités à synchroniser est possible.
# Customers Inbound Sync
## Introduction
Xsync permet la synchronisation entrante des clients depuis Odoo. La configuration de cette synchronisation est possible depuis le groupe **Customers** dans l'onglet **Inbound Sync** du **Remote System**.
## Configuration
Exemple de configuration pour la synchronisation entrante des clients
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer la synchronisation sortante manuellement avec les critères définis ci-dessus.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
### Mode automatique
La synchronisation de manière automatique est effectuée par une action planifiée qui s'exécute périodiquement. La documentation concernant les [Workers](/cn285-documentation/menu-qs/workers) permet de visualiser cette tâche.
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est lancée de manière asynchrone (soit via le bouton avec la case **Run Outbound Sync synchronously** décoché, soit via la tâche planifiée), XSync génère un message "**Outbound sync on X 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 "**Outbound Sync a batch of 'customer()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**.
La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**. 
Exemple de message lors de la synchronisation sortante avec Odoo
Exemple de paramétrage pour la synchronisation entrante des Products
situé dans l'onglet **Outbound Sync** du **Remote System** permet de lancer la synchronisation sortante manuellement avec les critères définis ci-dessus.
Si le champ **Run Outbound Sync synchronously** n'est pas coché alors cette synchronisation est lancée de manière aysnchrone.
### Mode automatique
La synchronisation de manière automatique est effectuée par une action planifiée qui s'exécute périodiquement. La documentation concernant les [Workers](/cn285-documentation/menu-qs/workers) permet de visualiser cette tâche.
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est lancée de manière asynchrone (soit via le bouton avec la case **Run Outbound Sync synchronously** décoché, soit via la tâche planifiée), XSync génère un message "**Outbound sync on X all 'invoices'**" 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 "**Outbound Sync a batch of 'invoice()'**" qui lui même va générer plusieurs messages "**Outbound** **Sync Cn**" en fonction de la taille définie par le champ **Sync Batch Size**.
La visualisation des messages et l'avancement de la synchronisation est possible depuis le menu **Cn / Qs / Messages**. 
Exemple de message généré par XSync pour synchroniser une page de 10 Invoices.
situé dans l'onglet **Inbound Sync** du formulaire du **Remote System**.Cette synchronisation se fera toujours de manière asynchrone.
### Mode automatique
Cn285 permet aussi une synchronisation automatique des statuts. 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 rubrique [Workers](/cn285-documentation/menu-qs/workers).
## Visualiser l'avancement de la synchronisation
Lorsque la synchronisation est manuelle via le boutonou automatique (via le CRON), celle-ci est lancée en mode asynchrone. XSync génère un message "**Syncs all 'invoices'**" 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 Invoice**" en fonction de la taille définie par le champ **Synced Invoices Page Size**. Pour visualiser ces messages et ainsi suivre l'avancement de la synchronisation, rendez-vous dans le menu **Cn / Qs / Messages**.
Création d'un nouveau SmartCode
Exemple de SmartCode "Prorator"
Exemple de SmartCode "LifeCycle"
Exemple de SmartCode "Event"
Création d'un IDG
