> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # O que é o Matcher? > Conheça o Matcher, o motor de conciliação da Lerian que automatiza a correspondência de transações, a pontuação de confiança, o roteamento de exceções e as trilhas de auditoria para compliance. O **Matcher** é o motor de conciliação (O processo de comparar dois conjuntos de registros, por exemplo, seu ledger interno com extratos bancários, para verificar se coincidem e sinalizar divergências.) da Lerian que automatiza a conciliação de transações entre quaisquer fontes de dados: sistemas internos, bancos, processadores de pagamento, ERPs (Enterprise Resource Planning, software de gestão empresarial (SAP, Oracle, NetSuite) que integra processos de contabilidade, compras e estoque.) ou gateways de pagamento. O Matcher está disponível para instituições licenciadas. A Lerian mantém o repositório dele internamente. Você configura as regras de correspondência uma vez. O Matcher cuida do trabalho repetitivo: fazer a correspondência das transações, sinalizar divergências e manter trilhas de auditoria para compliance. ## Por que usar o Matcher *** Toda instituição financeira concilia transações, comparando registros internos com extratos bancários, processadores de pagamento e ERPs. A maioria faz isso à mão, em planilhas. Isso não escala: a correspondência leva horas, erros passam despercebidos e o fechamento do mês vira um estresse. O Matcher resolve isso: * **Automatizar a correspondência**: configure as regras uma vez e deixe o sistema cuidar das correspondências de rotina * **Saber no que confiar**: as pontuações de confiança mostram quais correspondências são sólidas e quais precisam de revisão * **Manter o compliance**: um log de auditoria append-only registra as mudanças de configuração e as resoluções de exceções ## O que o Matcher faz *** * **Correspondência automática**: aplique as suas regras de correspondência. Receba pontuações de confiança (0-100) para cada correspondência * **Várias fontes**: concilie entre bancos, ERPs, processadores de pagamento e ledgers, todos de uma vez se precisar * **Gestão de exceções**: os itens não conciliados são classificados, atribuídos e acompanhados até a resolução * **Auditoria de mudanças**: uma trilha de auditoria (Um registro cronológico e imutável de cada ação e transação no sistema, essencial para conformidade regulatória e resolução de disputas.) append-only registra as mudanças de configuração e as resoluções de exceções ### Recursos de correspondência * **Correspondência exata**: faça a correspondência de transações por ID, valor, data e atributos personalizados * **Correspondência por tolerância**: permita variação controlada nos valores, definida em valores absolutos ou percentuais * **Correspondência por intervalo de datas**: trate diferenças de tempo com janelas de data configuráveis * **Suporte multimoeda**: concilie transações entre moedas com tratamento de taxa de câmbio * **Correspondência com divisão e agregação**: aceita relações de transação 1:N, N:1 e N:M * **Pontuação de confiança**: atribua uma pontuação de 0–100 que indica a confiabilidade da correspondência * **Modo dry run**: veja o resultado da correspondência antes de confirmar as mudanças * **Ajustes**: registre um lançamento de balanceamento, como uma tarifa bancária ou uma diferença de câmbio, em um grupo de correspondência ou em uma transação ### Ingestão de dados * Importe dados em formato **CSV**, **JSON**, **XML** ou **ISO 20022 camt.053**, além de um catálogo de layouts regionais (CNAB, OFX, arquivos EDI de adquirentes). Veja [Formatos e templates](https://docs.lerian.studio/pt/products/matcher/imports/matcher-import-formats.md) * Validação automática e detecção de duplicatas * Mapeamento flexível de campos para fontes de dados heterogêneas * Traga transações por conexões com bancos de dados e APIs REST * Opcional: concilie exportações do Midaz Ledger que você importa como uma fonte `LEDGER` ### Integração com workflows * Receba callbacks de resolução de sistemas externos ## Casos de uso comuns *** > [accordion] Conciliação bancária > > Faça a correspondência dos seus registros internos com os extratos bancários diários. Suba os CSVs, mapeie os campos e rode a correspondência. Revise as exceções em que o banco e os seus sistemas não batem. > [accordion] Processadores de pagamento > > Concilie liquidações da Stripe ou da Adyen com o seu ledger ou ERP. Trate divisões (um pagamento, várias faturas) e agregações (vários pagamentos, um depósito) automaticamente. > [accordion] Bandeiras de cartão > > Faça a correspondência dos arquivos de liquidação da Visa, da Mastercard ou da Elo com os seus registros de transação. As regras de tolerância tratam as variações de tarifa e as diferenças de tempo entre autorização e liquidação. > [accordion] Conciliação de adquirência (Interchange Plus) > > Concilie transações de adquirência com estruturas de taxas complexas. Trate taxas por MCC, variações de tipo de transação e modelos Interchange Plus em que as taxas mudam conforme o tipo de cartão, o segmento do estabelecimento e o método da transação. > [accordion] Sincronização com ERP > > Verifique transações do SAP, do Oracle ou do NetSuite contra os seus outros sistemas. Encontre divergências antes do fechamento do mês ou das auditorias. ## Como o Matcher funciona *** **1. Configurar** Defina o que você concilia (contextos), de onde vêm os dados (fontes) e como fazer a correspondência (regras). **2. Ingerir** Suba arquivos ou puxe os dados automaticamente. O Matcher valida, normaliza e remove as duplicatas de tudo. **3. Corresponder** Rode uma execução de correspondência. O Matcher aplica as suas regras e atribui pontuações de confiança a cada correspondência proposta. **4. Revisar** O Matcher confirma automaticamente as correspondências `EXACT` e `TOLERANCE` com pontuação 90 ou acima. O Matcher nunca confirma automaticamente uma correspondência `FUZZY` ou `DATE_LAG`: ele envia a correspondência para revisão, qualquer que seja a pontuação. Pontuações menores e itens não conciliados vão para a sua fila de revisão. **5. Resolver** Trate as exceções: force uma correspondência, crie um ajuste ou abra uma disputa. **6. Relatar** Exporte relatórios de conciliação. O log de auditoria registra as mudanças de configuração e as resoluções de exceções. ## Integrações com o ecossistema lerian *** O Matcher é um produto independente que pode, opcionalmente, integrar com outros componentes do ecossistema Lerian. | Produto | Integração | | - | - | | [Midaz](https://docs.lerian.studio/pt/products/midaz/about-midaz.md) | Opcional: concilie dados exportados do Ledger (O livro financeiro central que registra todas as transações, saldos e operações de uma organização. É a fonte única de verdade para as finanças de uma unidade de negócio.) que você importa como uma fonte `LEDGER` | > [!NOTE] > > O Matcher funciona de forma independente ou como parte do ecossistema Lerian Studio. Use-o sozinho ou conecte-o ao Midaz e a outros componentes financeiros conforme a necessidade. ## Acesso *** O Matcher concede os papéis de cliente dele a estes grupos do [Access Manager](https://docs.lerian.studio/pt/platform/access-manager.md): | Grupo | Papel | Acesso | | - | - | - | | `matcher-viewer-group` | `viewer` | Leitura, exceto conexões de fonte de dados. | | `matcher-analyst-group` | `analyst` | Leitura como `viewer`, atribuir exceções, comentar nelas e criar exportações. | | `matcher-operator-group` | `operator` | Tudo o que um `analyst` pode fazer, mais importar arquivos, executar a conciliação, criar correspondências manuais e ajustes, confirmar e desfazer grupos de correspondência, resolver e despachar exceções, e gerenciar disputas, credenciais de callback e conexões de agregador. | | `matcher-config-manager-group` | `config-manager` | Leitura e gestão da configuração: contextos, fontes, mapas de campos, regras de correspondência, regras de tarifa, tabelas de tarifas e agendamentos. | | `matcher-auditor-group` | `auditor` | Leitura de relatórios, jobs de exportação, logs de auditoria e arquivos, e download de exportações e arquivos. | | `matcher-admin-group` | `admin` | Tudo o que está acima, mais gerenciar mapeamentos de atores, incluindo a identidade em texto claro de um ator. | | `matcher-deanonymizer-group` | `deanonymizer` | Leitura da identidade em texto claro de um ator. | > [!NOTE] > > O Matcher lê uma chave de idempotência apenas do header `X-Idempotency`, e apenas quando você envia uma. O Matcher não usa uma chave que você envia em `X-Idempotency-Key` ou `Idempotency-Key`. ## Próximos passos *** > [card] [Conceitos principais](https://docs.lerian.studio/pt/products/matcher/matcher-concepts.md) > > Entenda os conceitos principais: contextos, fontes, regras, correspondências e exceções. > [card] [Arquitetura](https://docs.lerian.studio/pt/products/matcher/matcher-architecture.md) > > Explore a arquitetura e o fluxo de dados do Matcher. > [card] [Início rápido](https://docs.lerian.studio/pt/products/matcher/getting-started/matcher-quick-start.md) > > Rode a sua primeira conciliação e depois revise correspondências e exceções com confiança. > [card] [Regras de correspondência](https://docs.lerian.studio/pt/products/matcher/configuration/matcher-match-rules.md) > > Aprenda a configurar regras de correspondência exatas, por tolerância e por data. > [!TIP] > > [Explore a API do Matcher](https://docs.lerian.studio/pt/reference/products/matcher/matcher-developer-quick-start.md). Navegue pelos endpoints de contextos de conciliação, fontes e regras de correspondência. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.