Guía de instalación — Acopio

⚠️ SI ALGUIEN NO PUEDE ENTRAR, EMPIEZA POR LA DIRECCIÓN

Casi siempre es la misma causa: la dirección de tu app no está donde tiene que estar, o no es la misma en todos los sitios. Antes de buscar nada más, abre tu hoja y usa 🏭 Acopio → 🔧 Advanced → 🩺 Check this installation: lo comprueba y lo repara solo. Si después de eso sigue sin dejar entrar, escribe a quien te instaló el sistema y dile exactamente qué mensaje ves.

Tiempo estimado: 5 minutos. No necesitas saber programación. Solo una cuenta de Google (Gmail normal o de empresa).

Al terminar vas a tener tu propio sistema de inventario, corriendo en tu propia cuenta de Google, con tus datos en tu propio Google Drive. Nadie más —ni siquiera nosotros— tiene acceso a tu información.

Antes de empezar

Vas a recibir de nosotros un enlace. Ten ese enlace a la mano.

Importante: hazlo desde una computadora (no el teléfono), con una sola cuenta de Google abierta en el navegador. Si tienes varias cuentas abiertas al mismo tiempo, Google se confunde sobre cuál usar y la instalación puede fallar de formas raras. Lo más seguro: una ventana de incógnito, con solo la cuenta que va a ser la dueña del sistema.

¿Cuál cuenta debe ser la dueña? La primera persona que abre el enlace y completa la configuración se convierte automáticamente en el administrador. Elige bien desde el principio.

Paso 1 — Haz tu copia

1. Abre el enlace que te enviamos.
2. Te va a pedir "Hacer una copia". Acepta.

Eso es todo. Ya tienes tu propio sistema — completamente tuyo, en tu Drive, sin nada compartido con nadie más. El código va incluido en la copia; no hay que instalar ni pegar nada.

Paso 2 — Configura tu empresa

Al abrir tu copia, un asistente aparece automáticamente sobre la hoja (si no aparece: menú 🏭 Acopio → 🚀 Set Up Acopio).

Te va a pedir, en orden:

1. Tu empresa — nombre, tu correo, logo (opcional).
2. Qué guardas — categorías de material. Puedes elegir una plantilla (vidrio, construcción) o empezar en blanco.
3. Dónde lo guardas — tus racks/ubicaciones. Hay un generador automático (filas × niveles × lados) o puedes escribirlos a mano.
4. Quién trabaja aquí — tu equipo, con su rol (Admin / Bodega / Solo lectura).
5. Proveedores y proyectos — opcional, se puede saltar.

Nada de esto se pierde si cierras la ventana a medias — retoma donde ibas.

Paso 3 — El único paso técnico (una sola vez)

⚠️ DE DÓNDE SE COPIA LA DIRECCIÓN, Y DE DÓNDE NO

Cópiala sólo de la pantalla donde el asistente te la muestra al publicar.

NO la copies de la barra del navegador. Ahí Google le añade trozos según con qué cuenta estés mirando, y esas variantes no funcionan pegadas en ningún sitio: dan "Sorry, unable to open the file at this time".

Si te equivocas, no pasa nada: 🏭 Acopio → 🔧 Advanced → 🩺 Check this installation lo detecta y lo corrige.

Al final del asistente, te va a pedir publicar tu sistema. Es el único paso donde vas a ver algo parecido a "código", y el asistente te lleva de la mano:

1. Extensiones → Apps Script (se abre en una pestaña nueva; esta pestaña se queda abierta, regresa a ella después).
2. Arriba a la izquierda dice "Proyecto sin título" — haz clic y ponle el nombre de tu empresa. Esto es lo que tu equipo va a ver en la pantalla de permisos, así que vale la pena hacerlo antes de publicar.
3. Botón azul Implementar (Deploy) → Nueva implementación
4. Engranaje ⚙️ junto a "Seleccionar tipo" → Aplicación web
5. Ejecutar como: Yo · Quién tiene acceso: Cualquier usuario con una cuenta de Google
6. Implementar, luego Autorizar acceso

¿Sale "Google no ha verificado esta aplicación"? Es normal — le estás dando permiso a tu propio sistema, no a una app pública. Clic en Configuración avanzada → Ir a [tu proyecto] (no seguro).

¿Sale un aviso de que falta la Política de Privacidad? También es normal — es un límite de Google para software personal como este, no algo que tengas que arreglar.

