Retenção de dados
O que o Dunning guarda, por quanto tempo e por quê — o resumo para quem precisa responder a um DPO, a uma auditoria ou a um juiz. A regra geral: evidência de negócio é preservada; dado pessoal transitório é descartado assim que cumpre o papel.
O que expira automaticamente
| Dado | Retenção | Depois |
|---|---|---|
Chaves de idempotência (X-Idempotency-Key + resposta gravada) | 24 horas | A chave expira; o mesmo valor passa a executar uma operação nova |
| Conteúdo de arquivos de importação (CSV com nomes, documentos, contatos) | Até o fim do processamento | O conteúdo é apagado — com sucesso ou falha. Ficam os metadados: nome do arquivo, contagens e a lista de erros por linha |
O descarte do CSV é deliberado (LGPD): o arquivo bruto contém dados pessoais que o sistema não precisa reter depois que os registros foram criados ou rejeitados. O que você precisa para auditar e corrigir — quantos criados, quantos atualizados, qual linha falhou e por quê — permanece disponível.
O que é preservado como evidência
- Trilha de auditoria — append-only: registros de ações não são editados nem apagados. É a base probatória da operação.
- Versões de régua — cada versão publicada é um snapshot imutável; editar a régua cria versões novas, nunca reescreve as antigas. Você sempre consegue provar qual sequência valia quando um devedor foi cobrado.
- Execuções de etapa e notificações — o que foi enviado, por qual canal, quando, e por que algo não foi enviado (suprimido, reagendado, cancelado, com motivo tipado).
- Eventos de webhook — persistidos de forma imutável antes de qualquer entrega; cada tentativa de entrega fica registrada com request e response capturados (entregas e retry).
- Supressões — criação e revogação ficam registradas com tipo, escopo, origem e evidência, mesmo depois de expiradas ou revogadas.
- Chaves de API revogadas — o token morre na hora (respostas
401), mas o registro da chave permanece na listagem para histórico e auditoria. - Acordos — o aceite guarda data, IP e o texto dos termos vigente no momento.
O que isso significa para a sua integração
- Não reutilize chaves de idempotência depois de 24 horas esperando replay — do lado do servidor elas já expiraram.
- Não trate o Dunning como storage de arquivos: o CSV importado não fica disponível para download posterior. Guarde o original no seu lado se a sua política interna exigir.
- Pode confiar na trilha: para reconstruir "o que aconteceu com esta cobrança", a combinação auditoria + execuções + notificações + versões responde sem depender de logs seus.