Guia de início

Para quem vai operar o primeiro piloto no app.kroz.co: financeiro, tesouraria ou comercial.

Antes de começar

Reserve uns 10 minutos para ler e meia hora para mexer no demo. Você entende o layout e a ordem dos módulos antes de criar cobrança de verdade.

O que é a kroz

A kroz é a infraestrutura de recebíveis imobiliários da V.EVO. Quando o comprador paga uma parcela (PIX ou boleto), o valor já chega repartido entre SPE, terrenista e força de vendas. Não passa por conta-bolsão da incorporadora.

Pix, boleto e subcontas ficam com a instituição de pagamento parceira. Você comanda tudo na mesa, com regra clara e trilha de auditoria.

A regra de ouro

Pagador compra. Recebedor recebe.

• Recebedor entra no split. Ao cadastrar, você ganha o walletId para a matriz.
• Pagador é o comprador da unidade. Vai na cobrança, nunca na Oficina de Recebedores.

Se o comprador aparecer como recebedor, pare. Esse é o erro mais comum no primeiro dia.

Três coisas que a kroz não abre mão

1. Split na origem: repasse na liquidação, não em planilha depois.
2. Recebedor identificado: cada parte com subconta na IP (RC 16).
3. Regra versionada: o contrato vira matriz com hash e histórico.

Vale ler Conceitos antes de operar. A terminologia alinha o time em minutos.

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 cobrança 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 parceiro 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 do parceiro 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

Na prática

• ✅ 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