EnregistrerDE
DESCRIPTION
When a buyer profile wants to save critical data to the DUME database, it must use enregistrerDE operation of the Essential Data API.
This API makes it possible to record the essential data resulting from the parameters passed in input.
ENVIRONNEMENTS
| URL de Production | https://chorus-pro.gouv.fr:5443/service/dume/donneesEssentielles |
| URL de Qualification | https://chorus-pro.gouv.fr:5443/service-qualif/dume/donneesEssentielles |
PARAMÈTRES
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 = enregistrerDE |
| typeIdPlateforme | 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) |
| idPlateforme | 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 |
| idTechniquePlateforme | 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 |
| idConsultation | M | Call for tenders ID, released by the platform which makes the request to record the ESPD - 14 alphanumerical characters |
| RefFonctionnelleConsultation | F | Same reference as in the ESPD |
| Lot | O | 3 numerical characters |
| Témoin de publication (publiable) | M | True/false |
| typeDE | M | - MP (public market) - MDS (defense and security market) - CC (concession contract) |
JSON OUT :
| Output parameter | Management rule |
|---|---|
| ID Référence fonctionnelle DE | Alphanumerical characters Example : AIFEDUME-1gh25as8 |
| Publiable | True/False |
{
"operation": "enregistrerDE",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"idConsultation": "11223344556677",
"refFonctionnelleConsultation": "referenceconsultationX",
"lot" : "1",
"typeDE":"MP",
"accessible": "True",
"id": "2018123456789100",
"acheteur":
{
"id": "13001977100018",
"nom": "AcheteurX"
},
"nature": "Marche",
"objet": "Marche public X",
"codeCPV": "12345678",
"procedure": "Appel d'offres ouvert",
"lieuExecution":
{
"code": "93160",
"typeCode": "Code Postal",
"nom": "CommuneX"
},
"dureeMois": "8",
"dateNotification": "2018-07-12",
"datePublicationDonnees": "2018-07-12",
"montant": "123456.78",
"formePrix": "Ferme",
"titulaires":
[
{
"typeIdentifiant": "SIRET",
"id": "79858993300000",
"denominationSociale": "Entreprise1"
},
{
"typeIdentifiant": "TAHITI",
"id": "587850000",
"denominationSociale": "Entreprise2"
}
],
"modifications":
[
{
"objetModification": "Modification délai, montant, titulaire",
"datePublicationDonneesModification": "2018-07-15",
"dureeMois": "10",
"montant": "987654.32",
"titulaires":
[
{
"typeIdentifiant": "TVA",
"id": "FR21483209000",
"denominationSociale": "Entreprise3"
},
{
"typeIdentifiant": "RIDET",
"id": "1234567000",
"denominationSociale": "Entreprise4"
}
],
"dateSignatureModification": "2018-07-15"
}
] }
{
"operation": "enregistrerDE",
"rsDemandeur": "EntrepriseX",
"idDemandeur": "38103128500491",
"plateforme":
{
"typeIdPlateforme": "1",
"idPlateforme": "33592022900036",
"idTechniquePlateforme": "azerty"
},
"idConsultation": "11223344556677",
"refFonctionnelleConsultation": "Reference consultation X",
"lot" : "1",
"typeDE":"CC",
"accessible": "True",
"id": "2018123456789100",
"autoriteConcedante":
{
"id": "13001977100018",
"nom": "AcheteurX"
},
"nature": "Concession de travaux",
"objet": "ConcessionX",
"procedure": "Procedure negociee ouverte",
"lieuExecution":
{
"code": "93160",
"typeCode": "Code Postal",
"nom": "CommuneX"
},
"dureeMois": "8",
"dateSignature": "2018-07-12",
"datePublicationDonnees": "2018-08-06",
"dateDebutExecution": "2018-09-30",
"valeurGlobale": "7789456.56",
"montantSubventionPublique": "12456.32",
"donneesExecution":
[
{
"datePublicationDonneesExecution": "2019-02-17",
"depensesInvestissement": "12345.5",
"tarifs":
[
{
"intituleTarif": "TarifX",
"tarif": "115.5"
},
{
"intituleTarif": "TarifXX",
"tarif": "12000.2"
}
]
}
],
"concessionnaires":
[
{
"typeIdentifiant": "SIRET",
"id": "79858993300000",
"denominationSociale": "Entreprise1"
}
],
"modifications":
{
"objetModification": "Modification durée, valeurGlobale",
"datePublicationDonneesModification": "2018-11-09",
"dureeMois": "24",
"valeurGlobale": "123321123.12",
"dateSignatureModification": "2018-12-24"
}
}
