kroz docs
Perguntas frequentes
Respostas rápidas para o que mais aparece no piloto. Se não achar aqui, escreva para contato@kroz.co.
Em resumo
Esta página junta dúvidas de CFO, tesouraria e time comercial que costumam surgir antes ou durante o primeiro contrato no app. Para o passo a passo completo, use o Guia de início.
Primeiro contrato
Preciso cadastrar empreendimento antes de tudo?
Não existe tela de cadastro de obra hoje. Você configura o deal em Rateio → Ajustar deal ou carrega um contrato que já está no backend (Pagadoria → Carregar matriz). No demo, o contrato PS-0421 já vem pronto.
Ver Contratos e unidades.
Por onde começo no app?
Ordem que funciona: Recebedores → Rateio → Fechamento → Pagadoria → Conciliação → Governança. Pular etapa costuma gerar erro na cobrança ou split inconsistente.
Ver o fluxo na homepage ou o Guia de início.
O que é dry-run e quando posso sair dele?
Dry-run significa que nada vai para a instituição de pagamento de verdade. Você valida payload, percentuais e recebedores com segurança. Só desligue depois do Fechamento aprovado e com alinhamento do time kroz no piloto.
Ver Conceitos · Recebedor e subconta.
Pagador e recebedor
Por que o comprador não pode ser recebedor?
Pagador compra. Recebedor recebe. O comprador gera link de pagamento; quem entra no split[] precisa de subconta identificada (RC 16). Misturar os dois quebra compliance e o repasse.
Ver Conceitos · Pagador vs recebedor.
Onde acho o walletId?
Na Oficina de Recebedores, depois de validar o recebedor em dry-run. É o identificador que entra no array split[] da matriz. Sem walletId validado, o rateio não fecha.
Ver Guia · Passo 1.
Matriz e cobrança
A matriz não fecha em 100%. O que faço?
Confira os percentuais dos recebedores externos. A SPE emissora fica com o remainder automático. Se externos passarem de 100%, o app avisa em amarelo. Corrija antes de Validar rateio.
Ver Matriz de rateio.
Gerei cobrança e apareceu "contrato não encontrado"
Quase sempre falta Carregar matriz na Pagadoria antes de emitir. Informe a referência (ex.: PS-0421) e clique o botão antes de escolher tipo e valor.
Ver Cobranças · Carregar matriz.
Qual a diferença entre sinal, entrada e parcela?
São tipos de cobrança com regras comerciais diferentes no contrato. Na UI, escolha o tipo em Pagadoria; o split da matriz vale para todos, mas o rótulo e o fluxo comercial mudam.
Ver Cobranças · Tipos.
Conciliação e governança
Por que a fila de conciliação está vazia?
Em produção, a fila só enche quando há divergência entre o que entrou e o que o ERP esperava. Se tudo bate, fila vazia é normal. No modo demo, cenários ilustrativos aparecem para treino.
Ver Conciliação.
Quem aprova uma divergência?
O Diretor Financeiro (campo Aprovador). A decisão vai para a trilha de auditoria. Hoje a execução no BaaS após aprovação ainda é manual na tesouraria.
Ver Auditoria e prova.
Onde fica a prova para auditoria?
Em Governança e na aba Atividade do Rateio. Exporte evidência com hash da matriz selada, eventos e decisões de conciliação.
Integração e piloto
Posso integrar meu ERP agora?
O app já opera com contratos no backend e matriz versionada. Integração API completa sai no onboarding do piloto. Escreva para contato@kroz.co com o cenário (ERP, volume, BaaS).
Ver resumo em Desenvolver.
A documentação técnica completa está aqui?
Não. O que está em Desenvolver é resumo público. OpenAPI, webhooks detalhados e credenciais de homologação saem com o time kroz no piloto.
Ainda com dúvida?
- Operação no app: Guia de início
- Termos e RC 16: Compliance
- Suporte: contato@kroz.co