> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Lista de errores de BC Correios > Lerian BC Correios devuelve respuestas de error estructuradas. Consulta cada código de error de BC Correios, qué significa y el estado HTTP que lleva. **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`: ```json JSON theme={null} { "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/`. * **`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 | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.