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

# Idempotencia

> Reintentar es seguro: eventos por event_id, decisiones por Idempotency-Key.

* **Eventos**: cada `event_id` se procesa una sola vez por inquilino. Reenviar un
  lote entero devuelve los repetidos en `duplicados` y no cambia nada.
* **Decisiones en línea**: manda `Idempotency-Key` (cualquier cadena única por
  petición, por ejemplo un UUID). Durante 24 horas, repetir la misma clave con el
  mismo cuerpo devuelve **la misma decisión**; la misma clave con otro cuerpo
  responde `422 idempotencia_conflicto`. Así un reintento nunca crea dos
  decisiones ni altera las propensiones.
* **Confirmaciones**: una por decisión; repetirla responde `409`.

El SDK genera la clave y la conserva entre reintentos.