API INSEE#

Home > 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