Schéma des structures et services d'insertion
Schémas JSON
Schéma Structure
Exemple
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
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
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
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
nom
obligatoire : oui
type : chaîne de caractères
description : Ce champ contient le nom de la structure.
commune
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
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
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.
Outil d'aide à la saisie/récupération pour le code_insee :
https://adresse.data.gouv.fr/api-doc/adresse pour la récupération de masse
adresse
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
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
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
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
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 :
telephone
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
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
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
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
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
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
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
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'heure2022-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 :
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 :
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
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.
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.
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"]
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
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'heure2022-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'heure2022-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'heure2022-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