Pontuação de confiança

As pontuações de confiança indicam a confiabilidade de uma correspondência automatizada em uma escala de 0-100. Pontuações mais altas significam maior certeza de que duas transações representam o mesmo evento financeiro.

Visão geral

Quando o Matcher identifica uma correspondência potencial, ele atribui uma pontuação de confiança com base em múltiplos fatores. Esta pontuação define como a correspondência é tratada:

Pontuações altas (90+) são aprovadas automaticamente
Pontuações intermediárias (60 – 89) requerem revisão
Pontuações baixas (<60) são tratadas como exceções

Componentes da pontuação

O Matcher usa um sistema de pontuação ponderada com quatro componentes:

Componente	Peso	Descrição
Correspondência de valor	40%	Quão próximos os valores estão
Correspondência de moeda	30%	Verificação de mesma moeda
Proximidade de data	20%	Proximidade das datas das transações
Satisfação de regra	10%	Critérios da regra de correspondência atendidos

Correspondência de valor (40%)

O componente de valor tem o maior peso porque discrepâncias de valor frequentemente indicam transações diferentes. Cálculo:

amount_score = base_score - (variance_percent * penalty_per_percent)

Variação	Impacto na Pontuação	Exemplo
0% (exato)	40/40 pontos	$1.000,00 vs$ 1.000,00
0,1% - 0,5%	38-40 pontos	$1.000,00 vs$ 1.003,00
0,5% - 1,0%	35-38 pontos	$1.000,00 vs$ 1.008,00
1,0% - 2,0%	30-35 pontos	$1.000,00 vs$ 1.015,00
2,0% - 5,0%	20-30 pontos	$1.000,00 vs$ 1.040,00
> 5,0%	0-20 pontos	$1.000,00 vs$ 1.060,00

Configuração:

{
  "scoring": {
    "amount": {
      "weight": 40,
      "exact_match_score": 40,
      "penalty_per_percent": 5,
      "min_score": 0
    }
  }
}

Correspondência de moeda (30%)

A verificação de moeda é binária—as moedas correspondem ou não.

Cenário	Pontuação
Mesma moeda	30/30 pontos
Moeda diferente (sem contexto FX)	0/30 pontos
Moeda diferente (FX habilitado)	Calculado com base na variação da taxa

Com contexto FX habilitado:

{
  "scoring": {
    "currency": {
      "weight": 30,
      "same_currency_score": 30,
      "fx_enabled": true,
      "fx_rate_tolerance_percent": 2.0,
      "fx_penalty_per_percent": 10
    }
  }
}

Proximidade de data (20%)

A pontuação de data recompensa transações que ocorrem no mesmo dia e penaliza diferenças de data.

Diferença de Data	Impacto na Pontuação
Mesmo dia	20/20 pontos
1 dia	18/20 pontos
2 dias	16/20 pontos
3 dias	14/20 pontos
4-5 dias	10-12/20 pontos
6-7 dias	6-8/20 pontos
> 7 dias	0-5/20 pontos

Configuração:

{
  "scoring": {
    "date": {
      "weight": 20,
      "same_day_score": 20,
      "penalty_per_day": 2,
      "max_days": 14,
      "use_posting_date": false
    }
  }
}

Satisfação de regra (10%)

Este componente recompensa correspondências que satisfazem critérios de regras determinísticas além das comparações básicas.

Qualidade da Correspondência de Regra	Pontuação
Todas as condições da regra atendidas	10/10 pontos
Padrão de referência correspondido	+3 pontos
ID externo correspondido	+5 pontos
Contraparte correspondida	+2 pontos

A satisfação de regra pode exceder 10 pontos como bônus, mas o componente é limitado a 10 no cálculo final.

Fórmula de cálculo

A fórmula completa da pontuação de confiança:

confidence_score =
 (amount_score * 0.40) +
 (currency_score * 0.30) +
 (date_score * 0.20) +
 (rule_score * 0.10)

Resposta da API

Quando o Matcher propõe uma correspondência, a resposta inclui pontuação detalhada:

