> ## 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 > Classifique, atribua e escale transações não conciliadas com SLAs baseados em severidade e roteamento para sistemas de workflow externos. O roteamento de exceções define como as transações não conciliadas são classificadas, atribuídas e escaladas. Este guia descreve a classificação de severidade, as regras de atribuição, o rastreamento de SLA e as integrações com sistemas externos de workflow. ## Classificação de severidade *** As exceções são classificadas automaticamente por severidade para priorizar a revisão e a resolução. ### Regras de severidade padrão | Severidade | Critério padrão | SLA | | ----------- | ------------------------------------ | ------------------ | | **Crítica** | Valor ≥ 100.000 OU idade ≥ 120 horas | 24 horas | | **Alta** | Valor ≥ 10.000 OU idade ≥ 72 horas | 72 horas | | **Média** | Valor ≥ 1.000 OU idade ≥ 24 horas | 120 horas (5 dias) | | **Baixa** | Todos os outros casos | 168 horas (7 dias) | A severidade afeta diretamente os prazos de SLA, o comportamento de escalonamento e a prioridade de roteamento. ## Roteamento de atribuição *** O roteamento de atribuição garante que as exceções cheguem às equipes apropriadas automaticamente. ### Grupos de usuários Os grupos de usuários permitem estratégias de atribuição escaláveis e resilientes. Os métodos automáticos de atribuição de grupos de usuários (round\_robin, least\_loaded, random, all) estão planejados, mas ainda não implementados. Atualmente, as exceções podem ser atribuídas a usuários ou grupos individuais manualmente via API de atribuição. ## Rastreamento de SLA *** O rastreamento de SLA monitora o envelhecimento das exceções e dispara avisos ou escalonamentos quando os limites são atingidos. ## Endpoints adicionais de exceções *** Além do CRUD básico de exceções, o Matcher fornece endpoints para workflows avançados de exceções: | Endpoint | Método | Descrição | | ---------------------------------------------------------------------- | -------- | ------------------------------------------------------------------ | | [Despachar exceção](/pt/reference/matcher/dispatch-exception) | `POST` | Enviar uma exceção para um sistema ou equipe externa | | [Processar callback](/pt/reference/matcher/process-exception-callback) | `POST` | Receber callbacks de resolução de sistemas externos | | [Atribuição em lote](/pt/reference/matcher/bulk-assign-exceptions) | `POST` | Atribuir várias exceções a um usuário ou grupo de uma vez | | [Resolução em lote](/pt/reference/matcher/bulk-resolve-exceptions) | `POST` | Resolver várias exceções em uma única operação | | [Despacho em lote](/pt/reference/matcher/bulk-dispatch-exceptions) | `POST` | Despachar várias exceções para sistemas externos | | [Listar comentários](/pt/reference/matcher/list-exception-comments) | `GET` | Recuperar todos os comentários de uma exceção | | [Adicionar comentário](/pt/reference/matcher/add-exception-comment) | `POST` | Adicionar um comentário a uma exceção para auditoria e colaboração | | [Excluir comentário](/pt/reference/matcher/delete-exception-comment) | `DELETE` | Remover um comentário de uma exceção | | [Listar disputas](/pt/reference/matcher/list-disputes) | `GET` | Recuperar todas as disputas com filtros | | [Obter disputa](/pt/reference/matcher/retrieve-dispute) | `GET` | Recuperar detalhes de uma disputa específica | | [Abrir disputa](/pt/reference/matcher/open-dispute) | `POST` | Sinalizar uma exceção como disputada para revisão escalada | | [Fechar disputa](/pt/reference/matcher/close-dispute) | `POST` | Fechar uma disputa com uma resolução | | [Enviar evidência ](/pt/reference/matcher/submit-evidence) | `POST` | Adicionar evidência para fundamentar um caso de disputa | ## Integrações *** O Matcher se integra com sistemas externos para suportar workflows operacionais. * **JIRA**: Use o JIRA para rastrear e resolver exceções como issues. * **Webhooks**: Envie eventos de exceção para sistemas customizados em tempo real. Todas as integrações suportam: * Autenticação segura * Retry e backoff * Atualizações de status bidirecionais (quando habilitadas) ### Destinos de despacho Ao despachar uma exceção, o campo `targetSystem` deve ser um dos seguintes valores: | Destino | Descrição | | ------------ | ------------------------------------------------------------------------ | | `JIRA` | Despachar para um projeto JIRA | | `SERVICENOW` | Despachar para ServiceNow *(ainda não implementado — retorna MTCH-0508)* | | `WEBHOOK` | Despachar para um endpoint de webhook personalizado | | `MANUAL` | Sinalizar para tratamento manual fora de sistemas automatizados | ### Filtrando por sistema externo Ao listar exceções, o parâmetro de consulta `external_system` aceita qualquer valor de string para filtragem. Isso permite filtrar exceções despachadas para qualquer sistema, incluindo identificadores customizados que podem ter sido definidos através de callbacks. ### Tratamento de erros de despacho Ao despachar uma exceção para um sistema externo, o Matcher retorna respostas de erro específicas: | Código de status | Condição | Descrição | | ---------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | 200 | Sucesso | Exceção despachada e issue externa criada | | 400 | Requisição inválida | Campos obrigatórios ausentes (ID da exceção, sistema de destino ou ator) | | 422 | Sistema de destino não suportado | O valor do sistema de destino não é um dos destinos de despacho suportados listados acima | | 422 | Conector não configurado | O sistema de destino é válido, mas não possui configuração de conector. Verifique se a integração está configurada antes de despachar. | | 422 | Transição de estado inválida | A exceção não está em um estado despachável | ## Monitoramento e analytics *** Use estatísticas de roteamento para avaliar a efetividade: * Volume de exceções por severidade * Taxas de violação de SLA * Distribuição de regras de roteamento * Taxas de sucesso e falha de integrações ## Boas práticas *** Comece com roteamento baseado em severidade e expanda conforme os padrões emergem. O roteamento baseado em grupos melhora a resiliência e o balanceamento de carga de trabalho. Alinhe as metas de SLA com a capacidade operacional. Violações frequentes indicam limites desalinhados ou gaps de equipe. Teste sempre as integrações de JIRA e webhook em ambientes de não produção. Configure retries e alertas para caminhos de notificação críticos. ## Próximos passos *** Resolva exceções através da API ou de sistemas externos. Entrega avançada de eventos e tratamento de callbacks.