Skip to main content
O Matcher expõe dois endpoints de simulação somente leitura para você responder “o que aconteceria?” antes de gravar a configuração. São a simulação de correspondência (esta regra vai corresponder?) e a simulação de tarifas (que tarifas esta tabela cobraria?). Nenhum dos dois persiste nada.

Simulação de correspondência


Veja antes como uma única regra corresponderia às transações não conciliadas de um contexto, sem gravar nada. Escolha uma regra configurada existente (ruleId) ou uma regra candidata inline (rule).
Informe exatamente um destes:
  • ruleId: pré-visualize uma regra configurada existente do contexto.
  • rule: pré-visualize uma definição candidata não persistida (type é um entre EXACT, TOLERANCE, DATE_LAG, FUZZY, mais a config dela).
Informar os dois, ou nenhum, retorna 400. sampleLimit (1–200, padrão 25) limita os pares de correspondência potencial retornados. A resposta informa quantos grupos 1:1 a regra formaria e as contagens de não conciliados de cada lado. Ela também retorna uma amostra limitada de pares de correspondência potencial, cada um com uma pontuação de confiança e a justificativa por componente:
Escopo: a simulação pontua pelo motor determinístico de regras sobre os valores brutos das transações. Ela não aplica a normalização de tarifas em tempo de execução nem a faixa de variação de câmbio, e pré-visualiza apenas o agrupamento par a par 1:1 (sem alocação 1:N/N:M). A simulação não conta um par que apenas corresponde depois da normalização de tarifas, dentro da faixa de câmbio ou por alocação.

Simulação de tarifas


Calcule as tarifas para um valor bruto usando uma tabela de tarifas específica. Use isso para validar as regras de uma tabela antes de anexá-la a um contexto.
A resposta retorna o valor líquido, a tarifa total e a composição por item:
A simulação de tarifas não tem metadados de transação, então os itens de tarifa por expressão que exigem um identificador de transação mostram o erro de identificador ausente como 4xx. Uma tabela inexistente retorna 404.

Quando usar cada uma


Os dois endpoints continuam estritamente somente leitura. Eles nunca persistem uma execução, um grupo, um item, uma regra ou uma transação. O tenant sempre vem do JWT.

Códigos de resposta