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 exceções: Uma visão focada das exceções não resolvidas com envelhecimento, severidade e status de resolução.
- Relatório de trilha de auditoria: Um registro cronológico da atividade de reconciliação para investigação e conformidade.
Análises do dashboard
O dashboard de relatórios fornece métricas de reconciliação em tempo real para qualquer contexto e intervalo de datas.
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:
| Campo | Descrição |
|---|---|
volume | Estatísticas de volume de transações para o intervalo |
matchRate | Estatísticas de taxa de correspondência (correspondidos vs. total) |
sla | Estatísticas de SLA para o tratamento de exceções |
updatedAt | Quando os agregados foram calculados pela última vez (RFC 3339) |
/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).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
Impacto financeiro
Avalie a exposição financeira total das transações não correspondidas, detalhada por moeda e idade:cURL
byCurrency e byAge para ajudar a priorizar os esforços de resolução.
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:
| Endpoint | Descrição |
|---|---|
| Contar correspondências | Total de itens correspondidos em um intervalo de datas |
| Contar transações | Total de transações em um intervalo de datas |
| Contar exceções | Total de exceções em um intervalo de datas |
| Contar não correspondidos | Total de itens não correspondidos em um intervalo de datas |
cURL
count — ideal para dashboards leves ou verificações de saúde que não precisam do conjunto de resultados completo.
Melhores práticas
Agende resumos diários
Agende resumos diários
Automatize um relatório de resumo diário entregue todas as manhãs para manter as partes interessadas alinhadas.
Arquive exportações para conformidade
Arquive exportações para conformidade
Armazene relatórios em armazenamento seguro e durável. Artefatos financeiros frequentemente requerem retenção de vários anos.
Use filtros para manter a relevância
Use filtros para manter a relevância
Gere relatórios direcionados por data, status, severidade ou fonte—evite exportar tudo por padrão.
Torne as exportações autoexplicativas
Torne as exportações autoexplicativas
Inclua nomes de fontes, nomes de regras e identificadores-chave para que a saída possa ser autônoma fora do Matcher.
Monitore jobs de relatório
Monitore jobs de relatório
Relatórios grandes podem falhar ou travar. Acompanhe o status do job e alerte em
FAILED ou GENERATING 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.