kroz docs
Conciliação
Quando o valor pago não bate com o esperado, o diretor financeiro decide. Cada aprovação fica registrada.
Em resumo
Quando o valor pago (BaaS) ≠ valor esperado (ERP), a kroz gera uma sugestão de conciliação com split recalculado. Nada é executado no banco sem decisão humana do Diretor Financeiro (DF).
Menu: Operação → Conciliação (/conciliacao/)
Badge: Aprovação humana
Fluxo operacional
Webhook BaaS → Agente + motor → Aprovação DF → Execução
| Etapa | O que acontece | Status na UI |
|---|---|---|
| 1. Webhook BaaS | Valor pago ≠ ERP | Valor pago ≠ ERP |
| 2. Agente + motor | Split determinístico recalculado | Split determinístico |
| 3. Aprovação DF | Você decide aqui | Ativo |
| 4. Execução | BaaS manual* | Pós-aprovação |
*Em demo: execução parceiro BaaS é manual após aprovação. Em produção: evoluirá para execução controlada com trilha.
Copy do painel:
Após aprovar, o split não é enviado automaticamente para a parceiro BaaS. O time de tesouraria executa manualmente com base na sugestão aprovada e na trilha de governança.
Painel principal
Métricas (topo)
| Card | Significado |
|---|---|
| Sugestões pendentes | Aguardando DF |
| Alta confiança | Encargos conferem |
| Bloqueadas | Sem contexto ERP |
| Volume em fila | Soma R$ dos itens pendentes |
Toolbar
| Controle | Função |
|---|---|
| Pendentes / Histórico | Abas da fila |
| Busca | Placeholder: Buscar PS-0421, parcela… |
| Filtros confiança | Todas, Alta, Média, Baixa |
| Atualizar | Refresh da fila |
Analisar uma sugestão
1. Selecionar item na fila
Cada item mostra referência (ex.: PS-0421-P12), confiança e valor.
2. Painel de detalhe
Métricas de divergência
| Campo | Origem |
|---|---|
| Esperado (ERP) | Valor da parcela no contrato |
| Pago (BaaS) | Valor confirmado pelo webhook |
| Diferença | Delta a explicar |
| Atraso | Dias de mora |
Análise do agente
Texto de justificativa, ex.:
Pagamento de R$ 51.250,00 para parcela de R$ 50.000,00. Diferença de R$ 1.250,00 explicada por multa contratual (2%) e juros de mora (1% a.m., 15 dias). Encargos retidos integralmente na SPE; comissões calculadas apenas sobre a base original.
Meta tags
| Tag | Significado |
|---|---|
| Encargos conferem | Multa + juros batem com contrato |
| Multa R$ X | Valor calculado |
| Juros R$ Y | Valor calculado |
| Regra aplicada | ex.: Encargos 100% na SPE |
| Fonte | Motor determinístico ou LLM validado + motor determinístico |
Regras aplicadas (referência)
| Código | Label na UI |
|---|---|
encargos_100_spe_sem_comissao |
Encargos 100% na SPE |
pagamento_a_menor |
Pagamento a menor |
sem_divergencia |
Sem divergência |
divergencia_nao_explicada |
Divergência não explicada |
3. Comparar splits
Dois painéis lado a lado:
| Painel | Conteúdo |
|---|---|
| Split base (sem encargos) | Rateio sobre valor original |
| Split sugerido (pós-divergência) | Rateio sobre valor pago |
Rodapé: Soma verificada: R$ X, centavos fechados ✓
4. Linha do tempo
- Webhook do BaaS registrou pagamento divergente
- Agente + motor geraram sugestão auditável
- Aguardando decisão do Diretor Financeiro ← você está aqui
Aprovar ou rejeitar
Campos obrigatórios
| Campo | Descrição |
|---|---|
| Aprovador (Diretor Financeiro) | Nome completo · vai para trilha |
| Notas (opcional) | Observações para auditoria |
Ações
| Botão | Efeito |
|---|---|
| Aprovar sugestão | Registra decisão, move para Histórico |
| Rejeitar | Registra rejeição com motivo nas notas |
Após aprovação: tesouraria executa manualmente no painel do parceiro BaaS com base na sugestão + Governança.
Filtrar por confiança
| Filtro | Quando priorizar |
|---|---|
| Alta | Encargos conferem · aprovação rápida |
| Média | Revisar justificativa com atenção |
| Baixa | Escalar · possível erro de ERP ou fraude |
| Bloqueadas | Sem contexto ERP · completar cadastro antes |
Modo demonstração
Banner (quando ativo):
Modo demonstração ativo: cenários ilustrativos para apresentação. Dados reais substituem automaticamente quando houver divergências no Supabase.
Ativar: /conciliacao/?demo=1
Cenário demo típico, PS-0421-P12:
| Campo | Valor |
|---|---|
| Esperado | R$ 50.000 |
| Pago | R$ 51.250 |
| Diferença | R$ 1.250 (multa + juros) |
| Confiança | Alta |
| SPE retenção pós-encargos | R$ 37.250 |
Fila vazia
Estado vazio:
Nenhuma divergência na fila. Quando o webhook detectar valor pago ≠ esperado, a sugestão aparece aqui.
Links rápidos: - Abrir pagadoria - Simular rateio - Ver modo demonstração
Integração com outros módulos
flowchart LR
P[Pagadoria] -->|Cobrança| B[BaaS]
B -->|Webhook divergente| C[Conciliação]
C -->|Aprovação DF| G[Governança]
G -->|Trilha| T[Tesouraria / BaaS manual]
| Origem | Destino |
|---|---|
| Cobrança emitida | Pagadoria |
| Split base | Matriz de rateio |
| Decisão registrada | Auditoria e prova |
| Webhook | Webhooks (fase 3) |
Na prática
- ✅ Priorize fila Alta confiança no fechamento diário
- ✅ Preencha Aprovador com nome real, exigência de auditoria
- ✅ Use Notas para contexto (ex.: "acordo comercial #123")
- ✅ Após aprovar, confira evento na Governança
- ❌ Não aprovar Baixa confiança sem investigar ERP
- ❌ Não assumir execução automática, tesouraria age manualmente hoje
- ❌ Não ignorar Bloqueadas, falta contexto de contrato
Troubleshooting
| Problema | Causa | Solução |
|---|---|---|
| Fila sempre vazia (prod) | Pagamentos batem com ERP | Normal · conciliação só em divergência |
| Item bloqueado | Contrato não no Supabase | Cadastrar contrato / seed |
| Soma não fecha | Bug ou arredondamento | Verificar centavos fechados ✓ |
| Demo não aparece | Param ausente | ?demo=1 |
| Aprovação sem efeito | Execução manual pendente | Acionar tesouraria |
Relacionado
- Conceitos, Conciliação
- Cobranças, origem da cobrança
- Auditoria e prova, trilha pós-decisão
- Compliance, RC 16 e subprocessadores