Guia de início

Para operadores financeiros e comerciais que vão rodar o primeiro piloto em app.kroz.co.

Tenha uma visão geral rápida

Comece aqui se quiser entender o layout e os fluxos principais antes de operar. Tempo estimado: 10 minutos de leitura, 30 minutos hands-on no piloto demo.

O que é a kroz

A kroz é a infraestrutura financeira do mercado imobiliário. Conecta e opera a cadeia ao redor do ativo: projetos e glebas, SPEs e holdings, unidades e lotes, vendas, capital, obrigações, liquidação, distribuição e caixa.

Split e liquidação são capacidades dessa infraestrutura. Quando o pagador quita uma parcela (PIX ou boleto), o valor já pode nascer repartido entre os recebedores certos (SPE, incorporadora, loteador, força de vendas), sem passar por conta-bolsão.

A camada regulada (Pix, boleto, subcontas) fica com parceiro licenciado. Você opera com clareza na mesa de operação.

A regra de ouro

Pagador compra. Recebedor recebe.

• Recebedor só existe quando alguém precisa receber na liquidação: gera walletId para a matriz.
• Pagador / comprador entra como cliente da cobrança, nunca como recebedor.

Confundir pagador com recebedor é o erro mais comum no piloto. Se o comprador aparecer na Oficina de Recebedores, pare e revise.

Como pensar a kroz

A kroz é opinativa em três pontos:

1. Liquidação na origem: o repasse acontece na liquidação, não em batch manual depois.
2. Recebedor identificado: cada parte tem subconta na instituição de pagamento (RC 16).
3. Regra versionada: o contrato comercial vira matriz de rateio com hash e trilha de auditoria.

Antes de operar, leia Conceitos: a terminologia economiza horas de alinhamento.

Entrar no app

1. Acesse a mesa de operação

1. Abra app.kroz.co
2. Na tela kroz // acesso restrito, informe o Código de acesso
3. Clique em Entrar

O conteúdo protegido só é liberado após validação. Se precisar voltar à vitrine, use Voltar para a vitrine.

2. Conheça a navegação

O menu lateral (dock sidebar) organiza a operação em duas faixas:

Atalho global: Ctrl+K → Ir para módulo…

Sequência do piloto (ordem correta)

A kroz ensina esta ordem na Central. Siga-a no primeiro dia:

flowchart LR
    R[Recebedores] --> RT[Rateio]
    RT --> F[Fechamento]
    F --> P[Pagadoria]
    P --> C[Conciliação]
    C --> G[Governança]

Passo a passo: primeiro piloto completo

Passo 1: Cadastrar recebedores

Menu: Operação → Recebedores

Cada parte que recebe split precisa de subconta na instituição de pagamento antes de entrar na matriz.

01 Identificação: Quem vai receber o split?

1. Selecione Tipo de recebedor (Terrenista / permuta, Força de vendas, SPE recebedora, etc.)
2. Preencha CNPJ do recebedor → Consultar
3. Confirme Razão social / Nome do recebedor e Tipo da empresa inferido
4. Preencha E-mail principal, Celular com DDD, Faturamento mensal aproximado

02 Endereço

1. Informe CEP → Buscar
2. Confirme Bairro, Logradouro, Número

03 Operação segura

1. Mantenha Manter em dry-run seguro ativado no piloto
2. Clique Validar Payload (Dry-Run)
3. Revise o payload: mensagem: Dry-run concluído. Revise o payload…

Estado esperado no rail: Rascunho → Pendente → Validado → Pronto

Armadilha: criar recebedor real (Criar Recebedor Real) exige digitar CRIAR SUBCONTA e pode gerar efeito real no BaaS. No piloto, fique no dry-run.

Atalho: Preencher exemplo carrega um recebedor demo para explorar sem digitar tudo.

Passo 2: Configurar o deal e a matriz

Menu: Operação → Rateio

Ajustar o deal

1. Clique Ajustar deal
2. No sheet Origem do deal, preencha:

3. Clique Salvar → toast: Deal atualizado.

Nota importante: empreendimento, unidade e contrato não têm tela de cadastro dedicada hoje. São configurados via Ajustar deal (Rateio), referência + API (Pagadoria) ou seed no backend. No piloto demo, use PS-0421.

Montar o split

1. Clique Recebedores → sheet Split configurado
2. Selecione recebedores já cadastrados na oficina
3. Defina % por recebedor → + Adicionar recebedor se necessário
4. Clique Salvar

Matriz demo padrão: SPE 72% · Landbank 18% · Vendas 10% (CPC 47)

O restante não alocado fica na SPE emissora (remainder automático).

