• Cómo funciona el Plugin AiScan

Cómo funciona el Plugin AiScan

El Plugin AiScan permite escanear facturas de proveedor utilizando inteligencia artificial directamente desde FacturaScripts. El plugin extrae automáticamente los datos del documento (proveedor, número de factura, fechas, importes, impuestos y líneas de detalle) y los aplica a la factura de compra que estás editando.

Instalación

Descarga el archivo ZIP desde la página del plugin o desde GitHub. Accede al Panel de Administración de FacturaScripts, ve a la sección de Plugins, sube el archivo ZIP y actívalo.

Configuración

Tras instalar el plugin, accede a la configuración de AiScan desde el menú de administración. Allí podrás configurar:

Proveedor de IA: Elige entre OpenAI, Google Gemini, Mistral, un endpoint compatible con OpenAI o el motor de IA integrado en el navegador (Browser Prompt API). Cada proveedor en la nube requiere su propia clave API que puedes obtener en su web.

Modelo: Selecciona el modelo de IA que quieres usar para la extracción. Modelos con capacidades de visión ofrecen mejores resultados con documentos escaneados como imágenes.

Análisis automático: Si activas esta opción, el plugin analiza el documento en cuanto lo subes, sin necesidad de pulsar el botón de analizar manualmente.

Modo depuración: Actívalo para ver información detallada sobre las respuestas del proveedor de IA en los logs.

Extensiones permitidas: Configura qué tipos de archivo acepta el plugin (PDF, JPG, PNG, WEBP).

Prompt de extracción: Puedes personalizar el prompt que se envía al modelo de IA para ajustar la extracción a tus necesidades.

Uso

Desde la pantalla de edición de una factura de proveedor (EditFacturaProveedor), verás el botón "Escanear Factura". Al pulsarlo se abre una interfaz donde puedes:

1. Subir un archivo PDF o imagen de la factura.
2. Seleccionar el proveedor de IA que quieres usar.
3. El plugin envía el documento al proveedor de IA configurado.
4. Los datos extraídos aparecen en una interfaz de revisión.
5. Puedes revisar y corregir los datos antes de aplicarlos.
6. Al confirmar, los datos se aplican a la factura actual.

Proveedores de IA compatibles

OpenAI: Usa modelos como GPT-4o o GPT-4o-mini. Requiere una clave API de OpenAI.

Google Gemini: Usa modelos como Gemini Pro. Requiere una clave API de Google AI Studio.

Mistral: Usa modelos de Mistral AI. Requiere una clave API de Mistral.

OpenAI Compatible: Cualquier API que siga el formato de OpenAI (como Ollama, LM Studio, etc.). Configura la URL base y la clave API.

Browser Prompt API (experimental): Usa el motor de IA integrado directamente en el navegador Google Chrome, sin necesidad de claves API ni conexión a servicios externos. Esta opción utiliza la Prompt API de Chrome, que ejecuta un modelo de lenguaje de forma local en tu dispositivo. Para usarla necesitas Google Chrome con la funcionalidad de IA activada. Es una opción ideal para quienes prefieren no enviar datos de sus facturas a servicios en la nube, ya que todo el procesamiento ocurre en local.

Detección de proveedores y productos

El plugin intenta emparejar automáticamente el proveedor extraído de la factura con los proveedores existentes en tu base de datos de FacturaScripts. La búsqueda se hace por NIF/CIF y por nombre. Si encuentra una coincidencia exacta, la asigna directamente. Si hay varias coincidencias posibles, te permite elegir entre los candidatos.

Lo mismo ocurre con las líneas de detalle: el plugin intenta emparejar las descripciones extraídas con productos existentes en tu catálogo.

Requisitos

El plugin requiere FacturaScripts 2025 o superior y PHP 8.1 o superior. Para la extracción de texto de PDFs de forma local (antes de enviar al proveedor de IA), es recomendable tener instalado pdftotext en el servidor.