1. Regresa a la pestaña del asistente y da clic en "Ya lo hice — muéstrame mi link". El sistema verifica que funcionó y te entrega tu dirección web permanente.

Guarda ese enlace — es tu sistema. Compártelo con tu equipo (solo entrarán quienes hayas dado de alta en el paso 4).

¿Se te perdió el enlace? Menú 🏭 Acopio → Open WMS App, siempre desde tu hoja de cálculo.

Ya tienes tu inventario en Excel

No lo captures a mano: Configuración → Importar. Guarda tu archivo como .csv primero (un .xlsx será rechazado).

Problemas comunes

"Sign-in is not configured" / no me deja entrar Casi siempre es tener varias cuentas de Google abiertas en el navegador. Abre una ventana de incógnito, entra solo con la cuenta dueña, y prueba de nuevo. Si le pasa a varias personas, o solo a las que usan correo personal, mira ACCESO-Y-LOGIN.md — ahí está el diagnóstico completo por síntoma.

Hay gente que trabaja con nosotros pero no tiene correo de la empresa Necesitan un paso extra de configuración (una sola vez). Ver ACCESO-Y-LOGIN.md.

Republiqué la app y ahora los de correo personal no entran Es la trampa más común: Deploy → New deployment crea una URL nueva y rompe el login externo. Se arregla registrando la URL nueva. Ver ACCESO-Y-LOGIN.md, sección "La trampa número uno".

Actualicé el código pero no veo los cambios Publicar una versión nueva no es lo mismo que guardar. En el editor: Implementar → Administrar implementaciones → ✏️ (editar) → Versión: Nueva versión → Implementar. Usa Administrar implementaciones, no "Nueva implementación" — esa última crea una URL distinta y tu equipo seguiría entrando a la vieja.

Agregamos una función nueva y da error de permisos Fuérzalo así: en el editor de Apps Script, elige cualquier función en el menú de arriba y presiona ▶ Ejecutar. Ahí aparece la ventana de autorización.

No me llegan los correos de notificación Cuentas de Gmail normales: límite de 100 correos/día. Cuentas de Google Workspace: 1,500/día.

Cerré la ventana del asistente antes de terminar — ¿tengo que empezar de nuevo? No. Vuelve a abrirla desde el menú 🏭 Acopio: si ya guardaste tu configuración (llegaste hasta el paso de publicar), la ventana te lleva directo ahí de nuevo, sin pedirte los datos otra vez.

¿Necesitas ayuda?

Dentro de la app, abajo a la derecha, hay un botón 🐞 (Reportar un problema). Escribe qué pasó y adjunta una foto — nos llega directo.

Actualizar un cliente ya instalado — SON TRES ARCHIVOS, NO DOS

Cuando le mandes una versión nueva a un cliente (o cuando actualices tu propia copia), lo que se reemplaza en Extensions → Apps Script es:

1. Code_v3_fixed.gs
2. Index_v3_fixed.html
3. appsscript.json ← el que se olvida

El tercero es invisible por defecto. El editor de Apps Script esconde appsscript.json a menos que lo actives:

⚙ Project Settings → marca "Show appsscript.json manifest file in editor" → vuelve a Editor y ya aparece en la lista de la izquierda.

Por qué importa

Ese archivo es donde viven los permisos. Si el cliente se queda con el manifiesto viejo, casi todo sigue funcionando y el fallo aparece en un solo sitio, sin ninguna pista de dónde viene. El caso real:

Exception: Specified permissions are not sufficient to call Ui.showModalDialog.
Required permissions: https://www.googleapis.com/auth/script.container.ui

Eso es el wizard de configuración negándose a abrir. El síntoma no dice "manifiesto", dice "permisos", y nadie relaciona una cosa con la otra.

Después de cambiarlo

Google va a volver a pedir autorización, porque cambiaron los permisos. Eso es normal y hay que avisárselo al cliente ANTES, o va a pensar que algo se rompió. Vuelve a salir la pantalla de "app no verificada" → Advanced → "Go to…".

La regla corta

Si cambió appsscript.json, el cliente re-autoriza. Si no cambió, no. Ante la duda, mándalo igual: re-autorizar cuesta treinta segundos, y diagnosticar un permiso que falta cuesta una tarde.

⚠️ SI ALGO FALLA AL ENTRAR, EMPIEZA POR LA DIRECCIÓN

🏭 Acopio → 🔧 Advanced → 🩺 Check this installation. Comprueba la dirección de tu app y la arregla si hace falta.

Los dos mensajes más comunes y qué significan: