schema.json

{
  "$schema": "https://frictionlessdata.io/schemas/table-schema.json",
  "name": "subventions",
  "title": "Subventions",
  "description": "Spécification du modèle de données relatif aux subventions attribuées par une collectivité",
  "countryCode": "FR",
  "homepage": "https://gitlab.com/opendatafrance/scdl/subventions",
  "path": "https://gitlab.com/opendatafrance/scdl/subventions/raw/v2.1.1/schema.json",
  "resources": [
    {
      "title": "Exemple de fichier subventions valide",
      "path": "https://gitlab.com/opendatafrance/scdl/subventions/raw/v2.1.1/exemples/exemple_valide.csv"
    },
    {
      "title": "Exemple de fichier subventions invalide (erreurs cellules)",
      "path": "https://gitlab.com/opendatafrance/scdl/subventions/raw/v2.1.1/exemples/exemple_invalide_erreurs_cellules.csv"
    },
    {
      "title": "Exemple de fichier subventions invalide (erreurs colonnes)",
      "path": "https://gitlab.com/opendatafrance/scdl/subventions/raw/v2.1.1/exemples/exemple_invalide_erreurs_colonnes.csv"
    }
  ],
  "sources": [
    {
      "title": "Décret n° 2017-779 du 5 mai 2017 relatif à l'accès sous forme électronique aux données essentielles des conventions de subvention​",
      "path": "https://www.legifrance.gouv.fr/jo_pdf.do?id=JORFTEXT000034600552"
    },
    {
      "title": "Arrêté du 17 novembre 2017 relatif aux conditions de mises à disposition des données essentielles des conventions de subvention​",
      "path": "https://www.legifrance.gouv.fr/jo_pdf.do?id=JORFTEXT000036040528"
    },
    {
      "title": "Format réglementaire pour la publication des données essentielles des conventions de subventions sur le dépôt Github de la mission Etalab​",
      "path": "https://github.com/etalab/format-subventions"
    }
  ],
  "created": "2018-04-27",
  "lastModified": "2023-09-28",
  "version": "2.1.1",
  "contributors": [
    {
      "title": "OpenDataFrance",
      "role": "author"
    },
    {
      "title": "Pierre Dittgen",
      "organisation": "Jailbreak",
      "email": "pierre.dittgen@jailbreak.paris",
      "role": "author"
    },
    {
      "title": "Quentin Loridant",
      "organisation": "multi",
      "email": "quentin.loridant@multi.coop",
      "role": "contributor"
    },
    {
      "title": "Johan Richer",
      "organisation": "multi",
      "email": "johan.richer@multi.coop",
      "role": "contributor"
    },
    {
      "title": "Amélie Rondot",
      "organisation": "multi",
      "email": "amelie.rondot@multi.coop",
      "role": "contributor"
    }
  ],
  "fields": [
    {
      "name": "nomAttribuant",
      "title": "Nom de l'attribuant",
      "description": "Nom officiel de la collectivité attribuant la subvention.",
      "type": "string",
      "example": "Région Bretagne",
      "constraints": {
        "required": true
      }
    },
    {
      "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",
      "example": "2017-03-103"
    },
    {
      "name": "nomBeneficiaire",
      "title": "Nom du bénéficiaire",
      "description": "Nom officiel ou raison sociale du bénéficiaire de la subvention.",
      "type": "string",
      "example": "Association Les Petits Débrouillards Bretagne",
      "constraints": {
        "required": true
      }
    },
    {
      "name": "idBeneficiaire",
      "title": "Identification SIRET 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. Dans le cadre précis d'une subvention en nature pour une association, il est possible de ne pas renseigner de SIRET. Il faudra alors renseigner le champ rnaBeneficiaire.",
      "type": "string",
      "example": "38047555800058"
    },
    {
      "name": "rnaBeneficiaire",
      "title": "Identification RNA du bénéficiaire",
      "description": "Numéro d'identification RNA [Répertoire National des Associations](https://associations.gouv.fr/le-rna-repertoire-national-des-associations.html) du bénéficiaire de la subvention, débutant par 'W' et composé de 9 chiffres",
      "type": "string",
      "example": "W380475558",
      "constraints": {
        "pattern": "^W\\d{9}$"
      }
    },
    {
      "name": "objet",
      "title": "Objet de la subvention",
      "description": "Description de l'objet de la subvention attribuée limitée à 256 caractères maximum.",
      "type": "string",
      "example": "Animations climat-énergie dans les lycées de la région",
      "constraints": {
        "required": true,
        "maxLength": 256
      }
    },
    {
      "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",
      "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.",
      "type": "string",
      "example": "échelonné",
      "constraints": {
        "required": true,
        "maxLength": 256
      }
    },
    {
      "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/2018-03-14",
      "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": {
        "maxLength": 5
      }
    },
    {
      "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
      }
    },
    {
      "name": "dispositifAide",
      "title": "Identifiant référençant le dispositif d'aide à l'origine de la subvention",
      "description": "Identifiant présent dans les données issues du [schéma des dispositifs d'aide](https://schema.data.gouv.fr/etalab/schema-dispositif-aide/). Il peut être utilisé à la place de l'identifiant `idRAE` qui ne concerne que les aides aux entreprises.",
      "type": "string",
      "example": "65d5b6c7-102c-4440-ac3b-768f708edc0a"
    }
  ],
  "custom_checks": [
    {
      "name": "french-siret-value",
      "params": {
        "column": "idAttribuant"
      }
    },
    {
      "name": "french-siret-value",
      "params": {
        "column": "idBeneficiaire"
      }
    },
    {
      "name": "one-of-required",
      "params": {
        "column1": "idBeneficiaire",
        "column2": "rnaBeneficiaire"
      }
    }
  ]
}