Ajout des API de la Plateforme de l'inclusion

_data/api/api-data-inclusion.md

@@ -1,6 +1,6 @@
 ---
 title: API data·inclusion
-tagline: Créer un référentiel commun de toutes les données de l’offre d’insertion des territoires afin de permettre à tous les services recensant et mettant en visibilité leur offre d’être interopérables et de mutualiser les efforts de recensement et de mise à jour.
+tagline: 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.
 is_open: 0 # 0 means API require an account
 account_link: https://www.data.inclusion.beta.gouv.fr/api/conditions-generales-dutilisation-de-lapi
 external_site: https://www.data.inclusion.beta.gouv.fr
@@ -14,15 +14,12 @@ partners:
   - 1jeune1solution
 producer: gip-inclusion
 keywords:
-  - Data inclusion
   - Inclusion
   - Insertion
-  - Structures
-  - Services
   - Siret
   - Sociale
   - Subvention
-contact_link: [email protected]
+contact_link: https://tally.so/r/w7N6Zz
 doc_tech_link: https://api.data.inclusion.beta.gouv.fr/openapi.json
 doc_tech_external: https://api.data.inclusion.beta.gouv.fr/api/v0/docs
 stats_detail_resume: Accédez au suivi des consommations des API
@@ -35,24 +32,128 @@ stats_detail_link: http://metabase.data.inclusion.beta.gouv.fr/public/dashboard/
 themes:
   - Administration
   - Emploi
-last_update: 14/06/2023
+last_update: 27/02/2024
 ---
 
-L'API data·inclusion agrège les données de l'insertion sociale et professionnelle.
+## Description
+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)
 
-### Sources de données
+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/)
 
-Les sources de données sont consultables sur [le site Web de data·inclusion](https://www.data.inclusion.beta.gouv.fr/le-projet-data-inclusion/ils-partagent-deja-leurs-donnees).
+### À quoi sert l'API data.inclusion  ?
 
-Les données collectées sont:
+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.
 
-- historisées,
-- géocodées,
-- enrichies via l'outil de correspondance, développé par data•inclusion, qui permet de faire correspondre 2 jeux de données brutes,
-- alignées sur le schéma de données de data·inclusion
-- publiées hebdomadairement en open data sur [data.gouv](https://www.data.gouv.fr/fr/datasets/6233723c2c1e4a54af2f6b2d), la plateforme de données publiques,
-- consultables via une api.
+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": "[email protected]",
+    	"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": "[email protected]",
+    	"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)
 
-<Button href="https://www.data.inclusion.beta.gouv.fr/">Consulter le site data•inclusion</Button>
 
 

_data/api/api-marche-inclusion.md

@@ -0,0 +1,130 @@
+---
+title: API Marché de l'inclusion
+tagline: 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.
+is_open: 0 # 0 means API require an account
+account_link: https://lemarche.inclusion.beta.gouv.fr/api/
+external_site: https://lemarche.inclusion.beta.gouv.fr/
+producer: gip-inclusion
+keywords:
+  - Insertion
+  - social
+  - Inclusion
+  - Subvention
+  - Aides
+  - Entreprise
+  - Handicap
+  - ETTI
+  - EITI
+  - GEIQ
+  - EATT
+  - ESAT
+  - Inclusive
+#rate_limiting_resume: 
+themes:
+  - Entreprise
+  - Emploi
+contact_link: [email protected]
+doc_tech_link: https://lemarche.inclusion.beta.gouv.fr/api/schema/
+last_update: 27/02/2024
+---
+## Description
+
+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. 
+
+## À 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),<br>
+➡️ Associations intermédiaires (AI),<br>
+➡️ Ateliers de chantier d'insertion (ACI),<br>
+➡️ Entreprises de travail temporaire d'insertion (ETTI),<br>
+➡️ Entreprises d'insertion par le travail indépendant (EITI),<br>
+➡️ Groupements d'employeurs pour l'insertion et la qualification (GEIQ)
+
+
+#### Handicap
+
+➡️ Entreprises adaptées (EA),<br>
+➡️ Entreprises adaptées de travail temporaire (EATT),<br>
+➡️ Etablissements et services d'aides par le travail (ESAT)
+

_data/roadmap.md

@@ -460,4 +460,9 @@
     - type: ADD_API
       what: API Annuaire de l’administration et des services publics, par la DILA
       path: /les-api/api-annuaire-administration-services-publics
+2024:
+  2:
+    - type: INFO
+      what: Renommage de l'API "Structures de l'inclusion" en "Marché de l'inclusion"
+      path: /les-api/api-marche-inclusion
 ---