Lista de errores de Matcher

Formato de error

{
   "type": "https://errors.lerian.studio/v1/<error_code>",
   "title": "<error_title>",
   "status": 400,
   "detail": "<error_detail>",
   "code": "<error_code>"
}

Definiciones de los campos

type – Una URI que identifica el error, construida como https://errors.lerian.studio/v1/<code>.
title – El texto del estado HTTP (por ejemplo, Bad Request).
status – El código de estado HTTP.
detail – Una descripción breve de esta ocurrencia del error. Usa code para el manejo programático.
code – Un código de producto estable que identifica de forma única el error (por ejemplo, MTCH-0001). Útil para el manejo programático y las solicitudes de soporte.
errors – (opcional) Una lista con detalles de validación en el nivel de campo.

Detalles de error en el nivel de campo

Cuando la solicitud no pasa la validación de esquema, Matcher devuelve 422 Unprocessable Entity con un arreglo errors y sin code. Ejemplos:

{
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "validation failed",
  "errors": [
    { "message": "expected required property name to be present", "location": "body" }
  ]
}

{
  "type": "https://errors.lerian.studio/v1/MTCH-0005",
  "title": "Not Found",
  "status": 404,
  "detail": "No reconciliation context matches this id; check the context id and try again.",
  "code": "MTCH-0005"
}

Errores generales

Estos errores se aplican a todos los endpoints de la API de Matcher. 400

`code`	`title`	Descripción
`MTCH-0001`	Bad Request	La solicitud es inválida o tiene un formato incorrecto. Verifica el formato de la solicitud e inténtalo de nuevo.
`MTCH-0013`	Bad Request	El ID del contexto no es válido. Verifica el formato del ID e inténtalo de nuevo.

403

`code`	`title`	Descripción
`MTCH-0004`	Forbidden	No tienes permiso para hacer esta acción. Verifica tu nivel de acceso.
`MTCH-0012`	Forbidden	El contexto de conciliación no está activo. Activa el contexto antes de hacer esta operación.

404

`code`	`title`	Descripción
`MTCH-0005`	Not Found	El recurso solicitado no existe. Verifica el ID e inténtalo de nuevo.

409

`code`	`title`	Descripción
`MTCH-0007`	Conflict	La solicitud entra en conflicto con el estado actual del recurso. Verifica e inténtalo de nuevo.

413

`code`	`title`	Descripción
`MTCH-0010`	Request Entity Too Large	El archivo subido supera el tamaño máximo permitido. Reduce el tamaño del archivo e inténtalo de nuevo.

422

`code`	`title`	Descripción
`MTCH-0006`	Unprocessable Entity	La solicitud tenía un formato correcto, pero no se pudo procesar. Verifica los datos de entrada e inténtalo de nuevo.

500

`code`	`title`	Descripción
`MTCH-0002`	Internal Server Error	Ocurrió un error inesperado. El `detail` es `internal error`.

503

`code`	`title`	Descripción
`MTCH-0008`	Service Unavailable	Un servicio obligatorio no está disponible temporalmente. Inténtalo de nuevo más tarde.
`MTCH-0019`	Service Unavailable	El almacenamiento de objetos no está disponible temporalmente. Inténtalo de nuevo más tarde.

Errores de configuración

Matcher devuelve estos errores para un problema en la configuración de la conciliación (contextos, fuentes, mapas de campos, reglas de coincidencia, reglas de comisión, programaciones). 400

`code`	`title`	Descripción
`MTCH-0109`	Bad Request	Se requiere un nombre de contexto. Proporciona un nombre válido e inténtalo de nuevo.

404

`code`	`title`	Descripción
`MTCH-0111`	Not Found	No se encontró la fuente especificada. Verifica el ID de la fuente e inténtalo de nuevo.
`MTCH-0112`	Not Found	No se encontró el mapa de campos especificado. Verifica el ID del mapa de campos e inténtalo de nuevo.
`MTCH-0113`	Not Found	No se encontró la regla de coincidencia especificada. Verifica el ID de la regla de coincidencia e inténtalo de nuevo.
`MTCH-0114`	Not Found	No se encontró la regla de comisión especificada. Verifica el ID de la regla de comisión e inténtalo de nuevo.
`MTCH-0115`	Not Found	No se encontró la programación de comisiones especificada. Verifica el ID de la programación de comisiones e inténtalo de nuevo.
`MTCH-0116`	Not Found	No se encontró la programación especificada. Verifica el ID de la programación e inténtalo de nuevo.

409

