Skip to main content
Este guia percorre o ciclo de vida da conciliação no Matcher, da configuração inicial à revisão dos resultados. Ele foca nos conceitos e nas decisões de cada estágio. Para instruções passo a passo da API com exemplos de requisição e resposta, veja o início rápido da API do Matcher.

​
O ciclo de vida da conciliação

Cada conciliação no Matcher segue o mesmo ciclo de vida de cinco estágios:
1

Defina o escopo

Crie um contexto que descreve o que você concilia e registra o intervalo de conciliação dele.
2

Conecte as fontes

Registre os sistemas cujas transações você quer comparar.
3

Defina as regras

Configure os critérios que o Matcher usa para parear transações.
4

Rode a correspondência

Envie os dados e deixe o Matcher achar os pares, começando por uma prévia antes do commit.
5

Resolva as exceções

Revise as transações não conciliadas e decida como tratá-las.
As seções abaixo explicam cada estágio.

​
Defina o escopo com um contexto

Um contexto é o contêiner de nível mais alto de um workflow de conciliação. Ele responde três perguntas:
  • O que você concilia? Por exemplo, uma conta bancária contra seu razão geral.
  • Qual tipo de pareamento? Um para um, um para muitos ou muitos para muitos.
  • Qual rótulo de intervalo descreve o período de conciliação? Por exemplo, daily, weekly ou on-demand.
O valor obrigatório interval é metadado de texto livre. Ele não agenda execução. As execuções automáticas usam um ReconciliationSchedule separado, apoiado em cron, com cadência mínima de cinco minutos. A maioria das conciliações começa com 1:1. Você pode mudar o tipo de pareamento depois, conforme seu processo evolui.
Referência da API:

​
Conecte as fontes de dados

Cada contexto precisa de pelo menos duas fontes: os sistemas cujos dados de transação você quer comparar. Uma fonte representa um único feed de dados, como um extrato bancário, uma exportação de ledger ou um arquivo de gateway de pagamento.

​
Tipos de fonte

​
Mapeamento de campos

Arquivos de transações de sistemas diferentes raramente usam os mesmos nomes de coluna. Os mapas de campo traduzem as colunas da sua fonte para o schema padrão do Matcher, para que as transações possam ser comparadas. Por exemplo, um arquivo de banco pode chamar a data da transação de “Post Date”, enquanto seu ledger a chama de “posting_date”. Os mapas de campo normalizam as duas para o campo date do Matcher. Cada transação deve fornecer pelo menos quatro campos depois do mapeamento:
Referência da API: Criar fonte | Criar mapa de campo

​
Defina as regras de correspondência

As regras definem como o Matcher decide se duas transações são a mesma. Você pode empilhar várias regras com prioridades diferentes. O Matcher as avalia em ordem: apenas as transações que a primeira regra deixou não conciliadas passam para a próxima.

​
Tipos de regra

​
Configuração inicial recomendada

  1. Prioridade 1: regra Exata em valor, moeda e data. Isso pega todas as correspondências perfeitas primeiro.
  2. Prioridade 10: regra de Tolerância com uma pequena tolerância de valor (por exemplo, 1%) e uma janela de datas de 2 dias. Isso pega correspondências aproximadas causadas por tarifas ou por prazos.
Conforme você observa os resultados ao longo do tempo, ajuste as regras ou adicione novas para melhorar sua taxa de correspondência.
Referência da API: Criar regra de correspondência

​
Rode a correspondência

Depois que as fontes estiverem configuradas e os dados enviados, você pode rodar o motor de correspondência.

​
Primeiro a prévia, depois o commit

O Matcher oferece dois modos de execução: Sempre comece com um dry run. Revise a prévia para verificar a qualidade das correspondências antes do commit.

​
Entenda as pontuações de confiança

Cada correspondência recebe uma pontuação de confiança de 0 a 100: As pontuações derivam dos componentes correspondidos e dos pesos configurados para eles. As regras exata e de tolerância usam o mesmo esquema de pesos. Nenhum dos dois tipos de regra gera pontuações mais altas por natureza.
Referência da API: Rodar correspondência | Listar grupos de execução de correspondência

​
Resolva as exceções

Exceções são transações que o Matcher não conseguiu parear automaticamente. Elas representam os itens que precisam de atenção humana.

​
Severidade das exceções

O Matcher classifica cada exceção por severidade com base no valor da transação e no tempo que ela está não conciliada:

​
Opções de resolução

  • Forçar correspondência: pareie a transação manualmente com uma contraparte quando você souber que as duas pertencem uma à outra.
  • Criar ajuste: registre um lançamento de correção para dar conta da diferença.
  • Desfazer correspondência: se uma correspondência confirmada estiver errada, desfaça-a para que as duas transações voltem ao conjunto não conciliado.
  • Despachar: envie a exceção pela rota de JIRA ou de webhook configurada para ela. Essa ação dirigida pelo chamador não muda o status dela.
Referência da API:

​
Cenário de exemplo

Uma fintech concilia o extrato bancário diário dela com os registros do ledger interno. Configuração:
  • Contexto: “Daily Bank Reconciliation”, tipo 1:1, intervalo daily
  • Duas fontes: extrato do Chase Bank (BANK) e razão geral (LEDGER)
  • Duas regras: correspondência Exata (prioridade 1) e correspondência por Tolerância com 1% e janela de 2 dias (prioridade 10)
Workflow diário:
  1. O financeiro envia o extrato bancário e a exportação do ledger.
  2. O Matcher roda um dry run. A prévia mostra 95% das transações conciliadas com confiança alta.
  3. O time revisa a prévia e faz o commit dos resultados.
  4. Cinco transações continuam como exceções: duas têm pequenas diferenças de tarifa, três não têm contraparte.
  5. O time resolve as exceções de tarifa criando ajustes. As três transações ausentes são escaladas para investigação.

​
Próximos passos

Contextos e fontes

Guia completo para configurar contextos de conciliação.

Regras de correspondência

Aprofundamento em todos os tipos de regra e opções de configuração.

Mapeamento de campos

Mapeie diferentes formatos de arquivo para o schema padrão do Matcher.

Resolução de exceções

Estratégias para tratar transações não conciliadas.