> ## 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.

# Workflows

> Automatisez les réponses à vos données — créez des plans, ajoutez des articles, appelez des webhooks et envoyez des e-mails.

Un **workflow** est une automatisation qui réagit à vos données et exécute une séquence d'actions.
Vous le concevez comme un flux de nœuds — un **déclencheur** plus une ou plusieurs **actions** — et
la plateforme données l'exécute.

```mermaid theme={null}
flowchart TB
  T["Déclencheur<br/>type d'entité + filtres d'étiquettes"] --> A1["Créer ou récupérer un plan"]
  A1 --> A2["Ajouter des articles au plan"]
  A2 --> A3["Appeler un webhook"]
  A3 --> A4["Envoyer un e-mail"]
  A4 --> R["Exécution du workflow<br/>une étape par nœud"]
```

<Note>
  Pour la référence **exhaustive, au niveau du champ** — la config de chaque action,
  toutes les stratégies, les credentials, l'interpolation et le modèle de runs/steps —
  voir [Workflows (référence)](/fr/developers/workflows/overview).
</Note>

## Déclencheurs

Un workflow est déclenché par un type d'entité — **produit, variante de produit, marque, ou
article d'inventaire** — optionnellement filtré par [étiquettes](/fr/automation/tags) (inclure/exclure).

## Actions

| Action                           | Ce qu'elle fait                                                                                                                                       |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Créer ou obtenir un plan**     | Créer (ou réutiliser) un plan — réassort, rééquilibrage, démarque, retour fournisseur, ou échange fournisseur — avec son périmètre et sa date limite. |
| **Ajouter des articles au plan** | Ajouter des articles à un plan en utilisant les filtres d'entité, le périmètre magasin/taille, et une stratégie de quantité.                          |
| **Appeler un webhook**           | Envoyer une requête HTTP (GET/POST/PUT/PATCH/DELETE) avec authentification optionnelle, en-têtes et corps.                                            |
| **Envoyer un e-mail**            | Envoyer un e-mail (texte / HTML / markdown) aux destinataires.                                                                                        |

### Stratégies pour « ajouter des articles »

* **Quantité** : **fixe**, **remplir jusqu'à la cible**, ou **pilotée par score** (utilise les recommandations du vecteur de décision).
* **Correspondance** (rééquilibrage) : **fixe** ou **pilotée par score** (correspond les magasins excédentaires aux magasins déficitaires).
* **Remise** (démarque) : **fixe**, **pilotée par score**, ou **recommandée** (remise de couche données avec plancher de marge et plafonds).

Le périmètre magasin peut être **tous**, **spécifique**, ou **du déclencheur** ; le périmètre taille peut être **tous**
ou **en dessous d'un seuil de stock**. Les dates (dates limites, dates de démarque) peuvent être **absolues**,
**relatives** (jours à partir de maintenant), ou **interpolées** à partir des sorties des étapes précédentes.

## Exécutions & étapes

Chaque exécution est une **exécution de workflow** (en attente → en cours → complétée / échouée / annulée),
et chaque nœud produit un enregistrement d'**étape** (en attente, en cours, réussie, échouée, ignorée,
annulée) avec ses entrées résolues, sa sortie, ses journaux et ses tentatives — pour que vous puissiez voir exactement
ce qui s'est passé.

Un workflow lui-même a un statut : **brouillon, actif, en pause ou archivé**. Seuls les workflows actifs s'exécutent.

## Travailler avec les workflows

<Steps>
  <Step title="Ouvrir les workflows">
    Allez à **Orchestration → Workflows**.
  </Step>

  <Step title="Concevoir le flux">
    Ajoutez un déclencheur (entité + filtres d'étiquette) et enchaînez les actions dans le générateur plein écran.
  </Step>

  <Step title="Activer">
    Mettez le workflow en actif pour qu'il s'exécute quand son déclencheur correspond.
  </Step>

  <Step title="Surveiller les exécutions">
    Examinez l'historique des exécutions et les détails par étape pour vérifier les résultats.
  </Step>
</Steps>

<Note>
  Les identifiants de webhook sont stockés de manière sécurisée et référencés par l'action Appeler-webhook, donc
  les secrets ne vivent jamais dans la définition du workflow elle-même.
</Note>