Atualização da documentação do Matcher

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 mudou

​

Guias

​

Visão geral

• O que é o Matcher — Visão geral do produto, arquitetura e onde o Matcher se encaixa na plataforma Lerian
• Conceitos do Matcher — Conceitos principais: contexts, sources, rules, field mapping, matching runs, exceptions e disputes
• 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, da criação do context à primeira reconciliação

​

Configuração

• Contexts e sources — Definindo o escopo da reconciliação e conectando sistemas
• Match rules — Tipos de regra (exact, tolerance, date lag), ordem de prioridade e reordenação
• Field mapping — Mapeando campos de origem para o modelo canônico do Matcher
• Fee rules — Validação de fees e configuração de tolerância
• Exception routing — Roteando transações não conciliadas para revisão
• Modo multi-tenant — Isolamento e configuração de tenants
• Configuração em runtime (Systemplane) — Parâmetros de runtime e configurações a nível de sistema

​

Reconciliação diária

• Enviando arquivos — Importando dados de transações via API
• Revisando matches — Inspecionando resultados de matches e grupos
• Resolvendo exceptions — Workflows de exception e resolução
• Gerando reports — Dashboard, reports de matched/unmatched/variance e exportações

​

Integrações

• Integração com Midaz — Usando o Matcher com dados do ledger Midaz
• Sources externos — Conectando extratos bancários e sistemas de terceiros
• Discovery — Auto-discovery de conexões de dados externos
• Webhooks e callbacks — Notificações orientadas a eventos

​

Referência

• Confidence scoring — Como o Matcher calcula a confiança do match
• Multi-currency — Reconciliação entre moedas
• 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 de Pix — Guia passo a passo para reconciliar transações Pix

​

Lerian Console

• Usando o Matcher no Lerian Console — Visão geral da integração com o console
  • 19 páginas de console cobrindo todo o módulo Matcher:
  • Contexts — Gerenciando contexts, sources, rules e schedules
  • Reconciliation — Enviando dados, executando runs, revisando matches
  • Exceptions e disputes — Gerenciando exceptions, detalhes de exceptions, disputes
  • Governance — Mapeamentos de actor, audit logs e arquivos
  • Operations — Dashboard, fee schedules, matching manual e histórico operacional

​

Referência de API

• Quick start para developers — Walkthrough da API, do setup do context à reconciliação
• Lista de erros — Referência completa dos códigos de erro
• 119 páginas de referência de endpoints cobrindo toda a superfície da API:
  • Configuration — Contexts, sources, rules, field maps, schedules, fee rules, fee schedules
  • Ingestion — Import jobs, busca de transações
  • Matching — Runs, match groups
  • Exceptions — Gerenciamento de exceptions, comentários, histórico
  • Disputes — Ciclo de vida de disputes
  • Reporting — Métricas do dashboard (match rate, volume, SLA, cash impact, source breakdown), reports de matched/unmatched/variance com exportação
  • Discovery — Connections, introspecção de schema, extraction bridge
  • Governance — Audit logs, mapeamentos de actor, arquivos
  • Export — Export jobs com download

​

Especificação OpenAPI

• Especificação OpenAPI 3.1 do Matcher — Especificação legível por máquina com os 117 endpoints, schemas e exemplos — verificada contra o código-fonte

​

Principais correções desta release

• Paths da API corrigidos — Prefixos de rota alinhados com o registro real de rotas no Fiber
• Campos deprecados removidos — rateId removido de todos os schemas (rejeitado pela API desde a deprecação)
• Schemas ausentes adicionados — Arrays inline de sources e rules adicionados ao CreateReconciliationContextInput
• Spec YAML reforçada — Valores de enum com dois-pontos (1:1, 1:N, N:M) devidamente entre aspas para evitar interpretação incorreta do parser
• Exemplos dos guias corrigidos — URLs de endpoints incorretas em exemplos de curl corrigidas em todos os idiomas