Print Friendly, PDF & Email

rechercherDumes

DESCRIPTION

La place de marché souhaite récupérer les ID des DUMES répondant à un certain nombre de critères (ID_consultation, SIRET OE, …)

ENVIRONNEMENTS

URL de Production https://chorus-pro.gouv.fr:5443/service/dume/
URL de Qualification https://chorus-pro.gouv.fr:5443/service-qualif/dume/

PARAMÈTRES

Paramètres du Header

DonnéeFormatFacultatif / obligatoire
CertificatVarcharObligatoire
Content-TypeVarcharObligatoire

Exemple de header :
curl -v -X POST --insecure --cert xxxxx.pem https://chorus-pro.gouv.fr:5443/service/dume/dumeA -d "{}"
Les accolades encadrent le JSON.

 

Description complète des paramètres d'entrée et de sortie de l'API

Paramètre d’entrée
O/FRègle de gestion
opération
OConstante =rechercherDumes
typeIdPlateformeFLes 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
OLe 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
OID disponible sur l'espace "raccordement" de Chorus Pro
rsDemandeurONom de l'entité qui fait la demande sur la place (Raison sociale)
idDemandeur
OL'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
Consultation
idConsultation
FID de la consultation, issu de la plateforme qui fait la demande d'enregistrement du DUME
et
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
F1/ 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
F1/ 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
dateModificationDebutF1/ 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
dateModificationFinF1/ 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
FType de Marché
Code Libellé statut :
« 01 » - Travaux
« 02 » - Fourniture
« 03 » - Service
natureMarket
FNature de Marché
Code Libellé statut :
« 01 » - Marché (marché initial)
« 02 » - Marché de partenariat
« 03 » - Accord cadre
typeProcedure
FCode 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
refFonctionnelleFMême référence que dans le DUME
-Lot"lots":[{"idNumeroRecherche":"", ETC }],
idLot
FSi 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
F1/ 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
dateCreationFinF1/ 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
dateModificationDebutF1/ 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
dateModificationFinF1/ 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
idNumeroRechercheF-
-Acheteur-
identifiantA
Fid Acheteur Alphanumérique (14 caractères)
dateCreationDebut
F1/ 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
F1/ 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
F1/ 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
F1/ 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
idTechniquePlateformeF
-Dume A"dumesAcheteurs":[{"idDume":"", ETC }]
idDumeFID DUME - 8 caractères alphanumériques aléatoires
idStatutDume
FCode 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
F1/ 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
F1/ 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
F1/ 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
dateModificationFinF1/ 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-
idDumeFID DUME - 8 caractères alphanumériques aléatoires
idStatutDumeFCode 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 »
dateCreationDebutF1/ 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
dateCreationFinF1/ 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
dateModificationDebutF1/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
dateModificationFinF1/ 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
-Opérateur Economique-
ID opérateur économiqueFL’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
dateCreationDebut
F1/ 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
F1/ 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
F1/ 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
F1/ 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.

{
"operation":"rechercherDumes",
"plateforme":{ "typeIdPlateforme" : "1" , "idPlateforme": "33592022900036", "idTechniquePlateforme":"azerty"},
"idDemandeur":"123",
"rsDemandeur":"123",
"consultations":[{"idConsultation":"12345632165499"}]

}

{

"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" ]

}
 "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"
 }
 }
Back To Top