> ## 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.

export const GWebhook = ({children}) => <Tooltip headline="Webhook" tip="Uma notificação automática enviada de um sistema para outro quando um evento específico ocorre, por exemplo, alertando sua equipe quando uma exceção de conciliação é encontrada." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GSOX = ({children}) => <Tooltip headline="SOX" tip="Sarbanes-Oxley Act, uma lei dos EUA que exige padrões rígidos de registro financeiro e auditoria, exigindo trilhas de auditoria imutáveis e relatórios precisos." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GERP = ({children}) => <Tooltip headline="ERP" tip="Enterprise Resource Planning, software de gestão empresarial (SAP, Oracle, NetSuite) que integra processos de contabilidade, compras e estoque." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GAuditTrail = ({children}) => <Tooltip headline="Trilha de auditoria" tip="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." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GLedger = ({children}) => <Tooltip headline="Ledger" tip="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." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GReconciliation = ({children}) => <Tooltip headline="Conciliação" tip="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." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

O **Matcher** é o motor de <GReconciliation>conciliação</GReconciliation> da Lerian que automatiza a conciliação de transações entre quaisquer fontes de dados: sistemas internos, bancos, processadores de pagamento, <GERP>ERPs</GERP> ou gateways de pagamento. O Matcher está disponível para clientes licenciados. 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
* **Rotear exceções**: envie itens não conciliados para o JIRA, o ServiceNow ou as suas próprias ferramentas via <GWebhook>webhooks</GWebhook>
* **Manter o compliance**: cada correspondência e resolução fica registrada de forma imutável para auditorias

## O que o Matcher faz

***

* **Correspondência automática**: aplique regras exatas ou baseadas em tolerâ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, roteados para o seu time e acompanhados até a resolução
* **Auditoria de tudo**: logs imutáveis e relatórios prontos para <GSOX>SOX</GSOX> no compliance, uma <GAuditTrail>trilha de auditoria</GAuditTrail> completa

### 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

### 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](/pt/products/matcher/imports/matcher-import-formats)
* Validação automática e detecção de duplicatas
* Mapeamento flexível de campos para fontes de dados heterogêneas
* Opcional: concilie exportações do Midaz Ledger pelo tipo de fonte `LEDGER`

### Integração com workflows

* Roteie exceções para o **JIRA** ou o **ServiceNow**
* Emita eventos por **webhooks** para integrações personalizadas
* Receba callbacks de resolução de sistemas externos
* Acompanhe SLAs e escale as violações automaticamente

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Como o Matcher funciona

***

<Steps>
  <Step title="Configurar">
    Defina o que você concilia (contextos), de onde vêm os dados (fontes) e como fazer a correspondência (regras).
  </Step>

  <Step title="Ingerir">
    Suba arquivos ou puxe os dados automaticamente. O Matcher valida, normaliza e remove as duplicatas de tudo.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Revisar">
    O Matcher confirma automaticamente as correspondências de alta confiança (pontuação 90 ou acima), mas não as difusas nem as com defasagem de data. Essas sempre vão para revisão. Pontuações menores e itens não conciliados vão para a sua fila de revisão.
  </Step>

  <Step title="Resolver">
    Trate as exceções: force uma correspondência, crie um ajuste, divida transações ou roteie para JIRA/ServiceNow.
  </Step>

  <Step title="Relatar">
    Exporte relatórios de conciliação. O Matcher registra cada ação de forma imutável para auditorias.
  </Step>
</Steps>

## 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](/pt/products/midaz/about-midaz)            | Opcional: concilie dados exportados do <GLedger>Ledger</GLedger> pelo tipo de fonte `LEDGER` |
| [Reporter](/pt/products/reporter/what-is-reporter) | Opcional: relatórios de conciliação e resumos de auditoria                                   |
| [Flowker](/pt/products/flowker/what-is-flowker)    | Opcional: workflows de conciliação orientados a eventos                                      |

<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.
</Note>

<Note>
  Todos os endpoints de escrita do Matcher (POST, PUT, PATCH) trazem idempotência nativa pelo header de requisição `X-Idempotency-Key`. Para detalhes, veja [Novas tentativas e idempotência](/pt/reference/retries-idempotency).
</Note>

## Próximos passos

***

<Card title="Conceitos principais" icon="book" href="/pt/products/matcher/matcher-concepts" horizontal>
  Entenda os conceitos principais: contextos, fontes, regras, correspondências e exceções.
</Card>

<Card title="Arquitetura" icon="sitemap" href="/pt/products/matcher/matcher-architecture" horizontal>
  Explore a arquitetura e o fluxo de dados do Matcher.
</Card>

<Card title="Início rápido" icon="rocket" href="/pt/products/matcher/getting-started/matcher-quick-start" horizontal>
  Rode a sua primeira conciliação e depois revise correspondências e exceções com confiança.
</Card>

<Card title="Regras de correspondência" icon="scale-balanced" href="/pt/products/matcher/configuration/matcher-match-rules" horizontal>
  Aprenda a configurar regras de correspondência exatas, por tolerância e por data.
</Card>

<Tip>
  [Explore a API do Matcher](/pt/reference/products/matcher/matcher-developer-quick-start). Navegue pelos endpoints de contextos de conciliação, fontes e regras de correspondência.
</Tip>