Sirene 3.11

YellowBox Store #

Objet #

Le plugin SIRENE 3.11 permet à l’administrateur de la base YellowBox CRM d’intégrer au sein des écrans utilisateurs un composant permettant d’interroger directement la base de données SIRENE mise à disposition par l’INSEE. Le résultat d’une requête est visualisé de manière intégrée et les fiches sélectionnées générées en base de données via un simple clic.

Un maximum de 30 interrogations par minutes est permis par le site de l’INSEE.

Installation #

Téléchargement à partir du YellowBox Store #

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 le télécharger dans la liste des plugins paramétrables dans votre YellowBox CRM.

Ce plugin ne nécessite pas l’achat d’un pack de crédits via le YellowBox Store. Dans tous les cas, une activation et des identifiants API sont nécessaires.

Les identifiants INSEE #

Pour pouvoir utiliser le plugin SIRENE à partir de YellowBox CRM, il est nécessaire de créer au préalable un compte sur le site Portail API INSEE, de valider une souscription pour pouvoir ensuite générer les identifiants nécessaires au paramétrage du plugin.

Créer un compte utilisateur #

Cliquer sur :

• [Se connecter] en haut à droite de l’écran
• Puis sur [CONNEXION-POUR-LES-EXTERNES]

Via l’écran de connexion qui apparait, dans le cas où un compte est déjà existant, renseigner les informations de connexion puis cliquer sur le bouton [Connexion].

Dans le cas où un compte doit être créé, cliquer sur [Enregistrement] présent en bas à droite du bloc de connexion et renseigner les informations suivantes :

A la validation le mot de passe est envoyé via email.

Générer la clé d’API #

Il est également impératif de générer la clé d’API nécessaire pour le paramétrage des informations de connexion du plugin via la création d’une application sur le portail :

• Cliquer sur [Applications]
• Cliquer sur le bouton [ CREER UNE APP]

L’écran de création suivant apparaît :

Donner un nom à l’application (Par exemple : Sirene YellowBox CRM) et une description. Le champ ‘Domaine utilisé par l’application’ ainsi que l’image ne sont pas obligatoires. Une fois les champs saisis, cliquer sur [Suivant] en bas à droite de votre écran pour obtenir l’écran suivant :

Sur l’onglet Sécurité, sélectionner le premier bloc ‘Simple’ (il apparait en bleu une fois sélectionné) et saisir ‘Web’ dans le champ ‘Type’. Une fois les champs saisis, cliquer sur [Suivant] en bas à droite de votre écran.

Sur l’onglet Souscription, saisir “sirene” dans la barre de recherche et cliquer sur [API Sirene] qui apparait dans la liste. Une fois l’API sélectionnée cliquer sur [Soucrire] puis sur [Suivant].

Valider la création en cliquant sur [CREER L’APPLICATION] présent en bas à droite de l’écran.

Un message confirme que l’application a correctement été créée.

Cliquer ensuite sur [Applications] puis cliquer sur l’encart de l’application créée.

Cliquer sur l’onglet ‘Souscriptions’, et cliquer sur la ligne disponible dans la liste de soucriptions, un bloc apparaît alors sur la droite de l’écran contenant la clé d’API à renseigner dans le paramétrage YellowBox CRM.

Paramétrage #

Le plugin SIRENE 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 Administrateur > 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 seule instance de type composant est disponible avec ce plugin.

SearchSirene (composant) #

Les paramètres mis à disposition permettent d’une part d’établir les correspondances entre les données de type société, contact et adresse mis à disposition par SIRENE et les tables et champs disponibles dans la base YellowBox CRM. Ils permettent d’autre part de déterminer le comportement de l’intégration de données en cas de doublons.

Paramètres #

Ci-dessous un focus sur les points de paramétrage particuliers autres que les simples mises en correspondance des zones disponibles dans SIRENE et des champs présents dans la base YellowBox CRM :

• Clé d’API
  Permet de renseigner la clé obtenue suite aux opérations décrites ci-dessus sur le portail SIRENE.

• Table de stockage
  Permet de renseigner quelle est la table qui va être alimentée des données de type société

• SIRET
  Siret de la société

Ce paramètre est obligatoire car utilisé pour le dédoublonnage.

• Traitement du dédoublonnage
  Trois choix pour trois types de traitements possibles, si doublon :

  • 0 : mise à jour de la totalité des informations reçues de SIRENE
  • 1 : création systématique d’une nouvelle fiche, même si elle existe déjà en base
  • 2 : création d’une nouvelle fiche si inexistante en base uniquement : aucun traitement en termes de mises à jour n’est effectué si la fiche est déjà existante
    
    

• [Traitement société-contact] Actif
  Ce paramètre permet d’activer un dédoublonnage supplémentaire lors du traitement d’intégration d’une fiche de type société à partir des données de SIRENE en vérifiant au préalable si le SIRET envoyé par SIRENE est déjà présent en base sur une autre table que celle sur laquelle la fiche doit être effectivement intégrée. Il active également ce même type de dédoublonnage au niveau des contacts.

• [Traitement société-contact] Table de correspondance societe
  Indiquer ici la table sur laquelle le dédoublonnage préalable du SIRET de la société doit être pratiqué.

• [Traitement société-contact] Table de correspondance contact
  Indiquer ici la table sur laquelle le dédoublonnage préalable de la fiche du contact à intégrer doit être réalisé.

• [Traitement société-contact] Référence du champ SIRET société
  Permet d’identifier dans la table sélectionnée en correspondance société, le champ contenant le SIRET sur lequel la vérification du doublon doit être réalisée.

• [Traitement société-contact] Civilité
  Permet d’identifier dans la table sélectionnée en correspondance contact, le champ contenant la civilité sur laquelle la vérification du doublon doit être réalisée.

• [Traitement société-contact] Nom (dédoublonnage)
  Permet d’identifier dans la table sélectionnée en correspondance contact, le champ contenant le nom sur lequel la vérification du doublon doit être réalisée.

• [Traitement société-contact] Prénom
  Permet d’identifier dans la table sélectionnée en correspondance contact, le champ contenant le prénom sur lequel la vérification du doublon doit être réalisée.

Concernant la mise en correspondance des champs fournis par SIRENE et ceux existants dans la base YellowBox CRM, cliquer sur le lien SIRENE - Documentation des variables pour obtenir plus d’information.

Intégration d’un composant #

En tant qu’administrateur il est possible d’ajouter un plugin paramétré directement via les écrans de type fiche des utilisateurs en cliquant sur le bouton central en bas d’écran [Mode éditeur].
Pour ajouter un composant SIRENE préparamétré sur une table, il convient de réaliser les opérations suivantes :

• Passer en mode éditeur
• Sélectionner l’objet qui doit accueillir le composant
• Cliquer dans la barre de propriétés apparaissant au bas de l’écran sur [Ajouter]
• Sélectionner dans la liste déroulante [Composant]
• Sélectionner dans la seconde liste déroulante le plugin paramétré désiré
• Ajuster taille et position selon le résultat ciblé

Utilisation #

Pour commencer, ouvrir une fiche contenant le composant SIRENE.

Le composant se présente en trois parties :

• Partie entête
  Cette partie contient simplement le titre du composant.

• Les champs de filtrage
  Permettent de saisir les éléments recherchés dans SIRENE. Le caractère * est utilisé comme joker pour tous les champs d type alpha-numérique.
  

• La liste de résultats
  A partir de cette liste il est possible de visualiser l’ensemble des sociétés correspondantes aux filtres validés et d’effectuer les traitements suivants :
  
  
  • Dans le cas où la fiche doit être générée en base, il convient de cliquer sur le nom de la société mise en surbrillance : un message de confirmation de création sera alors présenté à l’utilisateur.
    
    
  • Dans le cas où un fiche est déjà en base, une flèche apparait sur la gauche de la ligne. Un clic sur cette flèche permet d’ouvrir dans un nouvel onglet la fiche société correspondante.
    
    
  • Dans le cas où la fiche existe déjà en base et qu’un clic est tout de même effectué sur le nom de la société, un message de confirmation apparaît pour effectuer la mise à jour de la fiche : cette mise à jour ne sera effective que si le paramétrage réalisé prévoit les mises à jour, car selon le paramétrage ce clic peut :
    
    
    • Si traitement du dédoublonnage = 0 : mise à jour
    • Si traitement du dédoublonnage = 1 : création d’une nouvelle fiche
    • Si traitement du dédoublonnage = 2 : rien n’est fait