API INSEE#

> Thématiques > Thématique “Les interfaces avec logiciels tiers” >

Cette fonctionnalité nécessite :

de disposer d’un compte sur le site de l’INSEE,

de transmettre les informations nécessaires à ARTIS pour sa mise en place.

Remarque :

Les identifiants de connexion à cette API seront par la suite chiffrés : ils n’apparaitront pas sur l’interface et ne pourront pas être récupérés par un utilisateur.

Objectif#

L’objectif de ce paramétrage est de permettre, lors de la création d’un tiers, d’effectuer une recherche auprès du site de l’INSEE (à partir du SIRET ou du SIREN) afin de récupérer automatiquement plusieurs informations :

Raison sociale,
Statut juridique,
Adresse,
Etc.

Remarque :

Cette recherche vient en complément du référentiel artis.net. L’utilisateur a la possibilité, via une fenêtre de sélection, de choisir à partir de quelle source il souhaite récupérer les informations.

Par exemple, à ce jour, l’INSEE ne permet pas de récupérer le code FANTOIR de l’adresse.

Cela se matérialise par la présence d’un bouton à droite du champ SIRET depuis les menus :

Menu ERP > Tiers > Clients > Gérer les organisations de type Client/Financeur
Menu ERP > Tiers > Autres clients > Gérer les organisations de type Fournisseur/Fabricant/Banque/Transporteur/Sous-traitant/Commanditaire
Menu ERP > Tiers > Organisations internes > Gérer les organisations de type Interne
Menu CRM > Créer un prospect

Mise en place de la connexion#

Le site de l’INSEE propose également une aide en ligne à consulter en cas de besoin.

Étape	Détails / Copie écran
Se rendre sur le site de l’INSEE	https://api.insee.fr/catalogue/
Se connecter ou Créer son compte à défaut
Dans MES APPLICATIONS, cliquer sur Ajouter une application
Saisir le nom ARTIS puis cliquer sur Ajouter
Dans LES API DE L’INSEE, sélectionner la tuile Sirene V3.11
Sélectionner l’application précédemment créée dans le champ Applications et cliquer sur Souscrire
Cliquer sur Voir les souscriptions
Cliquer sur l’onglet Clefs et jetons d’accès et cliquer sur Générer les clefs
Cliquer sur le bouton Montrer les clefs puis Copier les valeurs des clés générées : • Clé du consommateur, • Secret du consommateur. Transmettre ces informations au service technique d’ARTIS pour intégration dans artis.net. NE PAS FAIRE DE CAPTURE D’ÉCRAN, CERTAINS CARACTÈRES POUVANT PORTER À CONFUSION (‘l’ minuscule et ‘i’ majuscule, ‘o’ majuscule et chiffre ‘0’, etc.).

Obtenir la forme juridique#

L’API INSEE permet de récupérer la forme juridique de l’organisation recherchée. L’INSEE a codifié toutes les formes juridiques.
Par ailleurs, artis.net possède une table de données Forme juridique listant les formes juridiques utilisées dans les fiches tiers. En général, la liste n’est pas aussi exhaustive (en nombre) et est simple (c’est-à-dire pas aussi détaillée).
Il convient donc de mettre en place une correspondance.

La liste des formes juridiques codifiées par l’INSEE peut être obtenue depuis Catégories juridiques INSEE.

Code	Libellé	Code INSEE
Association	Associations à but non lucratif	5195;7321;7312;7322;7323;9150;9210;9220;9221;9222;9224;9230;9260
Coopérative	Coopérative	5543;5553;5547;5554;5555;5558;5559;5560;5643;5647
Coopérative (de comm.)	Coopérative de commerçants	5552
Coopérative (de crédit)	Coopérative de crédit	5192;5196
Coopérative (d'habit.)	Coopérative d'habitation
Coopérative (de conso.)	Coopératives de consommation	5451;5551
EI	Entreprise Individuelle	1000
EURL	Entreprise Unipersonnelle à Responsabilité Limitée
EPIC	Etablissement Public à caractère Industriel et Commercial	4140;4120;4110
GIE	Groupements d'Intérêts Economique	6210;6220
Mairie	Mairie
ONG	Organisation Non Gouvernementale
SARL	Société à Responsabilité Limitée	5485;5410;5499;5422;5426;5430;5431;5432;5442;5443;5453;5454;5455;5459;5460
SA	Société Anonyme	5646;5651;5648;5652;5653;5654;5655;5659;5660;5699
SCA	Société Coopérative Agricole	6316;6318;6317
SCIC	Société Coopérative d?Intérêt Collectif	6521;6539;6532;6540;6541;6542;6543;6544;6551;6554;6558;6560;6585;6589;6597;6599
SCOP	Société Coopérative de Production	5658;5458
SEML	Société d'Economie Mixte locale	5415
SCS	Société en Commandite Simple	5307;5306
SNC	Société en Nom Collectif	5202;5203
SEP	Société En Participation	2310;2385;2320;5370;5470;5505;5570;5605;5670;5770
SAS	Société par Actions Simplifiée	5308;5710
SASU	Société par Actions Simplifiée Unipersonnelle
SPRL	Société Privée à Responsabilité Limitée