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.