# Note a l'equipe CRM — plans commerciaux des biens (1 PDF par bien)

Objet : afficher sur la fiche d'un bien un bouton **"Telecharger les plans (PDF)"**.

Cote site : DEJA PRET. Il suffit que le CRM POUSSE le PDF des plans, comme il
pousse deja les photos et la fiche prix. Un bien = **un seul document** de type
`plans` (les plans commerciaux sont regroupes dans un unique PDF).

Le mecanisme est identique a celui des autres medias (voir
`contrat-push-biens-site.md`), en deux temps :

## 1. Declarer le document dans le manifeste du bien (upsert)

Dans le payload d'upsert du bien (`POST /api/crm/biens`), ajouter le document
aux `medias.documents` :

```jsonc
{
  "id_hfsql": "parcelle:6063",
  "medias": {
    "photos": [ /* ... inchange ... */ ],
    "documents": [
      { "ref": "parcelle:6063:plans", "type": "plans" }   // <-- A AJOUTER
    ]
  }
}
```

- `type` = **`plans`** (valeur desormais acceptee, a cote de `fiche_prix`).
- `ref` = identifiant stable du media (ex. `<cle_bien>:plans`).

## 2. Envoyer les octets du PDF

Comme pour les autres medias (`POST /api/crm/biens/{cle}/medias`, multipart,
Bearer + HMAC) :

- `ref` = la meme que dans le manifeste (`parcelle:6063:plans`)
- `type` = `plans`
- `sha256` = empreinte du fichier
- `fichier` = le PDF (**mime `application/pdf`** obligatoire)

## Comportement cote site

- Des que le PDF est recu, la fiche affiche la section **"Plans de la maison"**
  avec le bouton **"Telecharger les plans (PDF)"** (lien direct vers le PDF).
- Tant que le PDF n'est pas pousse, la section n'apparait pas (plus de
  vignettes fictives "Rez-de-chaussee / Etage / Implantation").
- Un seul PDF par bien : si vous en poussez plusieurs `plans`, le premier
  (ordre) est utilise.

En resume : ajoutez un document `type: "plans"` (PDF) au flux existant, et le
bouton apparait tout seul.