search mail facebook github rss rss twitter google + cross link

data.gouv.fr - documentation

Resultats de recherche pour ""

Publier un profil d’acheteur public

Obligation légale

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é.

Structure des données à publier

La structure des données à publier est définie par des schémas de données aux formats XML et JSON.

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.

Sources des données

Les données essentielles publiées sur data.gouv.fr proviennent de trois sources :

  1. 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) ;
  2. 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 ;
  3. 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.

Publier des données par l’intermédiaire de l’API de data.gouv.fr

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 :

  1. Structure plateforme : un jeu de données (dataset dans l’API) par plateforme de marchés (identifiée par son SIRET) ;
  2. Structure acheteur : un jeu de données par acheteur public (SIRET).

Jeu de données

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 :

curl --request POST --url https://data.gouv.fr/api/1/datasets/<dataset-id>/upload/ --header ’content-type: multipart/form-data’ --header ’x-api-key: <api-key>’ --form "file=<chemin du fichier à téléverser>"

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.

{
    "title": "Données essentielles des marchés publics - Conseil régional de Bretagne"
    …
    "extras": {
        "siret": "89764547841001"
}

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.

Ressource

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.

Téléchargement des données essentielles transmises par la DGFiP via le PES Marché

Via un système de fichier

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

Via l’API

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 :

  1. Récupérer la liste des ressources du jeu de données ;
  2. 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 :

curl https://data.gouv.fr/api/1/datasets/<dataset id ou slug>

Exemples d’URL :

https://data.gouv.fr/api/1/datasets/56cc6d6988ee385864fa79d0

https://data.gouv.fr/api/1/datasets/referentiel-de-donnees-marches-publics

Déclaration d’un profil d’acheteur

Qui doit déclarer

La déclaration du profil d’acheteur est effectuée par l’acheteur, ou toute personne habilitée par celui-ci, sur data.gouv.fr). L’objectif est d’impliquer les éditeurs de profils d’acheteurs afin de simplifier la déclaration des profils d’acheteurs initialement confiée aux acheteurs publics. Dans le cas où l’éditeur n’est pas en mesure d’assurer la déclaration, l’administrateur du profil d’acheteur ou l’acheteur peut le faire directement.

Comment déclarer

Format de fichier

Les éditeurs de profil d’acheteur sont invités à créer un fichier au format CSV contenant les informations suivantes :

  • le SIRET des acheteurs (colonne siretAcheteur) ;
  • l’adresse URL des profils d’acheteurs (colonne urlProfilAcheteur) ;
  • l’adresse URL du catalogue DCAT qui répértorie les données (colonne urlDCAT) ;
  • les coordonnées du ou des acheteurs concernés (colonne coordonnees).

Un modèle de fichier CSV est disponible sur data.gouv.fr.

Dépôt sur data.gouv.fr

Pour chaque fiche publiée il est essentiel de demander aux éditeurs de profils d’acheteurs d’associer le mot-clé (« tag ») suivant : « decp » (données essentielles de la commande publique) afin de permettre la centralisation de l’ensemble des contributions par Etalab.

La procédure complète pour déposer un ficher de déclaration de profil d’acheteur sur data.gouv.fr est la suivante :

  1. Créer un compte individuel en allant sur : https://www.data.gouv.fr/fr/register ;
  2. Une fois celui-ci validé via l’email de confirmation, créer une organisation correspondant à votre profil d’acheteur depuis : https://www.data.gouv.fr/fr/admin/organization/new/ ;
  3. Créer un jeu de données depuis https://www.data.gouv.fr/fr/admin/dataset/new/ en choisissant lors de l’étape « Choisissez qui publie » l’organisation créée au point précédent ;
  4. À l’étape « Décrivez votre jeu de données » renseigner un titre et éventuellement d’autres métadonnées (couverture spatiale, fréquence de mise à jour…) et renseigner le tag (mot clé) « decp » ;
  5. À l’étape « Ajouter vos premières ressources » de la création du jeu de données, déposer le fichier CSV.

✎ Editer cette page