Nuevo endpoint REST para Copiloto IA

Se incorpora el endpoint del copiloto IA conversacional para emisión asistida, consultas y acciones guiadas.

Nueva funcionalidad 02/04/2026 REST Version: v1

Endpoints afectados

  • POST /api/v1/ai/chat

Migracion recomendada

No requiere cambios para integraciones existentes. El endpoint nuevo es optativo y queda sujeto a permisos y feature flag.

Qué cambia

Se agrega un endpoint REST nuevo para interactuar con el copiloto IA del sistema.

El endpoint puede:

  • derivar solicitudes de emisión al flujo de emisión inteligente
  • devolver respuestas conversacionales
  • sugerir acciones o accesos rápidos dentro del sistema

Impacto para integradores

No modifica endpoints existentes.

Las integraciones que quieran usar el copiloto deben enviar:

  • mensaje
  • contexto.empresa
  • contexto.pantalla opcional
  • session_id opcional para conservar historial corto

Seguridad y validación

  • respeta permisos del usuario
  • valida acceso a empresa
  • no ejecuta SQL arbitrario desde IA
  • no emite CFEs sin pasar por validaciones backend