kroz docs

Conceitos

A linguagem comum para configurar, aprovar, cobrar, conciliar e provar uma operação.

Pagador e recebedor

Pagador compra. Recebedor recebe.

O pagador é responsável por quitar a cobrança. O recebedor é uma parte habilitada a participar da distribuição do valor.

Uma mesma operação pode envolver um pagador e vários recebedores. Os papéis não devem ser confundidos, mesmo quando todos aparecem no mesmo contrato.


Organização, empreendimento, contrato e unidade

Conceito Função
Organização Delimita o contexto autorizado da operação
Empreendimento Agrupa contratos e unidades relacionados ao ativo
Contrato Registra a relação comercial e as regras aplicáveis
Unidade Identifica o objeto específico da operação

Essas referências acompanham a cobrança, a matriz, a conciliação e a evidência.


Recebedor habilitado

Um recebedor habilitado passou pelas validações necessárias para participar de uma distribuição.

A habilitação confirma:

  • identidade da parte;
  • papel no contrato;
  • dados exigidos para o recebimento;
  • estado apto informado pela camada financeira;
  • vínculo correto com a organização.

Um cadastro incompleto não deve ser usado em uma matriz aprovada.


Matriz de rateio

A matriz traduz o contrato em uma distribuição verificável.

Ela relaciona:

  • recebedores;
  • percentuais ou valores;
  • condições comerciais;
  • vigência;
  • versão aprovada;
  • regra para eventuais diferenças de arredondamento.

A soma precisa respeitar a regra do contrato e fechar em centavos.


Condição e gatilho

Uma condição determina quando uma regra se aplica. Exemplos incluem número da parcela, vencimento, marco contratual ou aprovação prévia.

Um gatilho deve ser objetivo, explicável e testável. Texto livre e condições ambíguas aumentam o risco de divergência.


Fechamento

O Fechamento é a barreira de controle antes da execução.

Ele confirma que:

  • o contrato está correto;
  • os recebedores estão habilitados;
  • a matriz foi validada;
  • as condições foram compreendidas;
  • a aprovação foi registrada;
  • a evidência pode ser recuperada.

Validação e aprovação são etapas diferentes. Uma simulação válida ainda não autoriza movimentação real.


Cobrança e liquidação

A cobrança reúne pagador, valor, vencimento, meio de pagamento e referência do contrato.

A liquidação é a confirmação financeira do pagamento e de seu resultado. Ela deve ser comparada com a cobrança e a matriz esperadas.


Conciliação

Conciliação é o processo de resolver diferenças entre o esperado e o realizado.

Uma diferença pode envolver valor, data, estado, contrato, recebedor ou distribuição. Quando a política exigir, a decisão final é humana e deve ser registrada.


Governança e evidência

Governança responde:

  • quem realizou ou aprovou uma ação;
  • qual regra e versão foram usadas;
  • o que mudou;
  • qual foi o resultado;
  • como a decisão pode ser provada.

Uma evidência deve preservar contexto, tempo, responsável e correlação com a operação.


Modos de operação

Modo Significado
Homologação Ambiente separado para validar integração e processo
Modo seguro Preparação e avaliação sem efeito financeiro real
Aprovado Decisão registrada, ainda sujeita ao fluxo de execução aplicável
Produção Operação real, com credenciais, limites e controles próprios

Continue