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 exceções e decida como tratá-las.
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,weeklyouon-demand.
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.
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 campodate do Matcher.
Cada transação deve fornecer pelo menos quatro campos depois do mapeamento:
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
- Prioridade 1: regra Exata em valor, moeda e data. Isso pega todas as correspondências perfeitas primeiro.
- 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.
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 fixos deles. 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.
Resolva as exceções
Severidade das exceções
O Matcher classifica cada exceção por severidade com base no valor e na idade dela. O valor é o valor absoluto do valor base da transação ou, quando ela não tem valor base, do valor dela. Para um item em aberto envelhecido, é o valor absoluto do saldo em aberto.
O Matcher limita uma exceção
FEE_DATA_MISSING a Média.
Opções de resolução
- Forçar correspondência: marque a transação como conciliada e resolva a exceção. A ação recebe apenas
overrideReasonenotese não pareia a transação com nenhuma contraparte. Para parear transações, crie uma correspondência manual comPOST /v1/matching/manual. - 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: registre uma passagem manual da exceção na trilha de auditoria dela. Essa ação dirigida pelo chamador não muda o status dela.
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, intervalodaily - 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)
- O financeiro envia o extrato bancário e a exportação do ledger.
- O Matcher roda um dry run. A prévia mostra 95% das transações conciliadas com confiança alta.
- O time revisa a prévia e faz o commit dos resultados.
- Cinco transações continuam como exceções: duas têm pequenas diferenças de tarifa, três não têm contraparte.
- 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
Conheça em detalhe 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 exceções.