Saltar al contenido principal
Formato de error Lerian SLC devuelve los errores como problem details de RFC 9457 con el tipo de medio application/problem+json:
Definiciones de campos
  • type – Un URI que identifica el error en el catálogo de errores de Lerian, construido como https://errors.lerian.studio/v1/<code>.
  • title – El texto del estado HTTP, por ejemplo Conflict o Unprocessable Entity. Proviene del estado, no del nombre del error.
  • status – El código de estado HTTP, repetido de la línea de estado de la respuesta.
  • detail – Una explicación específica de esta ocurrencia. Una respuesta con estado 500 o superior lleva el texto fijo internal error, así que usa code para decidir la rama en lugar de analizar este campo.
  • code – El identificador estable para máquinas, con el formato SLC-NNNN. Usa este campo para decidir la rama.
  • correlationId – El identificador de correlación propio de la solicitud, el mismo valor que el header X-Request-Id de la respuesta. Cita este valor en una solicitud de soporte.
  • errors – Una lista de detalles por campo, cada uno con una location, un message y el value que causó el problema. Un fallo de validación de esquema lista una entrada por campo.

Errores de plataforma y de solicitud


Estos códigos pueden llegar desde cualquier endpoint. Cada uno describe la solicitud, la credencial o la disponibilidad del servicio, no la operación de liquidación en sí.

Errores de operación de liquidación


Estos códigos provienen del dominio de operaciones. Describen la instrucción de liquidación que enviaste, la operación original a la que apunta una cancelación, o la respuesta que recibió una conciliación de la contraparte.

Códigos de rechazo de Núclea


Núclea, la cámara de compensación que opera el SLC, responde a un envío o a un archivo de retorno con sus propios códigos de error de negocio, con el formato ESLCNNNN. Lerian SLC los registra contra la operación y los devuelve sin cambios. La respuesta de detalle de la operación lleva eslcErrors, un arreglo de los códigos registrados que está vacío cuando la operación no tiene ninguno. También incluye lastError, los códigos registrados unidos en una sola cadena, o null cuando no hay ninguno. eslcErrors también puede llevar el código de ocurrencia que devuelve una IF Domicílio. Cada valor llega textual desde la red, así que interprétalo como vocabulario de la contraparte y no como un código de Lerian. Núclea define 85 de estos códigos. La siguiente tabla cubre los que cambian lo que debes hacer a continuación.
Núclea puede rechazar de forma síncrona el envío de un archivo con uno de cuatro códigos: ESLC0119, ESLC0123, ESLC0140 y ESLC0161. La tabla de arriba indica la corrección de cada código. Operaciones de SLC describe el presupuesto de intentos de transmisión.
Los códigos restantes El resto del catálogo describe el registro enviado o el registro del participante. Las familias más grandes son:
  • Dominio y formato de campo – Un valor está fuera del dominio que permite el layout, o un segmento lleva el formato incorrecto. Aquí aparecen los códigos de moneda, los tipos de persona, los instituidores de esquema y los códigos de ocurrencia.
  • Registro e inscripción – Un CNPJ, un ISPB o una relación de participante difiere de lo que Núclea tiene registrado para el adquirente.
  • Números de control duplicados – Un número de control o un nombre de archivo repite uno que Núclea ya registró.
  • Fechas y períodos de reporte – Una fecha de pago, una fecha de referencia o un rango de reporte está fuera de lo que permite el tipo de producto.
  • Estado del registro y códigos de ocurrencia – El código de ocurrencia no corresponde al estado actual del registro, como un registro liquidado o uno cancelado.
  • Períodos de retorno – El registro está dentro de un período de retorno, y Núclea indica el tipo de archivo que lleva la corrección.
  • Límites y volúmenes – Un monto de pago, una cantidad de archivos o una cantidad de registros supera el máximo aceptado.
Núclea envía un código de estas familias en una línea de un archivo de retorno o en su veredicto sobre un envío. Lerian SLC lo registra en eslcErrors en la operación. Cita el código cuando plantees el caso con Núclea, porque es el identificador con el que trabaja el soporte de Núclea.