Reportes IA: motor interno de Boost

Códigos de error · 6 códigos · catálogo del 2026-10-21

Reportes internos de Boost para la IA de reportes (InternalReportsService, src/ai/internal/): cartera, asignaciones, cotizaciones, oportunidades y resumen de compras, con el alcance real de RecordsAccessService, recetas y Sistema 0 por entidad y el glosario de Boost de cada entidad (tablas ai_report_*, sql/ai/ai-reportes-motor.sql). Los estados de un reporte (decision_unavailable, source_unavailable, forbidden…) no son excepciones: viajan en el status/reason del resultado.

Para toda la familia

Lo que un código no dice lo hereda de aquí.

Cómo se detecta

La respuesta (code). Tablas que faltan: aviso ai_report_… no está disponible en el log de Render (una vez por proceso).

Qué hacer

El mensaje dice qué falta. Si es una tabla, aplica sql/ai/ai-reportes-motor.sql (con autorización de Roor en producción).

Filtrar los códigos de esta página6 códigos

Códigos

ai_report_knowledge_conflict

HTTPHTTP 409

Dos personas cambiaron el glosario de Boost de la misma entidad a la vez: la segunda no se guardó (llave única entidad + versión).

Qué hacer

Volver a cargar el glosario y aplicar el cambio otra vez.

ai_report_knowledge_invalid

HTTPHTTP 400

El glosario de Boost enviado no cumple el esquema estricto (src/ai/coli-core/knowledge.ts), repite un id, pasa de 200 entradas o nombra una capacidad, métrica o desglose que no existe en el catálogo de Boost. No se guardó nada.

Qué hacer

Corregir las entradas que lista issues y volver a enviar.

ai_report_knowledge_unavailable

HTTPHTTP 503

No se pudo leer o escribir ai_report_knowledge_entries (tabla sin aplicar o base caída). El glosario no se guardó.

Causa típica

Falta el DDL sql/ai/ai-reportes-motor.sql o la base no responde.

Qué hacer

Aplicar el DDL (con autorización) o reintentar cuando la base responda.

ai_report_no_entity

HTTPHTTP 403

La sesión no tiene una entidad activa: sin entidad no hay glosario ni reportes internos.

ai_report_recipe_not_found

HTTPHTTP 404

La receta de reporte interno no existe en la entidad de la sesión (las recetas son por entidad; otra entidad recibe 404 aunque el id exista).

ai_report_source_unavailable

HTTPHTTP 503

No se pudieron leer los vendedores visibles de la persona en la base de Boost (consulta de solo lectura caída o lenta).

Qué hacer

Reintentar; si persiste, revisar la base en Render.

Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.