Ce document, uniquement destiné aux éditeurs de profils d’acheteurs, décrit l'ensemble des API du Service DUME. Il est recommandé d’utiliser la table des matières pour consulter directement l'API ou le chapitre de son choix. Les API sont classées par domaine (Acheteur, Opérateur économique, Données, Référentiels, Métadonnées, Attestations ...). Des exemples d'appels sont fournis pour chaque API.
Table des matières (cliquer sur le chapitre de votre choix pour y accéder directement)
1 Introduction
Les API du Service Dume permettent aux éditeurs d'intégrer toutes les fonctionnalités du Service DUME aux profils d'acheteurs qu'ils administrent.
Les fonctionnalités proposées permettent aux acheteurs et opérateurs économiques de réaliser toutes les étapes de saisie, complétion et consultation des DUME. Chaque fonctionnalité est portée par une opération relevant d'une des API suivantes :
- API DUME A (pour les DUME Acheteurs)
- API DUME OE (pour les DUME Opérateurs Economiques)
- API Métadonnées (pour intervenir uniquement sur les métadonnées d'un DUME)
- API Données (pour récupérer des données issues de sources tierces comme API Entreprises)
- API Référentiel (pour interroger les référentiels du service DUME)
- API E-Certis (pour récupérer la transcription française de la réglementation européenne)
- API Attestations (pour récupérer les attestations via API Entreprises)
Cette page présente les opérations du Service DUME, classées par API.
Pour chaque opération sont listés les paramètres d’entrée, leur nature obligatoire (O) ou facultative (F) ainsi que les règles de gestion associées. Les paramètres sont présentés de la façon suivante :
- Paramètre (O/F) :
- Règle de gestion associée
- Détails sur la règle de gestion (le cas échéant).
Veuillez noter qu'il appartient à chaque éditeur de concevoir pour son profil d'acheteur l'ergonomie et les cinématiques d'utilisation du DUME, les opérations du Service DUME permettant simplement l'échange des données constitutives du DUME, sans préjuger de l'interface homme machine mise en œuvre par les différentes places de marché.
L'AIFE conseille l'implémentation, pour les API proposées, d'une opération permettant de consulter l'état de santé des applications. A cet effet chaque API DUME a été dotée d'une opération "healthCheck" permettant de consulter l'état de santé de l'application.
2 Fonctionnement des services exposés
2.1 Principes de fonctionnement et URI
Les services exposés sont organisés par domaine et par type d’opération.
L’utilisation d’URI globaux permet de distinguer à quel domaine s’adressent les opérations demandées. Pour rappel, une URI, de l'anglais Uniform Resource Identifier, soit "identifiant uniforme de ressource", est une courte chaîne de caractères identifiant une ressource sur un réseau (par exemple une ressource Web) physique ou abstraite, et dont la syntaxe respecte une norme d'Internet mise en place pour le World Wide Web.
2.1.1 Liste des URI des référentiels du Service DUME en mode PISTE :
Liste des URI par domaine :
- Données : https://api.piste.gouv.fr/dume/donnees
- DUME Acheteur : https://api.piste.gouv.fr/dume/dumeA
- DUME Opérateur Economique : https://api.piste.gouv.fr/dume/dumeOE
- Métadonnées : https://api.piste.gouv.fr/dume/metadonnees
- Référentiels : https://api.piste.gouv.fr/dume/referentiels
- Attestations : https://api.piste.gouv.fr/dume/attestations
2.1.2 La notion d’opération
Un paramètre d’entrée intitulé « opération » permet de déterminer la fonctionnalité qu’on souhaite activer (ex: rechercherDume, enregistrerDume, fusionnerDume, recupererModelDume,...). On note qu’une même opération peut être appliquée à un ou plusieurs domaine(s).
Ainsi, pour les cas d'utilisation similaires entre dume A et dume OE, on utilisera le même nom d'opération. La différentiation s’effectuera au niveau de l'URI sous laquelle l’opération est réalisée. Par exemple, si on effectue « opération=enregistrerDume » avec utilisation de l'URI "../dumes/dumeA", on réalisera l’enregistrement d'un DUME A.
Le tableau ci-dessous illustre quelques-uns des cas d’opérations réalisables sur une ou plusieurs URI, avec pour chaque opération les domaines sur lesquels elle est utilisée :
- rechercherDume : DUME A ou DUME OE
- enregistrerDume : DUME A ou DUME OE
- fusionnerDume : DUME OE uniquement
- recupererModelDume : DUME A ou DUME OE
Le paramètre d'entrée "opération" est toujours complété par d'autres paramètres (par exemple, l'identifiant du profil d'acheteur concerné) permettant d'exécuter la requête. Dans le cas où plusieurs paramètres identiques sont indiqués, alors seul le dernier est considéré par la solution.
Pour rappel, les API permettent l’utilisation du référentiel Service DUME. Leur implémentation demande également à l’éditeur un travail de conception afin de proposer des fonctionnalités plus simples et plus adaptées à l’utilisateur.
2.2 Format des appels (JSON)
Les appels de service sont structurés autour d’un flux JSON encapsulant le fichier XML qui contient le DUME proprement dit. Veuillez noter à ce propos que les seuls DUME dématérialisés reconnus par la réglementation sont des DUME de format XML, respectant un formalisme défini par l’Union Européenne. Tout autre format donné à un DUME (ex : PDF) ne vaut que copie, et ne saurait constituer un original à valeur probante.
Le flux JSON contient le nom de l’opération à exécuter, des paramètres d’entrée permettant d’exécuter l’appel ainsi que des données complémentaires au DUME appelées « métadonnées ». Celles-ci permettent soit d’assurer la bonne gestion technique du DUME soit d’apporter des informations complémentaires non présentes dans le fichier XML. Afin de connaître le contenu exact des métadonnées, il est nécessaire de consulter la liste des API.

Les réponses apportées aux appels passés à destination du service DUME obéissent aux mêmes règles. Cependant, les JSON émis par le service DUME retournent en guise de données des « paramètres de sortie ». Les paramètres d’entrée et de sortie propres à chaque appel vous seront présentés dans le descriptif de chaque API, plus loins dans le présent document.
Le formalisme du JSON est standardisé :
- une requête est encadrée par des crochets : {}
- chaque paramètre ou opération est défini par un titre entre guillemets : “ ”
- chaque donnée est encadrée par des guillemets : “ ”
- chaque ensemble titre et données est séparé du suivant par une virgule : ,
- le dernier champ de l’appel ne doit pas être suivi d’une virgule, cette dernière étant interprétée comme prélude au renseignement d’un nouveau champ,
- le XML est saisi encodé en base 64 dans le JSON.
2.3 Liste des codes erreurs fournis suite à un appel erroné
Les requêtes mal formulées donnent lieu à des messages d’erreur précisant la nature du problème identifié.
Vous trouverez ci-dessous les codes erreurs les plus fréquents, suivis d’un exemple :
- PARAM_MISSING : Paramètre présent dans la requête, mais pas attendu par l'API :
{
"type": "ERREUR",
"code": "PARAM_MISSING",
"message": "Le champs 'xxx' n'existe pas et ne doit pas être renseigné"
}
- PARAM_REQUIRED : Paramètre non présent dans la requête, mais attendu par l'API :
{
"type": "ERREUR",
"code": "PARAM_REQUIRED",
"message": "Le champs 'xxx' est manquant"
}
- PARAM_MAXLENGTH : La valeur du paramètre attendu a une longueur supérieure à la valeur attendue :
{
"type": "ERREUR",
"code": "PARAM_MAXLENGTH",
"message": "Le champs 'xxx' est mal formaté : longueur maximale 18"
}
- PARAM_FORMAT : La valeur du format du paramètre en entrée n'est pas conforme au format attendu :
{
"type": "ERREUR",
"code": "PARAM_FORMAT",
"message": "Le champs 'xxx' est mal formaté"
}
- PARAM_MINLENGTH : La valeur du paramètre attendu a une longueur inférieure à la valeur attendue
{
"type": "ERREUR",
"code": "PARAM_MINLENGTH",
"message": "Le champs 'xxx' est mal formaté : longueur minimale 1"
}
- InternalError : Erreur système
{
"type": "ERREUR",
"code": "InternalError",
"message": "Erreur Interne serveur"
}
2.4 Exemple de JSON commenté
La requête ci-dessous permet l’enregistrement d’un DUME acheteur au statut validé dans le référentiel Service DUME. Si le DUME A n’a jamais été enregistré dans le référentiel auparavant, il est inutile de renseigner un numéro d’ID dans le JSON d’entrée.

Une fois l’appel API effectué, le Service DUME stocke le XML du DUME enregistré dans la base Service DUME et retourne un numéro d’identification unique à l’acheteur.

3 Méthode de raccordement : PISTE
Pour accéder en tant que profil d’acheteur aux API et fonctionnalités du service DUME, il est nécessaire d’utiliser PISTE, la plateforme mutualisée des services API de l’État et de la sphère publique : https://piste.gouv.fr
Pour tout nouveau raccordement, il convient donc de se créer un compte sur PISTE. Les appels seront en effet centralisés par la plateforme PISTE.
Attention : à la création de votre compte, la plateforme PISTE vous demandera de mentionner une "organisation" (dans PISTE, une "organisation" est une maille organisationnelle donnant accès à un catalogue d'API spécifique). Par défaut, PISTE ne propose que l'organisation "universelle", qui ne référence pas les API du DUME. Vous devrez donc avant toute chose réclamer à PISTE, via le lien d'assistance "contact", le code de l'organisation donnant accès au DUME. Et c'est cette dernière que vous devrez référencer à la création de votre compte PISTE.
Une fois raccordée à PISTE, votre plateforme pourra envoyer des appels au Service DUME, de sorte à activer les diverses fonctionnalités du DUME et à échanger des données avec lui. Veuillez noter que la plateforme PISTE contient un espace "bac à sable" permettant de tester le bon fonctionnement des appels avant tout passage en production.
Pour plus de détails sur l’utilisation de PISTE, reportez-vous à la documentation mise à disposition directement sur PISTE.
Il appartient, en parallèle aux travaux de raccordement, à chaque profil d’acheteur de développer l’interface homme / machine qui permettra aux acheteurs et opérateurs économiques d’alimenter en données les différents appels de service et d’exploiter les données restituées par le service DUME.
4 Liste des opérations par API
Les opérations sont réparties sur 7 domaine API, à l’exception de l’opération healthCheck, qui est transverse, et permet de vérifier l’état du Service DUME avant de lancer un appel.
4.1 Opération « healthCheck » commune à toutes les API
L’opération healthCheck fonctionne avec toutes les URI correspondant aux diverses API DUME (utiliser l’URI de l’API dont on souhaite tester l’état).
Exemple de requête JSON
{
"operation": "healthCheck",
"plateforme": {
"typeIdPlateforme": "1",
"idPlateforme": "12345678901011",
"idTechniquePlateforme": "AAA001"
},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445"
}
Exemple de réponse JSON (out) si application UP
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "HEALTH_CHECK",
"message": "{\"status\":\"UP\"}"
}
] }
}
Exemple de réponse JSON (out) si application DOWN
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "HEALTH_CHECK",
"message": "{\"status\":\DOWN\"}"
}
] }
}
Exemple de réponse JSON (out) si le service healthCheck est inaccessible
{
"response": {
"messageList": [
{
"type": "ERREUR",
"code": "HEALTH_CHECK",
"message": "Pas de réponse du service HealthCheck"
}
] }
}
Paramètres de l’opération healthCheck
- Opération (O) :
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- typeIdPlateforme (O) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché.
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
4.2 API DUME acheteur
Les opérations effectuées sur les DUME A (DUME Acheteur) s’effectuent à l’URI suivante : https://api.piste.gouv.fr/dume/dumeA
- recupererModelDume : permet de récupérer un modèle de DUME A vierge.
- recupererDumeFormate : permet de récupérer un DUME A dans un format donné (ex : PDF, HTML, ...).
- enregistrerDume : permet d'enregistrer un DUME A dans le Service DUME et, le cas échéant, d'obtenir son identifiant.
- rechercherDumes : permet de lancer une recherche de DUMEs dans Service DUME.
- creerDumeSimple : permet de solliciter la création d’un DUME « simple », correspondant aux critères des procédures réalisées dans le cadre des marchés publics simplifiés.
- supprimer DUME : permet de supprimer un DUME
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/dumeA
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/dumeA
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple : curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/dumeA -d "{}"
Les accolades encadrent le JSON.
4.2.1 recupererModelDume
Description des paramètres d’entrée :
- operation (O) :
- constante = recupererModelDume
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
Paramètre de sortie : XML DUME A, UUENCODE en base 64
Exemple de JSON IN :
{
"operation" : "recupererModelDume",
"plateforme": { "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty" }
}
Exemple de JSON OUT :
{
"response": {
"model": "XML_DUME_ENCODE_EN_BASE_64"
}
}
4.2.2 recupererDumeFormate
Description des paramètres d’entrée :
- operation (O) :
- constante=recupererDumeFormate
- idDume (F : l'appel doit valoriser soit un XML soit un ID DUME) :
- ID DUME - 8 caractères alphanumériques aléatoires
- Dume (F : l'appel doit valoriser soit un XML soit un ID DUME) :
- Format (O) :
- Les valeurs pour « format de DUME » sont :
- « 1 » : DUME PDF
- « 2 » : DUME XML
- « 3 » : DUME HTML
- « 4 » : ZIP (PDF + XML)
- « 0 » : PAS DE DUME
- Un seul « format de DUME » peut être renseigné. Une Place sollicitant plusieurs formats devra réaliser plusieurs appels. Seul le format concerné est retourné.
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
Exemple de JSON IN :
{
"operation": "recupererDumeFormate",
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"dume": {"idDume":"amdhc8an"},
"format": "3"
}
Exemple de JSON OUT :
{
"response": {
"dumeA": "DUMEHTMLuuencode",
"idStatutDume": "01",
"identifiantA": "12345678901236",
"lots": [],
"accessible": true
}
}
4.2.3 enregistrerDume
Description des paramètres d’entrée :
- operation (O) :
- Constante =enregistrerDume
- idDume (F (ou O si modification d'un DUME déjà déposé)) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME uuencode (O) :
- Le XML est UUENCODE en base 64
- idStatutDume (O) :
- Code Libellé statut
- « 01 » : Brouillon
- « 02 » : Validé
- « 03 » : Remplacé
- Si la place souhaite remplacer un DUME, elle passe en paramètre d’entrée le XML du nouveau DUME avec l’Id du DUME à remplacer et le statut « 3 ». Le nouveau DUME est généré au statut « 2 »
- idTypeProcedure (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Code Libellé statut :
- « 01 » - procédure adaptée
- « 02 » - Appel d'offre ouvert
- « 03 » - Appel d'offre restreint
- « 04 » - procédure concurrentielle avec négociation
- « 05 » - procédure négociée avec mise en concurrence préalable
- « 06 »- marché négocié sans publicité ni mise en concurrence préalable
- « 07 » - dialogue compétitif
- « 08 »- Concours
- « 09 » - Autres
- idTypeMarche (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Code Libellé statut :
- « 01 » - Travaux
- « 02 » - Fourniture
- « 03 » - Service
- idNatureMarket (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Code Libellé statut :
- « 01 » - Marché (marché initial)
- « 02 » - Marché de partenariat
- « 03 » - Accord cadre
- « 04 » - Marché subséquent
- « 05 » - Marché réservé
- « 06 » - autre
- idConsultation (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- ID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME
- libelleConsultation (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Libellé de la consultation
- refFonctionnelleConsultation (F (O si demande statut « validé » ou si ID) :
- Même référence que dans le DUME
- accessible (O) :
- Témoin permettant de définir qu’un DUME Acheteur est accessible car il a été publié (le marché a fait l’objet d’une publication au JO)
- DLRO (F) :
- format YYYY-MM-DDTHH :MM :SS
- identifiantA (O) :
- Alphanumérique (14 caractères) : identifiant de l'acheteur
- Lots concernés : id (F (O si demande statut « validé » ou si ID consultation renseigné))
- Lots concernés : libelle (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (F) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité publique qui fait la demande sur la place de marché. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
Dans le cas où un DUME a déjà été déposé pour la même consultation / même lot pour un identifiant acheteur, l'ID DUME et le fichier XML sont obligatoires.
Lorsqu’un DUME est enregistré au statut validé, les paramètres d’entrée suivants sont obligatoires :
- ID Type de procédure
- ID Type de marché
- ID Nature de marché
- ID Consultation
- Libellé consultation
- refFonctionnelleConsultation
- Lots concernés
Lors de l'enregistrement d'un DUME au statut validé, les données liées au marché ne peuvent être modifiées que via l'API métadonnées.
Exemple de JSON IN :
{
"operation": "enregistrerDume",
"dumeA": {"xmlDume": "DUMEAuuencode"},
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"idStatutDume": "01",
"idTypeProcedure": "01",
"idTypeMarche": "01",
"idNatureMarche": "01",
"idConsultation": "12345632165412",
"libelleConsultation": "bonne consultation",
"refFonctionnelleConsultation": "consultation_Dume___A_ii12dfs9",
"DLRO": "2018-04-23T18:25:43.511Z",
"identifiantA": "65412398745621",
"typeIdA": "1",
"lots": [
{
"numeroLot":"1",
"libelle":"super lot"
}
],
"accessible": true
}
Exemple de JSON OUT :
{
"response": {
"idDume": "fufhjhhi",
"statutDume": "01"
}
}
4.2.4 rechercherDumes
Description des paramètres d’entrée :
- operation (O) :
- Constante =rechercherDumes
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité publique qui fait la demande sur la place de marché.
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- Consultation : idConsultation (F)
- Consultation : dateCreationDebut (F)
- Consultation : dateCreationFin (F)
- Consultation : dateModificationDebut (F)
- Consultation : dateModificationFin (F)
- Consultation : idNumeroRecherche (F)
- Id acheteur (F) :
- Alphanumérique (14 caractères)
- PLACE DE MARCHE : idPlateforme (F)
- PLACE DE MARCHE : idTechniquePlateforme (F)
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- idStatutDume (F)
- dateCreationDebut (F)
- dateCreationFin (F)
- dateModificationDebut (F)
- dateModificationFin (F)
Exemple de JSON IN :
{
"operation":"rechercherDumes",
"plateforme":{ "typeIdPlateforme" : "1" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"idDemandeur":"123",
"rsDemandeur":"123",
"consultations":[{"idConsultation":"12345678901236","dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2015-07-05T19:04:17.413Z", "dateModificationDebut":"2018-07-05T19:04:17.413Z", "dateModificationFin":"2018-07-05T19:04:17.413Z", "typeMarket":"01", "natureMarket":"01", "typeProcedure":"01", "refFonctionnelle":"123456789012345678901234567809"}] "
}
Exemple de JSON OUT :
"response": {
"responseRecherche": {
"1": {
"dumeAcheteur": {
"Id": "esfpekdj",
"Date de création": "2018-05-18 10:29:53",
"Date de modification": "2018-05-18 10:29:53",
"Statut": "02",
"Accessibilité": true
},
"consultation": {
"Id": "4718547779",
"referenceFonctionnelle": "consultalalala69",
"idTypeProcedure": "01",
"idNatureMarket": "01",
"idTypeMarket": "01"
},
"lot": {
"numeroLot": "1"
},
"acheteur": {
"identifiant": "65412398745621"
}
}
}
}
Exemple exhaustif : Ce modèle d'appel est exhaustif et illustre la structure d'ensemble de l'appel : pour le rendre opérationnel, retirer les sections qu'on ne souhaite pas utiliser dans sa recherche et compléter les critères à utiliser en indiquant les informations à rechercher entre les guillemets.
{
"operation":"rechercherDumes",
"plateforme":{ "typeIdPlateforme" : "" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"idDemandeur":"123",
"rsDemandeur":"123",
"consultations":[{"idConsultation":"","dateCreationDebut":"","dateCreationFin":"", "dateModificationDebut":"", "dateModificationFin":"", "typeMarket":"", "natureMarket":"", "typeProcedure":"", "refFonctionnelle":""}],
"lots":[{"idNumeroRecherche":"", "dateCreationDebut":"","dateCreationFin":"", "dateModificationDebut":"", "dateModificationFin":""}],
"identifiantsA":[{"identifiantA":""}],
"plateformeRecherche":{ "typeIdPlateforme" : "" , "idPlateforme": "", "idTechniquePlateforme":""},
"dumesAcheteurs":[{"idDume":"", "idStatutDume":"","dateCreationDebut":"","dateCreationFin":"", "dateModificationDebut":"", "dateModificationFin":""}]
}
4.2.5 creerDumeSimple
Cette fonctionnalité permet à une place de marché de solliciter la création d’un DUME « simple », correspondant aux critères des procédures réalisées dans le cadre des marchés publics simplifiés.
Contrairement aux autres XML, ceux réalisés dans le cadre du DUME simple sont produits par le SN DUME sur la base des paramètres d’entrée du JSON et non par les places de marché.
Description des paramètres d’entrée :
- operation (O) :
- Constante =creerDumeSimple
- Type ID plateforme demandeuse (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- ID Plateforme demandeuse (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- Id technique plateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- IdDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité publique qui fait la demande sur la place de marché.
- RsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- ID Type de procédure (F (O si demande statut « validé »)) :
- Code Libellé statut :
- « 01 » - procédure adaptée
- « 02 » - Appel d'offre ouvert
- « 03 » - Appel d'offre restreint
- « 04 » - procédure concurrentielle avec négociation
- « 05 » - procédure négociée avec mise en concurrence préalable
- « 06 »- marché négocié sans publicité ni mise en concurrence préalable
- « 07 » - dialogue compétitif
- « 08 »- Concours
- « 09 » - Autres
- ID Type de marché (F (O si demande statut « validé »)) :
- Code Libellé statut :
- « 01 » - Travaux
- « 02 » - Fourniture
- « 03 » - Service
- ID Nature de marché (F (O si demande statut « validé »)) :
- Code Libellé statut :
- « 01 » - Marché (marché initial)
- « 02 » - Marché de partenariat
- « 03 » - Accord cadre
- « 04 » - Marché subséquent
- « 05 » - Marché réservé
- « 06 » - autre
- ID Consultation (F (O si demande statut « validé ») :
- ID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME
- Libellé consultation (F (O si demande statut « validé ») :
- Libellé de la consultation
- Référence fonctionnelle consultation (F (O si demande statut « validé ») :
- Même référence que dans le DUME
- Témoin_accessible (F) :
- Témoin permettant de définir qu'un DUME Acheteur est accessible car il a été publié (le marché a fait l'objet d'une publication au JO)
- DLRO (O) :
- Lots concernés (F)
- SIRET Acheteur (O) :
- Alphanumérique (14 caractères)
- Nom Acheteur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- Description consultation (F)
- N° JOUE (F)
Exemple de JSON IN :
{
"operation": "creerDumeSimple",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"idTypeProcedure": "01",
"idTypeMarche": "01",
"idNatureMarche": "01",
"idConsultation": "YYYsdws0181234",
"libelleConsultation": "bonne consultation",
"refFonctionnelleConsultation": "consultation_Dume___A_ii12dfs9",
"descriptionConsultation":"bbbbbbbbbbbbbbb",
"DLRO": "2018-04-23T18:25:43.511Z",
"numeroJO_UE":"12345678901234567",
"identifiantA": "65412398745XXX",
"nomIdentifiantA": "65412398745621",
"accessible": true
}
Exemple de JSON OUT :
{
"response": {
"idDume": "sghqqkiz",
"statutDume": "02"
}
}
4.2.6 supprimerDume
La place de marché souhaite supprimer un DUME (uniquement des DUME Brouillon).
Description des paramètres d’entrée :
- operation (O) :
- Constante =supprimerDumeA
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni à la plateforme lors du raccordement à PISTE.
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- SIRET ou identifiant fonctionnel de l'entite de la place qui fait la demande
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
4.3 API DUME Opérateur économique
L'URL pour l'API DUME OE est la suivante : https://api.piste.gouv.fr/dume/dumeOE
- recupererModelDume : permet au profil d'acheteurs de récupérer un DUME totalement vide.
- recupererDumeFormate : permet de récupérer un DUME au format PDF, HTML ou XML ainsi que les métadonnées associées, sur la base de l'identifiant ou bien du XML de ce DUME.
- CreerdumeOEavecSiretOE : permet de récupérer un XML DUME OE à partir d'un identifiant, complété par les informations publiques ou privées de l'opérateur économique.
- fusionnerDumeavecDonneesEntreprise : permet de récupérer un DUME OE issu d'un DUME Acheteur dont elle a le numéro ou le XML, complété des données publiques ou privées de l'OE.
- fusionnerDume : La place de marché souhaite récupérer la fusion d'un DUME OE et d'un DUME Acheteur dont elle a les numéros ou les XML
- enregistrerDume : permet au profil d'acheteur d'enregistrer un DUME OE pour lequel il dispose d'un identifiant ou d'un XML.
- telechargerDumeAvecPJ :La place de marché souhaite récupérer le DUME avec les PJ éventuellement ajoutées par l’opérateur économique ou encore avec les attestations récupérées via les API entreprise
- rechercherDumes : La place de marché souhaite récupérer les ID des DUMES répondant à un certain nombre de critères (ID_consultation, SIRET OE, …)
- AjouterPJ : La place de marché souhaite ajouter une PJ à un DUME.
- supprimer un DUME - DUME OE : permet de supprimer un DUME
- Analyser réponses : permet ainsi à un acheteur de savoir facilement si les répondants respectent les critères d’exclusion, de sélection et de restriction sollicités par l’acheteur dans son DUME.
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/dumeOE
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/dumeOE
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple : curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/dumeOE -d "{}"
Les accolades encadrent le JSON.
4.3.1 recupererModelDume
La méthode recupererModelDume de l’API DUME OE permet au profil d'acheteurs de récupérer un DUME totalement vide.
Afin de limiter au maximum la saisie d'informations par l'utilisateur, vous pouvez également vous référer à l'opération FusionnerDumeAvecDonneesEntreprise qui permet de récupérer un DUME pré-rempli des données publiques de l'opérateur économique.
Description des paramètres d'entrée et de sortie de l'API :
- operation (O) :
- constante = recupererModelDume
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
Paramètres de sortie : modèle de DUME XML
Exemple de JSON IN :
{
"operation" : "recupererModelDume",
"plateforme": { "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty" }
}
Exemple de JSON OUT :
{ "response": { "model": "XML_DUME_ENCODE_EN_BASE_64" } }
4.3.2 RecupererDumeFormate
La méthode RécupérerDumeFormate permet de récupérer un DUME au format PDF, HTML ou XML ainsi que les métadonnées associées, sur la base de l'identifiant ou bien du XML de ce DUME.
Description des paramètres d’entrée :
- operation (O) :
- Constante = recupererDumeFormate
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires attribués par le Service DUME
- Format (O) :
- Les valeurs pour « format de DUME » sont :
- « 1 » : DUME PDF
- « 2 » : DUME XML
- « 3 » : DUME HTML
- « 4 » : ZIP (PDF + XML)
- « 0 » : PAS DE DUME
- Un seul « format de DUME » peut être renseigné. Une Place sollicitant plusieurs formats devra réaliser plusieurs appels.
- Seul le format concerné est retourné.
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) - 100 caractères
Paramètres de sortie : DUME au format demandé, et métadonnées associées
Exemple de JSON IN :
{
"dume":{"idDume":"xxxxxxx"},
"operation": "recupererDumeFormate",
"format": "2",
"plateforme": { "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty" },
"idDemandeur": "12345678901239",
"rsDemandeur": "aife"
}
Exemple de JSON OUT :
"response": {
"dumeOE": "DUMEOEuuencode",
"typeIdOE": "1",
"idStatutDume": "01",
"idTypeProcedure": "01",
"idTypeMarche": "01",
"idNatureMarche": "01",
"idConsultation": "4578524851447",
"libelleConsultation": "libconsult",
"refFonctionnelleConsultation": "consultation_DumeA_ii12dfs9",
"DLRO": 1524507943511,
"Lots": [
{
"lotId": 80,
"libelle": "super lot"
}
],
"idFonctionnelOE": "32165412345685",
"typeReponse": "1",
"siretNP1": 37
}
}
4.3.3 CreerdumeOEavecSiretOE
La place de marché souhaite récupérer un xml DUME OE à partir d'un identifiant, complété par les informations publiques ou privées de l'opérateur économique.
Description des paramètres d’entrée :
- operation (O) :
- Constante = recupererDumeOEAvecDonnesEntreprise
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- SiretOE (O) :
- Alphanumérique (1 à 18 caractères caractères)
- typeDonnees (O) :
- 1 : données OE publiées
- 2 : données OE publiées et non publiées
- Si ce paramètre n’est pas renseigné, i est réputé « 1 ».
Exemple de JSON IN :
{
"operation":"FusionnerDumeAvecDonneesEntreprise",
"idDemandeur":"12315548545754",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
"siretOE":"38103128500491",
"typeDonnees":"1"
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "CRIT_OE_ABSENT_7e7db838-eeac-46d9-ab39-42927486f22d",
"message": "Le critère n’a pas encore fait l’objet de réponse par l’opérateur économique"
}
],
"dumeOE": {
"xmlDume": xmlUUENCODE
} }}
4.3.4 FusionnerDumeAvecDonnesEntreprise
La méthode FusionnerDumeAvecDonnesEntreprise permet de répondre à deux besoins distincts :
- Le profil d'acheteurs souhaite récupérer le template d'un DUME OE issu d'un DUME A dont elle a le numéro d'identifiant ou le XML.
- Le profil d'acheteurs souhaite récupérer le template d'un DUME OE issu d'un DUME A dont elle a le numéro d'identifiant ou le XML, complété des données publiques ou privées de l'opérateur économique.
NB : Dans les deux cas, il importe évidemment de communiquer l'identifiant ou le XML du DUME A en amont de la fusion avec le DUME OE. Les paramètres Type ID OE et ID OE sont facultatifs pour l'utilisation de cette API.
Description des paramètres d’entrée :
- operation (O) :
- Constante = FusionnerDumeAvecDonneesEntreprise
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- En paramètre d’entrée, l’ID du DUME A doit être renseigné ou le XML du DUME A doit être communiqué. Il n’est pas possible de renseigner l’ID et le XML du DUME A.
- En paramètre d’entrée, l’ID du DUME OE doit être renseigné ou le XML du DUME OE doit être communiqué. Il n’est pas possible de renseigner l’ID et le XML du DUME OE.
- DUME A uuencode (F) :
- siretOE (O) :
- Alphanumérique (1 à 18 caractères caractères)
- typeDonnees (O) :
- 1 : données OE publiées
- 2 : données OE publiées et non publiées
- Si ce paramètre n’est pas renseigné, il est réputé « 1 ».
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
Paramètres de sortie : XML du DUME OE uuencodé en base 64 et métadonnées associées.
Exemple de JSON IN avec DUME A :
{
"operation":"FusionnerDumeAvecDonneesEntreprise",
"idDemandeur":"12345678901011",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
"siretOE":"38103128500491",
"typeDonnees":"1",
"dumeA": {
"idDume" : "1lm88fe6"
}
}
Exemple de JSON IN sans DUME A :
{
"operation":"FusionnerDumeAvecDonneesEntreprise",
"idDemandeur":"12315548545754",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
"siretOE":"38103128500491",
"typeDonnees":"1",
"dumeA": {
"idDume" : "1lm88fe6"
}
}
Exemple de JSON IN avec SIRET OE :
{
"operation":"FusionnerDumeAvecDonneesEntreprise",
"idDemandeur":"12315548545754",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
"siretOE":"38103128500491",
"typeDonnees":"1"
}
Exemple de JSON IN sans SIRET OE :
{
"operation":"FusionnerDumeAvecDonneesEntreprise",
"idDemandeur":"12315548545754",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "DUME-A_REMPLACE",
"message": "LE DUME 2 remplace le DUME 1lm88fe6 que vous avez sollicité pour fusion, conformément au souhait de l’acheteur "
},
{
"type": "INFO",
"code": "DLRO_DEPASSE",
"message": "Le DUME 2 a une DLRO dépassée. Veuillez contacter l’acheteur"
}
],
"dumeOE": {
"xmlDume": "xmluuencode",
}
}
}
4.3.5 fusionnerDumes
La place de marché souhaite récupérer la fusion d'un DUME OE et d'un DUME Acheteur dont elle a les numéros ou les XML.
Description des paramètres d’entrée :
- operation (O) : (
- Constante =FusionnerDumes
- idDume (O) :
- En paramètre d’entrée, l’ID du DUME A doit être renseigné ou le XML du DUME A doit être communiqué. Il n’est pas possible de renseigner l’ID et le XML du DUME A
- En paramètre d’entrée, l’ID du DUME OE doit être renseigné ou le XML du DUME OE doit être communiqué. Il n’est pas possible de renseigner l’ID et le XML du DUME OE
- ID DUME - 8 caractères alphanumériques aléatoires
- Si le DUME A est à un statut autre que « publié » ou « remplacé », un code et un message d’erreur sont transmis à la place de marché
- DumeA uuencode (O) :
- En paramètre d’entrée, l’ID du DUME A doit être renseigné ou le XML du DUME A doit être communiqué.
- Il n’est pas possible de renseigner en même temps l’ID et le XML du DUME A
- idDume (O) :
- Pour l'idDume du DUME OE : En paramètre d’entrée, l’ID du DUME OE doit être renseigné ou le XML du DUME OE doit être communiqué.
- Il n’est pas possible de renseigner l’ID et le XML du DUME OE
- DumeOE uuencode (O) :
- Le XML est UUENCODE en base 64
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- N° BOAMP (F)
Exemple de JSON IN :
{
"operation":"FusionnerDumes",
"idDemandeur":"12345678901011",
"rsDemandeur":"AIFE",
"plateforme":{
"typeIdPlateforme":"1",
"idPlateforme":"12345678901011",
"idTechniquePlateforme":"AAA001"
},
"dumeA": {
"idDume" : "1lm88fe6"
},
"dumeOE":{
"idDume": "rvzwhdob"
}
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "DUME-A_REMPLACE",
"message": "LE DUME 2 remplace le DUME 1lm88fe6 que vous avez sollicité pour fusion, conformément au souhait de l’acheteur "
},
{
"type": "INFO",
"code": "DLRO_DEPASSE",
"message": "Le DUME 2 a une DLRO dépassée. Veuillez contacter l’acheteur"
}
],
"dumeOE": {
"xmlDume": "xml uuencode"},
}
}
}
4.3.6 EnregistrerDUME
La méthode EnregistrerDume permet au profil d'acheteur d'enregistrer un DUME OE pour lequel il dispose d'un identifiant ou d'un XML.
Description des paramètres d’entrée :
- operation (O) :
- Constante = enregistrerDume
- idDume (F (O si modification d'un DUME déjà déposé)) :
- ID DUME - 8 caractères alphanumériques aléatoires attribués par le Service Dume
- Dume (O) :
- typeIdPlateforme (O) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- idGroupement (F) :
- Alphanumérique (30 caractères maximum)
- idStatutDume (O) :
- Code Libellé statut
- « 01 » : Brouillon
- « 02 » : Validé
- « 03 » : Remplacé
- Si la place souhaite remplacer un DUME, elle passe en paramètre d’entrée le XML du nouveau DUME avec l’Id du DUME à remplacer et le statut « 3 ». Le nouveau DUME est généré au statut « 2 ».
- idTypeProcedure (F (O si demande statut « validé » ou si ID consultation renseigné)) :
-
- Code Libellé statut :
- « 01 » - procédure adaptée
- « 02 » - Appel d'offre ouvert
- « 03 » - Appel d'offre restreint
- « 04 » - procédure concurrentielle avec négociation
- « 05 » - procédure négociée avec mise en concurrence préalable
- « 06 »- marché négocié sans publicité ni mise en concurrence préalable
- « 07 » - dialogue compétitif
- « 08 »- Concours
- « 09 » - Autres
- idTypeMarche (F (O si demande statut « validé » ou si ID consultation renseigné) :
- Code Libellé statut :
- « 01 » - Travaux
- « 02 » - Fourniture
- « 03 » - Service
- idNatureMarket (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Code Libellé statut :
- « 01 » - Marché (marché initial)
- « 02 » - Marché de partenariat
- « 03 » - Accord cadre
- « 04 » - Marché subséquent
- « 05 » - Marché réservé
- « 06 » - autre
- idConsultation (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- ID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME - 14 caractères alphanum
- libelleConsultation (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Libellé de la consultation - 100 caractères alphanum
- refFonctionnelleConsultation (F (O si demande statut « validé » ou si ID consultation renseigné)) :
- Même référence que dans le DUME
- DLRO (F) :
- format YYYY-MM-DDTHH :MM :SS
- idAcheteur (F) :
- SIRET acheteur : Alphanumérique (14 caractères)
- typeIdOE (F) :
- Les valeurs sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- ID Fonctionnel OE (O) :
- IDFonctionnelOE correspond à l’identifiant de l’opérateur économique au nom duquel le DUME est déposé.
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- type_réponse (F) :
- Qualité du répondant:
- « 1 » : Mandataire
- « 2 » : cotraitant
- « 3 » : sous-traitant
- « 4 » : titulaire
- siret_NP1 (F) :
- SIRET du Titulaire du marché
- LotsConcernes : id (F) :
- Tableau reprenant les Ids des lots et les libellés associés.
- LotsConcernes : libelle (F) :
- Tableau reprenant les Ids des lots et les libellés associés.
Paramètres de sortie : identifiant du DUME OE enregistré et métadonnées associées.
Lorsqu’un DUME est enregistré au statut validé, les paramètres d’entrée suivants sont obligatoires :
- ID Type de procédure
- ID Type de marché
- ID Nature de marché
- ID Consultation
- Libellé consultation
- refFonctionnelleConsultation
- Lots concernés
Lors de l'enregistrement d'un DUME au statut validé, les données liées au marché ne peuvent être modifiées que via l'API métadonnées.
Dans le cas où un DUME a déjà été déposé pour la même consultation / même lot pour un identifiant opérateur économique, l'ID DUME et le fichier XML sont obligatoires.
Exemple de JSON IN :
{
"operation": "enregistrerDume",
"dumeOE": {"xmlDume": "XMLdumeOEuuencode"},
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"idStatutDume": "01",
"idTypeProcedure": "01",
"idTypeMarche": "01",
"idNatureMarche": "01",
"idConsultation": "12345632165412",
"libelleConsultation": "bonne consultation",
"refFonctionnelleConsultation": "consultation_DumeA_ii12dfs9",
"DLRO": "2018-04-23T18:25:43.511Z",
"identifiantA": "65412398745621",
"typeIdOE": "1",
"identifiantOE": "32165412345685",
"typeReponse": "1",
"lots": [
{
"numeroLot":"1",
"libelle":"super lot"
}
],
"siretNP1": "12365412398745",
"accessible": true
}
Exemple de JSON OUT :
{
"response": {
"idDume": "psppzpcp",
"statutDume": "01"
}
}
4.3.7 telechargerDumeAvecPJ
La place de marché souhaite récupérer un ou plusieurs DUME opérateur économique afin de permettre son analyse par l'acheteur. Cette opération permet par ailleurs de récupérer au besoin les attestations obtenues depuis les API entreprise, ainsi que les éventuelles PJ ajoutées par l'opérateur économique.
Description des paramètres d’entrée :
- operation (O) : constante = telechargerDumeAvecPJ
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- Format (O) :
- / Format : "zip" uniquement. Les dossiers "zip" sont imbriqués.
- Par exemple, si un sous-traitant valorise un mandataire lors de l’enregistrement, son DUME sera présent dans le "zip" au sein d’un dossier contenant le DUME de son mandataire
- pjUnitaire (F) :
- Les valeurs possibles pour pjAttestationpjUnitaire sont les suivants :
- attestationSociale
- attestationFiscale
- OPQIBI
- QUALIBAT
- CNETP
- Autre
- AGEFIPH
- PROBTP
- MSA
- KBIS
- / PJ unitaire indique le souhait d'obtenir une PJ en particulier, alors que plusieurs sont disponibles, que ce paramètre soit renseigné à true, false ou non renseigné. S'il n'est pas renseigné, ce paramètre sera par défaut renseigné à true.
- listeAttestation (F) :
- / Si ce paramètre est valorisé, il permet d'identifier la liste des attestations disponibles pour un DUME, et ce, sans avoir à consulter l'archive. La liste de ces attestations disponibles se trouvera directement au sein du message d'information.
- / Si ce paramètre est valorisé, le SI DUME retournera par un message d'information la liste des attestations disponibles par OE en complément de l'archive.
- Si ce champ est valorisé, la valeur contenu dans le paramètre « piecesjointes » (true / false) n’est pas prise en compte et seule la pj sollicitée est retournée pour chaque OE.
Paramètres de sortie : identifiant du DUME OE enregistré et métadonnées associées.
Exemple de JSON IN :
{
"operation":"telechargerDumeAvecPJ",
"plateforme": {
"typeIdPlateforme":"1",
"idPlateforme":"33592022900036",
"idTechniquePlateforme":"azerty"
},
"idDemandeur":"12345678901012",
"rsDemandeur":"Testeur",
"idConsultation": "12345632165412",
"piecesJointes": "true",
"tousStatus": "true",
"listeAttestation": "true",
"format":"zip"
}
Exemple de JSON OUT :
"response": {
"messageList": [
{
"type": "INFO",
"code": "MSG_US29_002",
"message": "Les attestations disponibles pour le dume n° udfknydy de l' operateur economique 42165412345685 sont les suivantes: []"
},
{
"type": "INFO",
"code": "MSG_US29_002",
"message": "Les attestations disponibles pour le dume n° yj8zobdx de l' operateur economique 32165412345685 sont les suivantes: []"
}
],
"archive":
"ZIPUUENCODE" }
}
4.3.8 rechercherDumes
La place de marché souhaite récupérer les ID des DUMES répondant à un certain nombre de critères (ID_consultation, SIRET OE, …)
Description des paramètres d’entrée :
- operation (O) : Constante =rechercherDumes
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'opérateur économique qui fait la demande sur la place de marché. L’identifiant demandeur peut être identique à l’identifiant fonctionnel de l’opérateur économique. - 1 à 18 caractères
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- idConsultation (F) :
- ID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME
- Si le paramètre id lot est servi le paramètre consultation devient obligatoire, si ce n’est pas le cas le message suivant est retourné dans la réponse au service : « Le serveur ne peut traiter la demande : le paramètre lot est présent, le paramètre Id consultation devient nécessaire ».
- dateCreationDebut (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- typeMarket (F) :
- Code Libellé statut :
- « 01 » - Travaux
- « 02 » - Fourniture
- « 03 » - Service
- NatureMarket (F) :
- Code Libellé statut :
- « 01 » - Marché (marché initial)
- « 02 » - Marché de partenariat
- « 03 » - Accord cadre
- typeProcedure (F) :
- Code Libellé statut :
- « 01 » - procédure adaptée
- « 02 » - Appel d'offre ouvert
- « 03 » - Appel d'offre restreint
- « 04 » - procédure concurrentielle avec négociation
- « 05 » - procédure négociée avec mise en concurrence préalable
- « 06 »- marché négocié sans publicité ni mise en concurrence préalable
- « 07 » - dialogue compétitif
- « 08 »- Concours
- « 09 » - Autres
- refFonctionnelle (F) :
- Même référence que dans le DUME
- Lot :
- "lots":[{"idNumeroRecherche":"", ETC }],
- idLot (F) :
- Si le paramètre id lot est servi le paramètre consultation devient obligatoire, si ce n’est pas le cas le message suivant est retourné dans la réponse au service :
- - Le serveur ne peut traiter la demande : le paramètre lot est présent, le paramètre Id consultation devient nécessaire.
- dateCreationDebut (F) :
- 1/ Date de début
- Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/ Date de début Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- idNumeroRecherche (F)
- Acheteur
- identifiantA (F) :
- id Acheteur Alphanumérique (14 caractères)
- dateCreationDebut (F) :
- 1/ Date de début
- Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F)
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/ Date de début
- Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F)
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- Identifiant fonctionnel (F)
- Place de marché
- idPlateforme (F)
- idTechniquePlateforme (F)
- DumeA : "dumesAcheteurs":[{"idDume":"", ETC }]
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- idStatutDume (F) :
- Code Libellé statut
- « 1 » : Brouillon
- « 2 » : Validé
- « 3 » : Remplacé
- Si la place souhaite remplacer un DUME, elle passe en paramètre d’entrée le XML du nouveau DUME avec l’Id du DUME à remplacer et le statut « 3 ». Le nouveau DUME est généré au statut « 2 »
- dateCreationDebut (F) :
- 1/ Date de début. Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/ Date de début. Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- DUME OE :
- idDume (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- idStatutDume (F) :
- Code Libellé statut
- « 1 » : Brouillon
- « 2 » : Validé
- « 3 » : Remplacé
- Si la place souhaite remplacer un DUME, elle passe en paramètre d’entrée le XML du nouveau DUME avec l’Id du DUME à remplacer et le statut « 3 ». Le nouveau DUME est généré au statut « 2 »
- dateCreationDebut (F) :
- 1/ Date de début
- Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/Date de début. Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- ID opérateur économique (F) :
- L’ID Opérateur Economique correspond à l’identifiant de l’opérateur économique au nom duquel le DUME est déposé.
Si « type identifiant » est « 1 » : 14 caractères
-
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : 9 caractèresSi «
- Si type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- dateCreationDebut (F) :
- 1/ Date de début. Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ RG18 DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateCreationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
- dateModificationDebut (F) :
- 1/ Date de début. Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ DLRO Date format YYYY-MM-DDTHH :MM :SS
- dateModificationFin (F) :
- 1/ Si une date de début est positionnée dans les critères de recherche sans date de fin les occurrences remontées sont celles postérieures à cette date incluse (> ou =)
- 2/ format YYYY-MM-DDTHH :MM :SS
ATTENTION : La solution renvoie les DUME dont l’accessibilité est positionnée sur true mais aussi sur false. Il appartient ainsi aux places de marché de ne pas mettre en visibilité des OE les DUME A qui dont l’accessibilité est false.
Exemple de JSON IN :
{
"operation":"rechercherDumes",
"plateforme":{ "typeIdPlateforme" : "1" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"idDemandeur":"123",
"rsDemandeur":"123",
"consultations":[{"idConsultation":"12345632165499"}]
}
Exemple de JSON IN exhaustif :
{
"operation":"rechercherDumes",
"plateforme":{ "typeIdPlateforme" : "1" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"idDemandeur":"123",
"rsDemandeur":"123",
"consultations":[{"idConsultation":"12345678901236","dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2015-07-05T19:04:17.413Z", "dateModificationDebut":"2018-07-05T19:04:17.413Z", "dateModificationFin":"2018-07-05T19:04:17.413Z", "typeMarket":"01", "natureMarket":"01", "typeProcedure":"01", "refFonctionnelle":"123456789012345678901234567809"}],
"lots":[{"idNumeroRecherche":"1234567890123456789", "dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2015-07-05T19:04:17.413Z", "dateModificationDebut":"2018-07-05T19:04:17.413Z", "dateModificationFin":"2018-07-05T19:04:17.413Z"}],
"identifiantsA":[{"identifiantA":"33592022900036", "dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2015-07-05T19:04:17.413Z", "dateModificationDebut":"2018-07-05T19:04:17.413Z", "dateModificationFin":"2018-07-05T19:04:17.413Z"}],
"plateformeRecherche":{ "typeIdPlateforme" : "1" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"dumesAcheteurs":[{"idDume":"ii12dfs9", "idStatutDume":"02","dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2018-07-05T19:04:17.413Z", "dateModificationDebut":"2017-02-05T19:04:17.413Z", "dateModificationFin":"2019-07-05T19:04:17.413Z"}],
"dumesOE":[{"idDume":"ii12dfs9", "idStatutDume":"02","dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2018-07-05T19:04:17.413Z", "dateModificationDebut":"2017-02-05T19:04:17.413Z", "dateModificationFin":"2019-07-05T19:04:17.413Z"}],
"identifiantsOE":[{"identifiantOE":"11111111169696"},"dateCreationDebut":"2015-07-05T19:04:17.413Z","dateCreationFin":"2015-07-05T19:04:17.413Z", "dateModificationDebut":"2018-07-05T19:04:17.413Z", "dateModificationFin":"2018-07-05T19:04:17.413Z" ]
}
Exemple de JSON OUT :
"response": {
"responsesRecherche": {
"1": {
"consultation": {
"Id": "14741504",
"referenceFonctionnelle": "consultalalala",
"idTypeProcedure": "01",
"idNatureMarket": "01",
"idTypeMarket": "01"
},
"lot": {
"numeroLot": "0"
},
"Opérateur Economique": {
"identifiant": "125478"
},
"Dume OE": {
"dumeOEId": "sbvbrdnj",
"statutDume": "VALIDE",
"accessible": true,
"Date de création": "2018-05-18 11:54:43",
"Date de modification": "2018-05-18 11:54:43"
}
}
4.3.9 Ajouter PJ
La place de marché souhaite ajouter une PJ à un DUME.
Description des paramètres d’entrée :
- operation (O) :
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- SIRET ou identifiant fonctionnel de l'entite de la place qui fait la demande - Alphanumérique (1 à 18 caractères)
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- idDume (O) :
- ID DUME - 8 caractères alphanumériques aléatoires
- Pièce Jointe (O) :
- Les PJ sont communiquées encodées base 64. Seul le format PDF est accepté. Un contrôle antivirus est réalisé par la solution.
- A noter qu’il n’est pas possible d’ajouter un PJ à un DUME dont la DLRO est dépassée
- Nom Pièce jointe (O) :
Exemple de JSON IN :
{
"operation": "ajouterPJ",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"idDume":"9qkrrqaq",
"pieceJointeData":"",
"namePieceJoint":"saddemHK"
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": " MSG_INFO_PJ",
"message": " La pièce jointe a été ajoutée au DUME n° vyrisuox"
}
],
"idPieceJointe": "PJ_nomPieceJointeTst_vyrisuox_2018-08-10-101449"
}
}
4.3.10 Supprimer un DUME
La place de marché souhaite supprimer (faire évoluer au statut 04) un DUME afin, par exemple, de ressoumettre un DUME pour la même consultation / lot / opérateur économique et sans avoir à utiliser le statut « remplacé » de l’opération « enregistrer DUME ».
Description des paramètres d’entrée :
- operation (O) :
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- SIRET ou identifiant fonctionnel de l'entite de la place qui fait la demande - Alphanumérique (1 à 18 caractères)
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- idDume (O) :
- ID DUME - 8 caractères alphanumériques aléatoires
Paramètres de sortie :
- idDume :
- ID DUME - 8 caractères alphanumériques aléatoires
- Statut DUME
- Code Libellé statut
- « 1 » : Brouillon
- « 2 » : Validé
- « 3 » : Remplacé
- « 4 » : supprimé
- Si la place souhaite remplacer un DUME, elle passe en paramètre d’entrée le XML du nouveau DUME avec l’Id du DUME à remplacer et le statut « 3 ». Le nouveau DUME est généré au statut « 2 »
Exemple de JSON IN :
{
"operation": "supprimerDUME",
"plateforme": {
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty" },
"rsDemandeur": "AIFE",
"idDemandeur": "12345678901234",
"dumeOE": { "idDume" : "rvvvambv"}
}
Exemple de JSON OUT :
{
"response": {
"idDume": "rvvvambv",
"statutDume": "04"
}
}
4.3.11 Analyser des réponses
Cette opération du domaine opérateur économique est à destination des acheteurs des places de marché. Elle permet d’analyser plusieurs DUME OE au regard des attendus d’un DUME acheteur via une restitution JSON uniquement ou JSON accompagné d’un PDF ou d’un HTML. L’objectif pour l’acheteur est d’identifier rapidement si les opérateurs économiques répondent à ses attendus de la partie III (critères d’exclusion) et de la partie IV (critères de sélection). Jusqu’à 9 DUME OE peuvent être comparés.
Elle permet ainsi à un acheteur de savoir facilement si les répondants respectent les critères d’exclusion, de sélection et de restriction sollicités par l’acheteur dans son DUME.
Illustration de sa mise en œuvre dans l’utilitaire DUME de Chorus Pro :

Critères d’exclusion : Si un opérateur a signalé être concerné par un ou plusieurs critères d’exclusion, alors une croix rouge est valorisé pour cet opérateur économique.
Critères de sélection : Chaque critère de sélection sollicité par l’acheteur est détaillé. Si l’opérateur économique ne respecte pas le critère de sélection, alors une croix rouge apparait.
Lorsque l’opérateur économique respecte un critère de sélection qui fait appel à des données chiffrées, alors ces dernières sont valorisées. Exemple : chiffre d’affaire, nombre de cadre, ratios.
Critères de restriction : Il est possible pour un opérateur économique d’indiquer qu’il respecte les critères de restriction, selon certains types de procédure. Il est à noter que l’acheteur n’a pas nécessairement sollicité ce critère puisque le DUME A ne lui permet pas d’indiquer s’il les sollicite.

Paramètres d’entrée :
- operation (O) :
- Constante = analyserReponses
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- SIRET ou identifiant fonctionnel de l'entite de la place qui fait la demande - Alphanumérique (1 à 18 caractères)
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale) – max 100 caractères
- Format (O) :
- Les valeurs pour « format de DUME / format de donnée essentielle » sont :
- « 1 » : métadonnées + PDF
- « 2 » : métadonnées + XML
- « 3 » : métadonnées + HTML
- « 4 » : métadonnées + XML + PDF
- « 0 » : métadonnées
- Sinon, message ": "Le champ format ne correspond pas aux valeurs prédéfinies [0, 1, 2, 3,4]"
- DUME A (O) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 1 (O)
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 2 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 3 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 4 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 5 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 6 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 7 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 8 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
- DUME OE 9 (F) :
- ID DUME - 8 caractères alphanumériques aléatoires
Paramètres de sortie : JSON out avec les critères de selection demandés par l’acheteur ou message d’erreur
Exemple de JSON IN :
{
"operation": "analyserReponses",
"plateforme": {
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty" },
"rsDemandeur": "AIFE",
"idDemandeur": "12345678901234",
"format":"1",
"dumeA": { "idDume" : "gsvwcuft"},
"dumesOE": [
{"occurence":"1","idDume": "sphksp7s" },
{"occurence":"2","idDume": "ibvaakhh" }
] }
Exemple de JSON OUT :
{
"response": {
"consultation": {
"idDumeA": "gsvwcuft",
"consultId": "86880437347648",
"refFonctionnelle": "Dume A - US115",
"lots": "0"
},
"OEs": [
{
"occurence": "1",
"identifiant": "49897635600036",
"idDumeOE": "sphksp7s",
"qualite": "MANDATAIRE"
},
{
"occurence": "2",
"identifiant": "71543672094778",
"idDumeOE": "ibvaakhh",
"qualite": "MANDATAIRE"
}
],
"Partie3": {
"CandidatsFautifs": [
{
"occurence": "1",
"libelle": "OK"
},
{
"occurence": "2",
"libelle": "OK"
}
] },
"Partie4": {
"candidats": [
{
"occurence": "1",
"values": [
"499efc97-2ac1-4af2-9e84-323c2ca67747#Chiffre d’affaires annuel général#false",
"1f49b3f0-d50f-43f6-8b30-4bafab108b9b#Effectifs moyens annuels#false"
] },
{
"occurence": "2",
"values": [
"499efc97-2ac1-4af2-9e84-323c2ca67747#Chiffre d’affaires annuel général#false",
"1f49b3f0-d50f-43f6-8b30-4bafab108b9b#Effectifs moyens annuels#false"
] }
] },
"Partie5": {
"candidats": [
{
"occurence": "1"
},
{
"occurence": "2"
}
] },
"analyserReponsesData": "DOCUMENT UUENCODE"
}
4.4 API métadonnées
L’URI pour l’API Métadonnées DUME est la suivante : https://api.piste.gouv.fr/dume/metadonnees
- mettreAJourDume : permet de mettre à jour les métadonnées associées à un DUME Acheteur ou Opérateur Economique.
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/metadonnees
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/metadonnees
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple : curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/metadonnees -d "{}"
Les accolades encadrent le JSON.
4.4.1 mettreAJourDume
La place de marché souhaite enregistrer les métadonnées associées à un DUME Acheteur ou Opérateur Economique.
Description des paramètres d’entrée :
- operation (O) :
- Constante = mettreAJourDume
- idDume (O) :
- ID Fonctionnel du DUME - 6 caractères alphanumériques aléatoires
- Les trois paramètres ID DUME, ID Donnée et Valeur Donnée sont liés. Si l’un des trois paramètres est valorisé les deux autres deviennent obligatoires. Si ce n’est pas le cas le message suivant apparait :
- Le serveur ne peut traiter la demande : Pour effectuer la mise à jour les paramètres Id DUME, Id Donnée et Valeur Donnée sont nécessaires. Les paramètres suivant sont manquants ou non valorisés :
- [Liste des paramètres manquants dans la requête : Nom du paramètre]
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- ID type de procédure (F)
- ID Type de marché (F)
- ID Consultation (F)
- Libellé consultation (F)
- Référence fonctionnelle consultation (F)
- DLRO (F)
- Lots concernés (F)
- SIRET A (F)
- Type ID OE (F)
- ID Fonctionnel OE (F) :
- L’ID Opérateur Economique correspond à l’identifiant de l’opérateur économique au nom duquel le DUME est déposé.
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : 9 caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- Type_réponse (F)
- SIRET_N1 (F)
Exemple de JSON IN :
{
"operation": "mettreAJourDume",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"dume": {
"idDume":"7jq89hoy"
},
"numeroLot": "1",
"colonneAModifier": "libelleConsultation",
"valeurAModifier": "test"
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "MISE-A-JOUR",
"message": "Mise à jour de la donnée (venividivici) effectuée.Remplacement de la valeur (venividivici) par la valeur test."
}
]
}
}
4.5 API Données
L’URI pour l’API attestations est la suivante : https://api.piste.gouv.fr/dume/donnees
- recupererDonneesOE : permet de récupérer les données publiques ou privées d'un OE.
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/donnees
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/donnees
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple de header : curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/donnees -d "{}"
Les accolades encadrent le JSON.
4.5.1 recupererDonneesOE
L'appelant souhaite récupérer les données publiques ou privées d'un OE.
Description des paramètres d’entrée :
- operation (O) :
- Constante =recupererDonneesOE
- SiretOE (O) :
- Alphanumérique (14 caractères)
- Si l’identifiant fonctionnel sollicité par l’API tiers est un SIREN, les 5 derniers chiffres du SIRET OE communiqué par la place de marché sont tronqués
- typeDonnees (O) :
- 1 : données OE publiées
- 2 : données OE publiées et non publiées
- SI ce paramètre n’est pas renseigné, i est réputé « 1 ».
- typeIdPlateforme O) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- Service (O) :
- Les API pouvant être consommées sont les suivantes :
- Entreprises
- Etablissements
- Exercices
- AssociationsRNA
- Extraits_RCS_Infogreffe
- (ou 08)
Exemple de JSON IN :
{
"operation": "recupererDonneesOE",
"siretId": "13001977100018",
"service": "Entreprises",
"typeDonnees": "1",
"plateforme": {
"typeIdPlateforme": "1",
"idPlateforme": "12345678901011",
"idTechniquePlateforme": "AAA001"
}
}
Exemple de JSON OUT :
{
"entreprise": {
"code_effectif_entreprise": "NN",
"numero_tva_intracommunautaire": "FR15130019771",
"siren": "130019771",
"date_radiation": null,
"tranche_effectif_salarie_entreprise": {
"de": null,
"a": null,
"code": "NN",
"date_reference": null,
"intitule": "Non employeur"
},
"nom": null,
"forme_juridique": "Service central d'un ministère ",
"date_creation": 1396389600,
"forme_juridique_code": "7120",
"enseigne": "AIFE",
"categorie_entreprise": "PME",
"mandataires_sociaux": [],
"siret_siege_social": "13001977100018",
"capital_social": null,
"nom_commercial": "",
"procedure_collective": false,
"raison_sociale": "AGENCE POUR L'INFORMATIQUE FINANCIERE DE L'ETAT",
"prenom": null
},
"etablissement_siege": {
"pays_implantation": {
"code": null,
"value": null
},
"siret": "13001977100018",
"date_mise_a_jour": 1461621600,
"naf": "8411Z",
"enseigne": null,
"diffusable_commercialement": true,
"siege_social": true,
"libelle_naf": "Administration publique générale",
"tranche_effectif_salarie_etablissement": {
"de": null,
"a": null,
"code": "NN",
"date_reference": null,
"intitule": "Non employeur"
},
"date_creation_etablissement": 1396389600,
"commune_implantation": {
"code": "93051",
"value": "NOISY LE GRAND"
},
"adresse": {
"code_postal": "93160",
"localite": "NOISY LE GRAND",
"l1": "AGENCE INFORMATIQUE FINANCIERE ETAT",
"l2": "MINEFI",
"l3": "IMMEUBLE",
"l4": "10 RUE DU CENTRE",
"l5": null,
"numero_voie": "10",
"l6": "93160 NOISY LE GRAND",
"l7": "FRANCE",
"type_voie": "RUE",
"nom_voie": "DU CENTRE",
"complement_adresse": null,
"cedex": null,
"code_insee_localite": "93051"
},
"region_implantation": {
"code": "11",
"value": "Île-de-France"
}
},
"gateway_error": false
}
4.6 API Référentiels
L’URI pour l’API Référentiel est la suivante : https://api.piste.gouv.fr/dume/referentiels
- Listerréférentiel : permet au profil d’acheteur de connaitre la liste des référentiels présents dans le service DUME.
- listerValeursDeReferentiel : permet au profil d’acheteur de connaitre la liste des valeurs d'un des référentiels présent dans le service DUME.
- RecupererLibelles : permet au profil d’acheteur de récupérer les libellés du formulaire DUME
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/referentiels
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/referentiels
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple de header : curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/referentiels -d "{}"
Les accolades encadrent le JSON
4.6.1 Listerreférentiel
Cette fonctionnalité permet au profil d’acheteur de connaitre la liste des référentiels présents dans le service DUME. Cette fonctionnalité est donc à privilégier lorsque seules quelques données sont à modifier, par exemple les données d’identification du marché.
Description des paramètres d’entrée :
- operation (O) :
- Constante = listerReferentiels
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
Exemple de JSON IN :
{
"operation": "listerReferentiels",
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"}
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "INFO_REF_MSG",
"message": "Liste des référentiel"
}
],
"listeReferentiels": [
{
"nom": "REF_TYPE_PROCEDURE",
"commentaire": "REFERENTIEL TYPE PROCEDURE"
},
{
"nom": "REF_TYPE_MARKET",
"commentaire": "REFERENTIEL TYPE MARKET"
},
{
"nom": "REF_TYPE_QUALITY",
"commentaire": "REFERENTIEL TYPE QUALITY"
},
{
"nom": "REF_TYPE_ID",
"commentaire": "REFERENTIEL TYPE ID"
},
{
"nom": "REF_NATURE_MARKET",
"commentaire": "REFERENTIEL NATURE MARKET"
}
] }
}
4.6.2 listerValeursReferentiels
Cette fonctionnalité permet au profil d’acheteur de connaitre la liste des valeurs d'un des référentiels présents dans le service DUME.
Description des paramètres d’entrée :
- operation (O) :
- Constante = listerValeursReferentiels
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- Nom Référentiel (O)
Exemple de JSON IN :
{
"operation": "listerValeursReferentiels",
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"nomReferentiel" : "REF_NATURE_MARKET"
}
Exemple de JSON OUT :
{
"response": {
"messageList": [
{
"type": "INFO",
"code": "AFFICHAGE-VALEURS-REFERENTIEL",
"message": "Liste des valeurs référentiel"
}
],
"listeRefNatureMarket": [
{
"code": "01",
"libelle": "Marché (marché initial)"
},
{
"code": "02",
"libelle": "Marché de partenariat"
},
{
"code": "03",
"libelle": "Accord cadre"
},
{
"code": "04",
"libelle": "Marché subséquent"
},
{
"code": "05",
"libelle": "Marché réservé"
},
{
"code": "06",
"libelle": "Autre"
}
] }
}
4.6.3 recupererLibelles
Description des paramètres d’entrée :
- operation (O) :
- Constante = recupererLibelles
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- UUID (F) :
- 1/ Le système réalise un contrôle de cohérence des champs : UUID, Code et Contexte.
- 2/ Dans le cas où aucune infobulle n’est connue pour cet UUID, la solution retourne « null »
- 3/ Dans le cas où aucune règle de gestion n’est connue pour cet UUID, la solution retourne « null »
- Code (F)
- Contexte (F) :
- 1/ Le système réalise un contrôle de cohérence des champs : UUID,Code et Contexte.
- 2/ Les valeurs possibles pour le contexte sont les suivantes : A ou OE
- 3/ Dans le cas où pour un même UUID, la base de donnée des criterions dispose de deux libellés (un pour acheteur et un pour OE),Si la place de marché ne précise pas le contexte alors deux tableaux sont retournés pour par ce même UUIDcode
- Langue (O) :
- Les valeurs possibles pour le paramètre « langue » sont les suivantes (issues du code ISO 639-1)
- « en » (anglais)
- « fr » (français)
- Si le paramètre « langue » n’est pas valorisé dans les paramètres d’entrée, il est réputé « fr »
Exemple de JSON IN :
{
"operation": "recupererLibelles",
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"uuid" : "6ee55a59-6adb-4c3a-b89f-e62a7ad7be7f",
"contexte" : "A",
"langue": "fr"
}
Exemple de JSON OUT :
{
"response": {
"listeLibelles": [
{
"Uuid": "6ee55a59-6adb-4c3a-b89f-e62a7ad7be7f",
"Code": "CRITERION.SELECTION.SUITABILITY.PROFESSIONAL_REGISTER_ENROLMENT",
"Langue": "FR",
"Contexte": "A",
"Libellé": "Inscription sur un registre professionnel pertinent",
"Infobulle": "Pour la France, il s'agit du registre du commerce et des société et du répertoire des métiers. Pour les autres pays européens, se référer à l'annexe XI de l'a Directive 2014/24/UE",
"Regle de gestion": ""
}
] }
}
4.7 API e-CERTIS
L’URI pour l’API eCertis est la suivante : https://api.piste.gouv.fr/dume/ecertis
- recupererEvidence : Permet de récupérer les déclinaisons nationales et les évidences associées aux critères européens d’exclusion et de sélection
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/ecertis
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/ecertis
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple de header :
curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/ecertis -d "{}"
Les accolades encadrent le JSON
4.7.1 recupererEvidence
eCertis est une compilation des pièces justificatives les plus demandées par les pouvoirs adjudicateurs pour une adjudication européenne dans tout le marché interne.
Cette banque de données s’avère utile pour :
- Une entreprise :
- étrangère, qui souhaite répondre à une consultation dans un pays tiers, et qui s’interroge sur les pièces justificatives de son pays nécessaires selon sa situation
- française, qui n’a pas l’habitude de répondre aux marchés publics français
- L’acheteur qui veut savoir quelles pièces justificatives il peut demander ou quels certificats ou attestations émis dans un autre État membre il peut accepter, lorsqu’une entreprise étrangère répond à son appel d’offres
Chaque Etat membre de l’Union Européenne a pour tâche de décliner de manière nationale son critère, si possible dans sa langue nationale et en anglais. Chaque Etat doit aussi indiquer quels sont les éléments de preuve, appelés évidences, associés à ce critèrion.
Description des paramètres d’entrée :
- operation (O) :
- Type ID plateforme demandeuse (F) :
- Code valeur référentiel (1)
- ID Plateforme demandeuse (O) :
- Alphanumérique (31 à 18 caractères)
- Id technique plateforme (O) :
- Alphanumérique (6 caractères)
- RS demandeur (O) :
- ID demandeur (O) :
- Criterion (O) :
- Langue (O) :
- National entity (O) :
Paramètres de sortie :
- Type erreur (F) :
- Code retour (O) :
- Libellé message (F) :
Contexte (obligatoire si retour KO de ecertis)
- Nationalentity (O) :
- Langue (O) :
- UUID du criterion (O) :
Criterion - facultatif
- UUID du criterion (O) :
- Texte (O) :
Evidence(s) – facultatif
- UUID de l’évidence national (O) :
- Texte (O) :
Exemple de JSON IN :
{
"operation": "recupererEvidence",
"plateforme": {
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"criterion": "63adb07d-db1b-4ef0-a14e-a99785cf8cf6",
"langue": "fr",
"nationalEntities": "fr"
}
Exemple de JSON OUT :
{
"criterion": {
"uuid": "dd61d770-28d5-4ab2-8abd-c11a84dfedac",
"texte": "Interdictions de soumissionner facultatives : Influence sur la décision de l'acheteur par le truchement d'informations",
"Titre de la LegislationReference": "Ordonnance du 23 juillet 2015 relative aux marchés publics",
"Article de LegislationReference": "Art. 48 I. 2)",
"Description du SubCriterion": "Les personnes qui ont entrepris d'influer indûment sur le processus décisionnel de l'acheteur ou d'obtenir des informations confidentielles susceptibles de leur donner un avantage indu lors de la procédure de passation du marché public, ou ont fourni des informations trompeuses susceptibles d'avoir une influence déterminante sur les décisions d'exclusion, de sélection ou d'attribution\n"
},
"evidences": [
{
"uuid": "cbfbef8e-cc4d-4be2-940f-8e1f818e78a6",
"texte": "Preuve par tous moyens"
}
] },
{
"criterion": {
"uuid": "54fc9793-e42d-4fbf-a652-887b8359e2f7",
"texte": "Exclusion des contrats administratifs",
"Titre de la LegislationReference": "Code du travail",
"Article de LegislationReference": "Art. L. 8272-4",
"Description du SubCriterion": "Décision administrative portant mesure d'exclusion des contrats administratifs\n"
},
"evidences": [
{
"uuid": "886362e8-622d-4bb6-bb84-afbee846ba0c",
"texte": "Document unique de marché européen (DUME)",
"Publié par ": "Direction des Affaires Juridiques des ministères économique et financier"
},
{
"uuid": "10530588-503c-43e1-9613-4ddcb575c8cc",
"texte": "Marché public simplifié (MPS)",
"Publié par ": "SGMAP"
},
{
"uuid": "efdb28c5-880d-4ff2-8449-b21d4b45ce06",
"texte": "Formulaire de Déclaration du Candidat (DC1, DC2)"
},
{
"uuid": "28262c46-0feb-4390-957e-008f0ba9247d",
"texte": "Formulaire de déclaration du candidat fourni par l'acheteur"
}
] },
{
"criterion": {
"uuid": "b5a4ca4c-cc13-4d8c-9a61-ffc806db892b",
"texte": "Exclusion des marchés publics",
"Titre de la LegislationReference": "Code pénal",
"Article de LegislationReference": "Art. 131-39",
"Description du SubCriterion": "Condamnation à une peine d'exclusion des marchés publics\n"
},
"evidences": [
{
"uuid": "886362e8-622d-4bb6-bb84-afbee846ba0c",
"texte": "Document unique de marché européen (DUME)",
"Publié par ": "Direction des Affaires Juridiques des ministères économique et financier"
},
{
"uuid": "10530588-503c-43e1-9613-4ddcb575c8cc",
"texte": "Marché public simplifié (MPS)",
"Publié par ": "SGMAP"
},
{
"uuid": "efdb28c5-880d-4ff2-8449-b21d4b45ce06",
"texte": "Formulaire de Déclaration du Candidat (DC1, DC2)"
},
{
"uuid": "28262c46-0feb-4390-957e-008f0ba9247d",
"texte": "Formulaire de déclaration du candidat fourni par l'acheteur"
}
] }
] }
}
4.8 API Attestations
L'URL pour l'API Attestations est la suivante : https://api.piste.gouv.fr/dume/attestations
- récupererAttestations : Le profil d'acheteur souhaite récupérer les attestations connues de la solution DUME pour un opérateur économique.
- demanderMiseAjour : Le profil d'acheteur souhaite mettre à jour la liste des attestations connues de la solution DUME.
4.8.1 récupererAttestations
Cette opération du domaine opérateur économique est à destination des acheteurs des places de marché. Elle permet de récupérer les attestations d'un opérateur économique disposant d'un SIRET et qui sont déjà stockées en base de données.
Cette opération permet de récupérer l'ensemble des types d'attestation disponible, ou un seul uniquement, via l'utilisation du paramètre pjUnitaire
Environnements :
URL de Production : https://api.aife.economie.gouv.fr/dume/attestations
URL de Qualification : https://sandbox-api.aife.economie.gouv.fr/dume/attestations
Paramètres du Header :
Certificat (O) : format Varchar
Content-type (O) : format Varchar
Exemple de header :
curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/attestations -d "{}"
Les accolades encadrent le JSON
Description des paramètres d’entrée :
- operation (O) :
- Constante = récupererAttestations
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- identifiantOE (O)
- pjAttestationpjUnitaire (F) :
- Les valeurs possibles pour pjAttestationpjUnitaire sont les suivants :
- attestationSociale
- attestationFiscale
- OPQIBI
- QUALIBAT
- CNETP
- Autre
- AGEFIPH
- PROBTP
- MSA
- KBIS
- 12 (RGEADEME)
- 15 (DOCUMENTSASSOCIATIONS)
Paramètres de sortie :
JSON out avec un ZIP encodé ou un PDF encodé ou un message d’erreur
Exemple de JSON IN :
{
"operation": "recupererAttestations",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"identifiantOE": "38103128500491"
}
Exemple de JSON OUT :
{
"response": {
"attestation":[zipencode] }
}
4.8.2 demanderMiseAJourAttestations
Cette opération du domaine opérateur économique est à destination des acheteurs des places de marché. Elle permet de solliciter la mise à jour en base de données des attestations d'un opérateur économique disposant d'un SIRET.
Cette opération peut être réalisée quelques heures avant l'utilisation de l'opération récupérerAttestations.
Description des paramètres d’entrée :
- operation (O) :
- Constante = demanderMiseAJourAttestations
- typeIdPlateforme (F) :
- Les valeurs pour « type d’ID plateforme demandeuse » sont
- « 1 » (Tiers avec SIRET)
- « 2 » (Structure Européenne hors France) – TVA intracommunautaire
- « 3 » (Structure hors UE) – Code pays + 16 premiers caractères raison sociale
- « 4 » (RIDET)
- « 5 » (Numéro Tahiti)
- idPlateforme (O) :
- Id fonctionnel du profil d'acheteur ayant sollicité le raccordement
- Le format de l’ID de la plateforme est contrôlé :
- Si « type identifiant » est « 1 » : 14 caractères
- Si « type identifiant » est « 2 » : 18 caractères maximum (soit 1 à 18 caractères)
- Si « type identifiant » est « 3 » : 3 à 18 caractères
- Si « type identifiant » est « 4 » : 9 ou 10 caractères
- Si « type identifiant » est « 5 » : « 9 » caractères
- Si « type identifiant » n’est pas renseigné, il est réputé s’agir d’un SIRET : 14 caractères
- idTechniquePlateforme (O) :
- ID fourni lors du raccordement à PISTE
- L’ID technique de la plateforme et l’ID de la plateforme doivent exister en base de données et être positionnés sur la même ligne de cette base de données
- idDemandeur (O) :
- L'idDemandeur correspond au SIRET ou l'identifiant fonctionnel de l'entité qui fait la demande sur la place de marché
- rsDemandeur (O) :
- Nom de l'entité qui fait la demande sur la place (Raison sociale)
- identifiantOE (O)
Paramètres de sortie :
JSON out avec un message d’information « "Vous avez sollicité la mise à jour des attestations pour le SIRET xxxxxxxxxxxx. La solution initialise le traitement. Vous pourrez les récupérer ultérieurement via l'opération 'recupererAttestations » ou message d’erreur
Exemple de JSON IN :
{
"operation": "recupererAttestations",
"plateforme": { "typeIdPlateforme": "1" , "idPlateforme":"33592022900036", "idTechniquePlateforme":"azerty"},
"rsDemandeur": "AIFE",
"idDemandeur": "12345698765445",
"identifiantOE": "38103128500491"
}
Exemple de JSON OUT :
{
"response": {
"attestation":[zipencode] }
}