28 de abril de 2026 Atualização de documentação Revisão recomendadaDocumentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
Afeta
Times usando guias, referência de API ou documentação de Console do Matcher. Esta atualização se aplica ao portal público de documentação. Não altera o comportamento da API em runtime, a menos que a documentação do produto vinculada diga o contrário.
O que mudou
A documentação do Matcher foi totalmente auditada e alinhada com a branch
main atual. Este release inclui 27 páginas de guia, 119 páginas de referência de API, 19 páginas de console e uma spec OpenAPI 3.1 verificada.
O que mudou
Guias
Visão geral
- O que é Matcher — Visão geral do produto, arquitetura e onde o Matcher se encaixa na plataforma Lerian
- Conceitos do Matcher — Conceitos centrais: contextos, fontes, regras, mapeamento de campos, execuções de matching, exceções e disputas
- Arquitetura do Matcher — Arquitetura do sistema, módulos de domínio e fluxo de dados
Primeiros passos
- Pré-requisitos — Requisitos e dependências
- Instalando o Matcher — Setup e deployment
- Começando com o Matcher — Walkthrough completo desde a criação do contexto até a primeira reconciliação
Configuração
- Contextos e fontes — Definindo o escopo de reconciliação e conectando sistemas
- Regras de match — Tipos de regra (exata, tolerância, date lag), ordenação por prioridade e reordenação
- Mapeamento de campos — Mapeando campos de fonte para o modelo canônico do Matcher
- Regras de fee — Validação de fee e configuração de tolerância
- Roteamento de exceção — Roteando transações não conciliadas para revisão
- Modo multi-tenant — Isolamento e configuração de tenant
- Configuração de runtime (Systemplane) — Parâmetros de runtime e configurações em nível de sistema
Reconciliação diária
- Subindo arquivos — Importando dados de transação via API
- Revisando matches — Inspecionando resultados e grupos de match
- Resolvendo exceções — Fluxos de trabalho e resolução de exceções
- Gerando relatórios — Dashboard, relatórios matched/unmatched/variance e exportações
Integrações
- Integração com Midaz — Usando o Matcher com dados de ledger do Midaz
- Fontes externas — Conectando extratos bancários e sistemas de terceiros
- Discovery — Auto-discovery de conexões de dados externas
- Webhooks e callbacks — Notificações orientadas a eventos
Referência
- Score de confiança — Como o Matcher calcula a confiança do match
- Multi-currency — Reconciliação cross-currency
- Split e aggregate — Padrões de matching 1:N e N:M
- Segurança — Autenticação, autorização e proteção de dados
Casos de uso
- Reconciliação Pix — Guia passo a passo para reconciliar transações Pix
Lerian Console
- Usando Matcher no Lerian Console — Visão geral da integração com o console
- 19 páginas de console cobrindo o módulo Matcher completo:
- Contexts — Gerenciando contextos, fontes, regras e agendamentos
- Reconciliation — Subindo dados, executando runs, revisando matches
- Exceptions & disputes — Gerenciando exceções, detalhes de exceção, disputas
- Governance — Mapeamentos de actor, logs de auditoria, arquivos
- Operations — Dashboard, fee schedules, matching manual, histórico operacional
Referência de API
- Developer quick start — Walkthrough da API desde setup do contexto até reconciliação
- Lista de erros — Referência completa de códigos de erro
- 119 páginas de referência de endpoint cobrindo toda a superfície da API:
- Configuration — Contextos, fontes, regras, field maps, schedules, fee rules, fee schedules
- Ingestion — Jobs de importação, busca de transação
- Matching — Runs, match groups
- Exceptions — Gerenciamento de exceções, comentários, histórico
- Disputes — Ciclo de vida de disputa
- Reporting — Métricas de dashboard (match rate, volume, SLA, cash impact, source breakdown), relatórios matched/unmatched/variance com export
- Discovery — Conexões, introspecção de schema, extraction bridge
- Governance — Logs de auditoria, mapeamentos de actor, arquivos
- Export — Jobs de exportação com download
Especificação OpenAPI
- Spec OpenAPI 3.1 do Matcher — Especificação legível por máquina com todos os 117 endpoints, schemas e exemplos — verificada contra o código-fonte
Correções importantes neste release
- Paths de API corrigidos — Prefixos de rota alinhados com o registro real de rota Fiber
- Campos depreciados removidos —
rateIdremovido de todos os schemas (rejeitado pela API desde o deprecation) - Schemas faltantes adicionados — Arrays inline
sourceserulesadicionados aCreateReconciliationContextInput - Spec da API endurecida — Valores enum com dois-pontos (
1:1,1:N,N:M) corretamente entre aspas para evitar má interpretação do parser - Exemplos de guia corrigidos — URLs incorretas de endpoint em exemplos curl corrigidas em todos os idiomas
Impacto
Esta é uma atualização de documentação. Integrações existentes não precisam migrar apenas com base nesta release note.

