MettreAJourDonneesEssentielles
DESCRIPTION
When a buyer profile wants to modify the essential data contained in the DUME Service database, it must use MettreAJourDonneesEssentielles operation.
The update concerns data communicated to the Service DUME but not published, not yet communicated or the modification and execution data. It will not be possible to return the original document without update when it is already published.
A message is sent to the buyer profile to inform him of the modification or not of the data.
ENVIRONNEMENTS
URL de Production | https://chorus-pro.gouv.fr:5443/service/dumes/donneesEssentielles |
URL de Qualification | https://chorus-pro.gouv.fr:5443/service/dumes/donneesEssentielles |
PARAMETERS
Header parameter
Donnée | Format | Facultatif / obligatoire |
---|---|---|
Certificat | Varchar | Obligatoire |
Content-Type | Varchar | Obligatoire |
Header example :
curl -v -X POST --insecure --cert xxxxx.pem https://chorus-pro.gouv.fr:5443/service/dume/dumeA -d "{}"
Braces frame the JSON.
Complete description of the input and output parameters of the API
JSON IN :
Input parameter | Optional (O) / Mandatory (M) | Management rule |
---|---|---|
operation | M | constant = MettreAJourDonneesEssentielles |
Type ID plateforme demandeuse | O | The values for « type d’ID plateforme demandeuse » (which means "requesting platform ID type") are: - « 1 » (Third party with SIRET number) - « 2 » (European structure outside of France) – intracommunity VAT - « 3 » (Structure outside of the EU) – Country code + first 16 corporate name characters - « 4 » (RIDET) - « 5 » (Tahiti Number) |
ID Plateforme demandeuse | M | 1/ Functional Id of the buyer profile which requested the connection 2/ The ID format of the platform is controled: - If « identification type » is « 1 » : 14 characters - If « identification type » is « 2 » : 18 characters maximum (1 to 18 characters) - If « identification type » is « 3 » : 3 to 18 characters - If « identification type » is « 4 » : 9 ou 10 characters - If « identification type » is « 5 » : « 9 » characters - If « identification type » is not provided, it is deemed to be a SIRET: 14 characters 3/ The platform's technical ID and the platform's ID must exist in database and be postioned on the same line as this database |
Id technique plateforme | M | 1/ ID available on the Chorus Pro "connection" space. The technical ID corresponds to the partner application code contained in the connection form. 2/ The platform's technical ID and the platform's ID must exist in database and be postioned on the same line as this database |
rsDemandeur | M | Name of the entity which makes the request on the place (Corporate name) - 100 characters maximum |
idDemandeur | M | The idDemandeur (which means "requester ID") corresponds to the SIRET number or functional identifier of the public entity that makes the request on the marketplace. - 1 to 18 characters |
ID Référence Unique marché (unique market id) | O | You must inform ether "Id ref unique marché" or "Id ref fonctionnelle DE" |
Id Ref Fonctionnelle DE | O | Unique Id producted by SN DUME at time of the first registration |
Publiable | M | true/false |
JSON OUT :
Output parameter | Optional (O) / Mandatory (M) | Management rule |
---|---|---|
Return code | M | Code |
message gradation | M | Text |
Content | M | Text |
{
"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"
}
}