Schéma des structures et services d'insertion

Schémas JSON

Schéma Structure

Exemple

[
    {
        "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"]
    }
]

Partagez vos commentaires, questions, et besoins d'évolutions concernant ce schéma en cliquant ici

Format de fichier

  • encodage : utf-8

Champ présents

id

  • obligatoire : oui

  • type : chaîne de caractères

  • description : Ce champ renseigne un identifiant pour la structure dans le jeu de donnée considéré. La valeur de ce champ est relative à l'endroit où la donnée est stockée (sa valeur peut être différente d'une base à l'autre).

  • exemples :

    • dans une base A où les structures sont identifiées par un slug, l'identifiant de la structure S pourrait être structure-s-paris-1

    • dans une base B où les structures sont identifiées par un uuid, l'identifiant de la structure S (qui est la même structure que dans la base A) pourrait être c96d4cd8-afa6-4f66-ad2a-f76a60173b38

Les champ siret et rna ne sont pas obligatoires mais fortement conseillés pour permettre la déduplication des données et les croisements.

Le siret (et/ou le rna) est essentiel pour permettre de concilier les données provenant de bases de données différentes. Sans ces données "pivots", le travail de déduplication sera difficile, et ne permettra pas avec fiabilité de rechercher, pour une structure donnée, toutes les informations disponibles dans data.inclusion rattachables à cette structure.

siret

  • obligatoire : non (voir encadré ci-dessus)

  • type : chaîne de caractères respectant le motif ^\d{14}$

  • description : Ce champ contient le code SIRET de la structure, issu de la base SIRENE des entreprises et récupérable via annuaire-entreprises.data.gouv.fr.

rna

  • obigatoire : non (voir encadré ci-dessus)

  • type : chaîne de caractères respectant le motif ^W\d{9}$

  • description : Ce champ contient le numéro RNA (Répertoire National des Associations cf) de la structure.

nom

  • obligatoire : oui

  • type : chaîne de caractères

  • description : Ce champ contient le nom de la structure.

commune

  • obligatoire : oui

  • type : chaîne de caractères

  • description : Ce champ contient le nom de la commune rattachée à l'adresse de la structure.

code_postal

  • obligatoire : oui

  • type : chaine de caractères respectant le motif ^\d{5}$

  • description : Ce champ contient le code postale rattaché à l'adresse de la structure.

code_insee

  • obligatoire : non

  • type : chaîne de caractères respectant le motif ^\d[A-B0-9]\d{3}$

  • description : Ce champ contient le code officiel géographique de la commune rattachée à l'adresse de la structure.

adresse

  • obligatoire : oui

  • type : chaîne de caractères

  • description : Ce champ contient les éléments de l'adresse de la structure relatifs à la voie. Typiquement, <numero_voie> <indice_de_repetition> <type_voie> <libelle_voie>.

  • format : pas de format imposé mais l'utilisation du libellé renvoyé suite au géocodage par https://adresse.data.gouv.fr/api-doc/adresse est fortement recommandé.

  • exemple : 20 Avenue de Ségur

complement_adresse

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient des éléments permettant de préciser l'adresse et la situation exactes de la structure, afin d'en permettre l'accès aux usagers. Cela peut être un numéro d'appartement, un étage, un lieu-dit, etc.

longitude

  • obligatoire : non

  • type : nombre décimal (float)

  • description : Ce champ contient la longitude de la structure, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.

latitude

  • obligatoire : non

  • type : nombre décimal (float)

  • description : Ce champ contient la latitude de la structure, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.

typologie

  • obligatoire : non

  • type : chaîne de caractères

  • description : La valeur de ce champ indique le type de la structure : CCAS, ASSO, COMMUNE, etc. . Les valeurs possibles sont restreintes au vocabulaire décrivant les types de structures :

pageTypologie de structures

telephone

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient un numéro de téléphone de la structure consacré à rentrer en contact avec elle.

