Skip to main content
Os relatórios transformam uma execução de conciliação em algo acionável: quanto foi conciliado, o que continua em aberto e quanto dinheiro está exposto. Os times de operações usam os relatórios para trabalhar a fila do dia. As áreas financeira e de compliance os usam para fechar os livros e documentar os resultados.

​
Relatórios disponíveis

Cada relatório responde a uma pergunta diferente:
  • Resumo da conciliação: um panorama geral das taxas de correspondência, do volume de exceções e do total de variações.
  • Relatório de detalhes das correspondências: a lista completa de correspondências, incluindo detalhes das transações, pontuações de confiança e o detalhamento das variações.
  • Relatório de não conciliados: a lista de transações que continuam não conciliadas, para acompanhamento.
  • Relatório de exceções: uma visão focada nas exceções não resolvidas, com aging, severidade e status de resolução.
  • Relatório de variações: o detalhamento das diferenças de tarifa entre transações conciliadas. Cada linha preserva a variação líquida bruta, mostra os ajustes registrados aplicados àquela linha e informa a variação pendente resultante. O relatório mostra um ajuste como não atribuído quando ele não corresponde a exatamente uma linha de fonte, tabela de tarifas e moeda. O relatório nunca divide um ajuste assim.
Use os endpoints do dashboard de relatórios para acessar as métricas de conciliação e exportar dados.
Referência da API:

​
Análises do dashboard

O dashboard de relatórios traz métricas de conciliação em tempo real para um contexto e um intervalo de datas. Por padrão, os endpoints de relatório usam a janela de 30 dias que termina amanhã (UTC) e normalmente limitam a janela a 90 dias. Apenas os endpoints de lista e de contagem de não conciliados 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, de taxa de correspondência e de SLA de um contexto:
cURL
GET /v1/reports/contexts/{contextId}/dashboard aceita date_from, date_to e um filtro opcional source_id, e retorna um DashboardAggregatesResponse: Recortes mais granulares do dashboard ficam 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} puro. Os subcaminhos tipados sob /v1/reports/contexts/{contextId}/... carregam os dados dos relatórios, 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

Veja o desempenho da conciliação por fonte, incluindo taxas de correspondência, contagens de transações e valores não conciliados:
cURL
Referência da API: Obter detalhamento por fonte

​
Impacto de caixa

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

​
Paginação

Os endpoints dos relatórios de conciliados, de não conciliados e de variações usam paginação por cursor. Passe o valor de cursor de uma resposta anterior para obter a próxima página de resultados. Se você informar um valor de cursor inválido, 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 os conjuntos completos de resultados:
cURL
Cada endpoint de contagem retorna um único valor count, ideal para dashboards leves ou health checks que não precisam do conjunto completo de resultados.

​
Boas práticas

Automatize um relatório de resumo diário entregue toda manhã para manter os stakeholders alinhados.
Guarde os relatórios em um armazenamento seguro e durável. Artefatos financeiros costumam exigir retenção de vários anos.
Gere relatórios direcionados por data e por fonte. Evite exportar tudo por padrão.
Inclua os nomes das fontes, os nomes das regras e os identificadores principais para que a saída se sustente sozinha fora do Matcher.
Relatórios grandes podem falhar ou travar. Os jobs de exportação usam QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED e CANCELED. Crie alertas para FAILED ou para RUNNING prolongado.

​
Próximos passos

Contextos e fontes

Configure os contextos de conciliação e as fontes de dados.

Segurança

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