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

# Règles de tagging — anatomie

> Le modèle d'étiquette, la forme d'une règle de tagging, et comment les règles assignent des étiquettes aux entités.

Les **étiquettes** classent vos entités ; les **règles de tagging** les assignent automatiquement. Les étiquettes alimentent
les [alertes](/fr/signals/alerts) et les [déclencheurs de workflow](/fr/developers/workflows/triggers),
ce qui en fait la moitié « classifier » de *ingérer → classifier → automatiser*. Pour le guide utilisateur, voir
[Étiquettes & règles de tagging](/fr/automation/tags).

## Modèle d'étiquette

| Champ         | Signification                                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------------------------- |
| `name`        | Nom de l'étiquette (unique par organisation).                                                                   |
| `type`        | **Genre** : `DATA` (assignée automatiquement par les règles), `BUSINESS` (classification manuelle), ou `MIXED`. |
| `color`       | Couleur optionnelle pour l'interface.                                                                           |
| `description` | Optionnel.                                                                                                      |
| `labels`      | Métadonnées libres optionnelles (tableau de chaînes).                                                           |

Une étiquette est appliquée à une entité via une **assignation d'étiquette** :

| Champ                         | Signification                                                           |
| ----------------------------- | ----------------------------------------------------------------------- |
| `tagId`                       | L'étiquette.                                                            |
| `resourceId` + `resourceType` | L'entité et son type : `PRODUCT`, `BRAND`, `VARIANT`, `INVENTORY_ITEM`. |

Les assignations sont uniques sur `(tagId, resourceId, resourceType, organizationId)` — une étiquette ne peut
être présente sur une entité qu'une seule fois.

## Forme d'une règle de tagging

Une règle lie une **étiquette** à un ensemble de **conditions** (et optionnellement une **portée**) :

| Champ         | Signification                                                                                                              |
| ------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `tagId`       | L'étiquette que cette règle assigne.                                                                                       |
| `name`        | Nom de la règle (également la clé de correspondance stable lors de l'upsert).                                              |
| `description` | Optionnel.                                                                                                                 |
| `conditions`  | Ce qui doit être vrai — voir [Conditions](/fr/developers/tagging-rules/conditions).                                        |
| `scope`       | Les entités à évaluer et la propagation — voir [Portée & propagation](/fr/developers/tagging-rules/scope-and-propagation). |
| `isActive`    | Si la règle s'exécute dans les évaluations automatisées.                                                                   |

```json theme={null}
{
  "name": "Auto-tag: Stockout in 7 days",
  "tagId": "<uuid>",
  "conditions": { "operator": "AND", "rules": [ /* … */ ] },
  "scope": { "entityType": "INVENTORY_ITEM" },
  "isActive": true
}
```

<Note>
  Une règle n'a pas de genre propre — elle hérite du `type` de son étiquette. Plusieurs règles peuvent cibler
  la même étiquette.
</Note>

## Comment les règles s'appliquent

Les étiquettes ne sont pas appliquées en direct à la modification ; elles sont (re)calculées par une **exécution d'évaluation d'étiquette** qui
évalue les règles actives et crée/supprime les assignations en conséquence — voir
[Exécutions & exemples](/fr/developers/tagging-rules/runs-and-examples).

```mermaid theme={null}
flowchart TB
  A["Définir la Règle<br/>(étiquette + conditions + portée)"] -->|Déclencher| B["Exécution d'Évaluation d'Étiquette"]
  B -->|Évaluer les Règles Actives| C["Conditions Correspondantes"]
  C -->|Créer/Supprimer<br/>Assignations| D["Assignation d'Étiquette Appliquée"]
```