Lista de errores de SISBAJUD

Formato de error La Lerian SISBAJUD Mensageria y el Lerian SISBAJUD executor usan los mismos códigos de error, de SBJ-0001 a SBJ-0014, con los mismos estados HTTP. Un rechazo de licencia responde 403 con un código LCS-. Un error de operación usa detalles de problema RFC 9457 con el tipo de contenido application/problem+json:

{
  "type": "https://errors.lerian.studio/v1/SBJ-0001",
  "title": "Bad Request",
  "status": 400,
  "detail": "institutionId path parameter must be a valid non-nil UUID.",
  "code": "SBJ-0001"
}

Definiciones de campos

code – Un identificador estable para el error, con la forma SBJ-NNNN. Distingue por este valor.
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, Bad Request).
status – El código de estado HTTP.
detail – Orientación para esta ocurrencia del error. En las respuestas 5xx, el detail lleva el texto fijo internal error, así que usa code para distinguir.
errors – Lista opcional de detalles de validación por campo, cada uno con un message y un location.

Algunos rechazos ocurren antes de que la solicitud llegue a una operación, por ejemplo un método no admitido o un límite de tasa. Responden con el mismo code y title en un cuerpo JSON plano. La API de ejecución, que el executor llama en la Mensageria, es diferente: sus respuestas 409 y 422 usan un cuerpo de problema sin código SBJ-.

Errores del cliente

`code`	Descripción	Status
SBJ-0001	La solicitud tiene una sintaxis mal formada. Revisa los identificadores de ruta, el formato de la marca de tiempo y la longitud de los campos.	400
SBJ-0003	Falló la autenticación. Envía un token bearer válido.	401
SBJ-0004	La identidad del solicitante no tiene permiso para este recurso.	403
SBJ-0005	El recurso no existe. Revisa el identificador en la ruta.	404
SBJ-0007	La solicitud entra en conflicto con el estado actual del recurso, como una creación duplicada o una solicitud que ya llegó a un estado terminal.	409
SBJ-0012	Una operación de clave no puede seguir, y la misma solicitud falla de nuevo. Nada cambió.	409
SBJ-0010	El payload de la solicitud, o el contenido del archivo que pidió la solicitud, supera el tamaño aceptado.	413
SBJ-0006	La sintaxis es correcta, pero el servicio no puede procesar la solicitud. Un valor queda fuera del conjunto aceptado, o el recurso está en el estado incorrecto para la operación.	422
SBJ-0009	El solicitante envió demasiadas solicitudes en la ventana actual. Espera el número de segundos del header `Retry-After` y envía la solicitud de nuevo.	429
SBJ-0011	Un error del cliente fuera de los códigos anteriores, como un método HTTP no admitido. La respuesta conserva su estado original, así que lee el estado HTTP de la respuesta.	Otro `4xx`

Errores del servidor

`code`	Descripción	Status
SBJ-0002	El servicio falló de forma inesperada. Un error del servidor sin otro código también responde `SBJ-0002`. Envía la solicitud de nuevo, y contacta a soporte si el fallo continúa. Para una rotación de clave, lee Credenciales y rotación de claves antes de enviarla de nuevo.	500
SBJ-0008	Una dependencia que este endpoint necesita no está disponible. Contacta a tu equipo de plataforma si el fallo continúa.	503
SBJ-0013	El resultado de una rotación de clave no se conoce. No envíes la rotación de nuevo.	500
SBJ-0014	La clave rotó, pero un paso posterior de la rotación falló. No envíes la rotación de nuevo. Contacta a soporte.	500

SISBAJUD Mensageria · Instituciones

SISBAJUD Mensageria · Órdenes y archivos

SISBAJUD Mensageria · Monitoreo

SISBAJUD Mensageria · Archivos de retorno

SISBAJUD Mensageria · Solicitudes LGPD

SISBAJUD Mensageria · Seguridad

SISBAJUD Mensageria · Cumplimiento

SISBAJUD Mensageria · Dead letter de Lerian STA

SISBAJUD executor · Instituciones y conector Midaz

SISBAJUD executor · Órdenes que requieren atención

SISBAJUD executor · Enrutamiento de ledger

SISBAJUD executor · Seguridad

SISBAJUD executor · Auditoría

Manejo de errores

Lista de errores de SISBAJUD

Errores del cliente

Errores del servidor

​Errores del cliente

​Errores del servidor

Errores del cliente

Errores del servidor