Validar

1. Aba Visão geral: confira percentuais e valores
2. Aba Payload: veja o JSON do BaaS → Copiar JSON
3. Clique Validar rateio → botão vira Rateio validado
4. Status: Rateio validado em modo seguro. + Prova selada

Regra de negócio na UI: parcela < 3 → Comissão de vendas entra na 3ª parcela. Vendas aparece como Suspenso até lá.

Passo 3: Fechar a operação

Menu: Operação → Fechamento

Mesa de validação pré-execução em 5 estágios:

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

1. Revise sub-nav: Visão geral | Matriz | Evidência
2. Clique Validar fechamento: checklist 6/6 (ex.: Soma da matriz fecha em 100%, Payload BaaS gerado em sandbox)
3. Status muda para Validado
4. Clique Aprovar execução → status Aprovado
5. Exportar evidência → JSON + link Ver evidência na Governança →

Passo 4: Gerar a cobrança

Menu: Operação → Pagadoria

01 Qual cobrança gerar?

1. Contrato → ex.: PS-0421
2. Clique Carregar matriz → status: Contrato PS-0421 carregado com matriz v1.
3. SPE emissora aparece readonly
4. Selecione Tipo: Sinal, Entrada, Pré-venda ou Parcela

02 Quem paga e quanto?

03 Quem está na venda? (opcional)

Corretor, Gerente, Imobiliária: campos comerciais. Não alteram o split nem o link de pagamento.

04 Executar

1. Mantenha Executar em modo seguro ativado
2. Clique Gerar cobrança → Pagadoria validada em dry-run.
3. Copiar mensagem para o corretor: texto pronto para WhatsApp
4. Exportar captabilidade CSV: atribuição comercial

Fluxo hero: Contrato carregado → Tipo de cobrança → Split na origem → Mensagem para o corretor

Armadilha: gerar cobrança real exige desativar modo seguro + confirmação tipada no backend. No piloto, valide sempre em dry-run primeiro.

Passo 5: Conciliar (após liquidação)

Menu: Operação → Conciliação

Quando o BaaS confirma pagamento, divergências entram na fila:

Webhook BaaS → Agente + motor → Aprovação DF → Execução

1. Aba Pendentes: filtre por confiança: Alta, Média, Baixa
2. Selecione item → painel de detalhe
3. Aprovador (Diretor Financeiro) + Notas (opcional)
4. Aprovar sugestão ou Rejeitar

Passo 6: Provar na Governança

Menu: Operação → Governança

Hero aside: Quem decidiu / O que mudou / Como provar

1. Sub-nav: Visão geral | Livro | Trilha | Exportar planilha
2. Filtros por SPE e situação (Confirmados, Revisão)
3. Livro: colunas Evento, Valor, SPE, Terrenista, Vendas, Situação
4. Exportar planilha para auditoria externa

Demo em 30 segundos (modo apresentação)

Use na Central para explicar a kroz sem abrir oito telas:

1. Central → card Mostre a operação inteira em 30 segundos
2. Roteiro: Recebedores → Rateio → Fechamento → Governança
3. CTAs dinâmicos: Abrir Recebedores, Simular a matriz, Conferir a trilha

Ideal para alinhar CFO, diretor comercial ou parceiro BaaS antes do hands-on.

Modos de operação

Checklist: piloto pronto?

• [ ] Código de acesso funciona
• [ ] Recebedores validados em dry-run (terrenista + vendas)
• [ ] Deal configurado (PS-0421 ou contrato real)
• [ ] Matriz 100%: soma fecha, SPE como remainder
• [ ] Rateio validado com Prova selada
• [ ] Fechamento 6/6 + Aprovado
• [ ] Cobrança gerada em dry-run na Pagadoria
• [ ] Evidência exportada na Governança
• [ ] Equipe entende Pagador ≠ Recebedor

Boas práticas

• ✅ Sempre Carregar matriz na Pagadoria antes de gerar cobrança
• ✅ Valide payload na aba Payload do Rateio antes de Fechamento
• ✅ Use Sandbox para testar percentuais isolados (SPE/Landbank/Vendas)
• ✅ Exporte evidência a cada fechamento aprovado
• ❌ Não cadastre comprador como recebedor
• ❌ Não desative dry-run sem Fechamento aprovado
• ❌ Não assuma que empreendimento/contrato existem: configure via Ajustar deal

Estrutura desta documentação

Próximos passos

• Matriz de rateio: how-to detalhado
• Cobranças (Pagadoria): tipos e dry-run
• Conciliação: fila do Diretor Financeiro
• Auditoria e prova: export de evidência