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
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:
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 campotargetSystem debe ser uno de los siguientes valores:
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 consultaexternal_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 devuelveMTCH-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
Revisa la severidad automática
Revisa la severidad automática
Usa la severidad clasificada para priorizar la revisión y considera 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.Haz el seguimiento de los SLA de forma externa
Haz el seguimiento de los SLA de forma externa
Define plazos, avisos y escalamiento en tu sistema de workflow, porque Matcher no los aplica.
Valida la disponibilidad del despacho
Valida la disponibilidad del despacho
Confirma la configuración del conector seleccionado antes de depender del despacho dirigido por el llamador a JIRA, ServiceNow o webhook.
Inspecciona cada resultado masivo
Inspecciona cada resultado masivo
Trata las operaciones masivas como independientes por ID y maneja el éxito parcial de forma explícita.
Asegura los callbacks
Asegura los callbacks
Protege los tokens de callback y usa claves de idempotencia estables cuando sistemas externos actualicen el estado de las excepciones.
Próximos pasos
Resolver excepciones
Resuelve excepciones mediante la API o sistemas externos.
Webhooks y callbacks
Entrega avanzada de eventos y manejo de callbacks.