kroz docs
kroz.co Abrir app

Auditoria e prova

Hash, eventos e trilha regulatória. quem decidiu, o que mudou, como provar.

Em resumo

Cada validação de rateio, fechamento aprovado e decisão de conciliação gera evidência auditável. Objetivo: responder com prova documental:

  • Qual matriz estava vigente quando esta parcela liquidou?
  • Quem aprovou a execução?
  • Qual payload foi enviado ao BaaS?

Dois módulos principais:

Módulo Rota Foco
Fechamento /fechamento/ Prova pré-execução (checklist + export)
Governança /governanca/ Livro, trilha e export contínuo

Hero da Governança: Quem decidiu / O que mudou / Como provar

Fechamento: evidência pré-execução

Menu: Operação → Fechamento

Badge: Fechamento seguro

Estágios

Contrato → Recebedores → Rateio → Aprovação → Evidência

Checklist pré-execução (6 itens)

Item Estado demo
Contrato possui referência externa ✅
Recebedor SPE validado ✅
Soma da matriz fecha em 100% ✅
Payload do parceiro BaaS gerado em sandbox ✅
Aceite do terrenista pendente ⚠️
Aprovação da controladoria pendente ⚠️

Itens ⚠️ viram ✅ após Validar fechamento.

Fluxo de ações

# Botão Pré-requisito Resultado
1 Validar fechamento Rateio validado 6/6, status Validado
2 Aprovar execução Fechamento validado Status Aprovado
3 Exportar evidência Fechamento aprovado JSON download

Export de evidência

Arquivo: evidencia-fechamento-ps-0421.json

Estrutura:

{
  "tipo": "kroz.fechamento.evidencia",
  "versao": "2026-06-11",
  "geradoEm": "2026-07-01T...",
  "fechamento": {
    "id": "PS-0421-U1804",
    "empreendimento": "Jardim Oeste Residence",
    "contrato": "PS-0421 | Unidade 1804",
    "valor": 85000,
    "matriz": [ "... SPE 72%, Terrenista 18%, Vendas 10%" ]
  },
  "payload": { "externalReference": "...", "split": [ "..." ], "dryRun": true },
  "trilha": [ "09:22 Payload gerado sem execução financeira.", "..." ]
}

Após export: link Ver evidência na Governança →

Prova selada (Rateio)

No Motor de Rateio, após Validar rateio:

Indicador Valor
Botão Rateio validado (desabilitado)
Status atividade Prova selada
Payload "sealed": true em rule

Eventos na aba Atividade, origem Modo seguro, horário, detalhe.

Backend (roadmap): seal_hash em audit_events + snapshot_hash da rule version.

Governança: livro e trilha

Menu: Operação → Governança

Aba Conteúdo
Visão geral Dashboard tesouraria
Livro Registro cronológico de eventos
Trilha Sequência de decisões
Exportar planilha Download para auditoria

Filtros

Por SPE: Visão Geral, Incorp SPE, Aurora Lotes, Reserva Park

Por situação: Todos, Confirmados, Revisão

Período gráfico: 30 dias, 15 dias, 7 dias

Colunas do livro

Coluna Descrição
Evento ex.: PAYMENT_RECEIVED, SPLIT_RULE_REVIEW
Valor Montante total
SPE Parcela SPE
Terrenista Parcela landbank
Vendas Parcela comercial
Situação Confirmado, Revisão, Falha
Ações Detalhe / export

Eventos típicos

Evento Significado
PAYMENT_RECEIVED Liquidação confirmada
PAYMENT_CONFIRMED Confirmação BaaS
SPLIT_RULE_REVIEW Matriz exige revisão
PAYMENT_OVERDUE Vencimento operacional

Demo mode

/governanca/?demo=1&reference=PS-0421#ledger

Carrega transações demonstrativas (KROZ-AUD-20260530-*).

Deep link pós-Fechamento:

/governanca/?demo=1&reference=PS-0421#ledger

Trilha cross-módulo

Eventos registrados via KrozAudit.track():

Módulo Ações auditadas
Rateio Validação, deal atualizado
Fechamento fechamento_validado, fechamento_aprovado, evidencia_fechamento_exportada
Pagadoria pagadoria_dry_run_ui, pagadoria_cobranca_ui
Conciliação Aprovação/rejeição DF
Recebedores Dry-run, criação subconta

Campos comuns: source, action, status, reference, amount, entityId, payloadSummary.

Captabilidade (Pagadoria)

Export comercial separado da trilha financeira:

  • Exportar captabilidade CSV → kroz-captabilidade.csv
  • Corretor, gerente, imobiliária por cobrança
  • Não substitui evidência de split, complementa atribuição comercial

Responder perguntas de auditoria

Pergunta Onde provar
Qual matriz vigente? Export Fechamento → matriz + payload split[]
Quem aprovou execução? Fechamento → livro → evento fechamento_aprovado
Split na liquidação bateu? Governança → livro → colunas SPE/Terrenista/Vendas
Divergência como resolvida? Conciliação → Histórico + Governança
Payload enviado ao BaaS? Rateio → aba Payload OU Fechamento → Payload resumido

Retenção e acesso

Dado Local Acesso
Evidência JSON Download local + Governança Operadores autenticados
audit_events Supabase (backend) API interna
CSV captabilidade Download Pagadoria Comercial + financeiro

Política de retenção formal, ver Compliance (fase 3).

Na prática

  • ✅ Export evidência a cada fechamento aprovado
  • ✅ Arquive JSON com nomenclatura {contrato}-{data}.json
  • ✅ Cruze Governança com export Fechamento antes de execução real
  • ✅ Preencha Aprovador na Conciliação, alimenta trilha
  • ❌ Não execute cobrança real sem evidência exportada
  • ❌ Não confunda captabilidade CSV com trilha regulatória

Troubleshooting

Problema Solução
Exportar evidência desabilitado Validar fechamento → Aprovar execução primeiro
Livro vazio (prod) Aguardar liquidações reais ou usar ?demo=1
Prova selada ausente Validar rateio no Motor de Rateio
Link Governança não aparece Export evidência primeiro

Relacionado