{
  "match_id": "match_001",
  "confidence": 87,
  "confidence_breakdown": {
    "amount": {
      "weight": 40,
      "score": 38,
      "weighted_score": 15.2,
      "details": {
        "variance_amount": 5.0,
        "variance_percent": 0.5
      }
    },
    "currency": {
      "weight": 30,
      "score": 30,
      "weighted_score": 9.0,
      "details": {
        "source_currency": "USD",
        "target_currency": "USD",
        "match": true
      }
    },
    "date": {
      "weight": 20,
      "score": 16,
      "weighted_score": 3.2,
      "details": {
        "source_date": "2024-01-15",
        "target_date": "2024-01-17",
        "gap_days": 2
      }
    },
    "rule": {
      "weight": 10,
      "score": 10,
      "weighted_score": 1.0,
      "details": {
        "rule_id": "rule_002",
        "rule_name": "1% Tolerance",
        "conditions_met": [
          "amount_tolerance",
          "date_tolerance"
        ]
      }
    }
  },
  "transactions": {
    "source": {
      "id": "txn_001",
      "amount": 1000.0
    },
    "target": {
      "id": "txn_002",
      "amount": 1005.0
    }
  }
}

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Duas transações com valores idênticos no mesmo dia:

Campo	Origem	Destino	Pontuação do Componente
Valor	$1.000,00	$1.000,00	40/40
Moeda	USD	USD	30/30
Data	2024-01-15	2024-01-15	20/20
Regra	Correspondência exata	—	10/10

Pontuação Final: 100

{
  "confidence": 100,
  "confidence_breakdown": {
    "amount": {
      "score": 40,
      "weighted_score": 16.0
    },
    "currency": {
      "score": 30,
      "weighted_score": 9.0
    },
    "date": {
      "score": 20,
      "weighted_score": 4.0
    },
    "rule": {
      "score": 10,
      "weighted_score": 1.0
    }
  }
}

Correspondência de alta confiança (pontuação: 87)

Pequena variação de valor com diferença de 2 dias:

Campo	Origem	Destino	Pontuação do Componente
Valor	$1.000,00	$1.005,00 (0,5%)	38/40
Moeda	USD	USD	30/30
Data	2024-01-15	2024-01-17	16/20
Regra	Correspondência com tolerância	—	10/10

Cálculo:

Valor: 38 × 0,40 = 15,2
Moeda: 30 × 0,30 = 9,0
Data: 16 × 0,20 = 3,2
Regra: 10 × 0,10 = 1,0
Total: 28,4 → Normalizado para 87

Confiança média (pontuação: 72)

Maior variação requerendo revisão:

Campo	Origem	Destino	Pontuação do Componente
Valor	$1.000,00	$1.025,00 (2,5%)	28/40
Moeda	USD	USD	30/30
Data	2024-01-15	2024-01-19	12/20
Regra	Correspondência com tolerância	—	8/10

Cálculo:

Valor: 28 × 0,40 = 11,2
Moeda: 30 × 0,30 = 9,0
Data: 12 × 0,20 = 2,4
Regra: 8 × 0,10 = 0,8
Total: 23,4 → Normalizado para 72

Baixa confiança (pontuação: 55)

Variações significativas—tratada como exceção:

Campo	Origem	Destino	Pontuação do Componente
Valor	$1.000,00	$1.080,00 (8%)	15/40
Moeda	USD	USD	30/30
Data	2024-01-15	2024-01-25	4/20
Regra	Correspondência fraca	—	5/10

Pontuação Final: 55 (Abaixo do limite, torna-se exceção)

Níveis de confiança

O Matcher categoriza as correspondências em níveis com base na pontuação:

Nível	Faixa de Pontuação	Comportamento do Sistema	Volume Típico
Aprovado Automaticamente	>= 90	Confirmado automaticamente	70-80%
Necessita Revisão	60-89	Enfileirado para revisão manual	15-25%
Exceção	< 60	Tratado como não correspondido	5-10%

Como os níveis de confiança são aplicados

Quando o Matcher propõe uma correspondência, ele avalia a pontuação de confiança e aplica os seguintes passos:

Se a pontuação for 90 ou superior, a correspondência é automaticamente confirmada.
Se a pontuação for entre 60 e 89, a correspondência é enfileirada para revisão manual.
Se a pontuação for abaixo de 60, nenhuma correspondência é criada e a transação se torna uma exceção.
Correspondências revisadas podem ser confirmadas ou rejeitadas, atualizando seu status final.

Isso garante que correspondências de alta confiança fluam automaticamente, mantendo o controle humano onde é importante.

Personalizando limites

Configuração em nível de contexto

Você pode definir limites por contexto de reconciliação ao criar ou atualizar o contexto:

{
  "settings": {
    "confidence": {
      "auto_approve_threshold": 95,
      "review_threshold": 70,
      "exception_threshold": 70
    }
  }
}

