> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ & dépannage

> Réponses rapides à des questions courantes sur les données, les alertes, les plans, les risques, l'accès et l'API.

## Données & ingestion

<AccordionGroup>
  <Accordion title="Mes dernières données n'apparaissent pas">
    Vérifiez la [exécution d'ingestion](/fr/data-layer/ingestion-runs) la plus récente — son statut et ses
    journaux vous indiquent si l'import a réussi. Les analyses (tableaux de bord, KPIs, risques) reflètent
    l'**dernière ingestion réussie**.
  </Accordion>

  <Accordion title="Une exécution d'ingestion a échoué">
    Ouvrez l'exécution et consultez ses journaux et messages au niveau `Error`. Les causes courantes : le fichier
    ne correspondait pas à une [spécification d'ingestion](/fr/data-layer/ingestion-spec) déployée, ou une colonne
    n'a pas été analysée. Testez le fichier dans le [bac à sable](/fr/data-platform/sandbox) avant de réessayer.
  </Accordion>

  <Accordion title="Une spécification ne récupère pas mon fichier">
    Le fichier doit satisfaire les [règles de détection](/fr/developers/ingestion-specs/detection) de la spécification
    (source de données, modèle de nom de fichier, colonnes d'en-tête) **ET** la spécification doit être déployée. Utilisez
    le bac à sable pour voir quelle spécification correspond.
  </Accordion>
</AccordionGroup>

## Alertes & signaux

<AccordionGroup>
  <Accordion title="Mon alerte ne se déclenche pas">
    Les alertes sont **pilotées par les étiquettes** : elles surveillent les entités portant les étiquettes choisies. Assurez-vous qu'une
    [règle de tagging](/fr/automation/tags) étiquette vraiment les entités, qu'une
    [exécution d'évaluation d'étiquette](/fr/developers/tagging-rules/runs-and-examples) s'est exécutée, et que
    les étiquettes/périmètre de l'alerte correspondent. Voir [Alertes](/fr/signals/alerts).
  </Accordion>

  <Accordion title="Comment alerter sur un seuil de métrique ?">
    Créez une règle de tagging avec une condition de métrique (p. ex. jours de stock ≤ 7) pour étiqueter les
    articles correspondants, puis pointez une alerte vers cette étiquette. Voir
    [Aperçu des alertes](/fr/developers/alerts/overview).
  </Accordion>
</AccordionGroup>

## Plans & approbations

<AccordionGroup>
  <Accordion title="Je ne peux pas valider un plan — il demande une approbation">
    La valeur du plan a dépassé un seuil de [politique d'approbation](/fr/intelligence-layer/policies-and-lists).
    Un approbateur (avec la permission *Plan approver*) décide dans la file d'approbations. Voir
    [Cycle de vie du plan & approbations](/fr/inventory-plans/lifecycle).
  </Accordion>

  <Accordion title="L'ajout d'un article est bloqué">
    Une [règle métier](/fr/intelligence-layer/rules-and-rulesets) en mode **Bloquer** l'a rejeté
    (p. ex. un plafond budgétaire ou une MOQ fournisseur). Le message nomme la règle ; ajustez l'article ou
    le jeu de règles.
  </Accordion>

  <Accordion title="Une approbation a disparu / expiré">
    Les approbations **expirent** automatiquement quand le plan change après la demande, donc une
    approbation obsolète ne s'applique jamais. Re-validez pour en demander une nouvelle.
  </Accordion>
</AccordionGroup>

## Risques & analyses

<AccordionGroup>
  <Accordion title="Les chiffres de risque ou de KPI semblent obsolètes">
    Ils sont calculés sur les dernières données ingérées — confirmez une [exécution d'ingestion](/fr/data-layer/ingestion-runs) réussie récente. Voir
    [Risques d'inventaire](/fr/inventory-risks/overview).
  </Accordion>

  <Accordion title="Un utilisateur voit moins de magasins que prévu">
    La visibilité des magasins dépend du rôle : `shops.viewAll` vs `shops.viewAssigned`. Voir
    [Utilisateurs, équipes & rôles](/fr/administration/users-teams-roles).
  </Accordion>
</AccordionGroup>

## Accès & API

<AccordionGroup>
  <Accordion title="Un coéquipier ne peut pas voir une section">
    Les sections sont protégées par les permissions et le
    [modèle de navigation](/fr/administration/navigation-templates) de l'organisation. Vérifiez son rôle et le
    modèle assigné.
  </Accordion>

  <Accordion title="Mon appel API retourne 401 vs 403">
    `401` signifie que le token est manquant, invalide, révoqué ou expiré — réémettez-le. `403`
    signifie que le token manque de la permission requise — accordez-la (révoquez + recréez, car
    les permissions sont fixes à la création). Voir [Codes d'erreur](/fr/developers/error-codes).
  </Accordion>

  <Accordion title="J'ai perdu la valeur de mon token API">
    La valeur en clair du token n'est affichée qu'une seule fois. Si perdu, révoquez-le et créez-en un nouveau sous
    [Tokens API](/fr/administration/api-tokens).
  </Accordion>
</AccordionGroup>

<Note>
  Vous n'avez pas trouvé votre réponse ? L'[Agent IA](/fr/apps/ai-agent) peut souvent répondre à des questions
  sur vos propres données directement.
</Note>