Lista de errores de SISBAJUD

Consulta un código de error de Lerian SISBAJUD, el estado HTTP que lleva y la acción que lo resuelve. Esta lista sirve a la Mensageria.

Formato de error

La Lerian SISBAJUD Mensageria usa los códigos de error SBJ-0001 a SBJ-0014. El Plugin SISBAJUD responde los mismos códigos con los mismos estados HTTP, y agrega códigos propios. La lista de errores del Plugin SISBAJUD los enumera. 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:

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. El 503 de reconsolidate y resolve-transmission es la excepción: cuando Lerian STA no responde, su detail nombra el rail de Lerian STA.
• 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 Plugin SISBAJUD 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