YellowBox pour Sage

YellowBox Store #

Objet #

YellowBox pour Sage permet d’établir une connexion entre YellowBox CRM et Sage 100c gestion commerciale. Il permet d’émuler une API pour Sage et d’ainsi disposer d’un ensemble de méthodes entre les deux outils.

Installation #

Le plugin est téléchargeable par l’administrateur depuis le YellowBox Store accessible via le bouton de la barre de notification.

• Cliquer sur le pavé du plugin pour voir le descriptif.
• Cliquer sur le bouton [Installer] pour télécharger dans la liste des plugins paramétrables dans votre YellowBox CRM.

Pré-requis :

• Avoir Sage 100c gestion commerciale (version en cours chez Sage).
• Faire un audit préalable par rapport aux usages et possibilités de mise en place autres que fiche tiers et catalogue

Ce plugin nécessite un abonnement et une activation.

Paramétrage #

Le plugin YellowBox pour Sage peut faire l’objet de plusieurs utilisations dans la base YellowBox CRM. Pour chaque cas d’usage, il convient d’ajouter un paramétrage particulier.

Pour ce faire, aller dans le menu paramétrage/Automatismes/Traitements/Traitements/Plugins.

Cliquer sur le bouton [+ Ajouter]

Le paramétrage d’un plugin nécessite la réalisation des opérations suivantes :

• Donner un nom unique qui vous permettra de le repérer facilement par la suite
• Sélectionner le plugin désiré dans la listes des plugins téléchargés
• Sélectionner l’instance désirée
• Entrer les différents paramètres demandés

Les instances disponibles #

Une soixantaine d’instances de type fonction sont disponibles avec ce plugin. Les instances décrites ici sont les instances les plus utilisées, à savoir l’envoi et la récupération des tiers et la récupération du catalogue.

Deux types d’instances :

• Les instances de type export réalisent l’extraction de données de la base Sage. A chaque utilisation d’une instance de type export, un fichier est généré et doit être traité par import pour intégrer effectivement les données dans la base YellowBox CRM.
• Les instances de type import permettent de pousser de l’information de YellowBox CRM vers la base de données de la gestion commerciale de Sage.

Export - Article (Fonction) #

Cette instance permet d’importer dans YellowBox CRM l’ensemble du catalogue Sage.

Données de connexion

Une première partie concerne les informations de connexion : les champs url, login, mot de passe, client_id et client_secret sont livrés par les services de YellowBox CRM à l’implémentation. Le nom de la base est le nom du dossier Sage avec lequel le plugin doit communiquer.

Champs à récupérer

Lors du clic dans cette zone, la liste de tous les champs de la fiche Article disponibles dans la base Sage apparaissent. Il convient de sélectionner ceux qui sont intéressant pour la création ou la mise à jour des fiches articles du catalogue Sage gestion commerciale dans YellowBox CRM.

Condition

Il est possible dans ce champ de limiter les données exportées par le plugin.
Les opérateurs disponibles sont les suivants :

Les valeurs doivent respecter les formats suivants :

Exemples :

• Pour extraire uniquement les fiches modifées dans Sage depuis le 9 mars 2023, la syntaxe sera la suivante :
  DateLastModification ge datetime'09/03/2023’
  
  
• Pour extraire de la base Sage uniquement les fiches modifiées depuis le dernier export réalisé via le plugin :
  DateLastModification gt datetime’$DateLastExecution'

Séparateur de colonnes

Saisir ici le caractère qui sépare chacune des valeurs d’une fiche

Exemple : |

Nom du fichier

Saisir ici le nom du fichier préfixé du dossier le contenant. Il n’est pas nécessaire de saisir le dossier ‘père’ [Linqit] centralisant tous les fichiers générés par le plugin.

Exemple : Ref_Articles\Sage_Ref_Articles_ref.txt

Constantes à ajouter

Dans le cas où un où des champs doivent être extraits plusieurs fois pour une même fiche, il est possible de saisir entre guillemets un intitulé de colonne suivi du numéro de la position de ce champ au niveau du paramètre ‘Champs à récupérer’.

Exemple : {“Ref_Art”:"$0"}

Dans la liste des champs à récupérer le premier champ sélectionné tient la position $0, le second la postion $1 et ainsi de suite.

Il est également possible d’obtenir une colonne contenant la date courante dans le fichier généré, exemple :
{“Code du client”:"$0",“CleSage”: “$0_$1”,“DateSynchronisation”:"$CurrentDate"}

Export : Tiers (Fonction) #

Cette instance permet d’exporter un fichier contenant l’ensemble des fiches de type tiers de la base Sage pour pouvoir l’importer dans la base YellowBox CRM.

Comme sur l’instance précédente les paramètres à renseigner sont les suivants :

Données de connexion

Champs à récupérer

Condition

Séparateur de colonnes

Nom du fichier

Constantes à ajouter

Import - Tiers (Fonction) #

Cette instance permet d’importer dans Sage une fiche Tiers.

Comme sur les instances précédentes les paramètres à renseigner sont les suivants, avec ici des particularités par rapport à une instance de type import :

Données de connexion

Champs sélectionnables

Lors du clic dans cette zone, la liste de tous les champs de la fiche Tiers disponibles dans la base Sage apparaissent. Il convient de sélectionner ceux sur lesquels une correspondance doit être effectuée afin de créer ou mettre à jour les données d’une fiche tiers dans la base de données Sage gestion commerciale. Pour chaque champ sélectionné, une nouvelle ligne de correspondance apparaît. L’administrateur doit alors renseigner sur chacune le champ de YellowBox CRM à partir duquel l’information est extraite dans YellowBox CRM pour nourir le champ correspondant dans la fiche Sage.

Configuration YellowBox

Identifiant unique Yellowbox

Cette correspondance est nécessaire pour alimenter la fiche Société de YellowBox CRM avec l’identifiant Code_client_Sage créé par Sage au moment de la création.

Date synchronisation

Il convient de renseigner ici un champ créé pour accueillir la date du traitement de la synchronisation YellowBox CRM <-> Sage. Ce champ permet de d’isoler les fiche non encore poussée vers Sage par exemple.

Intégration des fonctions #

Ces fonctions peuvent être intégrées dans des processus mis à disposition pour les utilisateurs via paramétrage de l’administrateur selon les écrans disponibles. Bien entendu, il conviendra à l’administrateur de créer les tables, champs, règles, processus et règles de gestion des accès selon les besoins, et d’aménager les écrans utilisateur en conséquences.