MettreAJourDonneesEssentielles
DESCRIPTION
Lorsqu’un profil d’acheteur souhaite modifier les données essentielles contenues dans la base de données Service DUME, elle doit avoir recours à l’opération MettreAJourDonneesEssentielles de l’API Données essentielles.
La mise à jour concerne des données communiquées au Service DUME mais non publiées, non encore communiquées ou encore les données de modification et d’exécution. Il ne sera pas possible de renvoyer le document initial sans mise à jour lorsque celui-ci est déjà publié.
Un message est envoyé au profil d’acheteur pour l’informer de la modification ou non de la donnée.
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 | Valeur attendue = MettreAJourDonneesEssentielles |
| Type ID plateforme demandeuse | 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) |
| ID Plateforme demandeuse | 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 |
| Id technique plateforme | O | / ID disponible sur l'espace "raccordement" de Chorus Pro / 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) |
| idDemandeur | O | SIRET ou identifiant fonctionnel de l'entité de la place qui fait la demande |
| ID Référence Unique marché | F | Il est obligatoire de renseigner un des deux champs suivants au minimum: ID référence unique marché ou ID référence fonctionnelle DE |
| ID Référence fonctionnelle DE | F | / Il est obligatoire de renseigner un des deux champs suivants au minimum: ID référence unique marché ou ID référence fonctionnelle DE / Correspond à l’ID unique produit par SN DUME lors de l’enregistrement initial |
| Témoin de publication | O | True/False |
JSON OUT :
| Paramètre de sortie | Obligatoire (O) / Facultatif (F) | Règle de gestion |
|---|---|---|
| Code de retour | O | Code |
| Sévérité message | O | Texte |
| Contenu message | O | Texte |
{
"operation": "mettreAJourDonneesEssentielles",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"refFonctionnelleDE": "A REMPLIR APRES LA CREATION DE",
"accessible": "True",
"id":"2018123456789100",
"modifications":
{
"objetModification": "Modification délai, montant, titulaire",
"datePublicationDonneesModification": "2018-07-17",
"dureeMois": "14",
"montant": "654987123.32",
"titulaires":
[
{
"typeIdentifiant": "FRWF",
"id": "FRWFARPECAL",
"denominationSociale": "Entreprise1"
},
{
"typeIdentifiant": "HORS-UE",
"id": "BRDASILVAMOTORES",
"denominationSociale": "Entreprise2"
}
],
"dateSignatureModification": "2018-07-17"
}
}
{
"operation": "mettreAJourDonneesEssentielles",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"refFonctionnelleDE": "A REMPLIR APRES LA CREATION DE",
"accessible": "True",
"id":"2018123456789100",
"donneesExecution":
[
{
"datePublicationDonneesExecution": "2019-02-17",
"depensesInvestissement": "12344545.5",
"tarifs":
[
{
"intituleTarif": "TarifXX",
"tarif": "1115.5"
},
{
"intituleTarif": "TarifXXX",
"tarif": "12006540.2"
}
]
}
],
"modifications":
{
"objetModification": "Modification durée, valeurGlobale V2",
"datePublicationDonneesModification": "2018-08-08",
"dureeMois": "54",
"valeurGlobale": "451123.12",
"dateSignatureModification": "2018-08-09"
}
}
