# Résoudre les problèmes de documents légaux

> Onglet Légal absent, application non référencée, bouton Publier grisé, page introuvable, variables affichées, erreurs de l'API.

Cette page couvre les situations rencontrées en éditant, en publiant ou en lisant les documents légaux.

## Symptômes

- [L'onglet Légal n'apparaît pas](#onglet-légal-absent)
- [« Cette application n'est pas encore liée à une entrée dans le catalogue commercial. »](#application-non-référencée)
- [« Aucun document légal »](#aucun-document)
- [Le bouton Publier est grisé](#publier-grisé)
- [La page /legal affiche « Page introuvable »](#page-introuvable)
- [La page publique affiche encore l'ancienne version](#ancienne-version-affichée)
- [Des variables `{{…}}` apparaissent sur la page publique](#variables-affichées)
- [`404` « Aucun document légal actif de type … »](#aucun-document-actif)

## Onglet Légal absent

**Cause** : l'application n'est pas déclarée commerciale.

**Solution** : contactez l'équipe Wakastart pour faire déclarer l'application commerciale ; les documents sont alors créés automatiquement.

## Application non référencée

**Cause** : l'application est déclarée commerciale, mais son entrée au catalogue commercial de Wakastart n'existe pas encore.

**Solution** : contactez l'équipe Wakastart avec le WID de l'application.

## Aucun document

**Cause** : les documents n'ont pas encore été créés. Le message complet est « Les documents sont créés automatiquement lors de l'activation commerciale. »

**Solution** : contactez l'équipe Wakastart.

## Publier grisé

**Cause** : la page n'est rattachée à aucun environnement ni à aucune URL. Le statut est **Non configurée** ou **Détachée**.

**Solution** : cliquez sur **Configuration**, choisissez l'environnement et l'URL, puis **Rattacher**.

## Page introuvable

**Cause possible 1** : la route publique est encore en cours de mise en place après le rattachement. Attendez quelques minutes.

**Cause possible 2** : l'adresse ne correspond pas à un type publié, par exemple `/legal/dpa-hds` pour une application non HDS.

**Cause possible 3** : rien n'a encore été publié. Vérifiez que le statut est **Publiée**.

## Ancienne version affichée

**Cause** : la nouvelle version a été créée mais pas publiée, ou la publication date de moins de 30 secondes.

**Solution** : cliquez sur **Publier**, vérifiez que la fenêtre liste la nouvelle version, confirmez, puis attendez 30 secondes.

## Variables affichées

**Cause** : la page publique affiche le texte tel quel ; elle ne remplace pas les variables.

**Solution** : retirez les variables des documents destinés à la page publique, ou rendez le document par `POST /api/legal-documents/{id}/render` dans votre application.

## Aucun document actif

**Cause** : aucun document actif de ce type n'existe pour l'application, par exemple un `DPA_HDS` pour une application non HDS, ou un `appWid` erroné.

**Solution** : vérifiez le `documentType` et le WID ; `GET /api/legal-documents?appWid=…` liste les types disponibles.

## Toujours bloqué ?

Rassemblez le WID de l'application, le type de document, l'heure de la publication et le message exact, puis contactez le support Wakastart.
