> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Roteamento de exceções

> Entenda a classificação automática de severidade e use atribuição explícita, ações em lote, despacho dirigido pelo chamador e callbacks.

O Matcher classifica automaticamente as transações não conciliadas por severidade. Atribuição, operações em lote e despacho são ações explícitas da API. O Matcher não roteia exceções automaticamente.

## Classificação de severidade

***

O Matcher classifica exceções automaticamente a partir do valor e da idade para apoiar a priorização da revisão. O valor é o valor absoluto do valor base da transação ou, quando ela não tem valor base, do valor dela. Para um item em aberto envelhecido, é o valor absoluto do saldo em aberto.

### Regras de severidade padrão

| Severidade | Critério padrão de valor ou idade |
| - | - |
| **Crítica** | Valor ≥ 100.000 OU idade ≥ 120 horas |
| **Alta** | Valor ≥ 10.000 OU idade ≥ 72 horas |
| **Média** | Valor ≥ 1.000 OU idade ≥ 24 horas |
| **Baixa** | Todos os outros casos |

O Matcher limita as exceções com motivo `FEE_DATA_MISSING` a `MEDIUM`, mesmo quando os limiares de valor ou idade as classificariam como `HIGH` ou `CRITICAL`.

## Atribuição

***

A atribuição é explícita. Para uma exceção `OPEN` ou `ASSIGNED`, a API de atribuição aceita uma string `assignee` opaca e muda a exceção para `ASSIGNED` com esse responsável. A atribuição mantém a data de vencimento já definida.

> [!NOTE]
>
> O Matcher não tem modelo de grupo de usuários e não implementa atribuição automática, roteamento round-robin nem roteamento por menor carga. Se você usar um identificador de usuário ou de grupo, codifique-o na string `assignee` e resolva o significado dele no seu próprio sistema de identidade.

## Comportamento de SLA

***

O Matcher guarda uma data de vencimento de SLA apenas quando um callback de entrada fornece `dueAt`. Ele não deriva um prazo da severidade, não emite avisos automáticos de SLA, não escalona exceções por um workflow de SLA nem as roteia automaticamente. Os agregados do dashboard podem informar a conformidade dessas datas de vencimento fornecidas externamente. Defina e faça valer a política de SLA no sistema externo que envia o callback.

## Endpoints adicionais de exceção

***

O Matcher oferece endpoints para workflows avançados de exceção:

| Endpoint | Método | Descrição |
| - | - | - |
| [Despachar exceção](https://docs.lerian.studio/pt/reference/products/matcher/dispatch-exception.md) | `POST` | Tenta o despacho escolhido pelo chamador sem mudar o status da exceção |
| [Processar callback](https://docs.lerian.studio/pt/reference/products/matcher/process-exception-callback.md) | `POST` | Aplica uma atualização externa idempotente autenticada por token |
| [Atribuir em lote](https://docs.lerian.studio/pt/reference/products/matcher/bulk-assign-exceptions.md) | `POST` | Atribui exceções a uma string `assignee` |
| [Resolver em lote](https://docs.lerian.studio/pt/reference/products/matcher/bulk-resolve-exceptions.md) | `POST` | Resolve várias exceções de forma independente |
| [Despachar em lote](https://docs.lerian.studio/pt/reference/products/matcher/bulk-dispatch-exceptions.md) | `POST` | Despacha várias exceções de forma independente |
| [Listar comentários](https://docs.lerian.studio/pt/reference/products/matcher/list-exception-comments.md) | `GET` | Recupera todos os comentários de uma exceção |
| [Adicionar comentário](https://docs.lerian.studio/pt/reference/products/matcher/add-exception-comment.md) | `POST` | Adiciona um comentário a uma exceção para auditoria e colaboração |
| [Excluir comentário](https://docs.lerian.studio/pt/reference/products/matcher/delete-exception-comment.md) | `DELETE` | Remove um comentário de uma exceção |
| [Listar disputas](https://docs.lerian.studio/pt/reference/products/matcher/list-disputes.md) | `GET` | Recupera todas as disputas com filtragem |
| [Obter disputa](https://docs.lerian.studio/pt/reference/products/matcher/retrieve-dispute.md) | `GET` | Recupera os detalhes de uma disputa específica |
| [Abrir disputa](https://docs.lerian.studio/pt/reference/products/matcher/open-dispute.md) | `POST` | Marca uma exceção como disputada para revisão escalonada |
| [Fechar disputa](https://docs.lerian.studio/pt/reference/products/matcher/close-dispute.md) | `POST` | Fecha uma disputa com uma resolução |
| [Enviar evidência ](https://docs.lerian.studio/pt/reference/products/matcher/submit-evidence.md) | `POST` | Adiciona evidência para sustentar um caso de disputa |

Atribuição, resolução e despacho em lote aceitam de 1 a 100 IDs de exceção. O Matcher processa cada ID de forma independente, então espere sucesso parcial. A atribuição em lote aceita uma única string `assignee`, não um objeto de usuário ou de grupo.

## Despacho e callbacks

***

O despacho é dirigido pelo chamador: cada requisição nomeia o destino. O despacho registra um evento de auditoria, mas não muda o status da exceção.

### Destinos de despacho

Ao despachar uma exceção, defina o campo `targetSystem` com o seguinte valor:

| Destino | Descrição |
| - | - |
| `MANUAL` | Confirma o despacho localmente sem enviar para um sistema externo. |

Os callbacks de entrada são um fluxo separado, idempotente e autenticado por token. Um callback pode definir uma exceção como `ASSIGNED` quando inclui um responsável, ou como `RESOLVED`. O despacho não faz sincronização bidirecional.

### Filtragem por sistema externo

Ao listar exceções, o parâmetro de consulta `external_system` retorna as exceções cujo sistema externo é exatamente igual ao valor. Apenas os callbacks de entrada definem esse valor. O despacho não o define.

## Resumos de fila e observabilidade

***

A lista de exceções expõe contagens de resumo por fila. Os agregados do dashboard expõem contagens de conformidade de SLA para datas de vencimento fornecidas externamente. O Matcher não expõe a distribuição de regras de roteamento nem análises de sucesso e falha de integração. Use a sua stack externa de observabilidade para esses sinais operacionais.

## Boas práticas

***

> [accordion] Revise a severidade automática
>
> Use a severidade classificada para priorizar a revisão e considere o limite de `FEE_DATA_MISSING` em `MEDIUM`.

> [accordion] Use valores de assignee estáveis
>
> Passe um identificador estável na string `assignee` opaca e resolva a titularidade no seu sistema de identidade.

> [accordion] Acompanhe os SLAs por fora
>
> Defina prazos, avisos e escalonamento no seu sistema de workflow, porque o Matcher não os aplica.

> [accordion] Inspecione cada resultado em lote
>
> Trate as operações em lote como independentes por ID e lide com o sucesso parcial explicitamente.

> [accordion] Proteja os callbacks
>
> Proteja os tokens de callback e use chaves de idempotência estáveis quando sistemas externos atualizarem o status da exceção.

## Próximos passos

***

> [card] [Como resolver exceções](https://docs.lerian.studio/pt/products/matcher/daily-reconciliation/matcher-resolving-exceptions.md)
>
> Resolva exceções pela API ou por sistemas externos.

> [card] [Webhooks e callbacks](https://docs.lerian.studio/pt/products/matcher/integrations/matcher-webhooks-callbacks.md)
>
> Entrega avançada de eventos e tratamento de callbacks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.