Depuis le 1er octobre 2018, les acheteurs publics doivent publier les données d’attribution de leur marché, et ce, au plus tard deux mois après la notification du marché.
La publication devient obligatoire sur data.gouv.fr à partir du 1er janvier 2024.
La structure des données à publier jusqu’au 31 décembre 2023 est définie par des schémas de données aux formats XML et JSON dont vous trouverez la documentation sur ce lien.
La structure des données à publier à partir du 1er janvier 2024 est définie par des schémas de données aux formats XML et JSON dont vous trouverez la documentation sur ce lien.
Pour en savoir plus sur la publication des données, consultez le site de la direction des affaires juridiques, ainsi que l’article de blog consacré par data.gouv.fr à ce sujet.
Les données essentielles publiées sur data.gouv.fr proviennent de trois sources :
La DGFiP (Direction générale des finances publiques) propose aux acheteurs publics soumis à la comptabilité publics (par exemple les collectivités) de faire remonter ces données par l’intermédiaire d’Hélios (PES Marché), pour ensuite les transmettre à la mission Etalab qui les met à disposition du public (voir ci-dessous) ;
L’AIFE (Agence Informatique des Finances de l’État) publie sur data.gouv.fr les données essentielles provenant des places de marchés qui utilisent son service, et notamment de la plateforme de marchés de l’État, PLACE ;
Les données essentielles publiées sur les profils d’acheteurs (places de marché) peuvent être publiées sur data.gouv.fr par l’intermédiaire de l’API data.gouv.fr ou d’un fichier DCAT moissonnable.
La documentation de l’API est consultable en ligne, le détails des propriétés des jeux de données est visible sur cette page.
Afin de faciliter la localisation et donc l’utilisation des données essentielles, la publication de ces données doit respecter une certaine structure. Les deux structures proposées sont les suivantes :
Structure plateforme : un jeu de données (dataset dans l’API) par plateforme de marchés (identifiée par son SIRET) ;
Structure acheteur : un jeu de données par acheteur public (SIRET).
Pour des raisons d’archivage, le téléversement des fichiers de données sur data.gouv.fr est fortement préféré par rapport à un lien vers des serveurs externes.
Une fois que le jeu de données a été créé, vous pouvez y ajouter des ressources (API ressource).
Exemple de commande :
Nom (title dans l’API)
Le nom du jeu de données dépend de la structure choisie pour la publication :
jeu de données pour une plateforme : Données essentielles des marchés publics - {nom de la plateforme};
jeu de données pour un acheteur : Données essentielles des marchés publics - {nom de l’acheteur}.
Exemple :
Données essentielles des marchés publics - Conseil régional de Bretagne
Description (description)
La description attendue est un texte générique décrivant le contexte de publication des données essentielles, ainsi que quelques liens utiles. Le texte suivant remplit ces conditions et peut être étendu par le producteur, notamment avec un lien vers l’interface de visualisaton de données du profil d’acheteur concerné.
L’arrêté du 14 avril 2017, modifié par l’arrêté du 27 juillet 2018, impose à tous les acheteurs publics la publication des données essentielles de la commande publique. Ainsi, à partir du 1er octobre 2018, les acheteurs publics doivent publier les données d’attribution au plus tard deux mois après la notification du marché.
La structure des données est définie par des schémas XML et JSON qui appliquent les exigences des arrêtés.
Pour plus d’informations, vous pouvez consulter la page thématique sur le site de la direction des affaires juridiques.
Mot-clés (tags)
Renseignez les mot-clés suivants :
données-essentielles ;
commande-publique.
Extras (extras)
Si le jeu de données est spécifique à un acheteur et non à une plateforme, ajoutez une propriété siret à la propriété extras de l’objet Dataset, et indiquez le SIRET de l’acheteur.
Si le jeu de données est spécifique à une plateforme, ne renseignez pas la propriété extras.
Licence (license)
La licence à renseigner est la licence ouverte : fr-lo.
Organisation (organization)
Ajoutez votre identifiant d’organisation data.gouv.fr. L’utilisateur qui publie les données doit appartenir à cette organisation.
Fréquence (frequency)
Renseignez la fréquence de la publication des mises à jour.
Nom du fichier
Format : DECP-{SIRET}-{année}-{mois}-{jour}-{numéro de séquence}.{extension}
DECP pour « données essentielles de la commande publique » ;
siret : SIRET de la plateforme si structure plateforme, sinon SIRET de l’acheteur ;
année : année de la publication sur data.gouv.fr ;
mois : mois de la publication sur data.gouv.fr ;
jour : jour de la publication sur data.gouv.fr ;
numéro de séquence : numéro de séquence du fichier à incrémenter si plusieurs fichiers sont publiées dans la même journée. Le premier numéro est 01 ;
extension : xml ou json en fonction du format de publication. Il n’est pas obligatoire de publier les données à la fois en XML et en JSON, un seul des deux formats suffit.
Exemple :
DECP-89764547841001-2018-11-28-01.xml
URL (url)
L’URL n’est renseignée que si le fichier n’est pas téléversé sur data.gouv.fr et hébergé sur un serveur externe.
Nom (title dans l’API)
Identique au nom de fichier.
Type de fichier (filetype)
xml pour du XML ;
json pour du JSON.
Type MIME (mime)
application/xml pour du XML ;
application/json pour du JSON.
Type de ressource (type)
Renseignez main.
Les données essentielles transmises par la DGFiP peuvent être téléchargées depuis leur emplacement sur un système de fichiers hébergé par Etalab. Cette méthode est particulièrement adaptée pour récupérer les données essentielles d’un acheteur qui passe beaucoup de marchés.
Le format des URL est le suivant :
http://files.data.gouv.fr/decp/{siret}/{année}/{mois}/{jour}/DECP-{siret}-{année}-{mois}-{jour}-{seq}.xml
siret : SIRET de l’acheteur ;
année : année de la récéption par Etalab ;
mois : mois de la récéption par Etalab ;
jour : jour de la récéption par Etalab ;
seq : numéro de séquence du fichier à incrémenter si plusieurs fichiers sont réceptionnés dans la même journée. Le premier numéro est 01.
Exemple :
http://files.data.gouv.fr/decp/21440036800012/2019/01/18/DECP-21440036800012-2019-01-18-01.xml
Aujourd’hui, les données essentielles transmises par la DGFiP ne sont pas référencées sur data.gouv.fr sous forme de ressources. Elles sont hébergées sur un serveur de fichier annexe, https://files.data.gouv.fr. L’utilisation de l’API n’est donc pas pertinente, et nous vous conseillons par conséquent de consulter la section via un système de fichiers.
Pour récupérer les données via l’API, il vous faut :
Récupérer la liste des ressources du jeu de données ;
Télécharger les ressources dont vous avez besoin.
Récupérer la liste des ressources du jeu de données
Pour récupérer la liste des ressources d’un jeu de données, effectuez la requête suivante :
Exemples d’URL :
https://data.gouv.fr/api/1/datasets/56cc6d6988ee385864fa79d0
https://data.gouv.fr/api/1/datasets/referentiel-de-donnees-marches-publics