> ## 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.
# Enrutamiento de excepciones
> Entiende la clasificación automática de severidad y usa la asignación explícita, las acciones masivas, el despacho dirigido por el llamador y los callbacks.
Matcher clasifica automáticamente por severidad las transacciones no conciliadas. La asignación, las operaciones masivas y el despacho son acciones explícitas de la API. Matcher no enruta ni escala excepciones de forma automática.
## Clasificación de severidad
***
Matcher clasifica las excepciones de forma automática a partir del monto base, la antigüedad y las señales de la fuente para apoyar la priorización de la revisión.
### Reglas de severidad predeterminadas
| Severidad | Criterio predeterminado de monto o antigüedad |
| ----------- | --------------------------------------------- |
| **Crítica** | Monto base ≥ 100,000 O antigüedad ≥ 120 horas |
| **Alta** | Monto base ≥ 10,000 O antigüedad ≥ 72 horas |
| **Media** | Monto base ≥ 1,000 O antigüedad ≥ 24 horas |
| **Baja** | Todos los demás casos |
Las señales de la fuente también pueden influir en la clasificación. Matcher limita en `MEDIUM` las excepciones con motivo `FEE_DATA_MISSING`, incluso cuando los umbrales de monto o antigüedad las clasificarían de otro modo como `HIGH` o `CRITICAL`.
## Asignación
***
La asignación es explícita. Para una excepción `OPEN`, la API de asignación acepta una sola cadena opaca `assignee` y cambia la excepción a `ASSIGNED`.
Matcher no tiene un modelo de grupos de usuarios y no implementa asignación automática, enrutamiento round-robin ni enrutamiento por menor carga. Si usas un identificador de usuario o de grupo, codifícalo en la cadena `assignee` y resuelve su significado en tu propio sistema de identidad.
## Comportamiento de SLA
***
Matcher guarda una fecha de vencimiento de SLA solo cuando un callback entrante suministra `dueAt`. No deriva un plazo a partir de la severidad, no emite avisos automáticos de SLA, no escala excepciones mediante un workflow de SLA ni las enruta de forma automática. Los agregados del dashboard pueden informar el cumplimiento de esas fechas de vencimiento suministradas de forma externa. Define y aplica la política de SLA en el sistema externo que envía el callback.
## Endpoints adicionales de excepciones
***
Más allá del CRUD básico de excepciones, Matcher ofrece endpoints para workflows avanzados de excepciones:
| Endpoint | Método | Descripción |
| ------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------- |
| [Despachar excepción](/es/reference/products/matcher/dispatch-exception) | `POST` | Intenta el despacho elegido por el llamador sin cambiar el estado de la excepción |
| [Procesar callback](/es/reference/products/matcher/process-exception-callback) | `POST` | Aplica una actualización externa idempotente y autenticada por token |
| [Asignación masiva](/es/reference/products/matcher/bulk-assign-exceptions) | `POST` | Asigna excepciones a una sola cadena `assignee` |
| [Resolución masiva](/es/reference/products/matcher/bulk-resolve-exceptions) | `POST` | Resuelve múltiples excepciones de forma independiente |
| [Despacho masivo](/es/reference/products/matcher/bulk-dispatch-exceptions) | `POST` | Despacha múltiples excepciones de forma independiente |
| [Listar comentarios](/es/reference/products/matcher/list-exception-comments) | `GET` | Recupera todos los comentarios de una excepción |
| [Agregar comentario](/es/reference/products/matcher/add-exception-comment) | `POST` | Agrega un comentario a una excepción para auditoría y colaboración |
| [Eliminar comentario](/es/reference/products/matcher/delete-exception-comment) | `DELETE` | Quita un comentario de una excepción |
| [Listar disputas](/es/reference/products/matcher/list-disputes) | `GET` | Recupera todas las disputas con filtrado |
| [Obtener disputa](/es/reference/products/matcher/retrieve-dispute) | `GET` | Recupera los detalles de una disputa específica |
| [Abrir disputa](/es/reference/products/matcher/open-dispute) | `POST` | Marca una excepción como disputada para revisión escalada |
| [Cerrar disputa](/es/reference/products/matcher/close-dispute) | `POST` | Cierra una disputa con una resolución |
| [Enviar evidencia ](/es/reference/products/matcher/submit-evidence) | `POST` | Agrega evidencia para respaldar un caso de disputa |
La asignación, la resolución y el despacho masivos aceptan de 1 a 100 IDs de excepción. Matcher procesa cada ID de forma independiente, así que espera éxito parcial. La asignación masiva acepta una sola cadena `assignee`, no un objeto de usuario o de grupo.
## Despacho y callbacks
***
El despacho es dirigido por el llamador: cada solicitud nombra el destino. El despacho registra un evento de auditoría, pero no cambia el estado de la excepción. No trates los nombres de destino aceptados como integraciones preconfiguradas.
### Destinos de despacho
Al despachar una excepción, el campo `targetSystem` debe ser uno de los siguientes valores:
| Destino | Descripción |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `JIRA` | Intenta el despacho a JIRA dirigido por el llamador; se requiere la configuración del conector en tiempo de ejecución. |
| `SERVICENOW` | Intenta la creación de incidentes por la Table API de ServiceNow dirigida por el llamador; se requiere la configuración del conector en tiempo de ejecución. |
| `WEBHOOK` | Intenta el despacho por webhook dirigido por el llamador; se requiere la configuración del conector en tiempo de ejecución. |
| `MANUAL` | Reconoce el despacho de forma local sin enviarlo a un sistema externo. |
Los callbacks entrantes son un flujo aparte, idempotente y autenticado por token. Un callback puede poner una excepción en `ASSIGNED` cuando incluye un asignado, o en `RESOLVED`. El despacho no hace sincronización bidireccional.
### Filtrar por sistema externo
Al listar excepciones, el parámetro de consulta `external_system` acepta cualquier valor de cadena para filtrar. Esto permite filtrar las excepciones despachadas a cualquier sistema, incluidos los identificadores personalizados que los callbacks pueden establecer.
### Manejo de errores de despacho
La validación de la solicitud y las fallas del conector usan respuestas de problema de la API. Un conector de ServiceNow sin configurar devuelve `MTCH-0509`. Si Matcher no puede confirmar un despacho a ServiceNow, devuelve `MTCH-0514`. Revisa ServiceNow antes de despachar de nuevo, porque el incidente puede ya existir. Un despacho exitoso reconoce la operación en el destino, pero de todos modos deja el estado de la excepción sin cambios.
## Resúmenes de cola y observabilidad
***
El listado de excepciones expone conteos de resumen por cola. Los agregados del dashboard exponen conteos de cumplimiento de SLA para las fechas de vencimiento suministradas de forma externa. Matcher no expone la distribución de reglas de enrutamiento ni analítica de éxito y falla de integraciones. Usa tu stack de observabilidad externo para esas señales operativas.
## Mejores prácticas
***
Usa la severidad clasificada para priorizar la revisión y considera el límite de `FEE_DATA_MISSING` en `MEDIUM`.
Pasa un identificador estable en la cadena opaca `assignee` y resuelve la propiedad en tu sistema de identidad.
Define plazos, avisos y escalamiento en tu sistema de workflow, porque Matcher no los aplica.
Confirma la configuración del conector seleccionado antes de depender del despacho dirigido por el llamador a JIRA, ServiceNow o webhook.
Trata las operaciones masivas como independientes por ID y maneja el éxito parcial de forma explícita.
Protege los tokens de callback y usa claves de idempotencia estables cuando sistemas externos actualicen el estado de las excepciones.
## Próximos pasos
***
Resuelve excepciones mediante la API o sistemas externos.
Entrega avanzada de eventos y manejo de callbacks.