`code`	`title`	Descripción
`MTCH-0101`	Conflict	Ya existe un contexto con este nombre. Elige un nombre diferente e inténtalo de nuevo.
`MTCH-0102`	Conflict	Ya existe un recurso con esta prioridad. Elige un valor de prioridad diferente e inténtalo de nuevo.
`MTCH-0103`	Conflict	El recurso está en un estado no válido para esta operación. Verifica su estado actual e inténtalo de nuevo.
`MTCH-0104`	Conflict	El contexto se archivó. Usa un contexto activo para esta operación.
`MTCH-0107`	Conflict	Ya existe un recurso con esta prioridad. Elige un valor de prioridad diferente.
`MTCH-0108`	Conflict	La programación de comisiones está en uso y no se puede eliminar.
`MTCH-0118`	Conflict	La regla de coincidencia no se puede eliminar porque un grupo de coincidencia confirmado que creó todavía tiene una excepción. Cambia la configuración de la regla en su lugar.

Errores de descubrimiento

Matcher devuelve estos errores para el descubrimiento de fuentes de datos y la gestión de conexiones. El descubrimiento depende del motor de extracción integrado de Matcher. Consulta Descubrimiento para saber cómo funciona. 400

`code`	`title`	Descripción
`MTCH-0204`	Bad Request	La solicitud de extracción no es válida. Verifica los parámetros e inténtalo de nuevo.
`MTCH-0208`	Bad Request	El tipo de conector especificado no está registrado en este despliegue. Verifica el tipo de conector e inténtalo de nuevo.

404

`code`	`title`	Descripción
`MTCH-0201`	Not Found	No se encontró la conexión especificada. Verifica el ID de la conexión e inténtalo de nuevo.
`MTCH-0202`	Not Found	No se encontró la extracción especificada. Verifica el ID de la extracción e inténtalo de nuevo.

409

`code`	`title`	Descripción
`MTCH-0205`	Conflict	Ya hay una actualización de descubrimiento en curso. Espera a que termine antes de iniciar una nueva.
`MTCH-0209`	Conflict	Matcher retiró la conexión, pero no pudo confirmar la eliminación en el sistema externo. Revisa en el sistema externo si una conexión todavía puede estar activa.

422

`code`	`title`	Descripción
`MTCH-0210`	Unprocessable Entity	Matcher no puede ejecutar pruebas de conectividad para este proveedor de agregador. No se ejecutó ninguna prueba y nada cambió.
`MTCH-0211`	Unprocessable Entity	La conexión de agregador todavía no está vinculada a una cuenta. Matcher no ejecutó la prueba. Completa el flujo de consentimiento alojado y vuelve a intentarlo.
`MTCH-0212`	Unprocessable Entity	El proveedor de agregador no emitió un token de consentimiento, y nada cambió. Prueba la conexión y vuelve a intentarlo.
`MTCH-0213`	Unprocessable Entity	Matcher no puede abrir un flujo de consentimiento alojado para este proveedor de agregador, y nada cambió. Contacta a soporte si necesitas el flujo de consentimiento para este proveedor.

503

`code`	`title`	Descripción
`MTCH-0203`	Service Unavailable	El motor de extracción no está disponible temporalmente. Inténtalo de nuevo más tarde.

Errores de ingesta

Matcher devuelve estos errores para la carga y el procesamiento de archivos de transacciones. 400

`code`	`title`	Descripción
`MTCH-0303`	Bad Request	Se requiere el formato del archivo. Especifica el formato e inténtalo de nuevo.
`MTCH-0304`	Bad Request	El archivo subido está vacío. Proporciona un archivo que no esté vacío e inténtalo de nuevo.
`MTCH-0307`	Bad Request	El archivo tenía un formato correcto, pero no contenía elementos de registro para ingerir. Verifica el contenido del archivo e inténtalo de nuevo.
`MTCH-0308`	Bad Request	El esquema del archivo subido no es compatible. Verifica la estructura del archivo e inténtalo de nuevo.
`MTCH-0317`	Bad Request	Se requiere una muestra de asignación. Proporciona una muestra e inténtalo de nuevo.
`MTCH-0322`	Bad Request	El cuerpo del documento está vacío. Proporciona un documento que no esté vacío e inténtalo de nuevo.

403

`code`	`title`	Descripción
`MTCH-0319`	Forbidden	La extracción de documentos no está habilitada. Contacta a soporte para activarla.

404

`code`	`title`	Descripción
`MTCH-0301`	Not Found	No se encontró la fuente de ingesta especificada. Verifica el ID de la fuente e inténtalo de nuevo.
`MTCH-0302`	Not Found	No se encontró el mapa de campos de ingesta especificado. Verifica el ID del mapa de campos e inténtalo de nuevo.
`MTCH-0306`	Not Found	No se encontró el trabajo de ingesta especificado. Verifica el ID del trabajo e inténtalo de nuevo.

408

`code`	`title`	Descripción
`MTCH-0311`	Request Timeout	La carga se detuvo porque no se recibieron datos dentro del tiempo permitido. Vuelve a intentar la carga.