Le format n'est pas encore spécifié.

courriel

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une adresse email de la structure consacrée à rentrer en contact avec elle.

site_web

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une URL vers le site internet de la structure.

presentation_resume

  • obligatoire : non

  • type : chaîne de caractères limitée à 280 caractères

  • description : Ce champ contient une courte description de la structure.

presentation_detail

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une courte description de la structure, pouvant également servir à préciser son lieu ou son activité.

source

  • obligatoire : non

  • type : chaîne de caractères

  • description : La valeur de ce champ indique la source de données où les données de cette structure ont été saisies.

antenne

  • obligatoire : oui

  • type : booléen

  • description : La valeur de ce champs indique si la structure est une antenne. Il peut exister plusieurs antennes pour un même siret (ou rna), contrairement à une structure "classique" qui devrait être unique pour une source donnée.

date_maj

  • obligatoire : oui

  • type : chaîne de caractères, au format ISO 8601.

  • description : Ce champ contient la date, et optionnellement l'heure, à laquelle la donnée a été mise à jour.

  • exemples :

    • 2022-04-28 : sans l'heure

    • 2022-04-28T16:53:11Z : avec l'heure

lien_source

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une URL vers le site de la source. Il s'agit d'un lien vers la structure pouvant être utilisé afin de rediriger un utilisateur vers la source.

horaires_ouverture

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient les horaires d'ouverture. Le format recommandé (mais non obligatoire) est le format OSM opening_hours (OSM : OpenStreetMap).

Outil d'aide à la saisie : https://projets.pavie.info/yohours/

accessibilite

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une url renvoyant vers le profil Acceslibre du lieu de la structure : https://acceslibre.beta.gouv.fr/.

Acceslibre est un service public porté par le Ministère de la Transition Écologique afin de collecter et de partager les données d’accessibilité des établissements recevant du public.

Le remplissage d’une fiche prend moins de 5 minutes !

labels_nationaux

  • obligatoire : non

  • type : liste de chaînes de caractères

  • description : Ce champ indique la liste des éventuels labels et réseaux nationaux dont la structure fait partie : MOBIN, AFPA, FRANCE_SERVICE, etc. . Les valeurs possibles sont restreintes à la liste des labels :

pageLabels et réseaux
  • exemple : ["FRANCE_SERVICE", "AIDANTS_CONNECT"]

labels_autres

  • obligatoire : non

  • type : liste de chaines de caractères

  • description : Ce champ permet de préciser si le lieu a obtenu d’autres labels (régionaux, locaux…). Les valeurs ne sont pas restreintes.

  • exemple : ["SudLabs", "Nièvre médiation numérique"]

thematiques

  • obligatoire : non

  • type : liste de chaines de caractères

  • description : Ce champ précise une liste de thématiques abordées par la structure. Les valeurs possibles sont restreintes à la liste des thématiques :

pageThématiques
  • exemple : ["mobilite", "numerique"]

Schéma Service

Une structure peut proposer des services.

Chaque donnée service peut référencer une donnée structure.

[
    {
        "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"
    }
]

id

  • obligatoire : oui

  • type : chaîne de caractères

  • description : Ce champ renseigne un identifiant local pour la service dans le jeu de donnée considéré. La valeur de ce champ est relative à l'endroit où la donnée est stockée (fichier, base de donnée, etc.) et permet d'identifier de manière unique au sein de cette source.

structure_id

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient l'identifiant local (id) de la structure proposant le service.

source

  • obligatoire : oui

  • type : chaîne de caractères

  • description : La valeur de ce champ indique la source de données où les données de ce service ont été saisies. Le couple structure_id + source permet de retrouver la structure.

nom

  • obligatoire : oui

  • type : chaîne de caractères

  • description : un nom pour le service considéré rendu par la structure. Il n'est pas nécessaire d'indiquer à nouveau le nom de la structure.

  • exemple : "Accompagnement dans les démarches administratives"

