Skip to main content
Os relatórios transformam uma execução de reconciliação em algo sobre o qual você pode agir: quanto foi correspondido, o que ainda está em aberto e quanto dinheiro está exposto. As equipes de operações os usam para trabalhar a fila do dia; finanças e conformidade os usam para fechar os livros e documentar os resultados.

​
Relatórios disponíveis

Cada relatório responde a uma pergunta diferente:
  • Resumo da reconciliação: Uma visão geral de alto nível das taxas de correspondência, volume de exceções e variações totais.
  • Relatório de detalhes de correspondência: Uma lista completa das correspondências, incluindo detalhes das transações, pontuações de confiança e detalhamento de variações.
  • Relatório de não correspondidos: Uma lista de transações que continuam sem correspondência para acompanhamento.
  • Relatório de exceções: Uma visão focada das exceções não resolvidas com envelhecimento, severidade e status de resolução.
  • Relatório de variação: Um detalhamento das diferenças de taxas entre as transações correspondidas. Cada linha preserva a variação líquida bruta, mostra os ajustes registrados aplicados àquela linha e informa a variação pendente resultante. Um ajuste que não pode ser atribuído a exatamente uma linha de fonte, fee schedule e moeda permanece informado como não atribuído em vez de ser dividido.
Use os endpoints do dashboard de relatórios para acessar métricas de reconciliação e exportar dados.
Referência da API: Agregados do dashboard | Exportar relatório de correspondidos | Exportar relatório de não correspondidos

​
Análises do dashboard

O dashboard de relatórios fornece métricas de reconciliação em tempo real para um contexto e um intervalo de datas. Os endpoints de relatórios usam por padrão a janela de 30 dias que termina amanhã (UTC) e normalmente limitam a janela a 90 dias. Somente os endpoints de lista e contagem de itens não correspondidos aceitam unbounded=true para consultar sem limites de data.

​
Agregados do dashboard

Use o endpoint combinado de agregados do dashboard para uma única chamada que retorna estatísticas de volume, taxa de correspondência e SLA para um contexto:
cURL
GET /v1/reports/contexts/{contextId}/dashboard aceita date_from, date_to e um filtro opcional source_id, e retorna um DashboardAggregatesResponse: Fatias mais granulares do dashboard estão disponíveis em /v1/reports/contexts/{contextId}/dashboard/* (por exemplo metrics, match-rate, sla, volume, source-breakdown e cash-impact).
Não existe um endpoint GET /v1/reports/contexts/{contextId} simples. Os dados de relatórios são servidos por meio dos sub-caminhos tipados em /v1/reports/contexts/{contextId}/... — por exemplo dashboard, summary, matched, unmatched e variance (cada um com uma variante /export).
Referência da API: Obter agregados do dashboard

​
Detalhamento por fonte

Visualize o desempenho da reconciliação por fonte — incluindo taxas de correspondência, contagens de transações e valores não correspondidos:
cURL
Referência da API: Obter detalhamento por fonte

​
Impacto financeiro

Avalie a exposição financeira total das transações não correspondidas, detalhada por moeda e idade:
cURL
A resposta inclui detalhamentos byCurrency e byAge para ajudar a priorizar os esforços de resolução.
Referência da API: Obter impacto financeiro

​
Paginação

Os endpoints de relatórios de correspondidos, não correspondidos e variância usam paginação baseada em cursor. Passe o valor cursor de uma resposta anterior para recuperar a próxima página de resultados. Se um valor de cursor inválido for fornecido, a API retorna um erro 400 Bad Request com uma mensagem indicando que os parâmetros de paginação são inválidos. Versões anteriores retornavam um erro 500 nesse caso.

​
Contagens rápidas

Use os endpoints de contagem para verificações de status leves sem buscar conjuntos de resultados completos:
cURL
Cada endpoint de contagem retorna um único valor count — ideal para dashboards leves ou verificações de saúde que não precisam do conjunto de resultados completo.

​
Melhores práticas

Automatize um relatório de resumo diário entregue todas as manhãs para manter as partes interessadas alinhadas.
Armazene relatórios em armazenamento seguro e durável. Artefatos financeiros frequentemente requerem retenção de vários anos.
Gere relatórios direcionados por data e fonte—evite exportar tudo por padrão.
Inclua nomes de fontes, nomes de regras e identificadores-chave para que a saída possa ser autônoma fora do Matcher.
Relatórios grandes podem falhar ou travar. Os jobs de exportação usam QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED e CANCELED; gere alertas para FAILED ou um estado RUNNING prolongado.

​
Próximos passos

Contextos e Fontes

Configure contextos de reconciliação e fontes de dados.

Segurança

Aprenda como o controle de acesso e a proteção de dados funcionam no Matcher.