Lista de errores de BC Correios

Formato de error Las operaciones de Lerian BC Correios devuelven los errores como problem details de RFC 9457 con el tipo de medio application/problem+json:

{
  "code": "BCC-0005",
  "correlationId": "req-7a3f9c2e",
  "detail": "Mail not found or access denied",
  "status": 404,
  "title": "Not Found",
  "type": "https://errors.lerian.studio/v1/BCC-0005"
}

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, Not Found).
status – El código de estado HTTP.
detail – Una explicación legible de esta ocurrencia. En las respuestas 5xx, el detail dice internal error. Decide la rama con code en su lugar. El detail de BCC-2009, BCC-2010 y BCC-2011 está en portugués.
code – Un identificador estable para el error. Decide la rama con este campo. Las tablas siguientes listan los códigos BCC-NNNN y el código con nombre BANDWIDTH_LIMIT_EXCEEDED. Dos errores pueden compartir un estado y aun así diferir aquí. BCC-0006 y BCC-2010 responden ambos 409. El code te dice cuál obtuviste.
errors – Lista opcional de detalles de error individuales, cada uno con una location, un message y un value.
correlationId – El identificador de correlación con alcance de la solicitud.

Errores de solicitud

Estos errores se aplican a la solicitud misma. Cubren sus campos, sus headers, el recurso que nombra y el estado del servicio que la recibió.

`code`	Descripción	Estado
BCC-0001	Entrada no válida. Un valor de la solicitud no es válido. Una solicitud `POST`, `PUT` o `PATCH` con un `Content-Type` distinto de `application/json` responde `415`. Una clave `X-Idempotency` ya usada en otra solicitud responde `422`.	400, 415, 422
BCC-0002	Validación fallida. La solicitud no pasa la validación. Un rechazo por el esquema de la solicitud responde `422`, y `errors` nombra los campos responsables. Una verificación de campo responde `400`. Un rechazo del lado del cliente sin código propio también lleva `BCC-0002`, con su propio estado.	4xx
BCC-0003	Cursor no válido. El cursor de paginación no es válido o ya venció.	400
BCC-0005	No encontrado. El recurso no existe para el tenant de quien llama. En un envío, el correo que nombra `inReplyToMailId` no existe.	404
BCC-0006	La configuración ya existe. El tenant ya tiene una configuración. Actualízala en lugar de crearla de nuevo.	409
BCC-0007	Límite de solicitudes superado. Llegaron demasiadas solicitudes en la ventana actual. Vuelve a intentarlo después del intervalo del header `Retry-After`.	429
BCC-0008	Error interno del servidor. Una falla inesperada. El `detail` dice `internal error`.	500
BCC-0009	Servicio no disponible. El servicio, o una dependencia que necesita, no puede completar la solicitud. Vuelve a intentarlo más tarde.	503
BCC-0010	Checksum no coincidente. El adjunto almacenado no pasó su verificación de integridad en la descarga. El `detail` dice `internal error`.	500
BCC-0012	Clave de idempotencia duplicada. Una solicitud con la misma clave `X-Idempotency` todavía está en proceso, y la respuesta lleva un header `Retry-After`. En un nuevo análisis, una clave ya usada para otro correo responde `422`.	409, 422
BCC-0013	Modificación concurrente. Otra solicitud cambió el recurso antes. Lee los valores actuales y aplica tu cambio de nuevo.	409
BCC-0014	Estado no válido. El estado actual del correo no permite la acción. Una restauración de un correo en la carpeta `CANCELLED` o `SENT` responde este código.	409
BANDWIDTH_LIMIT_EXCEEDED	El tenant usó su presupuesto de descarga de adjuntos en la ventana actual de 60 segundos. Vuelve a intentarlo después del intervalo del header `Retry-After`.	429

Errores de autenticación

Estos errores se aplican al token y a los permisos de quien llama.

`code`	Descripción	Estado
BCC-1002	No autorizado. La solicitud no tiene bearer token, o el servicio no acepta el token.	401
BCC-1003	Prohibido. Quien llama no tiene permiso para esta operación. En el modo multi-tenant, un token sin claim de tenant también responde este código.	403

Errores de BC Correio y de envío

Estos errores se aplican a los mensajes que envías al BACEN por BC Correio.

`code`	Descripción	Estado
BCC-2001	Falla de autenticación con el BCB. El tenant no tiene configuración, o no tiene credenciales de BC Correio almacenadas, o el servicio no puede leerlas. Revisa la configuración del tenant.	401
BCC-2002	Servicio del BCB no disponible. BC Correio rechazó el mensaje, o el servicio no lo envió. Envía el mensaje de nuevo con una nueva clave `X-Idempotency`.	503
BCC-2009	Transmisión en curso. Otro envío con la misma clave `X-Idempotency` está en curso. Espera unos segundos y vuelve a intentarlo con la misma clave.	409
BCC-2010	Estado de transmisión desconocido. El servicio no puede saber si BC Correio recibió el mensaje. No lo envíes de nuevo. Confirma con el BACEN, por su canal manual, que no se entregó antes de usar una nueva clave.	409
BCC-2011	Transmisión fallida. Un envío anterior con la misma clave falló, y BC Correio no tiene el mensaje. Envía el mensaje de nuevo con una nueva clave.	409
BCC-4003	Adjunto demasiado grande para la transmisión. El cuerpo de la solicitud de envío supera los 8 MB.	413

Errores de insight de IA

Estos errores se aplican a un nuevo análisis de un correo por el proveedor de IA que configuró el tenant.

`code`	Descripción	Estado
BCC-3002	Análisis de IA fallido. El proveedor de IA devolvió un error en un nuevo análisis. El `detail` dice `internal error`.	502
BCC-3004	IA no configurada. La IA no está configurada para el tenant.	422
BCC-3005	IA sin contenido. El correo no tiene texto para analizar. Su cuerpo está vacío, y no salió texto de sus adjuntos.	422
BCC-3006	Extracción de adjuntos en curso. El servicio todavía extrae texto de los adjuntos del correo. Vuelve a intentarlo en unos segundos.	409

Correos

Configuración

Auditoría

Panel

Manejo de errores

Lista de errores de BC Correios

Errores de solicitud

Errores de autenticación

Errores de BC Correio y de envío

Errores de insight de IA

​Errores de solicitud

​Errores de autenticación

​Errores de BC Correio y de envío

​Errores de insight de IA

Errores de solicitud

Errores de autenticación

Errores de BC Correio y de envío

Errores de insight de IA