Clasificación de severidad
Matcher clasifica las excepciones automáticamente a partir del monto base, la antigüedad y las señales de la fuente para facilitar la priorización de la revisión.
Reglas de severidad por defecto
Las señales de la fuente también pueden influir en la clasificación. Las excepciones con motivo
FEE_DATA_MISSING están limitadas a MEDIUM, incluso cuando los umbrales de monto o antigüedad las clasificarían como HIGH o CRITICAL.
Asignación
La asignación es explícita. Para una excepción
OPEN, la API de asignación acepta una única cadena opaca assignee y cambia la excepción a ASSIGNED.
Matcher no tiene un modelo de grupos de usuarios ni implementa asignación automática, enrutamiento round-robin o enrutamiento por menor carga. Si usas un identificador de usuario o grupo, codifícalo en la cadena
assignee y resuelve su significado en tu propio sistema de identidad.Comportamiento de SLA
Matcher contiene helpers de dominio que pueden calcular vencimientos de SLA, pero el flujo productivo de excepciones no los invoca. Matcher no establece actualmente plazos de SLA, emite advertencias, escala excepciones ni las enruta automáticamente. Controla y aplica los SLA operativos fuera de Matcher.
Endpoints adicionales de excepciones
Además del CRUD básico de excepciones, Matcher proporciona endpoints para flujos de trabajo avanzados de excepciones:
La asignación, resolución y el despacho masivos aceptan entre 1 y 100 IDs de excepciones. Matcher procesa cada ID de forma independiente, por lo que el éxito parcial es esperado. La asignación masiva acepta una única cadena
assignee, no un objeto de usuario o grupo.
Despacho y callbacks
El despacho lo dirige quien llama: cada solicitud indica 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.
Objetivos de despacho
Al despachar una excepción, el campotargetSystem debe ser uno de los siguientes valores:
Los callbacks entrantes son un flujo separado, autenticado por token e idempotente. Un callback puede establecer una excepción en
ASSIGNED cuando incluye un assignee, o en RESOLVED; no es una sincronización bidireccional realizada por el despacho.
Filtrado por sistema externo
Al listar excepciones, el parámetro de consultaexternal_system acepta cualquier valor de cadena para filtrar. Esto te permite filtrar excepciones despachadas a cualquier sistema, incluyendo identificadores personalizados que pueden haberse establecido a través de callbacks.
Manejo de errores de despacho
Los errores de validación y de conectores usan respuestas de problema de la API. En particular,SERVICENOW no devuelve MTCH-0508; actualmente devuelve el fallo genérico HTTP 500 por destino no soportado. Un despacho exitoso confirma la operación del destino, pero mantiene sin cambios el estado de la excepción.
Resúmenes de cola y observabilidad
La lista de excepciones expone recuentos resumidos con alcance de cola. Matcher no expone tasas de incumplimiento de SLA, distribución de reglas de enrutamiento ni analíticas de éxito y fallo de integraciones. Usa tu plataforma externa de observabilidad para esas señales operativas.
Mejores prácticas
Revisa la severidad automática
Revisa la severidad automática
Usa la severidad clasificada para priorizar la revisión y ten en cuenta el límite de
FEE_DATA_MISSING en MEDIUM.Usa valores de assignee estables
Usa valores de assignee estables
Pasa un identificador estable en la cadena opaca
assignee y resuelve la propiedad en tu sistema de identidad.Controla los SLA externamente
Controla los SLA externamente
Define plazos, advertencias y escalamiento en tu sistema de flujo de trabajo porque Matcher no los aplica.
Valida la disponibilidad del despacho
Valida la disponibilidad del despacho
Confirma que el conector elegido está configurado antes de depender del despacho dirigido a JIRA o webhooks.
Inspecciona cada resultado masivo
Inspecciona cada resultado masivo
Trata las operaciones masivas de forma independiente por ID y maneja explícitamente el éxito parcial.
Protege los callbacks
Protege los callbacks
Protege los tokens de callback y usa claves de idempotencia estables cuando sistemas externos actualicen el estado de una excepción.
Próximos pasos
Resolver excepciones
Resuelve excepciones a través de la API o de sistemas externos.
Webhooks y callbacks
Entrega avanzada de eventos y manejo de callbacks.