409

`code`	`title`	Descripción
`MTCH-0305`	Conflict	El trabajo de ingesta está en un estado no válido para esta operación. Verifica su estado actual.
`MTCH-0324`	Conflict	La revisión de extracción ya no está pendiente y no se puede modificar. Verifica su estado actual.

422

`code`	`title`	Descripción
`MTCH-0309`	Unprocessable Entity	El trabajo de ingesta superó el umbral configurado de tasa de errores. Revisa los datos de la fuente e inténtalo de nuevo.
`MTCH-0310`	Unprocessable Entity	La configuración de la fuente no es válida. Corrige la configuración de la fuente y vuelve a intentar la carga.
`MTCH-0312`	Unprocessable Entity	El mapa de campos de la fuente no es válido. Corrige el mapa de campos y vuelve a intentar la carga.
`MTCH-0321`	Unprocessable Entity	No se pudo extraer ningún candidato a transacción del documento. Verifica el documento e inténtalo de nuevo.

503

`code`	`title`	Descripción
`MTCH-0313`	Service Unavailable	La función de buscar e ingerir no está habilitada en este despliegue. Sube el archivo manualmente.
`MTCH-0314`	Service Unavailable	No se pudo alcanzar ni leer el transporte externo. Inténtalo de nuevo más tarde.
`MTCH-0315`	Service Unavailable	La propuesta de asignación no está habilitada en este despliegue. Configura el mapa de campos manualmente.
`MTCH-0316`	Service Unavailable	El asesor de asignación no está disponible. Configura un mapa de campos manualmente.
`MTCH-0318`	Service Unavailable	La extracción de documentos no está habilitada en este despliegue. Ingiere el archivo manualmente.
`MTCH-0320`	Service Unavailable	El extractor de documentos no está disponible. Ingiere el archivo manualmente.
`MTCH-0323`	Service Unavailable	La revisión de extracción no está habilitada en este despliegue. Inténtalo de nuevo más tarde.

Errores de coincidencia

Matcher devuelve estos errores para el proceso de coincidencia de la conciliación. 400

`code`	`title`	Descripción
`MTCH-0401`	Bad Request	No hay fuentes configuradas para este contexto. Configura al menos una fuente antes de ejecutar una coincidencia.
`MTCH-0402`	Bad Request	Se requieren al menos dos fuentes para la coincidencia. Configura fuentes adicionales.
`MTCH-0403`	Bad Request	Cada fuente debe tener un lado definido. Especifica el lado de la fuente e inténtalo de nuevo.
`MTCH-0404`	Bad Request	La configuración de topología uno a uno no es válida. Verifica la configuración de la fuente.
`MTCH-0405`	Bad Request	La configuración de topología uno a muchos no es válida. Verifica la configuración de la fuente.

403

`code`	`title`	Descripción
`MTCH-0409`	Forbidden	La sugerencia de reglas no está habilitada. Contacta a soporte para activarla.

409

`code`	`title`	Descripción
`MTCH-0408`	Conflict	Ya hay una ejecución de coincidencia en curso para este contexto. Espera a que termine.
`MTCH-0413`	Conflict	La sugerencia ya no está pendiente y no se puede modificar. Verifica su estado actual.

422

`code`	`title`	Descripción
`MTCH-0406`	Unprocessable Entity	Se requieren reglas de comisión, pero no están configuradas. Agrega reglas de comisión antes de ejecutar una coincidencia.
`MTCH-0407`	Unprocessable Entity	Las reglas de comisión están mal configuradas. Revisa la configuración de las reglas de comisión e inténtalo de nuevo.
`MTCH-0412`	Unprocessable Entity	La sugerencia aprobada no pasó la validación. Revisa la sugerencia e inténtalo de nuevo.

503

`code`	`title`	Descripción
`MTCH-0410`	Service Unavailable	La sugerencia de reglas no está habilitada en este despliegue. Crea las reglas de coincidencia manualmente.
`MTCH-0411`	Service Unavailable	El asesor de reglas no está disponible. Crea las reglas de coincidencia manualmente.

Errores de excepciones

Matcher devuelve estos errores para el manejo de excepciones, disputas y procesamiento de callbacks. 404

`code`	`title`	Descripción
`MTCH-0501`	Not Found	No se encontró la excepción especificada. Verifica el ID de la excepción e inténtalo de nuevo.
`MTCH-0502`	Not Found	No se encontró la disputa especificada. Verifica el ID de la disputa e inténtalo de nuevo.
`MTCH-0507`	Not Found	No se encontró el comentario especificado. Verifica el ID del comentario e inténtalo de nuevo.
`MTCH-0512`	Not Found	Matcher aplicó la resolución, pero no pudo confirmar el registro actualizado de la excepción. Vuelve a cargar la excepción para ver su estado actual.

