Retención de datos
Qué guarda Dunning, por cuánto tiempo y por qué — el resumen para quien debe responder a un DPO, a una auditoría o a un juez. La regla general: la evidencia de negocio se preserva; el dato personal transitorio se descarta apenas cumple su papel.
Lo que expira automáticamente
| Dato | Retención | Después |
|---|---|---|
Claves de idempotencia (X-Idempotency-Key + respuesta grabada) | 24 horas | La clave expira; el mismo valor pasa a ejecutar una operación nueva |
| Contenido de archivos de importación (CSV con nombres, documentos, contactos) | Hasta el fin del procesamiento | El contenido se borra — con éxito o falla. Quedan los metadatos: nombre del archivo, conteos y la lista de errores por fila |
El descarte del CSV es deliberado (LGPD): el archivo bruto contiene datos personales que el sistema no necesita retener una vez que los registros fueron creados o rechazados. Lo que necesitas para auditar y corregir — cuántos creados, cuántos actualizados, qué fila falló y por qué — sigue disponible.
Lo que se preserva como evidencia
- Registro de auditoría — append-only: los registros de acciones no se editan ni se borran. Es la base probatoria de la operación.
- Versiones de regla — cada versión publicada es un snapshot inmutable; editar la regla crea versiones nuevas, nunca reescribe las antiguas. Siempre puedes probar qué secuencia regía cuando un deudor fue contactado.
- Ejecuciones de etapa y notificaciones — qué se envió, por qué canal, cuándo, y por qué algo no se envió (suprimido, reprogramado, cancelado, con motivo tipado).
- Eventos de webhook — persistidos de forma inmutable antes de cualquier entrega; cada intento de entrega queda registrado con request y response capturados (entregas y reintentos).
- Supresiones — la creación y la revocación quedan registradas con tipo, alcance, origen y evidencia, incluso después de expirar o ser revocadas.
- Claves de API revocadas — el token muere al instante (respuestas
401), pero el registro de la clave permanece en el listado para historial y auditoría. - Acuerdos — la aceptación guarda fecha, IP y el texto de los términos vigente en ese momento.
Qué significa esto para tu integración
- No reutilices claves de idempotencia después de 24 horas esperando replay — del lado del servidor ya expiraron.
- No trates a Dunning como storage de archivos: el CSV importado no queda disponible para descarga posterior. Guarda el original de tu lado si tu política interna lo exige.
- Puedes confiar en el registro: para reconstruir "qué pasó con este cobro", la combinación auditoría + ejecuciones + notificaciones + versiones responde sin depender de tus propios logs.