Opcional: conciliar dados do Midaz
O Matcher se combina com o Midaz Ledger, mas não existe conector ativo entre eles. O Matcher não abre conexão com o Midaz. Conciliar dados do Midaz é totalmente opcional. O Matcher funciona como produto independente que concilia quaisquer fontes de dados.
Quando conciliar dados do Midaz
Concilie dados de ledger do Midaz se:- Você usa o Midaz como seu sistema de ledger
- Você quer conciliar os lançamentos do Midaz com fontes externas (extratos bancários, relatórios de gateway)
Quando o Midaz não está envolvido
O Matcher funciona de forma independente quando:- Ao conciliar entre sistemas externos (bancos, ERPs, processadores de pagamento)
- Ao usar outro sistema de ledger
- Ao importar dados de ledger por arquivos CSV/JSON/XML
Como funciona
O Matcher concilia dados do Midaz do mesmo jeito que ingere qualquer fonte (por importação, não por consulta ativa):- Exporte os dados do ledger do período que você quer conciliar.
- Importe essa exportação para um contexto do Matcher como fonte do tipo
LEDGER. - Importe os dados da contraparte (extrato bancário ou relatório de gateway) como o outro lado.
- O Matcher faz a correspondência dos dois lados usando suas regras de correspondência.
Veja o guia Matcher e Midaz para o fluxo completo.
Autenticação
O Access Manager emite o token e verifica as permissões de quem chama.
Permissões obrigatórias
Permissões refinadas controlam o acesso aos recursos do Matcher:Formatos genéricos de importação
Os importadores genéricos do Matcher aceitam CSV, JSON e XML. Os parsers embutidos também aceitam CAMT.053, CNAB 240/400, OFX, vários formatos de adquirente e formatos de recebíveis. Veja o catálogo de formatos de importação para o inventário completo. Cada formato genérico tem requisitos estruturais específicos para a ingestão dar certo.
CSV (valores separados por vírgula)
Muito usado para extratos bancários e exportações. Requisitos:- O arquivo deve ter uma linha de cabeçalho
- Codificação UTF-8 (configurável)
- Delimitador vírgula (configurável)
- Campos entre aspas para valores que contêm delimitadores
JSON (notação de objetos javascript)
Recomendado para integrações baseadas em API. Requisitos:- Um array de objetos ou um único objeto
- Codificação UTF-8 (configurável)
- Nomes de campo consistentes entre os registros
XML (linguagem de marcação extensível)
Comum em integrações corporativas e bancárias. Requisitos:- Um único elemento raiz
- Codificação UTF-8 (configurável)
- Estrutura de elementos consistente
Limites de tamanho de arquivo
Requisitos de rede
Acesso ao Matcher
Seus sistemas e usuários acessam a API do Matcher e o módulo Matcher do Lerian Console nos endereços que a Lerian fornece.Acesso aos seus sistemas
Para estas fontes, o Matcher se conecta ao sistema que você indica, e esse sistema deve aceitar conexões do Matcher:
As conexões de agregador precisam da sua conta no Pluggy ou no Belvo.
A entrega de eventos é opcional. Quando a Lerian a habilita para você, o Matcher publica os eventos de Eventos do Matcher como CloudEvents.
Checklist
Antes de começar, confirme que:
- As credenciais estão disponíveis: você tem um token do Access Manager
- O acesso de rede funciona: os sistemas que você registra aceitam conexões do Matcher
- Um navegador está disponível: você o usa para abrir o módulo Matcher do Lerian Console
- Os dados de exemplo estão prontos: você tem arquivos de transações para o primeiro teste (veja Início rápido)
Próximos passos
Início rápido
Rode sua primeira conciliação.