Pular para o conteúdo principal
Exceções são transações que o Matcher não consegue reconciliar automaticamente. Este guia mostra como revisar exceções, priorizar o trabalho com base na severidade e resolver itens com o nível adequado de documentação.

O que é uma exceção?


Uma exceção é criada quando uma transação de uma fonte não possui uma contrapartida válida em outra fonte. Causas comuns incluem:
  • Nenhum candidato encontrado: Nenhuma transação na outra fonte atende aos critérios da regra ativa.
  • Abaixo do limite de confiança: Candidatos existem, mas pontuam abaixo da confiança mínima (padrão: 60).
  • Rejeição por duplicidade: Uma correspondência anterior foi rejeitada e nenhum candidato alternativo permanece.
  • Desbalanceamento de fonte: Uma fonte contém transações que estão ausentes na outra.

Ciclo de vida da exceção


Exceções passam por um fluxo de trabalho simples:
  • Quando o Matcher não consegue reconciliar uma transação, ele cria uma exceção com status OPEN.
  • A partir daí, um analista a assume para investigação (IN_REVIEW). A maioria das exceções é resolvida diretamente após a investigação.
  • Se a resolução requer aprovação—como um write-off acima de um determinado limite—a exceção passa para ESCALATED.
  • Um supervisor pode então aprovar e fechá-la, ou devolvê-la com orientações para revisão adicional.
Ciclo de Vida da Exceção do Matcher

Definições de status

StatusDescriçãoQuem Pode Transicionar
OPENNova exceção aguardando atribuiçãoSistema, Analista
IN_REVIEWAtribuída a um revisor para investigaçãoAnalista
ESCALATEDRequer aprovação antes da resoluçãoAnalista, Supervisor
RESOLVEDFechada com uma resolução auditávelAnalista, Supervisor

Severidade da exceção


O Matcher classifica exceções por severidade para que você possa trabalhar na fila na ordem correta.
SeveridadeCritériosSLA
CriticalValor >= 100.000 OU Idade >= 5 dias OU Flag de fonte regulatóriaResolver em 24 horas
HighValor >= 10.000 OU Idade >= 3 diasResolver em 48 horas
MediumValor >= 1.000 OU Idade >= 1 diaResolver em 72 horas
LowTodos os outrosResolver em 5 dias úteis

Escalação de severidade

A severidade pode aumentar automaticamente conforme uma exceção envelhece:
Dia 0: Low → permanece Low
Dia 1: Low → Medium (se valor < 1.000)
Dia 3: Medium → High (se valor < 10.000)
Dia 5: High → Critical (todos não resolvidos)

Métodos de resolução


Você pode resolver uma exceção de quatro maneiras.

1. Forçar correspondência

Vincule manualmente transações quando você confirmou que elas pertencem juntas, mas o sistema não conseguiu correspondê-las. Use Forçar Correspondência quando:
  • A contrapartida correta existe, mas variações bloquearam a correspondência automática.
  • Você pode explicar e documentar claramente a justificativa.
  • A variação é esperada (taxas, timing, arredondamento).

2. Criar ajuste

Crie um lançamento de ajuste para contabilizar uma variação ou equilibrar um item não correspondido. Tipos comuns de ajuste:
TipoCaso de Uso
BANK_FEETaxas bancárias não registradas no razão
FX_VARIANCEDiferenças de conversão de moeda
TIMING_DIFFERENCEAjustes de timing de liquidação
ROUNDINGPequenas diferenças de arredondamento
CORRECTIONCorreções de erros
OTHEROutras variações documentadas

3. Write-off

Faça write-off de uma transação que não possui contrapartida válida. Isso deve ser raro e tipicamente requer aprovação. Motivos de write-off:
MotivoDescrição
DUPLICATE_ENTRYTransação foi lançada duas vezes
CANCELLEDTransação foi revertida ou cancelada
NOT_APPLICABLENão pertence ao escopo desta reconciliação
BELOW_THRESHOLDValor está abaixo do limite de investigação
APPROVED_VARIANCEVariação aprovada pela gerência

4. Dividir transação

Use divisão quando uma transação deve corresponder a múltiplas contrapartidas.

Requisitos de auditoria


Toda resolução cria um registro de auditoria. Alguns tipos de resolução requerem evidências e aprovações mais fortes.

Documentação necessária por tipo de resolução

ResoluçãoCampos NecessáriosAprovação Necessária
Forçar Correspondênciareason, notesNão (exceto se valor > limite)
Ajusteadjustment_type, amount, descriptionSe valor > $1.000
Write-Offreason, notes, reference_documentSempre
Divisãosplits[] com valores e alvosNão

Fluxo de trabalho de resolução de exceções


Use este fluxo para manter revisões consistentes e amigáveis para auditoria.
1

Triagem

Revise a fila por severidade e SLA. Comece com Critical e High.
2

Investigar

Use o payload da exceção para entender o que falhou e quais candidatos existem.
  • Leia reason_details para ver por que a correspondência falhou.
  • Revise candidates para correspondências próximas abaixo do limite.
  • Procure por padrões (mesma contrapartida, formatos de referência recorrentes).
3

Resolver

Escolha a resolução que melhor reflete a realidade e a política.
  • Forçar Correspondência: Você encontrou a contrapartida correta.
  • Ajustar: Você precisa de um lançamento de ajuste para variação.
  • Dividir: Uma transação mapeia para múltiplas contrapartidas.
  • Write-Off: Nenhuma contrapartida existe e a política permite (aprovação necessária).
4

Documentar

Capture detalhes suficientes para que outra pessoa possa reproduzir sua decisão depois:
  • O que você verificou
  • O que você concluiu
  • Links ou IDs para evidências de suporte
5

Escalar se Necessário

Se a ação requer aprovação, escale com uma recomendação clara e notas de suporte.

Melhores práticas


Comece com itens Critical e High. Eles carregam o maior risco e os prazos mais apertados.
Notas não são opcionais. Trate-as como parte da resolução:
  • O que você verificou
  • Por que esta resolução está correta
  • Quaisquer IDs de tickets, extratos ou confirmações
Exceções repetidas geralmente apontam para problemas de configuração:
  • Mesma contrapartida → Normalize nomes ou mapeamento
  • Mesma janela de datas → Valide completude da ingestão
  • Mesma fonte → Revise mapeamento de campos e convenções de sinal
Se você força correspondências regularmente, suas regras ou tolerâncias precisam de atenção.
Use regras de atribuição para reduzir o tempo de triagem e manter a propriedade clara.
Se você faz write-off frequentemente, revisite limites, escopo do contexto ou qualidade de dados upstream.

Próximos passos