API INSEE#
> Thématiques > Thématique “Les interfaces avec logiciels tiers” >
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
Remarque :
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.
L’identifiant de connexion à cette API sera par la suite chiffrés : il n’apparaitra pas sur l’interface et ne pourra pas être récupéré par un utilisateur.
Attention !
Comme tout service en ligne, celui-ci peut subir des indisponibilités. En cas d’erreur à l’utilisation du bouton, vérifier que le service proposé par l’INSEE n’est pas momentanément indisponible avant de contacter le service support ARTIS. Des informations sont notamment disponibles sur le site web de l’API INSEE.
Une société peut refuser que tout ou partie ses informations soient accessibles par ce biais. La recherche ne pourra pas donc retourner de résultat. Au besoin, il est possible de faire une recherche directement sur le site web de l’insee à cette adresse : https://www.sirene.fr/sirene/public/recherche
Mise en place de la connexion#
Attention !
En 2024, l’INSEE a déployé une nouvelle version de son API, avec un nouveau portail. À partir du 28 février 2025, les identifiants utilisés jusqu’alors (Clé du consommateur, secret du consommateur) ne seront plus valides et le portail INSEE “historique” ne sera plus accessible. Pour que la fonctionnalité reste accessible après cette date :
Si celle-ci était déployée sur votre environnement :
Vous devez nous fournir la clé d’API en créant une nouvelle application (voir la procédure ci-dessous : les comptes d’accès aux catalogues restent quant à eux valides),
ARTIS intervient pour modifier l’interfaçage avec le nouvel identifiant (Clé d’API).
Si la fonctionnalité n’est pas encore déployée sur l’environnement artis.net, pour en bénéficier, suivre la même manière la procédure ci-dessous et transmettre la Clé d’API aux équipes techniques d’ARTIS.
Cette nouvelle version est compatible à partir de la version 4.2.14 d’artis.net.
Étape |
Détails / Copie écran |
|---|---|
Se rendre sur le site de l’INSEE |
|
Cliquer sur le bouton Se connecter |
|
Sélectionner CONNEXION-POUR-LES-EXTERNES |
|
Se connecter ou créer un compte à défaut |
|
Cliquer sur le bouton Applications |
|
Cliquer sur CRÉER UNE APP |
|
Étape Général |
|
Étape Sécurité |
|
Étape Souscription |
|
|
|
|
|
|
|
|
|
|
|
|
|
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 |