Lista de errores de Reporter

Formato de error Reporter devuelve los errores como problem details de RFC 9457 con el tipo de medio application/problem+json:

{
  "type": "https://errors.lerian.studio/v1/RPT-0012",
  "title": "Bad Request",
  "status": 400,
  "detail": "The specified templateID is not a valid UUID. Please check the value passed.",
  "code": "RPT-0012"
}

Definiciones de los campos

type – Un URI que identifica el error en el catálogo de errores de Lerian. Se construye 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 detallada para ayudarte a resolver el error. En las respuestas 5xx, Reporter siempre sanea el detalle a internal error, de modo que ninguna causa interna se filtra. Usa code para ramificar de forma programática.
code – Un identificador estable y único para el error (RPT-NNNN). Útil para el manejo programático y las solicitudes de soporte.
errors – Lista opcional de detalles de validación por campo, cada uno con un message y una location.

Algunos mensajes contienen marcadores de posición como %v o %s. Reporter los reemplaza por los valores específicos de tu solicitud.

Errores de Reporter

Las tablas a continuación enumeran los errores que pueden ocurrir cuando llamas a los endpoints de Reporter, qué significa cada uno y cómo resolverlo.

400: Errores de validación

`code`	Descripción	`detail`
RPT-0001	Faltan campos obligatorios	Faltan uno o más campos obligatorios. Verifica que se incluyan todos los campos obligatorios.
RPT-0002	Formato de archivo no válido	El archivo cargado debe ser un archivo .tpl. No se admiten otros formatos.
RPT-0003	Formato de salida no válido	El campo outputFormat debe ser uno de los siguientes: html, csv, pdf, txt o xml.
RPT-0004	Header no válido	Uno o más valores de header faltan o tienen un formato incorrecto. Verifica los headers requeridos %v.
RPT-0005	Archivo cargado no válido	El archivo que enviaste no es válido. Verifica el archivo cargado con el error: %v
RPT-0006	Error: archivo vacío	El archivo que enviaste está vacío. Verifica el archivo cargado.
RPT-0007	Error: contenido del archivo no válido	El contenido del archivo no es válido porque no es %s. Verifica el archivo cargado.
RPT-0008	Campos de mapeo no válidos	El campo del archivo de plantilla no es válido. Campo no válido %s en %s.
RPT-0009	Parámetro de ruta no válido	Los parámetros de ruta tienen un formato incorrecto. Verifica el siguiente parámetro %v y confirma que cumpla con el formato requerido antes de volver a intentarlo.
RPT-0010	Actualización del formato de salida sin archivo de plantilla	No es posible actualizar el formato de salida sin enviar el archivo de plantilla. Verifica la información enviada e inténtalo de nuevo.
RPT-0012	templateID no válido	El templateID especificado no es un UUID válido. Verifica el valor enviado.
RPT-0013	ledgerID no válido	El ledgerID especificado dentro de la lista de IDs de ledger no es un UUID válido. Verifica el valor enviado %v.
RPT-0014	Faltan campos obligatorios	Los campos mapeados en el archivo de plantilla faltan en el esquema de la tabla o pueden estar vacíos. Verifica los campos enviados: ‘%v’.
RPT-0015	Campos inesperados en la solicitud	El cuerpo de la solicitud contiene más campos de los esperados. Envía solo los campos permitidos según la documentación. Los campos inesperados aparecen en el objeto fields.
RPT-0016	Faltan campos en la solicitud	A tu solicitud le faltan uno o más campos obligatorios. Consulta la documentación para confirmar que se incluyan todos los campos necesarios en tu solicitud.
RPT-0017	Solicitud incorrecta	El servidor no pudo interpretar la solicitud debido a una sintaxis incorrecta. Verifica los campos indicados e inténtalo de nuevo.
RPT-0019	Parámetro de consulta no válido	Uno o más parámetros de consulta tienen un formato incorrecto. Verifica los siguientes parámetros ‘%v’ y confirma que cumplan con el formato requerido antes de volver a intentarlo.
RPT-0023	Error de rango de fechas no válido	Los campos ‘initialDate’ y ‘finalDate’ son obligatorios y deben tener el formato ‘yyyy-mm-dd’. Proporciona fechas válidas e inténtalo de nuevo.
RPT-0024	Límite de paginación superado	El límite de paginación supera el máximo permitido de %v elementos por página. Verifica el límite e inténtalo de nuevo.
RPT-0025	Orden de clasificación no válido	El campo ‘sort_order’ debe ser ‘asc’ o ‘desc’. Proporciona un orden de clasificación válido e inténtalo de nuevo.
RPT-0026	Longitud de la clave de metadatos superada	La clave de metadatos %v supera la longitud máxima permitida de %v caracteres. Usa una clave más corta.
RPT-0027	Longitud del valor de metadatos superada	El valor de metadatos %v supera la longitud máxima permitida de %v caracteres. Usa un valor más corto.
RPT-0028	Anidamiento de metadatos no válido	El objeto metadata no puede contener valores anidados. Verifica que el valor %v no esté anidado e inténtalo de nuevo.
RPT-0030	Falta la tabla del esquema	Falta la tabla de esquema %v para la fuente de datos ‘%v’. Verifica la información enviada.
RPT-0031	Falta la tabla de la fuente de datos	Falta la fuente de datos %v. Verifica el valor enviado.
RPT-0032	Etiqueta de script detectada	El archivo de plantilla contiene una etiqueta de script, lo cual no está permitido. Verifica el archivo de plantilla e inténtalo de nuevo.
RPT-0035	Referencia de esquema ambigua	La tabla ‘%v’ existe en varios esquemas: %v. Califícala con su esquema, como schema__%v.
RPT-0036	Esquema no encontrado	El esquema ‘%v’ no fue encontrado en la base de datos ‘%v’. Verifica el nombre del esquema.
RPT-0037	Tabla no encontrada en el esquema	La tabla ‘%v’ no fue encontrada en el esquema ‘%v’ de la base de datos ‘%v’. Verifica el nombre de la tabla y el esquema.
RPT-0038	Base de datos no registrada	La base de datos ‘%v’ no está registrada. Verifica la configuración de la fuente de datos.
RPT-0041	Bucket obligatorio	El nombre del bucket de almacenamiento es obligatorio. Verifica la configuración de almacenamiento.
RPT-0042	Clave de objeto obligatoria	La clave de objeto es obligatoria para la operación de almacenamiento.
RPT-0044	TTL no admitido	El parámetro TTL no se admite en el modo S3. Usa políticas de ciclo de vida del bucket en su lugar.
RPT-0046	Tipo de plazo no válido	El campo ‘type’ debe ser ‘regulatory’ o ‘custom’. Proporciona un tipo de plazo válido e inténtalo de nuevo.
RPT-0047	Frecuencia de plazo no válida	El campo ‘frequency’ debe ser uno de los siguientes: ‘once’, ‘daily’, ‘weekly’, ‘monthly’, ‘semiannual’, ‘annual’. Proporciona una frecuencia válida e inténtalo de nuevo.
RPT-0048	Color de plazo no válido	El campo ‘color’ debe ser un código de color hexadecimal válido (por ejemplo, ‘#FF5733’). Proporciona un color válido e inténtalo de nuevo.
RPT-0050	Meses del año no aplicable	El campo ‘monthsOfYear’ no aplica para la frecuencia ‘%v’. Solo puede usarse con las frecuencias ‘semiannual’ o ‘annual’.
RPT-0052	Meses del año obligatorios	El campo ‘monthsOfYear’ es obligatorio para la frecuencia ‘%v’. Especifica en qué meses del año debe repetirse el plazo.
RPT-0054	Meses del año fuera de rango	Cada valor en ‘monthsOfYear’ debe estar entre 1 y 12. Se recibió un valor no válido: %v.
RPT-0055	Vencimiento en el pasado	El campo ‘dueDate’ debe ser hoy o una fecha futura. Proporciona una fecha que no esté en el pasado.
RPT-0056	Cantidad de meses del año no coincide	La cantidad de meses en ‘monthsOfYear’ no coincide con la frecuencia ‘%v’. ‘semiannual’ requiere exactamente 2 meses y ‘annual’ requiere exactamente 1 mes.
RPT-0059	Falló la validación del esquema	La validación del esquema falló. Verifica los campos contra el esquema de la fuente de datos.
RPT-0062	Codificación UTF-8 no válida	El campo ‘%v’ contiene secuencias de bytes UTF-8 no válidas. Proporciona texto UTF-8 válido e inténtalo de nuevo.
RPT-0073	Nombre de configuración reservado para la fuente de datos	El `configName` está reservado para una fuente de datos gestionada por el operador y no puede asignarse ni renombrarse a través de la API.
RPT-0075	Ámbito de organización CRM no resuelto	No fue posible resolver el ámbito de organización de la fuente de datos CRM, por lo que la plantilla no puede guardarse de forma segura.
RPT-0076	Tabla de filtro no extraída	La tabla del filtro no coincide con ninguna tabla mapeada por la plantilla del informe. Usa una de las tablas mapeadas.
RPT-0077	El valor del filtro no puede leerse como fecha	El valor del filtro no puede leerse como fecha para el campo. Usa un valor de fecha u hora ISO adecuado para ese campo.
RPT-0078	Archivo de plantilla demasiado grande	El archivo de plantilla supera el límite de bytes admitido. Divide el informe en plantillas más pequeñas e inténtalo de nuevo.
RPT-0079	Conflicto entre operadores de filtro	El filtro combina operadores que no pueden usarse juntos. Conserva un operador compatible para el campo.
RPT-0080	Campo de la fuente de datos no válido	Un campo de la fuente de datos no es válido. Corrige el campo identificado y envía la solicitud de nuevo.
RPT-0090	La plantilla mapea demasiadas columnas	La plantilla mapea más columnas de las que un informe puede procesar. Reduce las columnas mapeadas o divide la plantilla.
RPT-0095	El límite del filtro no tiene valor	Un operador de filtro no tiene un valor comparable. Proporciona un valor o quita el operador.
RPT-0096	El filtro supera lo que una consulta puede soportar	Los filtros superan un límite de recursos de la consulta. Reduce los valores del filtro o acota la solicitud.
RPT-0097	El operador de filtro lleva una cantidad incorrecta de valores	El operador de filtro recibió una cantidad incorrecta de valores. Por ejemplo, `between` requiere exactamente dos valores.
RPT-0105	El valor del filtro no puede leerse frente al campo que filtra	El valor del filtro no puede leerse como el tipo que contiene el campo. Usa un valor compatible o un campo que admita fechas.
RPT-0106	Cursor no válido	El cursor no fue emitido por esta API o ya no identifica una posición usable. Reinicia el listado y sigue `nextCursor`.
RPT-0107	Falló la vista previa de la plantilla	No fue posible generar la vista previa de la plantilla. Corrige la plantilla o los datos de muestra y vuelve a intentarlo. El detalle de la respuesta identifica el motivo específico del rechazo.
RPT-0110	El período del filtro no puede compartir su campo	El campo del filtro usa `period` junto con otro operador. Un período ya define los dos extremos de su rango. Deja solo el período, o quítalo e indica tú mismo las dos fechas.
RPT-0111	El filtro del recordatorio supera lo que un recordatorio puede guardar	El filtro completo del plazo supera lo que un plazo puede almacenar. Divídelo en más de un plazo, cada uno con menos tablas.
RPT-0112	El filtro nombra algo que no puede ser un nombre	Una clave de filtro no puede nombrar una fuente de datos, una tabla ni un campo. Corrige la clave. Si una automatización la completó, revisa la variable que la alimenta.
RPT-0120	La categoría de la plantilla es obligatoria	La plantilla no tiene categoría. Envía `category` con la familia bajo la que se archiva el informe, como `cadoc`.
RPT-0121	La categoría de la plantilla no es un nombre de familia válido	La categoría debe coincidir con `^[a-z0-9_-]{1,100}$`. Reporter corrige mayúsculas y espacios en los extremos, pero rechaza un espacio interno, un punto, una barra o un acento.
RPT-0122	La plantilla no tiene categoría	El plazo nombra una plantilla sin categoría. Archiva la plantilla en una categoría y vuelve a enviar el plazo sin cambios.
RPT-0123	Demasiadas plantillas en una asociación de categoría	La solicitud asocia una categoría con más plantillas de las que admite una solicitud. Divide el trabajo en lotes más pequeños.
RPT-0124	La asociación de categoría no nombra ninguna plantilla	La solicitud no nombra ninguna plantilla. Envía `templateIds` con al menos un ID de plantilla.
RPT-0130	Zona horaria del plazo no válida	El campo `timezone` debe ser un nombre de zona horaria IANA válido, como `America/Sao_Paulo`.
RPT-0131	El período del filtro no es una ventana conocida	El valor de `period` no es una ventana que Reporter conozca. Escribe una de las ventanas que indica el detalle, exactamente como aparece.
RPT-0134	La condición del filtro no tiene operador	Un campo del filtro no nombra ningún operador, así que no acotaría el informe. Indica un operador con sus valores o quita el campo del filtro.
RPT-0135	La fuente de datos usa un nombre reservado	El nombre `system` está reservado para los parámetros de generación del informe. Elige otro `configName`.
RPT-0137	Contrato de documento no válido	No se puede cargar el contrato del documento regulatorio. El detalle indica el punto que debes corregir.
RPT-0138	Valor rechazado por el contrato del documento	Un valor producido para un campo no está permitido por el contrato del documento. Corrige el binding o los datos que lo respaldan y vuelve a generar el informe.
RPT-0139	Documento regulatorio fuera de este catálogo	La plantilla hace referencia a un documento regulatorio que este despliegue no ofrece. Indica un documento del catálogo.
RPT-0140	Parámetro de generación ausente o no válido	Falta un parámetro de generación que la plantilla declara o no es válido, o la plantilla declara un parámetro mal formado. Corrige los `parameters` de la solicitud o la declaración.
RPT-0141	La plantilla marca una posición que el contrato no declara	La plantilla marca un campo que el contrato del documento regulatorio no declara. Corrige el nombre en la plantilla.
RPT-0142	Una plantilla regulatoria no se carga	Un documento regulatorio curado toma su diseño del catálogo, así que no se carga ningún archivo de plantilla para él. Indica el documento y su fuente de datos, o crea un informe personalizado.
RPT-0143	Binding del documento no válido	No se puede leer el binding del documento. El detalle indica el punto que debes corregir. Corrígelo y vuelve a guardar el binding.
RPT-0146	Suscripción no válida	La suscripción no puede usarse tal como está. El detalle indica qué corregir.
RPT-0149	No se puede aplicar la corrección	La corrección no es válida para su posición en el documento. Corrígela en la posición indicada y vuelve a aplicarla.
RPT-0153	La procedencia del informe está incompleta	Al registro de procedencia congelado del informe le falta un elemento obligatorio, por lo que Reporter se negó a guardarlo. El detalle indica el elemento.
RPT-0154	El contenido del catálogo no es el que se publicó	La versión del catálogo falló la verificación de integridad y fue rechazada. El catálogo vigente no cambia. Revisa la versión y la ruta por la que llegó.
RPT-0155	No se puede obtener la versión regulatoria	El origen del catálogo no pudo proporcionar los archivos del documento, así que no se escribió nada. Vuelve a intentarlo cuando el origen responda. Los documentos ya suscritos no se ven afectados.
RPT-0165	La plantilla tiene una macro recursiva	Una macro de la plantilla se llama a sí misma, directamente o a través de otra macro, así que la generación nunca terminaría. Rompe el ciclo y vuelve a cargar la plantilla.
RPT-0166	La plantilla da formato a un importe y después lo altera	La plantilla aplica otro filtro después del filtro `decimal`, lo que pondría un importe incorrecto en el archivo. Mueve el otro filtro antes de `decimal` o quítalo.
RPT-0169	La institución no es válida	Un campo de la institución no es válido: un nombre en blanco, un CNPJ cuyos dígitos verificadores no coinciden o un ámbito mal formado. Corrige el campo y vuelve a enviar la institución.
RPT-0173	Ninguna tabla de organización de Midaz	Ninguna de las fuentes de datos indicadas contiene la tabla de organización de Midaz, así que no hay organización para proponer como institución. Indica la fuente de datos de la base de onboarding de Midaz.
RPT-0174	La fuente de datos no es PostgreSQL	Reporter solo propone instituciones a partir de bases PostgreSQL de Midaz. Omite la fuente de datos o indica la fuente de datos de la base de onboarding de Midaz.
RPT-0175	Más de una tabla de organización de Midaz	Las fuentes de datos indicadas contienen más de una tabla de organización de Midaz. Indica solo la fuente de datos de la base de onboarding de Midaz.
RPT-0180	Elige la institución	El tenant tiene varias instituciones y la solicitud no nombra ninguna. Define `institution` con un ID de institución, o con `all` para leer las filas de todas las instituciones en un solo informe.
RPT-0181	La institución no cubre esta tabla	El informe lee una tabla que el ámbito de la institución no filtra ni marca como compartida. Agrega la tabla al ámbito de la institución y vuelve a solicitar el informe.
RPT-0183	La selección de institución no es válida	El valor de `institution` no es un ID de institución ni `all`, o es `all` en una presentación regulatoria, que declara exactamente una institución.
RPT-0190	Elige la institución que hace la presentación	Una presentación regulatoria declara exactamente una institución. La solicitud no nombra ninguna y el tenant no tiene exactamente una. Indica la institución que hace la presentación, también en la suscripción cuando sea anterior a las instituciones, y registra una primero si el tenant no tiene ninguna.
RPT-0193	El filtro de prefijo necesita texto	Un filtro `startsWith` o `notStartsWith` lleva una entrada que no es un texto no vacío, o apunta a una columna que no guarda texto. Da a cada entrada un prefijo de texto no vacío, en una columna de texto.
RPT-0196	El declarante no es la institución	El CNPJ que declara la presentación no es el CNPJ de la institución para la que se genera la presentación. La generación termina en `Error`, y se rechaza una corrección con ese valor. Corrige el CNPJ donde el mapeo lo lee, o el registro de la institución.

RPT-0075: CRM Organization Scope Unresolved

RPT-0075 es una protección de tipo fail-closed para las plantillas que mapean plugin_crm. Reporter no guarda ni ejecuta un mapeo de CRM sin ámbito definido porque eso podría exponer registros entre organizaciones de Midaz. Puede ocurrir al importar, crear o actualizar una plantilla de CRM, y cuando un worker resuelve una plantilla de CRM ya guardada. No trates este código como prueba de que falta una variable de entorno. También ocurre cuando Reporter no puede encontrar plugin_crm en el registro de fuentes de datos. Primero confirma que la plantilla mapea plugin_crm, luego revisa la configuración del Manager y del worker, la disponibilidad del registro y los ajustes de conexión del CRM que no son sensibles. Para un despliegue self-hosted, configura el bloque completo DATASOURCE_CRM_*, incluido DATASOURCE_CRM_MIDAZ_ORGANIZATION_ID, y mantén la contraseña del CRM y CRYPTO_HASH_SECRET_KEY_CRM / CRYPTO_ENCRYPT_SECRET_KEY_CRM en Secrets. Esas claves criptográficas deben ser las mismas que usa el CRM, y DATASOURCE_CRED_ENC_KEY debe mantenerse estable. Al iniciar el Manager, la semilla de fuente de datos reservada puede completar un metadata.midazOrganizationId ausente o vacío. La semilla nunca sobrescribe un valor persistido que no esté vacío. No crees ni apliques PATCH a plugin_crm a través de la API común de fuentes de datos. Si un ID de organización persistido y no vacío es incorrecto, detén la recuperación genérica y contacta al soporte de Lerian. Después de un cambio aprobado, importa o guarda la plantilla, genera un informe, confirma que los campos del CRM se descifran y verifica el aislamiento entre organizaciones. Consulta Reporter mediante Helm para conocer los valores del chart.

401: No autorizado

`code`	Descripción	`detail`
RPT-0158	Autor de la acción no identificado	La solicitud fue autorizada, pero no identifica quién actúa, y Reporter registra cada corrección y aprobación a nombre de una persona. Presenta un token que lleve un claim de subject.

404: No encontrado

`code`	Descripción	`detail`
RPT-0011	Entidad no encontrada	No se encontró ninguna entidad %v para el ID proporcionado. Verifica que uses el ID correcto para la entidad que intentas gestionar.
RPT-0020	Error de formato de fecha no válido	’initialDate’, ‘finalDate’, o ambos, tienen un formato incorrecto. Usa el formato ‘yyyy-mm-dd’ e inténtalo de nuevo.
RPT-0021	Error de fecha final no válida	’finalDate’ no puede ser anterior a ‘initialDate’. Verifica las fechas e inténtalo de nuevo.
RPT-0022	Error: el rango de fechas supera el límite	El rango entre ‘initialDate’ y ‘finalDate’ supera el límite permitido de %v meses. Ajusta las fechas e inténtalo de nuevo.
RPT-0043	Objeto no encontrado	El objeto solicitado no fue encontrado en el almacenamiento.
RPT-0057	Fuente de datos no encontrada	La fuente de datos solicitada no fue encontrada. Verifica el ID de la fuente de datos.
RPT-0147	Documento regulatorio no disponible	El documento regulatorio no está en el catálogo de este despliegue, o el despliegue no tiene catálogo. Lista el catálogo para ver qué documentos ofrece.

409: Conflictos

`code`	Descripción	`detail`
RPT-0039	Solicitud duplicada en curso	Actualmente se está procesando una solicitud duplicada. Espera e inténtalo de nuevo.
RPT-0040	Conflicto de idempotencia	Ya se procesó una solicitud con esta clave de idempotencia.
RPT-0045	Plazo duplicado	Ya existe un plazo con el mismo nombre, tipo, vencimiento y frecuencia. Usa valores diferentes o actualiza el plazo existente.
RPT-0071	Conflicto en el nombre de configuración de la fuente de datos	Ya existe una fuente de datos con el mismo `configName`. Usa un `configName` diferente e inténtalo de nuevo.
RPT-0072	Fuente de datos en uso por una plantilla	La fuente de datos está referenciada por plantillas y no puede eliminarse ni renombrarse. Actualiza o elimina primero esas plantillas.
RPT-0144	El binding cambió mientras lo editabas	Alguien guardó el binding después de que lo abriste. Vuelve a cargar el binding, aplica tu cambio encima y guarda de nuevo.
RPT-0145	El documento ya está suscrito	La institución ya entrega este documento con otra suscripción. Edita el binding de esa suscripción o cancélala primero.
RPT-0150	El borrador cambió mientras lo editabas	Alguien corrigió el borrador después de que lo abriste. Vuelve a cargar el borrador, aplica tu corrección encima e inténtalo de nuevo.
RPT-0151	El informe ya fue aprobado	Un informe aprobado no cambia. Para entregar algo distinto, genera un informe nuevo.
RPT-0152	El informe no es un borrador	Una corrección solo se aplica a un borrador. El informe todavía se está generando, o su generación falló.
RPT-0156	Borrador con campos obligatorios en blanco	Hay campos obligatorios del borrador sin valor. Completa cada uno con una corrección y luego aprueba o descarga el borrador.
RPT-0167	Otra suscripción del documento está activa	Otra suscripción ya entrega este documento para la misma institución. Desactiva esa suscripción primero, o deja esta inactiva.
RPT-0168	Fuente de datos integrada	La plataforma proporciona esta fuente de datos y es de solo lectura. No puedes actualizarla, eliminarla ni probarla, ni registrar otra fuente de datos con su nombre.
RPT-0170	El CNPJ ya está registrado	El tenant ya registró una institución con este CNPJ. Edita esa institución o elimínala primero.
RPT-0171	La institución cambió mientras la editabas	Alguien actualizó la institución después de que la leíste. Vuelve a leerla, aplica tu cambio encima y guarda con el ETag que devuelva.
RPT-0182	La institución está en uso	Plazos o suscripciones regulatorias activas todavía generan informes para esta institución. Apunta los plazos a otra institución o elimínalos, desactiva las suscripciones y vuelve a eliminar la institución.
RPT-0191	La suscripción cambió mientras la editabas	Alguien cambió la suscripción después de que la leíste. Vuelve a leerla y escribe con la versión que devuelva.
RPT-0197	El período ya tiene un original aprobado	El período ya tiene una presentación original aprobada, así que Reporter rechaza otro original, en la generación y en la aprobación. Para presentar el período de nuevo, genera una sustitución.
RPT-0198	Todavía no hay nada que sustituir	El período no tiene una presentación original aprobada, así que una sustitución no tiene nada que sustituir. Genera el original y apruébalo primero.
RPT-0199	Otra versión está publicada ahora	La suscripción o la adopción nombra una versión distinta de la que el catálogo publica ahora. Lee la versión que publica el catálogo y vuelve a enviar la solicitud.

412: Falló la condición previa

`code`	Descripción	`detail`
RPT-0074	Protección de credenciales de la fuente de datos no configurada	La protección de credenciales no está configurada. Define `DATASOURCE_CRED_ENC_KEY` e inténtalo de nuevo.

422: No procesable

`code`	Descripción	`detail`
RPT-0029	El estado del informe no es Finished	El informe no está listo para descargar. El informe todavía se está procesando.
RPT-0157	El artefacto almacenado no coincide con su procedencia	El checksum del archivo almacenado no coincide con el checksum congelado cuando se generó el informe, por lo que Reporter no entrega el archivo. Vuelve a generar el informe o investiga el almacenamiento.

428: Condición previa requerida

`code`	Descripción	`detail`
RPT-0148	Versión del binding obligatoria	Guardar un binding requiere el header `If-Match` con el ETag de la última lectura. Vuelve a leer el binding y guarda con ese ETag.
RPT-0172	Versión de la institución obligatoria	Actualizar una institución requiere el header `If-Match` con el ETag de la última lectura. Vuelve a leer la institución y guarda con ese ETag.
RPT-0192	Versión de la suscripción obligatoria	Cambiar una suscripción requiere el header `If-Match` con la versión de la última lectura. Vuelve a leer la suscripción y escribe con esa versión.

429: Demasiadas solicitudes

`code`	Descripción	`detail`
RPT-0108	Vista previa de plantilla ocupada	Todos los espacios simultáneos configurados para la vista previa están en uso, para una vista previa de plantilla o de una consulta del mapeo. No se rechazó nada; vuelve a intentar la vista previa en unos momentos.

500: Errores del servidor

`code`	Descripción	`detail`
RPT-0018	Error interno del servidor	internal error
RPT-0034	Error de comunicación con SeaweedFS	internal error

Toda falla inesperada durante el manejo síncrono de un endpoint se presenta como HTTP 500. La respuesta lleva code: RPT-0018, o code: RPT-0034 cuando falla el almacenamiento de archivos, y un detalle saneado de internal error. Las causas internas nunca se filtran en el cuerpo de la respuesta. Las fallas asíncronas del worker y de la generación de informes, en cambio, siguen los estados del informe y los metadatos descritos a continuación. Reporter no las devuelve a la solicitud original como HTTP 500.

Errores de generación de informes (asíncronos)

La generación de informes se ejecuta de forma asíncrona en el worker. La solicitud HTTP original nunca recibe una sección de extracción de datos fallida. El informe termina con estado Error cuando fallan todas las secciones, o Partial cuando fallan algunas. En cualquiera de los dos casos, metadata.error_code es RPT-0060. Las claves de metadata.sections son nombres de bases de datos. Cada entrada fallida contiene su error_code clasificado (RPT-0018 para una falla sin tipo). Una entrada RPT-0075 también lleva un mensaje remediation. Cuando el worker termina un informe con un rechazo RPT, el informe queda con estado Error. metadata.error_code lleva el código RPT, metadata.error_title su título, y metadata.error su mensaje. Otras fallas del worker terminan con estado Error y un metadata.error_code que no es RPT: report_generation_failed, report_generation_timeout, report_generation_canceled o report_message_schema_unsupported. Estas fallas no tienen un mapa sections. Un informe cuyo worker dejó de indicar que seguía activo termina con estado Error y metadata.error_code RPT-0160.

`code`	Descripción	Significado
RPT-0058	Fuente de datos no disponible	La fuente de datos no está disponible en este momento. Los resultados pueden estar incompletos.
RPT-0060	Falló el trabajo de extracción	El trabajo de extracción falló. Inténtalo de nuevo más tarde o contacta a soporte.
RPT-0061	Falló la generación de la plantilla	No fue posible generar la plantilla con los datos proporcionados. Este es un error permanente y no se resolverá al reintentar.
RPT-0063	Clave hash del CRM no configurada	La clave hash del CRM no está configurada.
RPT-0064	Clave de cifrado del CRM no configurada	La clave de cifrado del CRM no está configurada.
RPT-0065	Falló el descifrado del registro	El descifrado del registro falló.
RPT-0066	Falló la inicialización del cifrador	La inicialización del cifrador falló.
RPT-0067	Datos extraídos no válidos	Los datos extraídos no son válidos.
RPT-0068	Resultado de recolección inesperado	La recolección de datos devolvió un resultado inesperado.
RPT-0069	Fuente de datos no encontrada	No se encontró la fuente de datos referenciada por el informe.
RPT-0070	Fuente de datos no disponible	La fuente de datos no estaba disponible durante la extracción.
RPT-0136	Versión de esquema del mensaje de informe no admitida	El worker recibió un mensaje de informe escrito para una versión de esquema más reciente de la que admite, y lo rechazó. El informe termina con estado `Error` y `metadata.error_code` `report_message_schema_unsupported`. Vuelve a generar el informe cuando todos los workers ejecuten la versión más reciente.
RPT-0160	Worker del informe perdido	El worker a cargo del informe dejó de indicar que seguía activo, por lo que Reporter terminó el informe con estado `Error`. Busca un worker detenido o bloqueado.
RPT-0161	Límite de filas superado	Una sección de datos encontró más filas que el límite de filas configurado en la fuente de datos. La sección falla en lugar de devolver un resultado truncado. Acota el filtro del informe o aumenta el límite de filas de la fuente de datos.
RPT-0162	Tiempo de espera de consulta de la fuente de datos	La consulta de una sección de datos no terminó dentro del tiempo de espera de consulta configurado en la fuente de datos. Acota el filtro del informe o aumenta el tiempo de espera de consulta de la fuente de datos.
RPT-0195	Nada que presentar	Un conjunto que el documento no puede presentar vacío, o un conjunto cerrado, no leyó ninguna fila. El mensaje dice lo que leyó cada consulta. Revisa el período, los filtros y el alcance de la institución, y luego los datos mismos.

Errores de generación programada (registrados en el log)

El programador de plazos genera estos códigos. Se ejecuta en el Manager cuando DEADLINE_TRIGGER_ENABLED=true. No responde a ninguna solicitud, así que los códigos aparecen solo en sus líneas de log, nunca en una respuesta HTTP. Cada código está en el campo error_code de su línea de log, excepto RPT-0113, que aparece solo en el campo error. Cuando un rechazo no se resuelve con un reintento, una segunda línea lo informa con error_code RPT-0118 y lleva el código original en error.

`code`	Descripción	Significado
RPT-0113	El recordatorio no nombra una plantilla de la cual leer la familia	El plazo venció, pero no nombra ninguna plantilla, así que no hay familia de informe que generar. La ocurrencia se anuncia igual. Si el plazo debe producir un informe, asígnale un `templateId` cuya plantilla tenga categoría.
RPT-0114	La plantilla no tiene familia al despachar	La plantilla del plazo no tiene categoría cuando el programador la despacha, así que no se genera ningún informe. Archiva la plantilla en una categoría.
RPT-0115	La generación programada no pudo verificar su tenant	El programador no pudo confirmar el tenant dueño del plazo, así que no escribió nada.
RPT-0116	No se pudo resolver la ventana del recordatorio al despachar	El programador no pudo resolver la ventana de datos de la ocurrencia, así que no se genera ningún informe para ella. Vuelve a guardar el plazo con una ventana que Reporter conozca.
RPT-0117	Se rechazó la generación programada del informe	La generación de informes rechazó la solicitud programada. La línea de log lleva el rechazo subyacente.
RPT-0118	Generación programada sin reintento útil	Califica un rechazo que se repite en cada ocurrencia hasta que alguien cambie el plazo, la plantilla o el filtro.
RPT-0119	Generación programada agotada	El mismo rechazo se repitió en ocurrencias consecutivas, así que el programador dejó de intentar generar el informe de este plazo. El anuncio se sigue enviando.
RPT-0132	Ocurrencias programadas omitidas	Hubo ocurrencias que vencieron y se omitieron cuando el programador avanzó. Cada ocurrencia omitida no produjo informe. Es un aviso, no una falla.
RPT-0133	Recuperación programada incompleta	El programador produjo parte del atraso de un plazo, y la próxima ejecución continúa desde donde se detuvo. `catch_up_stop_reason` es `tenant_budget_spent` (una advertencia) o `ceiling_reached` (un error: investiga la demora).

Primeros pasos

API de Plantillas

API del Constructor de Plantillas

API de Informes

API de Plazos

API de Fuentes de Datos

API de Instituciones

API de Catálogo Regulatorio

API de Suscripciones Regulatorias

API de Mapeos Regulatorios

API de Informes Regulatorios

API de Métricas

API de Streaming

Manejo de errores

Eventos

Lista de errores de Reporter

Errores de Reporter

400: Errores de validación

RPT-0075: CRM Organization Scope Unresolved

401: No autorizado

404: No encontrado

409: Conflictos

412: Falló la condición previa

422: No procesable

428: Condición previa requerida

429: Demasiadas solicitudes

500: Errores del servidor

Errores de generación de informes (asíncronos)

Errores de generación programada (registrados en el log)

​Errores de Reporter

​400: Errores de validación

​RPT-0075: CRM Organization Scope Unresolved

​401: No autorizado

​404: No encontrado

​409: Conflictos

​412: Falló la condición previa

​422: No procesable

​428: Condición previa requerida

​429: Demasiadas solicitudes

​500: Errores del servidor

​Errores de generación de informes (asíncronos)

​Errores de generación programada (registrados en el log)

Errores de Reporter

400: Errores de validación

RPT-0075: CRM Organization Scope Unresolved

401: No autorizado

404: No encontrado

409: Conflictos

412: Falló la condición previa

422: No procesable

428: Condición previa requerida

429: Demasiadas solicitudes

500: Errores del servidor

Errores de generación de informes (asíncronos)

Errores de generación programada (registrados en el log)