[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Obtenir le lien d'une pièce de DCE

L'outil marches_dce_lien_obtenir de Prescriptio donne un lien de téléchargement, valable une heure, d'une pièce de dossier de consultation ou de l'archive complète.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "marche_id": "fixture-dce-001"
    },
    "name": "marches_dce_lien_obtenir"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"marche_id":"fixture-dce-001"},"name":"marches_dce_lien_obtenir"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "telechargement_dce",
  "content_type": "<texte>",
  "count": 0,
  "doc_type": "<texte>",
  "download_url": "<texte>",
  "expires_in": 0,
  "fichiers": [
    {
      "filename": "<texte>",
      "pages_estimees": 0,
      "parties": 0
    }
  ],
  "fields": {},
  "filename": "<texte>",
  "hint": "<texte>",
  "marche_id": "<texte>",
  "ok": true,
  "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

| Nom | Type | Requis | Description |
|---|---|---|---|
| `filename` | texte | — | Nom exact d'une pièce a telecharger (facultatif). Omis, ou pièce non stockee isolement : l'archive complete du dossier est renvoyee. |
| `marche_id` | texte | oui | Identifiant du dossier : UUID de marché OU annonce_id betterplace (ex "2833189"). |

## Quand l'utiliser

{ marche_id } (UUID de marché OU annonce_id) telecharge le dossier entier ; ajouter { filename } cible une pièce précise si elle est stockee isolement. Renvoie une erreur honnete si le dossier n'est pas heberge chez Prescriptio (jamais de lien mort ni de lien vers la plateforme externe).

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Donne-moi le lien de téléchargement de l'archive complète de ce dossier de consultation.
```

Outil : `marches_dce_lien_obtenir` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, et 1 unité de dossier par dossier lu dans la journée · Limite : 5 dossiers lus par jour en compte gratuit, 500 abonné

## En bref

| | |
|---|---|
| Effets | lecture seule |
| 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. |
| Données lues | la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée |
| Distribution | connecteurs ChatGPT/Claude (`connectors-1.0.0`) et MCP historique |
| En REST | `POST /api/mcp/v1/dce.download` : [dce.download](https://prescriptio.fr/docs/api/dce.download) |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## 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 compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des 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 skills qui s'en servent

- [prescriptio-trouver-marches](https://prescriptio.fr/skills/prescriptio-trouver-marches) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `marches_dce_lien_obtenir`.

- [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
- [Lire un DCE avec votre agent IA](https://prescriptio.fr/docs/guides/lire-un-dce-avec-votre-agent) : Guides, Entreprise de travaux
- [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin
- [Trouver et lire des marchés](https://prescriptio.fr/skills/prescriptio-trouver-marches) : IA, Les skills du plugin
- [Carte de résultats](https://prescriptio.fr/docs/ia/carte-de-resultats) : IA, Le connecteur en détail
- [Référence API](https://prescriptio.fr/docs/reference) : Référence, Pour commencer

## Voir aussi

- [dce.download](https://prescriptio.fr/docs/api/dce.download) : La même action, en opération REST
- [marches_rechercher](https://prescriptio.fr/docs/api/marches_rechercher) : Avis d'appels d'offres publics du bâti (BOAMP + DECP, ~744 000 avis)
- [marches_attributions](https://prescriptio.fr/docs/api/marches_attributions) : Qui a gagne quoi : attributions de marchés publics (DECP, ~308 000 contrats)
- [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : Pièces d'un dossier de consultation (DCE)
- [marches_dossiers](https://prescriptio.fr/docs/api/marches_dossiers) : Pipeline des dossiers d'appels d'offres suivis (kanban du portefeuille)
- [marches_dossier_suivre](https://prescriptio.fr/docs/api/marches_dossier_suivre) : Ajoute un marché public ou un DCE au pipeline AO (crée un dossier au statut 'A qualifier')
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module