AI chat

POST /api/v1/ai/chat

Procesa mensajes del copiloto IA y deriva cada solicitud según la intención detectada.

Capacidades actuales

• emisión asistida usando EmisionInteligenteService
• consultas de negocio con datos reales del ERP a través de resolvers backend controlados
• respuestas conversacionales de bajo riesgo
• acciones sugeridas clickeables y navegación contextual
• ejecución de acciones sugeridas mediante el mismo endpoint usando action + payload

Intenciones de consulta de negocio soportadas

• ventas_resumen
• ventas_por_periodo
• cantidad_cfe_emitidos
• top_clientes
• clientes_deudores
• cuentas_a_cobrar_resumen
• top_productos
• clientes_inactivos
• comparativa_periodos

Las consultas de negocio no ejecutan SQL libre desde la IA. El modelo solo devuelve una intención estructurada y el backend decide el resolver seguro a ejecutar.

Contrato de acciones sugeridas

Las respuestas pueden incluir suggested_actions con estructura formal:

[
  {
    "label": "Comparar con mes anterior",
    "action": "send_prompt",
    "icon": "fa-exchange",
    "type": "secondary",
    "payload": {
      "mensaje": "Comparar ventas con el mes anterior"
    }
  }
]

Acciones soportadas en esta etapa:

• navigate
• send_prompt
• confirm_emision_inteligente

Widgets de respuesta

Las respuestas pueden incluir data.widgets para render ejecutivo dentro del chat:

• kpi
• table
• chart
• mixed

Seguridad

• requiere autenticación
• valida permisos del usuario
• valida permisos funcionales por intención antes de consultar datos reales
• toma como fuente de verdad la empresa activa de la sesión cuando existe
• ignora contexto.empresa si intenta apuntar a otra empresa distinta de la sesión
• bloquea solicitudes de datos interempresa, secretos, credenciales o intentos de manipular el prompt
• liga cada session_id a empresa y usuario para evitar reutilización cruzada
• no ejecuta SQL arbitrario desde la IA
• toda consulta de negocio se resuelve con queries backend predefinidas, límites y filtros por IdEmpresa
• no emite comprobantes sin pasar por el backend real
• solo acepta acciones sugeridas whitelisteadas por backend