Rechercher…
Schéma des structures d'insertion
GitHub - betagouv/data-inclusion-schema
GitHub
Le schéma est versionné dans ce dépôt

Exemple d'une donnée de structure dans le schéma

1
[
2
{
3
"id": "c3d15659-8de9-4fd6-b283-04d50f6ace57",
4
"siret": "60487647500499",
5
"rna": "W123456789",
6
"nom": "MOBILETTE",
7
"commune": "Robinboeuf CEDEX",
8
"code_postal": "09891",
9
"code_insee": "09890",
10
"adresse": "RUE DE LECLERCQ",
11
"date_maj": "2022-04-28T16:53:11Z",
12
"complement_adresse": "HOTEL DE VILLE",
13
"longitude": 7.848133,
14
"latitude": 48.7703,
15
"typologie": "ASSO",
16
"telephone": "0102030405",
17
"courriel": "[email protected]",
18
"site_web": "https://www.asso-gonzalez.net/",
19
"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",
20
"presentation_detail": "",
21
"source": "solidagregateur",
22
"structure_parente": "7713e292-abd1-42fc-b1f0-071b7e7a2f61",
23
"lien_source": "https://solidagregateur.fr/structures/c3d15659-8de9-4fd6-b283-04d50f6ace57",
24
"horaires_ouverture": "Mo-Fr 10:00-20:00 \"sur rendez-vous\"; PH off"
25
}
26
]
Copied!

Format de fichier

  • encodage : utf-8

Champs présents

id

  • obligatoire : oui
  • type : chaîne de caractères
  • description : Ce champs renseigne un identifiant pour la structure dans le jeu de donnée considéré. La valeur de ce champs 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

siret

  • obligatoire : non
  • type : chaîne de caractères respectant le motif ^\d{14}$
  • description : Ce champs contient le code SIRET de la structure, issu de la base SIRENE des entreprises et récupérable via annuaire-entreprises.data.gouv.fr.
Le siret est essentiel pour permettre de concilier les données provenant de bases de données différentes. Sans données pivots (siret ou rna), impossible de regrouper les données documentant les mêmes structures et de rechercher, pour une structure donnée, toutes les données disponibles dans data.inclusion.

rna

  • obigatoire : non
  • type : chaîne de caractères respectant le motif ^W\d{9}$
  • description : Ce champs 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 champs contient le nom de la structure.

commune

  • obligatoire : oui
  • type : chaîne de caractères
  • description : Ce champs 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 champs contient le code postale rattaché à l'adresse de la structure.

code_insee

  • obligatoire : oui
  • type : chaîne de caractères respectant le motif ^\d[A-B0-9_]\d{3}$
  • description : Ce champs 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 champs contient les éléments de l'adresse de la structure relatifs à la voie. Typiquement, <numero_voie> <indice_de_repetition> <type_voie> <libelle_voie>.
  • exemple : 12 BIS RUE DE LECLERCQ

complement_adresse

  • obligatoire : non
  • type : chaîne de caractères
  • description : Ce champs 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 champs 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 champs 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 champs indique le type de la structure : CCAS, ASSO, COMMUNE, etc. . Les valeurs possibles sont restreintes au vocabulaire décrivant les types de structures :
Les valeurs

telephone

  • obligatoire : non
  • type : chaîne de caractères
  • description : Ce champs 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 champs 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 champs 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 champs contient une courte description de la structure.

presentation_detail

  • obligatoire : non
  • type : chaîne de caractères
  • description : Ce champs 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 champs détaille l'acteur à l'origine de la donnée considérée.

structure_parente

  • obligatoire : non
  • type : chaîne de caractères
  • description : Ce champs est utilisé pour une antenne et contient l'identifiant de la structure parente, dans la base de la source.
  • exemple :
    • la source=toto a dans sa base de données :
      • une première structure (identifiée structure-mère-foo)
      • une antenne associée à cette première structure (identifiée structure-antenne-bar )
    • la représentation attendue pour ces 2 structures est la suivante:
1
[
2
{
3
"id": "structure-mère-foo",
4
"source": "toto",
5
...
6
},
7
{
8
"id": "structure-antenne-bar",
9
"source": "toto",
10
"structure_parente": "structure-mère-foo",
11
...
12
}
13
] "structure_parente":
Copied!

date_maj

  • obligatoire : oui
  • type : chaîne de caractères, au format ISO 8601.
  • description : Ce champs contient la date, et optionellement l'heure, à laquelle la donnée considérée a été mise à jour.
  • exemple:
    • 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 champs 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 champs 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/