Pular para o conteúdo principal
Após executar um job de correspondência, você precisará revisar os resultados. Este guia explica como interpretar os resultados das correspondências, entender as pontuações de confiança e aprovar ou rejeitar correspondências propostas.

​
Ciclo de vida do status da correspondência

As correspondências progridem através de um ciclo de vida definido:
  • Quando o motor de correspondência encontra um par de transações que pertencem juntas, ele cria uma correspondência com status PROPOSED.
  • Correspondências de alta confiança (pontuação 90 ou acima) são auto-confirmadas imediatamente.
  • Correspondências de menor confiança aguardam revisão manual—um analista pode então confirmá-las ou rejeitá-las.
  • Transações rejeitadas retornam ao pool de não correspondidas para outra tentativa de correspondência.
Ciclo de Vida do Status da Correspondência

​
Definições de status

StatusDescriçãoPróximas Ações
PROPOSEDCorrespondência identificada pelo sistema, aguardando confirmaçãoRevisar, confirmar ou rejeitar
CONFIRMEDCorrespondência foi aprovada (automática ou manual)Revogar se incorreto
REJECTEDCorrespondência foi recusadaTransações retornam ao pool de não correspondidas
REVOKEDUma correspondência previamente confirmada foi revogadaTransações retornam ao pool de não correspondidos

​
Níveis de confiança

O Matcher atribui uma pontuação de confiança (0-100) a cada correspondência proposta. A pontuação determina como a correspondência é tratada.

​
Níveis de confiança

NívelFaixa de PontuaçãoComportamento
Auto-Aprovado90-100Correspondências de alta confiança são automaticamente confirmadas sem revisão manual.
Precisa Revisão60-89Correspondências de média confiança requerem revisão manual antes da confirmação.
Sem CorrespondênciaAbaixo de 60Candidatos de baixa confiança não são propostos como correspondências e se tornam exceções.

​
Entendendo a pontuação

A pontuação de confiança é calculada a partir de componentes ponderados:
ComponentePesoO Que Mede
Correspondência de valor40%Quão próximos estão os valores das transações
Correspondência de moeda30%Se as moedas são as mesmas
Tolerância de data20%Quão próximas estão as datas das transações
Correspondência de referência10%Se as referências das transações correspondem
Exemplo de Detalhamento da Pontuação: 
Correspondência: BANK-001 ↔ LED-001

Valor: $1.000,00 vs $1.000,00 → 100% × 40% = 40 pontos
Moeda: USD vs USD → 100% × 30% = 30 pontos
Data: 2024-01-15 vs 2024-01-15 → 100% × 20% = 20 pontos
Reference: PAY-001 vs PAY-001 → match → 10 points
 ─────────────────────────
Confiança Total: 100 pontos

​
Entendendo variações

Quando correspondências têm diferenças, revise os detalhes da variação:

​
Variação de valor

Causas comuns de variação de valor:
  • Taxas bancárias
  • Diferenças de conversão de moeda
  • Diferenças de arredondamento
  • Pagamentos parciais

​
Variação de data

Causas comuns de variação de data:
  • Tempo de liquidação
  • Diferenças de fuso horário
  • Data de lançamento vs. data da transação
  • Processamento em finais de semana/feriados

​
Revogando correspondências confirmadas

Às vezes você precisa reverter uma correspondência confirmada porque ela foi aprovada incorretamente. A operação de revogação quebra uma correspondência existente e retorna as transações ao pool de não correspondidas.
cURL
curl -X POST "https://api.matcher.example.com/v1/matching/groups/{groupId}/revoke" \
 -H "Authorization: Bearer $TOKEN"
Revogar uma correspondência confirmada cria uma trilha de auditoria completa e pode acionar fluxos de trabalho de aprovação. Esta operação deve ser usada com cuidado e apenas quando necessário.

​
Quando revogar

Cenários comuns para revogar:
  • Correspondência incorreta confirmada: A correspondência foi aprovada mas as transações na verdade pertencem a registros diferentes
  • Nova informação: Dados adicionais mostram que a correspondência está errada
  • Correção na origem: O sistema de origem emitiu uma correção ou reversão
  • Transação duplicada: Uma das transações era uma duplicata que deveria ser removida

​
O que acontece após revogar

Quando uma correspondência é revogada:
  1. Status da correspondência muda: De CONFIRMED para REVOKED
  2. Trilha de auditoria criada: Registro completo de quem revogou e por quê
  3. Transações retornadas: Todas as transações retornam ao pool de não correspondidas
  4. Exceções criadas: Novas exceções são criadas para cada transação
  5. Webhook acionado: Evento match.revoked é emitido
  6. Re-correspondência possível: Transações podem ser correspondidas novamente na próxima execução

​
Melhores práticas

Revise correspondências com as menores pontuações de confiança primeiro. Estas são mais propensas a estar incorretas e precisam de mais atenção.
Os limites de confiança são fixos no sistema. Pontuações de 90 ou acima são auto-confirmadas. Pontuações entre 60 e 89 requerem revisão manual. Pontuações abaixo de 60 se tornam exceções. Esses valores não são configuráveis por contexto. Use o ajuste de regras (prioridade, valores de tolerância) para influenciar quantas correspondências caem em cada faixa.
Sempre adicione notas ao confirmar ou rejeitar correspondências. Isso cria uma trilha de auditoria e ajuda os membros da equipe a entender o raciocínio.
Confirmar em lote é eficiente, mas use apenas após revisar uma amostra. Nunca confirme em lote sem entender o que você está aprovando.
Independentemente da pontuação de confiança, dê atenção extra a correspondências de alto valor. O impacto de uma correspondência incorreta é proporcional ao valor.

​
Próximos passos

Resolvendo exceções

Lide com transações que não puderam ser correspondidas automaticamente.

Pontuação de confiança

Aprofunde-se em como as pontuações de confiança são calculadas.