Referência da API: Criar contexto, Atualizar contexto

Recomendações de limites

Caso de Uso	Aprovação Automática	Revisão	Exceção
Alto volume, baixo risco	>= 85	55-84	< 55
Reconciliação padrão	>= 90	60-89	< 60
Alto valor, alto risco	>= 95	70-94	< 70
Crítico para conformidade	>= 98	80-97	< 80

Personalizando pesos

Ajuste os pesos dos componentes com base nas suas necessidades de reconciliação na configuração do contexto:

{
  "weights": {
    "amount": 50,
    "currency": 20,
    "date": 20,
    "rule": 10
  },
  "penalties": {
    "amount_per_percent": 8,
    "date_per_day": 3
  }
}

Diretrizes de pesos

Cenário	Pesos Recomendados
Conciliação de extrato bancário	Valor: 40%, Moeda: 30%, Data: 20%, Regra: 10%
Gateway de pagamento	Valor: 35%, Moeda: 25%, Data: 15%, Regra: 25%
Intercompanhia	Valor: 30%, Moeda: 20%, Data: 10%, Regra: 40%
Varejo de alto volume	Valor: 45%, Moeda: 30%, Data: 15%, Regra: 10%

Melhores práticas

Comece com os pesos padrão

Os pesos padrão 40/30/20/10 funcionam bem para a maioria dos cenários de reconciliação. Só ajuste após analisar os padrões de correspondência.

Monitore a distribuição por níveis

Acompanhe a porcentagem de transações em cada nível. Mudanças incomuns podem indicar problemas de qualidade de dados ou configuração incorreta de limites.

Use simulação antes de mudanças

Sempre simule mudanças de pontuação antes de aplicar. Isso evita aumentos inesperados no volume de revisão manual.

Documente a justificativa dos limites

Registre por que limites específicos foram escolhidos. Isso ajuda durante auditorias e ao integrar novos membros da equipe.

Revise correspondências de baixa confiança

Periodicamente revise correspondências logo acima do limite de exceção. Estas frequentemente revelam oportunidades para melhorias nas regras.

Considere a tolerância ao risco

Limites mais altos de aprovação automática reduzem o risco, mas aumentam o trabalho manual. Encontre o equilíbrio apropriado para sua organização.

Introduction

Primeiros passos

Configurações

Reconciliação diária

Integrações

Referência

Pontuação de confiança

Visão geral

Componentes da pontuação

Correspondência de valor (40%)

Correspondência de moeda (30%)

Proximidade de data (20%)

Satisfação de regra (10%)

Fórmula de cálculo

Resposta da API

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Correspondência de alta confiança (pontuação: 87)

Confiança média (pontuação: 72)

Baixa confiança (pontuação: 55)

Níveis de confiança

Como os níveis de confiança são aplicados

Personalizando limites

Configuração em nível de contexto

Recomendações de limites

Personalizando pesos

Diretrizes de pesos

Melhores práticas

Próximos passos

Regras de Correspondência

Multi-Moeda

Introduction

Primeiros passos

Configurações

Reconciliação diária

Integrações

Referência

​Visão geral

​Componentes da pontuação

​Correspondência de valor (40%)

​Correspondência de moeda (30%)

​Proximidade de data (20%)

​Satisfação de regra (10%)

​Fórmula de cálculo

​Resposta da API

​Exemplos de cálculo

​Correspondência exata (pontuação: 100)

​Correspondência de alta confiança (pontuação: 87)

​Confiança média (pontuação: 72)

​Baixa confiança (pontuação: 55)

​Níveis de confiança

​Como os níveis de confiança são aplicados

​Personalizando limites

​Configuração em nível de contexto

​Recomendações de limites

​Personalizando pesos

​Diretrizes de pesos

​Melhores práticas

​Próximos passos

Regras de Correspondência

Multi-Moeda

Visão geral

Componentes da pontuação

Correspondência de valor (40%)

Correspondência de moeda (30%)

Proximidade de data (20%)

Satisfação de regra (10%)

Fórmula de cálculo

Resposta da API

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Correspondência de alta confiança (pontuação: 87)

Confiança média (pontuação: 72)

Baixa confiança (pontuação: 55)

Níveis de confiança

Como os níveis de confiança são aplicados

Personalizando limites

Configuração em nível de contexto

Recomendações de limites

Personalizando pesos

Diretrizes de pesos

Melhores práticas

Próximos passos