Clasificación de severidad
Matcher clasifica las excepciones de forma automática a partir del monto y la antigüedad para apoyar la priorización de la revisión. El monto es el valor absoluto del monto base de la transacción o, cuando no tiene monto base, de su monto. Para una partida abierta vencida, es el valor absoluto del saldo abierto.
Reglas de severidad predeterminadas
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
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.
Destinos de despacho
Al despachar una excepción, configura el campotargetSystem con el siguiente valor:
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 devuelve las excepciones cuyo sistema externo es exactamente igual al valor. Solo los callbacks de entrada establecen ese valor. El despacho no lo establece.
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.
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.