### À quoi sert l'API data.inclusion  ?

L’API data·inclusion a mis en place un langage commun pour définir l’offre d’insertion. Ce langage se traduit par [un schéma public de données](https://github.com/gip-inclusion/data-inclusion-schema/tree/main/schemas) que toute donnée intégrée dans data·inclusion respecte.

Nos données sont disponibles en accès libre open-data ou par API. Le jeu en open-data n’inclut aucune donnée personnelle. L’API offre une connexion en flux direct et permet la mise à jour en temps réel des données, évitant ainsi les risques liés à l’obsolescence des informations.

### Les différents cas d'usage

![Illustration cas d'usage](/images/divers/api-data-inclusion-ecosystem.png)

### Quelles sont les données contenues dans l'API data.inclusion  ?

Schéma des structures et services d'insertion

🔎 Exemple schéma "Structure"

```
[
	{
    	"id": "c3d15659-8de9-4fd6-b283-04d50f6ace57",
    	"siret": "60487647500499",
    	"rna": "W123456789",
    	"nom": "MOBILETTE",
    	"commune": "Robinboeuf CEDEX",
    	"code_postal": "09891",
    	"code_insee": "09890",
    	"adresse": "RUE DE LECLERCQ",
    	"date_maj": "2022-04-28T16:53:11Z",
    	"complement_adresse": "HOTEL DE VILLE",
    	"longitude": 7.848133,
    	"latitude": 48.7703,
    	"typologie": "ASSO",
    	"telephone": "0102030405",
    	"courriel": "julie@example.net",
    	"site_web": "https://www.asso-gonzalez.net/",
    	"presentation_resume": "L’association Mobilette propose des solutions de déplacement aux personnes pour qui la non mobilité est un frein à l’insertion professionnelle : - connaissance de l'offre de transport du territoire - accès à un véhicule 2 ou 4 roues - transport solidaire - accès au permis",
    	"presentation_detail": null,
    	"source": "solidagregateur",
    	"antenne": True,
    	"lien_source": "https://solidagregateur.fr/structures/c3d15659-8de9-4fd6-b283-04d50f6ace57",
    	"horaires_ouverture": "Mo-Fr 10:00-20:00 \"sur rendez-vous\"; PH off",
    	"accessibilite": "https://acceslibre.beta.gouv.fr/app/29-lampaul-plouarzel/a/bibliotheque-mediatheque/erp/mediatheque-13/",
    	"labels_nationaux": ["MOBIN", "AFPA"],
    	"labels_autres": ["Nièvre médiation numérique"],
    	"thematiques": ["mobilite", "trouver-un-emploi"]
	}
]
```


🔎 Exemple schéma "Service"

```
[
	{
    	"id": "mon-service-id",
    	"structure_id": "ma-structure-id",
    	"source": "dora",
    	"nom": "TISF",
    	"presentation_resume": "Accompagnement des familles à domicile",
    	"presentation_detail": "Service de proximité visant à soutenir les familles ayant la responsabilité de jeunes enfants, en particulier les familles monoparentales.",
    	"types": [
        	"formation",
        	"information",
        	"aide-materielle",
        	"accueil",
        	"accompagnement",
    	],
    	"thematiques": ["mobilite"],
    	"prise_rdv": "https://www.alys.fr/familles/etre-accompagne-a-domicile",
    	"frais": "gratuit",
    	"frais_autres": null,
    	"profils": ["adultes","jeunes-16-26", "femmes"],
    	"pre_requis": "Bonne connaissance du français oral et écrit",
    	"cumulable": True,
    	"justificatifs": "Carte d'identité, passeport ou permis de séjour",
    	"modes_orientation_accompagnateur": ["envoyer-un-mail-avec-des-documents-a-completer"],
    	"modes_orientation_beneficiaire": ["envoyer-un-email", "se-presenter"],
    	"formulaire_en_ligne": null,
    	"commune": "Plougasnou",
    	"code_postal": "29630",
    	"code_insee": "29188",
    	"adresse": "25 route de Morlaix",
    	"complement_adresse": null,
    	"longitude": 3.76855,
    	"latitude": 23.88654,
    	"recurrence": "Tu 09:00-12:00;We 14:00-17:00",
    	"date_creation": "2023-02-04T12:34:44Z",
    	"date_maj": "2023-03-11T16:54:10Z",
    	"date_suspension": null,
    	"lien_source": "https://dora.fabrique.social.gouv.fr/services/etre-accompagne-a-domicile",
    	"telephone": "02 78 91 12 62",
    	"courriel": "contact@alys.fr",
    	"contact_nom_prenom": "Gwennaël Kergonna",
    	"contact_public": True,
    	"modes_accueil": ["a-distance", "en-presentiel"],
    	"zone_diffusion_type": "departement",
    	"zone_diffusion_code": "29",
    	"zone_diffusion_nom": "Finistère"
	}
]
```

### Typologie d'utilisateurs

#### Producteurs
Les acteurs de l’insertion qui partagent leur offre de service sur notre commun numérique. Leur offre est variée en termes de thématiques abordées, de publics ciblés et de couverture géographique.

➡️ [Devenir producteur](https://tally.so/r/w7N6Zz)

#### Consommateurs
Toute personne qui récupèrent et utilisent les données disponibles sur data·inclusion. Nos consommateurs sont variés : communs numériques, annuaires d'offre d'insertion, logiciels de suivi de parcours, outils de cartographie, outils de pilotage pour l'administration…”

➡️ [Devenir consommateur](https://tally.so/r/w7N6Zz)





L'API data·inclusion permet de mettre en œuvre le principe « Dites-le-nous une fois », en application de [l’article L114-8 du Code des relations entre le public et l’administration](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000045213315)

L’équipe data·inclusion propose le traitement et l’analyse des jeux de données multi sources en un seul et unique patrimoine commun disponible publiquement 👉 [Accéder à notre site](https://www.data.inclusion.beta.gouv.fr/)


data·inclusion facilite et accélère le partage des données entre les acteurs de l'insertion en mutualisant l’effort de mise à jour et de recensement entre les différents services numériques.

Plateforme de l'inclusion

France Travail

Les lieux de médiations numérique

Collectivités territoriales

1jeune1solution

Tableau de bord public disponible ci-dessous

API data·inclusion

### À quoi sert l'API Les emplois de l'inclusion ?


L'API permet de visualiser :

**🔎 La liste des candidats par structure**

Retourne la liste de tous les demandeurs d'emploi liés à une candidature pour la structure en cours.
Les candidats sont triés par date de création dans la base des emplois de l'inclusion, du plus récent au plus ancien.

Principales données fournies par l'API : 

```
- Civilité
- Nom
- Prénom
- Courriel
- Téléphone
- Adresse complète (rue, numéro, ville, code postal, complément)
- Date de naissance
- Lieu de naissance (dont pays)
- Lien vers le CV de la personne
```

 

**🔎 La liste des embauches réalisées en GEIQ**

Retourne la liste complète des embauches réalisées en GEIQ connues des Emplois de l'inclusion. Ces embauches représentent des candidatures acceptées.

Elles ne seront plus listées par l'API une fois le contrat terminé.

Principales données fournies par l'API : 

```
- Identité des candidats
- Source d'orientation
- Date de début et de fin de contrat
- Type de contrat de travail
- Données sur les actions préalables au recrutement
- Critères d'éligibilité (public prioritaire GEIQ)
- Nombre d'heures de formation prévues
```

 

**🔎 Les fiches salarié**

Retourne la liste des fiches salarié saisies par les SIAE :
- pour toutes les embauches / candidatures des SIAE liées au token d'identification
- classées par date de création (plus récent au plus ancien)


Il est également possible d'obtenir le détail d'une fiche salarié par son identifiant (dans les mêmes conditions d'autorisation que pour la liste complète).

Principales données fournies par l'API : 

```
- SIRET
- Mesure associée
- Informations d'identité et coordonnées personnelles du salarié
- Situation du salarié
```

 

**🔎 La liste des SIAE**

Renvoie une liste de SIAE à proximité d’une ville (déterminée par son code INSEE) et dans un rayon de recherche en kilomètres autour du centre de cette ville.
Les coordonnées des centres-villes sont issus de [geo.api.gouv.fr](https://geo.api.gouv.fr/).

Chaque SIAE est accompagnée d’un certain nombre de métadonnées :

```
- SIRET
- Type
- Raison Sociale
- Enseigne
- Site web
- Description de la SIAE
- Blocage de toutes les candidatures OUI/NON
- Adresse de la SIAE
- Complément d’adresse
- Code Postal
- Ville
- Département
```

Chaque SIAE peut proposer 0, 1 ou plusieurs postes. Pour chaque poste renvoyé, les métadonnées fournies sont :

```
- Appellation ROME
- Date de création
- Date de modification
- Recrutement ouvert OUI/NON
- Description du poste
```

 

👉 [Tester le service](https://emplois.inclusion.beta.gouv.fr)

### Périmètre

#### Insertion par l'activité économique (IAE)

➡️ Entreprises d'insertion (EI), 
➡️ Associations intermédiaires (AI), 
➡️ Ateliers de chantier d'insertion (ACI), 
➡️ Entreprises de travail temporaire d'insertion (ETTI), 
➡️ Entreprises d'insertion par le travail indépendant (EITI), 
➡️ Groupements d'employeurs pour l'insertion et la qualification (GEIQ) 

#### Handicap :

➡️ Entreprises adaptées (EA), 
➡️ Entreprises adaptées de travail temporaire (EATT), 
➡️ Etablissements et services d'aides par le travail (ESAT)

L'API Les emplois de l'inclusion offre aux utilisateurs un outil mutualisé pour simplifier les procédures, fluidifier les parcours d'insertion entre professionnels et renforcer la qualité de l'accompagnement des personnes.


Faciliter la mise en relation des personnes les plus éloignées de l'emploi avec les employeurs solidaires (SIAE, GEIQ, EA et EATT) et les accompagnants (orienteurs et prescripteurs habilités).

API Les emplois de l'inclusion

## À quoi servent les API d’Immersion facilitée ?

Les API permettent :

🔎 **La recherche d'entreprises accueillantes et mise en contact** :

- Consulter le détail d’une offre d’immersion
- Rechercher des offres d'immersion correspondant à une recherche
- Soumettre une demande de mise en contact auprès d’une entreprise accueillante


🔎 **L'accès aux conventions** (dans ce cas il nous faudra connaître les agences qui vous concernent)

- Récupération et consultation du détail d’une convention
- Lister (avec filtre) les conventions rattachées au consommateur


👉 [Tester le service](https://immersion-facile.beta.gouv.fr/)


## Quelles sont les données contenues dans l'API Immersion facilitée ?

On retrouve - entre autres :

### Entreprises accueillantes

➡️ SIRET, 
➡️ Raison sociale ou nom d'enseigne, 
➡️ NAF, 
➡️ Effectifs, 
➡️ Adresse de l'entreprise, 
➡️ Métiers (ROME et appellations) pour lesquels l’entreprise est prête à accueillir en immersion, 
➡️ Les modalités de mise en relation, 

### Conventions d’immersion (PMSMP)

➡️ Toutes les informations contenues dans la convention, 
➡️ L’état de la convention :
- En brouillon ou demande de modification en cours
- Obsolète
- Partiellement signée
- Prête à signer
- Rejetée
- Validée par le prescripteur
- À valider par le conseiller
- À valider par le prescripteur

ℹ️ La souscription aux API se fait par *webhook*. Une clé API est nécessaire pour utiliser les API. Cette clé est fournie sur demande auprès de l’équipe.

Le but d'Immersion facilitée est de faciliter la réalisation des immersions professionnelles en s’appuyant sur deux piliers :
- la dématérialisation de la convention et, à terme, du bilan
- un annuaire d’entreprises accueillantes, volontaires pour accueillir en immersion professionnelle sur leurs métiers. Cette base entreprise est enrichie par l’appel à des bases existantes (La Bonne Boîte …). La base est accessible grâce à un moteur de recherche et un parcours de mise en relation avec l’entreprise.


Faciliter la réalisation des immersions professionnelles.

API Immersion Facilitée

## À quoi sert l'API Marché de l'inclusion ?

### Chercher des structures

L'API fournit toutes les données essentielles pour identifier les prestataires inclusifs. Elle permet de :
 
- Rechercher (via son SIRET ou SIREN) et consulter le détail des **structures de l'IAE**
- Rechercher et consulter le détail des **types de structures**
- Rechercher et consulter le détail des **types de prestations**
- Rechercher et consulter le détail des **secteurs d'activité**
- Rechercher et consulter le détail des **réseaux de l'IAE**
- Rechercher et consulter le détail des **périmètres et types de périmètres**

👉 [Tester le version web du moteur de recherche](https://lemarche.inclusion.beta.gouv.fr/prestataires)

### Déposer un besoin d'achat

Elle permet aussi de déposer des besoins d'achats. Une fois déposé, le moteur de recherche trouvera les structures les plus pertinentes pour répondre au besoin.
 
- Créer un besoin d'achat
- Lister tous les montants de besoins d'achat 
- Lister tous les types de besoins d'achat

👉 [Tester le version web du formulaire de dépôt de besoins](https://lemarche.inclusion.beta.gouv.fr/besoins/ajouter)

## Les différents cas d'usage

### 🔎 Moteur de recherche multicritères

1. Je suis acheteur
2. Je souhaite rechercher un prestataire inclusif
3. Je renseigne le secteur géographique
4. Je sélectionne le secteur d'activité
5. Je lance la recherche
6. J'accède à la listes des prestataires et à leurs fiches de contact

### 🔎 Moteur de recherche par nom ou SIRET/SIREN

1. Je suis acheteur
2. Je souhaite rechercher un prestataire inclusif
3. Je renseigne son nom, ou son n° de SIRET/SIREN
5. Je lance la recherche
6. J'accède à la fiche de contact du (ou des) prestataire(s) correpondant(s)

### 🔎 Sourcing inversé

 1. Je suis acheteur
 2. Je souhaite rechercher un prestataire inclusif
 3. Je renseigne son n° de SIRET/SIREN ou son nom
 5. Je lance la recherche
 6. J'accède à fiche de contact du prestataire

### 🔎 Déposer un appel d'offre
 
1. Je suis acheteur
2. J'ai un besoin d'achat et je souhaite trouver un prestataire inclusif
3. Je dépose mon besoin via l'API
4. Je me connecte ensuite sur mon tableau de bord pour accéder à la liste des prestataires correspondants, et j'échange avec ceux qui sont intéressés

## Quelles sont les données contenues dans l'API ?

### Structures

On retrouve pour chaque structure :

| Nom de la donnée | Description |
|------------------|-----------------------------------|
| name | Raison sociale |
| brand | Nom commercial |
| kind | Type de structure |
| kind_parent | Type "parent" de structure |
| siret | Numéro de siret de la structure |
| address | Localisation de la structure |
| offers | Offres proposées par la structure |
| sectors | Secteurs d'activité |
| networks | Liens avec les différents réseaux |
| labels | Labels de la structure |
| updated_at | Date de dernière mise à jour |

### Types de structures

#### Insertion par l'activité économique (IAE)
 
➡️ Entreprises d'insertion (EI), 
➡️ Associations intermédiaires (AI), 
➡️ Ateliers de chantier d'insertion (ACI), 
➡️ Entreprises de travail temporaire d'insertion (ETTI), 
➡️ Entreprises d'insertion par le travail indépendant (EITI), 
➡️ Groupements d'employeurs pour l'insertion et la qualification (GEIQ)
 

#### Handicap
 
➡️ Entreprises adaptées (EA), 
➡️ Entreprises adaptées de travail temporaire (EATT), 
➡️ Etablissements et services d'aides par le travail (ESAT)

L'API Marché de l'inclusion simplifie et accélère l'identification et la mise en relation avec toutes les structure sociales et inclusives. Une solution permettant aux acheteurs de sourcer parmi plus de 6000 prestataires socialement responsables conventionnés par l'Etat. 


Plateforme d'achat et de sourcing à destination des acheteurs privés et publics engagés pour l'inclusion. l'API permet de retrouver facilement les informations sur les structures de l'inclusion, et de déposer des besoins d'achats.

API Marché de l'inclusion

La Plateforme de l'inclusion développe et améliore en continu des services numériques publics et ouvre des données pour l’ensemble des professionnels de l’insertion  autour de 3 objectifs :
- **Accompagnement** : diminuer le non-recours au service public et améliorer l’expérience d’accompagnement des personnes éloignées de l’emploi
- **Connaissance** : développer les connaissances des professionnels de l’insertion et faire évoluer leur pratiques pour augmenter l’impact qu’ils peuvent avoir sur les parcours
- **Expériences professionnelles** : développer les expériences des personnes éloignées de l’emploi chez des employeurs solidaires ou des entreprises classiques


Plateforme de l'inclusion

Qu'est-ce que Plateforme de l'inclusion ?

Quelle est sa mission de service public ?

Contacter Plateforme de l'inclusion

Quelles sont les API de Plateforme de l'inclusion ?