# Enrichissements

> Ce qu'est un enrichissement, comment une transaction en accumule plusieurs au fil des rafraîchissements, et les trois opérations qui les créent et les relisent.

Un enrichissement est le résultat réglé d'un appel : une identité marchande (ou son absence), un statut, et ce que l'appel a coûté. Il est identifié par un `enrichment_id` de la forme `enr_<uuid>`, et son contenu reste lisible pendant 90 jours.

## Une transaction, un ou plusieurs enrichissements

Une transaction, identifiée par votre `external_transaction_id`, commence par un premier enrichissement. Chaque rafraîchissement ajoute un **nouvel** enrichissement, avec son propre `enrichment_id` ; il n'écrase jamais le précédent.

```text
tx_8f21c0 (votre external_transaction_id)
├── enr_ffe8…  création            resolved              ← résultat courant au départ
└── enr_dd42…  rafraîchissement    refresh_recalculated  ← devient le résultat courant
```

À tout moment, la transaction a un **résultat courant** : le premier, remplacé seulement par un rafraîchissement qui aboutit (`refresh_recalculated`). C'est lui qu'un nouvel envoi de la même transaction rend en déduplication. Chaque `enrichment_id`, lui, continue de désigner son propre résultat. Voir [Cycle de vie](https://developer.noryo.app/fr-FR/merchant/enrichments/lifecycle).

Un enrichissement créé avec une seule `Idempotency-Key`, sans `external_transaction_id`, existe et se relit, mais il n'est rattaché à aucune transaction : il ne se déduplique pas et ne se rafraîchit pas.

## Les trois opérations

| Opération | Scope | Coût | Page |
|---|---|---|---|
| `POST /merchant/v1/enrichments` | `enrich:write` | 1 unité si `resolved` | [Créer un enrichissement](https://developer.noryo.app/fr-FR/merchant/enrichments/create) |
| `GET /merchant/v1/enrichments/{enrichment_id}` | `enrich:read` | jamais facturé | [Relire un enrichissement](https://developer.noryo.app/fr-FR/merchant/enrichments/read) |
| `POST /merchant/v1/enrichments/{enrichment_id}/refresh` | `enrich:write` | 1 unité si `refresh_recalculated` | [Rafraîchir](https://developer.noryo.app/fr-FR/merchant/refresh) |

Chacune consomme un jeton de débit. Les schémas complets figurent dans la [référence de l'API](https://developer.noryo.app/fr-FR/merchant/reference).

## Ce qu'il faut retenir

- Un `200` est un résultat réglé, pas forcément un marchand trouvé : lisez `enrichment.status`. Voir [Statuts](https://developer.noryo.app/fr-FR/merchant/enrichments/statuses).
- Un enrichissement est propre au workspace et à l'environnement qui l'ont créé ; toute clé de ce workspace et de cet environnement peut le relire.
- Le contenu expire au bout de 90 jours ; l'identité, la ligne de registre et l'écriture comptable survivent. Voir [Rétention et 410](https://developer.noryo.app/fr-FR/merchant/retention).

## Dans cette section

- [Créer un enrichissement](https://developer.noryo.app/fr-FR/merchant/enrichments/create)
- [Relire un enrichissement](https://developer.noryo.app/fr-FR/merchant/enrichments/read)
- [Rafraîchir](https://developer.noryo.app/fr-FR/merchant/refresh)
- [Statuts](https://developer.noryo.app/fr-FR/merchant/enrichments/statuses)
- [Cycle de vie](https://developer.noryo.app/fr-FR/merchant/enrichments/lifecycle)
- [Rétention et 410](https://developer.noryo.app/fr-FR/merchant/retention)

---

Page canonique : https://developer.noryo.app/fr-FR/merchant/enrichments