récupererIdDE
DESCRIPTION
Lorsqu’un profil d’acheteur souhaite récupérer le ou les identifiant(s) des données essentielles associé(s) à un lot et une consultation, elle doit avoir recours à l’opération recupererIdDE de l’API Données essentielles.
La place de marché est informée si la donnée a été modifiée ou non par un message.
ENVIRONNEMENTS
| URL de Production | https://api.aife.economie.gouv.fr/dume/donneesEssentielles |
| URL de Qualification | https://sandbox-api.aife.economie.gouv.fr/dume/donneesEsssentielles |
PARAMÈTRES
Paramètres du Header
| Donnée | Format | Facultatif / obligatoire |
|---|---|---|
| Certificat | Varchar | Obligatoire |
| Content-Type | Varchar | Obligatoire |
Exemple de header :
curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/donneesEssentielles -d "{}"
Les accolades encadrent le JSON.
Description complète des paramètres d'entrée et de sortie de l'API
JSON IN :
| Paramètre d'entrée | Obligatoire (O) / Facultatif (F) | Règle de gestion |
|---|---|---|
| Opération | O | Donnée fixe : recupererIdDE |
| rsDemandeur | O | Nom de l'entité qui fait la demande sur la place (Raison sociale) |
| idDemandeur | O | SIRET ou identifiant fonctionnel de l'entité de la place qui fait la demande |
| idConsultation | F | ID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME |
| refFonctionnelleConsultation | F | Même référence que dans le DUME |
| Numéro Lot | F | / Alphanumérique (255 caractères) / Si la consultation n’est pas allotie, il n’est pas nécessaire de renseigner de lot. Pour une même consultation et un même lot, il est possible d’avoir n données essentielles (s’il y a n contrats) |
| Acheteur | F | / SIRET Acheteur : Alphanumérique (14 caractères) |
| Plateforme | ||
| typeIdPlateforme | F | Les valeurs pour « type d’ID plateforme demandeuse / Type ID OE» 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 / ID OE 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 | / Alphanumérique (6 caractères) / ID disponible sur l'espace "raccordement" de Chorus Pro |
| Date | ||
| dateDebutPublication | F | AAAA-MM-JJ |
| dateFinPublication | F | AAAA-MM-JJ |
| ID Référence unique marché | ||
| ID Référence Unique marché | F (1..n) | Alphanumérique (255 caractères) |
JSON OUT :
| Paramètre d'entrée | Obligatoire (O) / Facultatif (F) | Type |
|---|---|---|
| ID Référence Unique marché | F (1..n) | Alphanumérique (255 caractères) |
| Référence fonctionnelle DE | O (1..n) | Alphanumérique |
| Témoin publiable | O (1..n) | True/False |
{
"operation": "recupererIdDE",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"idConsultation": "11223344556677",
"refFonctionnelleConsultation": "reference consultation X",
"lot" : "1",
"dateDebutPublication": "2018-07-12",
"dateFinPublication": "2018-12-12",
"id":"2018123456789100",
"acheteur":
{
"id": "13001977100018"
}
}
{
"operation": "recupererIdDE",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"idConsultation": "11223344556677",
"refFonctionnelleConsultation": "reference consultation X",
"lot" : "1",
"dateDebutPublication": "2017-07-13",
"dateFinPublication": "2020-07-13",
"id": "2018123456789100",
"autoriteConcedante":
{
"id": "13001977100018"
}
}
