schema.json 9.31 KB
Newer Older
Loïc Haÿ's avatar
Loïc Haÿ committed
1
2
3
4
{
    "$schema": "https://frictionlessdata.io/schemas/table-schema.json",
    "title": "Subventions",
    "author": "OpenDataFrance",
Pierre Dittgen's avatar
Pierre Dittgen committed
5
    "contributor": "Pierre Dittgen",
Pierre Dittgen's avatar
Pierre Dittgen committed
6
    "version": "2.0.0",
Loïc Haÿ's avatar
Loïc Haÿ committed
7
    "created": "2018-04-27",
Pierre Dittgen's avatar
Pierre Dittgen committed
8
    "updated": "2019-01-24",
Loïc Haÿ's avatar
Loïc Haÿ committed
9
    "description": "Spécification du modèle de données relatif aux subventions attribuées par une collectivité",
Loïc Haÿ's avatar
Loïc Haÿ committed
10
    "homepage": "https://git.opendatafrance.net/scdl/subventions",
Pierre Dittgen's avatar
Pierre Dittgen committed
11
    "uri": "https://git.opendatafrance.net/scdl/subventions/raw/v2.0.0/schema.json",
Pierre Dittgen's avatar
Pierre Dittgen committed
12
13
14
    "examples": [
        {
            "name": "Subventions fictives invalides",
Pierre Dittgen's avatar
Pierre Dittgen committed
15
            "url": "https://git.opendatafrance.net/scdl/subventions/raw/v2.0.0/exemples/exemple_invalide.csv"
Pierre Dittgen's avatar
Pierre Dittgen committed
16
17
18
19
20
21
        },
        {
            "name": "Erreur de format (HTML au lieu de CSV)",
            "url": "https://git.opendatafrance.net/"
        }
    ],
Loïc Haÿ's avatar
Loïc Haÿ committed
22
23
24
25
    "fields": [
        {
            "name": "nomAttribuant",
            "title": "Nom de l'attribuant",
26
            "description": "Nom officiel de la collectivité attribuant la subvention.",
Loïc Haÿ's avatar
Loïc Haÿ committed
27
28
29
            "type": "string",
            "example": "Région Bretagne",
            "constraints": {
Pierre Dittgen's avatar
Pierre Dittgen committed
30
                "required": true
Loïc Haÿ's avatar
Loïc Haÿ committed
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
            }
        },
        {
            "name": "idAttribuant",
            "title": "Identification de l'attribuant",
            "description": "Identifiant du [Système d'Identification du Répertoire des Etablissements](https://fr.wikipedia.org/wiki/Syst%C3%A8me_d%27identification_du_r%C3%A9pertoire_des_%C3%A9tablissements) (SIRET) de la collectivité attribuant la subvention, composé de 9 chiffres SIREN + 5 chiffres NIC d’un seul tenant.",
            "type": "string",
            "example": "23350001600040",
            "constraints": {
                "required": true,
                "pattern": "^\\d{14}$"
            }
        },
        {
            "name": "dateConvention",
            "title": "Date de la convention de subvention",
            "description": "Date de la convention au format AAAA-MM-JJ suivant la norme internationale [ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601).",
            "type": "date",
            "example": "2017-06-27",
            "constraints": {
                "required": true
            }
        },
        {
            "name": "referenceDecision",
            "title": "Référence de la décision",
            "description": "Identifiant interne de l’acte matérialisant la décision d’attribution de la subvention. Sa composition dépend des pratiques propres à la collectivité.",
            "type": "string",
Pierre Dittgen's avatar
Pierre Dittgen committed
59
            "example": "2017-03-103"
Loïc Haÿ's avatar
Loïc Haÿ committed
60
61
62
63
        },
        {
            "name": "nomBeneficiaire",
            "title": "Nom du bénéficiaire",
64
            "description": "Nom officiel ou raison sociale du bénéficiaire de la subvention.",
Loïc Haÿ's avatar
Loïc Haÿ committed
65
66
67
            "type": "string",
            "example": "Association Les Petits Débrouillards Bretagne",
            "constraints": {
Pierre Dittgen's avatar
Pierre Dittgen committed
68
                "required": true
Loïc Haÿ's avatar
Loïc Haÿ committed
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
            }
        },
        {
            "name": "idBeneficiaire",
            "title": "Identification du bénéficiaire",
            "description": "Identifiant du [Système d'Identification du Répertoire des Etablissements](https://fr.wikipedia.org/wiki/Syst%C3%A8me_d%27identification_du_r%C3%A9pertoire_des_%C3%A9tablissements) (SIRET) du bénéficiaire de la subvention, composé de 9 chiffres SIREN + 5 chiffres NIC d’un seul tenant.",
            "type": "string",
            "example": "38047555800058",
            "constraints": {
                "required": true,
                "pattern": "^\\d{14}$"
            }
        },
        {
            "name": "objet",
            "title": "Objet de la subvention",
85
            "description": "Description de l'objet de la subvention attribuée limitée à 256 caractères maximum.",
Loïc Haÿ's avatar
Loïc Haÿ committed
86
87
88
89
            "type": "string",
            "example": "Animations climat-énergie dans les lycées de la région",
            "constraints": {
                "required": true,
Pierre Dittgen's avatar
Pierre Dittgen committed
90
                "maxLength": 256
Loïc Haÿ's avatar
Loïc Haÿ committed
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
            }
        },
        {
            "name": "montant",
            "title": "Montant total de la subvention",
            "description": "Montant total de la subvention attribuée, exprimé en euros et calculé avant répartition entre les bénéficiaires dans le cas de bénéficaires multiples. Le signe de séparation entre les parties entière et décimale du nombre est le point.",
            "type": "number",
            "example": "47800.20",
            "constraints": {
                "required": true
            }
        },
        {
            "name": "nature",
            "title": "Nature de la subvention",
            "description": "Plusieurs choix possibles en combinant les valeurs 'aide en numéraire' et/ou 'aide en nature'. Les valeurs autorisées sont 'aide en numéraire', 'aide en nature', 'aide en numéraire;aide en nature', 'aide en nature;aide en numéraire'. Quand la nature de la subvention est à la fois en numéraire et en nature, le signe de séparation des valeurs est le point-virgule.",
            "type": "string",
            "example": "aide en numéraire;aide en nature",
            "constraints": {
                "required": true,
                "enum": [
                    "aide en numéraire",
                    "aide en nature",
                    "aide en numéraire;aide en nature",
                    "aide en nature;aide en numéraire"
                ]
            }
        },
        {
            "name": "conditionsVersement",
            "title": "Conditions de versement de la subvention",
122
            "description": "Choix unique parmi plusieurs valeurs possibles : 'unique', 'échelonné' ou 'autre'. La valeur 'autre' correspond à une description libre des modalités de versement de la subvention dans la limite de 256 caractères maximum.",
Loïc Haÿ's avatar
Loïc Haÿ committed
123
            "type": "string",
Loïc Haÿ's avatar
Loïc Haÿ committed
124
            "example": "échelonné",
Loïc Haÿ's avatar
Loïc Haÿ committed
125
126
            "constraints": {
                "required": true,
Pierre Dittgen's avatar
Pierre Dittgen committed
127
                "maxLength": 256
Loïc Haÿ's avatar
Loïc Haÿ committed
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
            }
        },
        {
            "name": "datesPeriodeVersement",
            "title": "Date ou période de versement",
            "description": "Si le versement est unique et que la date précise est connue, alors il s'agit d'une date au format AAAA-MM-JJ suivant la norme internationale [ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601). Si le versement est échelonné (ou que la date précise de versement unique est inconnue), alors il s'agit d'une période exprimée au format AAAA-MM-JJ/AAAA-MM-JJ où le séparateur entre la première et la seconde date de l'intervalle est la barre oblique suivant la norme internationale [ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601).",
            "type": "string",
            "example": "'2017-03-14' pour une date ou '2017-03-14/2018-03-14' pour une période",
            "constraints": {
                "required": true,
                "pattern": "^[0-9]{4}\\-[0-9]{2}\\-[0-9]{2}(\\/[0-9]{4}\\-[0-9]{2}\\-[0-9]{2})?$"
            }
        },
        {
            "name": "idRAE",
            "title": "Identifiant RAE de l’aide au titre de laquelle la subvention est attribuée",
            "description": "Numéro unique de référencement dans le [Répertoire des Aides aux Entreprises](https://aides-entreprises.fr/). Ce champ ne concerne que les subventions attribuées au titre d’une aide référencée dans la [base de données du RAE](https://data.aides-entreprises.fr/documentation) gérée par l'Institut Supérieur des Métiers.",
            "type": "string",
            "example": "12345",
            "constraints": {
Pierre Dittgen's avatar
Pierre Dittgen committed
148
                "maxLength": 5
Loïc Haÿ's avatar
Loïc Haÿ committed
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
            }
        },
        {
            "name": "notificationUE",
            "title": "Aide d'Etat notifiée à la Commission Européenne",
            "description": "Subvention attribuée au titre d’une aide de minimis notifiée à la Commission Européenne en vertu des dispositions du règlement n° 1407/2013 du 18 décembre 2013. Seules les valeurs 'oui' ou 'non' sont autorisées.",
            "type": "boolean",
            "trueValues": [
                "oui"
            ],
            "falseValues": [
                "non"
            ],
            "example": "non",
            "constraints": {
                "required": true
            }
        },
        {
            "name": "pourcentageSubvention",
            "title": "Pourcentage du montant total de la subvention attribuée au bénéficiaire",
            "description": "Pourcentage exprimé sous la forme d'un nombre décimal. Dans le cas d’un bénéficiaire unique, le pourcentage est 100%, soit '1.00' en nombre décimal. Dans le cas de bénéficiaires multiples, le pourcentage du montant attribué au bénéficiaire correspond à la part qui lui est versée : par exemple 45%, soit '0.45' en nombre décimal. Le signe de séparation entre les parties entière et décimale du nombre est le point.",
            "type": "number",
            "example": "0.45",
            "constraints": {
                "required": true,
                "minimum": 0.01,
                "maximum": 1.00
            }
        }
    ],
    "custom_checks": [
        {
            "name": "french-siret-value",
            "params": {
                "column": "idAttribuant"
            }
        },
        {
            "name": "french-siret-value",
            "params": {
                "column": "idBeneficiaire"
            }
        }
    ]
Christophe Benz's avatar
Christophe Benz committed
194
}