Lire un dossier de consultation | Documentation Prescriptio

POST /api/mcp/v1/dce.read, portée mcp:read; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil marches_dce.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/dce.read \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"marche_id":"fixture-dce-001","type":"rc"}'

{
  "marche_id": "fixture-dce-001",
  "type": "rc"
}

Réponsegénérée depuis le schéma

{
  "action": "<sommaire_dce | lecture_dce | recherche_dce | recherche_dans_dossier>",
  "count": 0,
  "doc_type": "<texte>",
  "fichiers": [
    {
      "filename": "<texte>",
      "pages_estimees": 0,
      "parties": 0
    }
  ],
  "fields": {},
  "filename": "<texte>",
  "hint": "<texte>",
  "marche_id": "<texte>",
  "ok": null,
  "page": 0,
  "pages_total": 0,
  "query": "<texte>",
  "results": [
    {
      "acheteur": "<texte>",
      "doc_type": "<texte>",
      "extrait": "<texte>",
      "filename": "<texte>",
      "lieu": "<texte>",
      "marche_id": "<texte>",
      "titre": "<texte>"
    }
  ],
  "texte": "<texte>",
  "titre": "<texte>"
}

Paramètres du corps

filenametexte

Nom de la pièce a lire dans un dossier multi-lots. Un nom approximatif suffit (ex "CCTP lot 12", "chape") : il est resolu contre les pièces réelles. Omis sur un dossier multi-lots, l'outil renvoie la table des matieres au lieu de coller tous les fichiers bout a bout.

marche_idtexte

Identifiant du dossier : marche_id (UUID) ou annonce_id betterplace (ex "2833189"), les deux sont acceptes. Requis en mode lecture.

pageentier

Page de lecture (~8000 caracteres) dans la pièce choisie. pages_total indique le total ; demander page:2, 3... Pour la suite. Ne pas feuilleter un dossier entier page par page : utiliser filename, ou query pour localiser. (min 1, défaut 1)

querytexte

Avec marche_id : cherche dans ce dossier et renvoie les pièces qui parlent du terme (le moyen rapide de trouver le bon lot). Sans marche_id : recherche semantique globale dans tous les DCE.

typetexte

Pièce a lire : rc (reglement de consultation), cctp (clauses techniques), ccap (clauses administratives), dpgf/bpu (prix). Requis en lecture ; en recherche, restreint a ce type. (valeurs : rc · cctp · ccap · dpgf · bpu)

Quand l'utiliser

L'identifiant canonique est annonce_id ; les modes sont décrits dans le schéma.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

En bref

Adresse: POST /api/mcp/v1/dce.read
Contrat: 3.0.0
Portée OAuth: mcp:read
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Outil MCP: marches_dce : même traitement

Erreurs et quotas

Cet outil consomme en plus une unité de dossier : un dossier vaut une unité pour la journée, quel que soit le nombre de pièces lues ou téléchargées dedans. Le compteur de dossiers repart à minuit, heure de Paris ; les deux compteurs d'appels, eux, glissent sur leur fenêtre.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite dce.read.

Moteur de rechercheDocumentation, Les modules Les dossiers de consultation (DCE)Documentation, Les données Appels d'offresDocumentation, Les modules API RESTIA, Intégrations

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse marches_dceLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

{ "action": "<sommaire_dce | lecture_dce | recherche_dce | recherche_dans_dossier>", "count": 0, "doc_type": "<texte>", "fichiers": [ { "filename": "<texte>", "pages_estimees": 0, "parties": 0 } ], "fields": {}, "filename": "<texte>", "hint": "<texte>", "marche_id": "<texte>", "ok": null, "page": 0, "pages_total": 0, "query": "<texte>", "results": [ { "acheteur": "<texte>", "doc_type": "<texte>", "extrait": "<texte>", "filename": "<texte>", "lieu": "<texte>", "marche_id": "<texte>", "titre": "<texte>" } ], "texte": "<texte>", "titre": "<texte>" }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Lire un dossier de consultation L'opération REST dce.read de Prescriptio sert à rechercher dans un dossier ou lire une pièce ciblée. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/dce.read \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"marche_id":"fixture-dce-001","type":"rc"}' ``` **Corps JSON** ```json { "marche_id": "fixture-dce-001", "type": "rc" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<sommaire_dce | lecture_dce | recherche_dce | recherche_dans_dossier>", "count": 0, "doc_type": "<texte>", "fichiers": [ { "filename": "<texte>", "pages_estimees": 0, "parties": 0 } ], "fields": {}, "filename": "<texte>", "hint": "<texte>", "marche_id": "<texte>", "ok": null, "page": 0, "pages_total": 0, "query": "<texte>", "results": [ { "acheteur": "<texte>", "doc_type": "<texte>", "extrait": "<texte>", "filename": "<texte>", "lieu": "<texte>", "marche_id": "<texte>", "titre": "<texte>" } ], "texte": "<texte>", "titre": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `filename` | texte | — | Nom de la pièce a lire dans un dossier MULTI-LOTS. Un nom approximatif suffit (ex "CCTP lot 12", "chape") : il est resolu contre les pièces réelles. Omis sur un dossier multi-lots, l'outil renvoie la TABLE DES MATIERES au lieu de coller tous les fichiers bout a bout. | | `marche_id` | texte | — | Identifiant du dossier : marche_id (UUID) OU annonce_id betterplace (ex "2833189") — les deux sont acceptes. Requis en mode lecture. | | `page` | entier | — | Page de lecture (~8000 caracteres) DANS la pièce choisie. pages_total indique le total ; demander page:2, 3... pour la suite. Ne PAS feuilleter un dossier entier page par page : utiliser filename, ou query pour localiser. (min 1, défaut `1`) | | `query` | texte | — | Avec marche_id : cherche DANS ce dossier et renvoie les pièces qui parlent du terme (le moyen rapide de trouver le bon lot). Sans marche_id : recherche semantique globale dans tous les DCE. | | `type` | texte | — | Pièce a lire : rc (reglement de consultation), cctp (clauses techniques), ccap (clauses administratives), dpgf/bpu (prix). Requis en lecture ; en recherche, restreint a ce type. (valeurs : `rc` · `cctp` · `ccap` · `dpgf` · `bpu`) | ## Quand l'utiliser L'identifiant canonique est annonce_id ; les modes sont décrits dans le schéma. ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/dce.read` | | Contrat | 3.0.0 | | Portée OAuth | `mcp:read` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Outil MCP | [`marches_dce`](https://prescriptio.fr/docs/api/marches_dce) : même traitement | ## Erreurs et quotas Cet outil consomme **en plus une unité de dossier** : un dossier vaut une unité pour la journée, quel que soit le nombre de pièces lues ou téléchargées dedans. Le compteur de dossiers repart à minuit, heure de Paris ; les deux compteurs d'appels, eux, glissent sur leur fenêtre. Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `dce.read`. - [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules - [Les dossiers de consultation (DCE)](https://prescriptio.fr/docs/donnees/dce) : Documentation, Les données - [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules - [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations