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://api.aife.economie.gouv.fr/dume/dumeOE |
| URL de Qualification | https://sandbox-api.aife.economie.gouv.fr/dume/dumeOE |
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/dumeOE -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/F | Règle de gestion |
|---|---|---|
| opération | O | Constante =rechercherDumes |
| typeIdPlateforme | F | Les 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 | O | Le 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 | O | ID disponible sur l'espace "raccordement" de Chorus Pro |
| rsDemandeur | O | Nom de l'entité qui fait la demande sur la place (Raison sociale) |
| idDemandeur | O | L'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 | F | ID 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 |
| dateModificationFin | F | 1/ 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 | F | Type de Marché Code Libellé statut : « 01 » - Travaux « 02 » - Fourniture « 03 » - Service |
| natureMarket | F | Nature de Marché Code Libellé statut : « 01 » - Marché (marché initial) « 02 » - Marché de partenariat « 03 » - Accord cadre |
| typeProcedure | F | Code 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 |
| refFonctionnelle | F | Même référence que dans le DUME |
| - | Lot | "lots":[{"idNumeroRecherche":"", ETC }], |
| idLot | F | 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 |
| idNumeroRecherche | F | - |
| - | Acheteur | - |
| identifiantA | F | id Acheteur Alphanumérique (14 caractères) |
| dateCreationDebut | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | |
| idTechniquePlateforme | F | |
| - | Dume A | "dumesAcheteurs":[{"idDume":"", ETC }] |
| idDume | F | ID DUME - 8 caractères alphanumériques aléatoires |
| idStatutDume | F | Code 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | - |
| idDume | F | ID DUME - 8 caractères alphanumériques aléatoires |
| idStatutDume | F | Code 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 | F | 1/ 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 | F | 1/ 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 | F | 1/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 | F | 1/ 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 économique | F | L’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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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 | F | 1/ 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"
}
}
