CACTUS STOCK v3.8.0 - PRIMERA PRUEBA FACTURAS IA GOOGLE + GEMINI
===============================================================

OBJETIVO DE ESTA VERSION
------------------------
Conectar Cactus Stock con el Google Apps Script que ya usa Gemini en la planilla de compras.

Esta version:
- Lee PDF/JPG/PNG/WEBP desde Documentos de compra.
- Envia el archivo al Web App de Google Apps Script.
- Apps Script usa la GEMINI_API_KEY existente.
- Devuelve proveedor, RUT, tipo/nro documento, fecha, neto, IVA, total y lineas de productos.
- Cactus Stock muestra una pantalla de revision.
- Sugiere productos existentes y permite guardar los vinculos linea -> producto.
- NO MODIFICA STOCK.
- NO CREA COMPRAS TODAVIA.

ARCHIVOS
--------
1) index.php
   Reemplaza solamente el index.php actual de stock.cactusgrafico.cl.

2) PUENTE_WEB_CACTUS_STOCK_v34_PEGAR_AL_FINAL.gs
   Opcion recomendada: pegar ESTE bloque al final del Apps Script actual.
   Conserva todo lo que ya tienes en la planilla.

3) Automatizacion_Facturas_Cactus_v34_WEB_STOCK.gs
   Copia completa basada en Automatizacion_Facturas_Cactus_v33_BUSCADOR_INTELIGENTE.gs.
   Usar solamente si sabes que tu script actual sigue siendo esa version.

PASO A PASO
-----------
A. INSTALAR CACTUS STOCK
1. Haz respaldo del index.php actual.
2. Reemplaza solamente index.php por el de este paquete.
3. Entra a Cactus Stock > Documentos de compra.
4. Veras un bloque nuevo: "Facturas IA · Google + Gemini".
5. Matias o Joana deben tocar "Configurar IA".
6. Copia el TOKEN COMPARTIDO que aparece. No lo publiques.

B. PREPARAR GOOGLE APPS SCRIPT
1. Abre la misma planilla de Google Sheets donde funciona FACTURAS IA.
2. Extensiones > Apps Script.
3. Haz una copia/respaldo del codigo actual antes de cambiar nada.
4. Pega el contenido de:
      PUENTE_WEB_CACTUS_STOCK_v34_PEGAR_AL_FINAL.gs
   AL FINAL del codigo actual.
5. Guarda el proyecto.

C. CONFIGURAR PROPIEDADES DEL SCRIPT
1. Apps Script > Configuracion del proyecto (icono engranaje).
2. En Propiedades del script debe seguir existiendo:
      GEMINI_API_KEY = tu clave actual
3. Agrega:
      CACTUS_STOCK_TOKEN = [pegar el token copiado desde Cactus Stock]
4. Guarda.

D. PUBLICAR COMO APLICACION WEB
1. Apps Script > Implementar > Nueva implementacion.
2. Tipo: Aplicacion web.
3. Ejecutar como: Yo.
4. Quien tiene acceso: Cualquier usuario / Anyone.
   La llamada igualmente queda protegida por CACTUS_STOCK_TOKEN.
5. Implementar y autorizar si Google lo solicita.
6. Copia la URL de la aplicacion web. Debe terminar en /exec.

IMPORTANTE:
Si ya tenias una implementacion anterior, al cambiar el codigo usa
"Administrar implementaciones" y crea/actualiza una version para que el Web App use el codigo nuevo.

E. CONECTAR LA PAGINA
1. Vuelve a Cactus Stock > Documentos de compra > Configurar IA.
2. Pega la URL /exec de Apps Script.
3. Guardar URL.
4. Toca "Probar conexion".
5. Debe aparecer un mensaje indicando que la conexion Google IA es correcta.

F. PRIMERA FACTURA DE PRUEBA
1. En Documentos de compra: + Cargar documento.
2. Sube una factura PDF o foto (maximo 10 MB en esta etapa).
3. En la fila del documento toca "Leer con IA".
4. Espera la lectura (puede tardar varios segundos).
5. Se abrira "Revision de factura con IA".
6. Compara los datos con la factura original.
7. En cada linea selecciona el producto correcto de Cactus Stock.
8. Guarda los vinculos.

NINGUNO DE ESTOS PASOS CAMBIA EL STOCK.

PRUEBAS RECOMENDADAS
--------------------
Primero probar 3 tipos distintos:
- Una factura normal de proveedor.
- Una compra de Mercado Libre / pantallazo.
- Una factura con varias lineas y materiales distintos.

Anotar cualquier lectura incorrecta para ajustar el prompt antes de habilitar el ingreso automatico al stock.

SIGUIENTE ETAPA
---------------
Cuando comprobemos que las lecturas y vinculaciones funcionan bien:
- recordar equivalencias por proveedor,
- crear producto nuevo desde la revision,
- detectar proveedor existente,
- pantalla final de confirmacion,
- crear compra + historial + precios,
- sumar stock SOLO al confirmar manualmente.
