application/problem+json:
type– Un URI que identifica el error en el catálogo de errores de Lerian, construido comohttps://errors.lerian.studio/v1/<code>.title– El texto del estado HTTP, por ejemploConflictoUnprocessable 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 fijointernal error, así que usacodepara decidir la rama en lugar de analizar este campo.code– El identificador estable para máquinas, con el formatoSLC-NNNN. Usa este campo para decidir la rama.errors– Una lista de detalles por campo, cada uno con unalocation, unmessagey elvalueque 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 Nuclea
Nuclea, la cámara de compensación que opera la 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, y lastError, los códigos registrados unidos en una sola cadena. Cada valor de código llega textual desde la red, así que interprétalo como vocabulario de Nuclea y no como un código de Lerian.
Nuclea define 85 de estos códigos en su manual de layout de SLC. La siguiente tabla cubre los que cambian lo que debes hacer a continuación.
Cuatro de estos códigos te llegan en un rechazo síncrono del envío de un archivo:
ESLC0119, ESLC0123, ESLC0140 y ESLC0161. Llegan en el evento operation.forward_rejected, en rejectionCode, en lugar de en el archivo de retorno. Cada uno es una condición de registro o de inscripción que se aplica a todos los archivos que envía el participante, y un cambio de registro en Nuclea la resuelve. El archivo en sí no necesita ninguna edición.- 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 arreglo y los códigos de ocurrencia.
- Registro e inscripción – Un CNPJ, un ISPB o una relación de participante difiere de lo que Nuclea tiene registrado para el adquirente.
- Números de control duplicados – Un número de control o un nombre de archivo repite uno que Nuclea 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 Nuclea 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.
eslcErrors en la operación. Cita el código cuando plantees el caso con Nuclea, porque es el identificador con el que trabaja el soporte de Nuclea.