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

> Descubra como o motor de conciliação da Lerian automatiza o matching de transações, o tratamento de exceções e as trilhas de auditoria.

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 reconciliação é encontrada." cta="Ver glossário" href="/pt/glossary">
    {children}
  </Tooltip>;

export const GSOX = ({children}) => <Tooltip headline="SOX" tip="Lei Sarbanes-Oxley — uma lei americana que exige padrões rigorosos de registro financeiro e auditoria, requerendo trilhas de auditoria imutáveis." cta="Ver glossário" href="/pt/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 inventário." cta="Ver glossário" href="/pt/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/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/glossary">
    {children}
  </Tooltip>;

export const GReconciliation = ({children}) => <Tooltip headline="Reconciliação" tip="O processo de comparar dois conjuntos de registros — por exemplo, seu ledger interno contra extratos bancários — para verificar se correspondem e sinalizar discrepâncias." cta="Ver glossário" href="/pt/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; seu repositório é mantido internamente.

Você configura as regras de matching uma vez. O Matcher cuida do trabalho repetitivo—conciliando transações, sinalizando discrepâncias e mantendo <GAuditTrail>trilhas de auditoria</GAuditTrail> para compliance.

## Por que usar o Matcher

***

Toda instituição financeira precisa garantir que seus registros internos batem com os extratos de bancos, processadores de pagamento e ERPs. Quando esse processo é manual, equipes gastam horas em planilhas, erros passam despercebidos e o fechamento mensal vira um gargalo.

A conciliação manual não escala. Planilhas falham, o matching leva horas, e você perde visibilidade sobre o que está conciliado versus o que está pendente.

O Matcher resolve isso:

* **Automatize o matching**: Configure as regras uma vez, deixe o sistema cuidar das conciliações rotineiras
* **Saiba o que é confiável**: Scores de confiança indicam quais matches são sólidos e quais precisam de revisão
* **Roteie exceções**: Envie itens não conciliados para JIRA, ServiceNow ou suas próprias ferramentas via <GWebhook>webhooks</GWebhook>
* **Mantenha compliance**: Cada match e resolução é registrado de forma imutável para auditorias

## O que o Matcher faz

***

* **Match automático**: Aplique regras exatas ou baseadas em tolerância. Obtenha scores de confiança (0-100) para cada match
* **Múltiplas fontes**: Concilie entre bancos, ERPs, processadores de pagamento, ledgers—tudo de uma vez se necessário
* **Gerenciamento de exceções**: Itens não conciliados são classificados, roteados para sua equipe e rastreados até serem resolvidos
* **Auditoria completa**: Logs imutáveis e relatórios prontos para <GSOX>SOX</GSOX> para compliance

### Funcionalidades de matching

* **Matching exato**: Concilie transações por ID, valor, data e atributos customizados
* **Matching por tolerância**: Permita variância controlada em valores, definida como valores absolutos ou percentuais
* **Matching por intervalo de datas**: Lide com diferenças de timing usando janelas de data configuráveis
* **Suporte multi-moeda**: Concilie transações em diferentes moedas com tratamento de taxas de câmbio
* **Matching split e agregado**: Suporte para relacionamentos de transações 1:N, N:1 e N:M
* **Score de confiança**: Atribua uma pontuação de 0–100 indicando a confiabilidade do match
* **Modo dry run**: Visualize os resultados do matching antes de confirmar as alterações

### Ingestão de dados

* Importe dados nos formatos **CSV**, **JSON** ou **XML**
* Validação automática e detecção de duplicatas
* Mapeamento flexível de campos para fontes de dados heterogêneas
* Opcional: Acesso nativo às transações do Midaz Ledger

### Integração com workflows

* Roteie exceções para **JIRA** ou **ServiceNow**
* Emita eventos através de **webhooks** para integrações customizadas
* Receba callbacks de resolução de sistemas externos
* Rastreie SLAs e escale automaticamente violações

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="Conciliação bancária">
    Concilie seus registros internos com extratos bancários diários. Faça upload de CSVs, mapeie campos, execute o matching. Revise exceções onde o banco e seus sistemas não se alinham.
  </Accordion>

  <Accordion title="Processadores de pagamento">
    Concilie liquidações do Stripe ou Adyen com seu ledger ou ERP. Lide com splits (um pagamento, várias faturas) e agregações (vários pagamentos, um depósito) automaticamente.
  </Accordion>

  <Accordion title="Bandeiras de cartão">
    Concilie arquivos de liquidação da Visa, Mastercard ou Elo com seus registros de transações. Regras de tolerância lidam com variações de taxas e diferenças de timing 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. Lide com taxas baseadas em MCC, variações de tipo de transação e modelos Interchange Plus onde as taxas variam por tipo de cartão, segmento de merchant e método de transação.
  </Accordion>

  <Accordion title="Sincronização com ERP">
    Verifique transações do SAP, Oracle ou NetSuite contra seus outros sistemas. Detecte discrepâncias antes do fechamento mensal ou auditorias.
  </Accordion>
</AccordionGroup>

## Como o Matcher funciona

***

<Steps>
  <Step title="Configure">
    Defina o que você está conciliando (contextos), de onde os dados vêm (fontes) e como fazer o matching (regras).
  </Step>

  <Step title="Ingira">
    Faça upload de arquivos ou puxe dados automaticamente. O Matcher valida, normaliza e deduplica tudo.
  </Step>

  <Step title="Concilie">
    Execute um job de matching. O Matcher aplica suas regras e atribui scores de confiança a cada match proposto.
  </Step>

  <Step title="Revise">
    Matches de alta confiança (>90%) são aprovados automaticamente. Scores mais baixos e itens não conciliados vão para sua fila de revisão.
  </Step>

  <Step title="Resolva">
    Trate as exceções: force um match, crie um ajuste, divida transações ou roteie para JIRA/ServiceNow.
  </Step>

  <Step title="Reporte">
    Exporte relatórios de conciliação. Cada ação é registrada de forma imutável para auditorias.
  </Step>
</Steps>

## Integrações com o ecossistema Lerian

***

O Matcher é um produto standalone que pode opcionalmente se integrar com outros componentes do ecossistema Lerian.

| Produto                                   | Integração                                                                          |
| ----------------------------------------- | ----------------------------------------------------------------------------------- |
| [Midaz](/pt/midaz/about-midaz)            | Opcional: Acesso direto às transações do <GLedger>Ledger</GLedger> para conciliação |
| [Reporter](/pt/reporter/what-is-reporter) | Opcional: Relatórios de conciliação e resumos de auditoria                          |
| [Flowker](/pt/flowker/what-is-flowker)    | Opcional: Workflows de conciliação orientados a eventos                             |

<Note>
  O Matcher funciona independentemente ou como parte do ecossistema Lerian Studio. Use-o sozinho ou conecte-o ao Midaz e outros componentes financeiros conforme necessário.
</Note>

<Note>
  Todos os endpoints de escrita do Matcher (POST, PUT, PATCH) incluem idempotência integrada através do header de requisição `X-Idempotency-Key`. Para mais detalhes, consulte [Retentativas e idempotência](/pt/reference/retries-idempotency).
</Note>

## Próximos passos

***

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

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

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

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

<Tip>
  [Explorar a API do Matcher](/pt/reference/matcher/matcher-developer-quick-start). Consulte endpoints para contextos de conciliação, fontes e regras de matching.
</Tip>