409

`code`	`title`	Descripción
`MTCH-0504`	Conflict	Ya se está procesando un callback para esta excepción. Espera a que termine.
`MTCH-0505`	Conflict	El callback tuvo un error transitorio y se puede reintentar. Vuelve a intentar la solicitud.
`MTCH-0510`	Conflict	Ya hay una liquidación en curso en esta excepción. Vuelve a intentar la solicitud en un momento.
`MTCH-0511`	Conflict	La excepción ya está resuelta, o hay una resolución en curso. Revisa los detalles de su resolución.

422

`code`	`title`	Descripción
`MTCH-0503`	Unprocessable Entity	La excepción está en un estado no válido para esta operación. Verifica su estado actual.
`MTCH-0508`	Unprocessable Entity	El tipo de destino de envío no es compatible. Verifica la configuración del destino.
`MTCH-0509`	Unprocessable Entity	El conector de envío no está configurado. Configura el conector e inténtalo de nuevo.

429

`code`	`title`	Descripción
`MTCH-0506`	Too Many Requests	Se superó el límite de tasa de callbacks. Espera antes de volver a intentarlo.

Errores de gobernanza

Las operaciones de registro de auditoría y gobernanza devuelven los errores generales, como MTCH-0005 cuando un registro de auditoría, una asignación de actor o un registro archivado no existe.

Errores de informes

Las operaciones de exportación de informes devuelven los errores generales. Un trabajo de exportación que no existe devuelve MTCH-0005, un trabajo que todavía no está listo para descargar o que ya terminó devuelve MTCH-0007, un worker de exportación deshabilitado devuelve MTCH-0702 y un almacenamiento de objetos no disponible devuelve MTCH-0019. Un archivo de exportación vencido devuelve 410 sin code.

Errores de límite de solicitudes

Matcher limita cuántas solicitudes puede enviar cada llamador en una ventana de tiempo. Una solicitud por encima del límite devuelve 429 antes de llegar a la operación, con un cuerpo plano en el que code es el número 429. El header Retry-After indica cuántos segundos debes esperar antes de reintentar.

{
  "code": 429,
  "title": "rate_limit_exceeded",
  "message": "rate limit exceeded"
}

Cuando Matcher no puede acceder al almacenamiento que cuenta las solicitudes, rechaza la solicitud con 503 y un cuerpo plano con la misma forma:

{
  "code": 503,
  "title": "service_unavailable",
  "message": "rate limiter temporarily unavailable"
}

Errores de autenticación

Access Manager verifica el token y los permisos de quien llama. Un rechazo de esa verificación no es un objeto de problema y no lleva código MTCH. Cuando Access Manager no responde, Matcher responde 503. 401

`code`	`title`	Descripción
`MTCH-0003`	Unauthorized	No se pudo autenticar la solicitud. Verifica tus credenciales e inténtalo de nuevo.

403

`code`	`title`	Descripción
`MTCH-0004`	Forbidden	El token no identifica un tenant. Verifica tu nivel de acceso.

Errores de idempotencia

Matcher devuelve estos errores para un problema con el manejo de la clave de idempotencia. 400

`code`	`title`	Descripción
`MTCH-0015`	Bad Request	La clave de idempotencia debe contener de 1 a 128 letras, dígitos, guiones, guiones bajos o dos puntos; no se procesó ninguna solicitud.

409

`code`	`title`	Descripción
`MTCH-0018`	Conflict	Ya se está procesando una solicitud con esta clave de idempotencia. Espera a que termine y luego reinténtalo con la misma clave; es posible que la solicitud original todavía tenga éxito.

500

`code`	`title`	Descripción
`MTCH-0016`	Internal Server Error	Ocurrió un error inesperado.
`MTCH-0017`	Internal Server Error	El procesamiento de idempotencia no está disponible temporalmente; vuelve a intentar la misma solicitud más tarde con la misma clave de idempotencia. Si la falla continúa, pídele a un administrador que revise el almacenamiento de idempotencia.

​Formato de error

​Definiciones de los campos

​Detalles de error en el nivel de campo

​Errores generales

​Errores de configuración

​Errores de descubrimiento

​Errores de ingesta

​Errores de coincidencia

​Errores de excepciones

​Errores de gobernanza

​Errores de informes

​Errores de límite de solicitudes

​Errores de autenticación

​Errores de idempotencia

Formato de error

Definiciones de los campos

Detalles de error en el nivel de campo

Errores generales

Errores de configuración

Errores de descubrimiento

Errores de ingesta

Errores de coincidencia

Errores de excepciones

Errores de gobernanza

Errores de informes

Errores de límite de solicitudes

Errores de autenticación

Errores de idempotencia