presentation_resume

  • obligatoire : non

  • type : chaîne de caractères limitée à 280 caractères

  • description : une description courte du service considéré rendu par la structure.

presentation_detail

  • obligatoire : non

  • type : chaîne de caractères

  • description : une description détaillée du service considéré rendu par la structure.

types

  • obligatoire : non

  • type : liste de chaînes de caractères

  • description : une liste précisant la ou les catégories attribuables au service.

pageTypologie de services
  • exemple : ["accompagnement", "aide-materielle"]

thematiques

  • obligatoire : non

  • type : liste de chaînes de caractères

  • description : une liste précisant la ou les thématiques attribuables au service.

pageThématiques
  • exemple : ["numerique", "mobilite"]

prise_rdv

  • obligatoire : non

  • type : chaîne de caractères

  • description : ce champ contient une url renvoyant vers le site de prise de rendez-vous en ligne avec les aidants du lieu.

  • exemple : https://www.rdv-solidarites.fr/...

frais

  • obligatoire : non

  • type : liste de chaîne de caractères

  • description : une liste précisant les différents frais requis pour avoir recours au service. La liste des valeurs possibles est restreintes au code du tableaux suivant.

  • exemple : ["adhesion", "gratuit-sous-conditions"]

codedescription

gratuit

gratuit-sous-conditions

payant

adhesion

pass-numerique

frais_autres

  • obligatoire : non

  • type : chaîne de caractères

  • description : une description libre des frais requis

profils

  • obligatoire : non

  • type : liste de chaîne de caractères

  • description : une liste précisant les différents profils de publics accueillis pour ce service. La liste des valeurs possibles est restreintes au code du tableaux suivant

codelabeldescription

seniors-65

Seniors (+ 65 ans)

familles-enfants

Familles/enfants

adultes

Adultes

jeunes-16-26

Jeunes (16-26 ans)

public-langues-etrangeres

Public langues étrangères

deficience-visuelle

Déficience visuelle

surdite

Surdité

handicaps-psychiques

Handicaps psychiques : troubles psychiatriques donnant lieu à des atteintes comportementales

handicaps-mentaux

Handicaps mentaux : déficiences limitant les activités d’une personne

femmes

Femmes

Le lieu propose des accompagnements réservés aux femmes.

personnes-en-situation-illettrisme

Personnes en situation d’illettrisme

pre_requis

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ libre indique les pré-requis et compétences nécessaires à l'accès au service

cumulable

  • obligatoire : non

  • type : booléen

  • description : Option permettant d'afficher si le service peut être cumulé ou non, en particulier pour les aides financières

justificatifs

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ libre indique les justificatifs à fournir pour mobiliser le service

modes_orientation_accompagnateur

  • obligatoire : non

  • type : liste de chaînes de caractères.

  • description : Ce champ indique les modalités permettant aux professionnels accompagnateurs d'orienter les usagers vers la structure pour le service proposé. Les valeurs possibles sont restreintes au vocabulaire décrivant les modes d'orientation : Modes d'orientation

modes_orientation_beneficiaire

  • obligatoire : non

  • type : liste de chaînes de caractères.

  • description : Ce champ indique les modalités permettant aux usagers de mobiliser le service proposé. Les valeurs possibles sont restreintes au vocabulaire décrivant les modes d'orientation : Modes d'orientation

formulaire_en_ligne

  • obligatoire : non

  • type : chaîne de caractères de type URL de 1 à 2083 caractères

  • description : Ce champ indique l'adresse du formulaire en ligne à remplir pour mobiliser le service

commune

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient le nom de la commune du lieu de réalisation du service

code_postal

  • obligatoire : non

  • type : chaîne de 5 caractères

  • description : Ce champ contient le code postal du lieu de réalisation du service

code_insee

  • obligatoire : non

  • type : chaîne de 5 caractères

  • description : Ce champ contient le code officiel géographique de la commune du lieu de réalisation du service

adresse

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient les éléments de l'adresse de la structure relatifs à la voie. Typiquement, <numero_voie> <indice_de_repetition> <type_voie> <libelle_voie>.

complement_adresse

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient des éléments permettant de préciser l'adresse et la situation exactes du lieu de réalisation du service, afin d'en permettre l'accès aux usagers. Cela peut être un numéro d'appartement, un étage, un lieu-dit, etc.

longitude

  • obligatoire : non

  • type : nombre décimal

  • description : Ce champ contient la longitude du lieu de réalisation du service, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.

latitude

  • obligatoire : non

  • type : nombre décimal

  • description : Ce champ contient la latitude du lieu de réalisation du service, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.

recurrence

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ décrit les plages horaires durant lesquelles le service est proposé. Le format recommandé (mais non obligatoire) est le format OpenStreetMaps opening_hours.

  • exemple :

    • Mo-Fr 08:00-12:00,13:00-17:30; Sa 08:00-12:00

    • est synonyme de "Du lundi au vendredi de 8:00 à midi et de 13:00 à 17:30, et le samedi de 8:00 à midi"

date_creation

  • obligatoire : non

  • type : chaîne de caractères, au format ISO 8601.

  • description : Ce champ contient la date, et optionnellement l'heure, à laquelle le service a été créé dans la source de données.

  • exemples :

    • 2022-04-28 : sans l'heure

    • 2022-04-28T16:53:11Z : avec l'heure

date_maj

  • obligatoire : non

  • type : chaîne de caractères, au format ISO 8601.

  • description : Ce champ contient la date, et optionnellement l'heure, à laquelle le service a été mis à jour dans la source de données.

  • exemples :

    • 2022-04-28 : sans l'heure

    • 2022-04-28T16:53:11Z : avec l'heure

date_suspension

  • obligatoire : non

  • type : chaîne de caractères, au format ISO 8601.

  • description : Ce champ contient la date, et optionnellement l'heure, à laquelle le service n'est plus accessible.

  • exemples :

    • 2022-04-28 : sans l'heure

    • 2022-04-28T16:53:11Z : avec l'heure

lien_source

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une URL vers le service sur le site Web de la source. Il s'agit d'un lien vers le service pouvant être utilisé afin de rediriger un utilisateur vers la source.

telephone

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient un numéro de téléphone de la personne référente du service concerné consacré à rentrer en contact avec elle.

courriel

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient une adresse email de la personne référente du service concerné.

contact_nom_prenom

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient le nom de famille et le prénom de la personne référente du service concerné. Le nom de famille et le prénom peuvent apparaître dans n'importe quel ordre.

contact_public

  • obligatoire : non

  • type : booléen

  • description : Ce champ contient l'information relative au choix de la structure de diffuser publiquement, ou non, les coordonnées de contact rattachées à un service .

modes_accueil

  • obligatoire : non

  • type : liste de chaînes de caractères

  • description : Ce champ indique le mode d'accueil et de réalisation du service. Les valeurs possibles sont restreintes au vocabulaire décrivant les modes d'accueil : Modes d'accueil

  • exemples :

    • ["a-distance", "en-presentiel"] : le service est proposé à distance et en présentiel

    • ["en-presentiel"] : le service n'est proposé qu'en présentiel

zone_diffusion_type

  • obligatoire : non

  • type : chaînes de caractères

  • description : Ce champ contient le type de code géographique INSEE (ou autre) utilisé pour caractériser la zone de diffusion du service. Les valeurs possibles sont restreintes au vocabulaire décrivant les types de codes INSEE : Types de codes INSEE

zone_diffusion_code

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient le code géographique INSEE utilisé pour caractériser la zone de diffusion du service.

zone_diffusion_nom

  • obligatoire : non

  • type : chaîne de caractères

  • description : Ce champ contient le nom de la zone géographique de la zone de diffusion.

Dernière mise à jour