Carga de productos · Riegos del Sur

Formulario web responsive para que la CM cargue productos (fotos, SKU, categoría, descripción, envío y variantes) y los publique directo en Tiendanube.

Cómo está armado

index.html          formulario y lista de productos cargados
js/config.js        ← lo único que hay que tocar (API_BASE, categorías, reglas de fotos)
js/app.js           pantalla: formulario, validaciones, lista
js/tiendanube.js    convierte lo cargado al formato de la API de Tiendanube
js/imagenes.js      fotos: cuadradas con fondo blanco, JPG, cualquier formato y tamaño (máx. 2048 px)
js/db.js            guarda borradores y fotos en el navegador (IndexedDB)
api/                backend para Vercel que habla con Tiendanube (el token nunca llega al navegador)

Cómo carga la empleada (4 pasos)

1. Fotos: el producto de frente (se publica) y la etiqueta o el dorso (solo la lee la IA). Al sacar la de etiqueta, la IA completa sola: nombre, marca, categoría, descripción, código de barras y una estimación de peso y medidas.
2. Revisá: lo azul lo completó la IA; se corrige lo que haga falta.
3. Precio, cantidad y envío: lo único que la IA no puede saber. El precio es opcional: sin precio el producto queda de vidriera en Tiendanube. Peso y medidas estimados se confirman.
4. Códigos y extras (opcional): el código de barras ya viene leído (o se escanea); el SKU se genera solo si queda vacío (usa el código de barras o RDS-xxxx). Variantes y proveedor.

Después de guardar aparece Cargar uno parecido: copia todo menos fotos, códigos y cantidad, para cargar rápido otra medida o color del mismo producto.

Qué se manda a Tiendanube

Dato cargado	Campo en la API (2025-03)
Tipo + marca + modelo + medida	name, handle, seo_title
Para qué sirve, especificaciones, modo de uso, qué incluye	description (HTML con títulos y listas), seo_description
Categoría	categories (el backend busca el ID por nombre y la crea si no existe)
SKU	variants[].sku
Peso (kg) y medidas (cm)	variants[].weight/width/height/depth
Variantes (medida/color/capacidad)	attributes + variants[].values
Marca	brand
Fotos	POST /products/{id}/images (base64, una por pedido, en orden)
Proveedor	No se envía (dato interno)
Precio de venta y cantidad en stock	variants[].price, variants[].stock (con stock_management: true)
Código de barras	variants[].barcode

Si Contabilium sincroniza precio y stock por SKU, va a pisar lo que se cargue acá.

Ingreso (administrador único)

La app pide usuario y contraseña al abrirse. Hay un solo usuario, definido en Vercel:

• ADMIN_USUARIO y ADMIN_CLAVE: usuario y contraseña del administrador.
• SESION_SECRETO: texto aleatorio de 32 caracteres o más para firmar las sesiones. Si se cambia, se cierran todas las sesiones abiertas.

La sesión dura 12 horas y se guarda en una cookie HttpOnly (el JavaScript de la página no la puede leer). Después de 5 intentos fallidos desde la misma IP, se bloquea 15 minutos. Toda la API (/api/*) exige sesión, salvo login, sesion, logout y estado.

Conectarlo con Tiendanube

Se usa una aplicación a medida de la propia tienda (no hace falta el Portal de Partners):

1. Admin de Tiendanube → Aplicaciones a medida → Crear aplicación a medida. Nombre: "Carga de productos". Perfil de acceso: solo Productos (lectura y escritura).
2. Guardar, abrir la app y tocar Revelar para ver el token (se muestra una sola vez).
3. Cargarlo en Vercel: npx vercel env add TN_ACCESS_TOKEN production --sensitive.
4. Cargar el número de tienda: npx vercel env add TN_STORE_ID production (aparece en el código de la página de la tienda como LS.store.id).
5. Volver a publicar: npx vercel deploy --prod.

TN_USER_AGENT ya está cargado. El token no vence; deja de valer si se borra la aplicación a medida.

Alternativa (app de Partners con OAuth): los endpoints /api/tiendanube-conectar y /api/tiendanube-callback siguen disponibles con TN_APP_ID y TN_CLIENT_SECRET.

Código de barras

• api/codigo-barras.js + api/_codigos.js: consulta el catálogo global desde el servidor (la key nunca llega al navegador), con caché de 7 días (1 día si no lo encontró) y corte a los 6 s.
• Catálogos en BARCODE_PROVEEDOR, en orden y separados por coma (por defecto upcitemdb,openfacts; también eansearch y barcodelookup, pagos, con key en BARCODE_API_KEY). Se usa el primero que encuentre el producto. upcitemdb: 100 consultas por día, fuerte en importados. Open Food Facts: gratis, tiene alimentos argentinos y pocos productos no alimenticios.
• Estados del formulario: escaneando → buscando_info → completado_automatico o modo_manual → guardando. Solo se completan campos vacíos y quedan marcados en azul.
• Ojo: en las pruebas, los productos argentinos (códigos 779…) no aparecieron en upcitemdb. Para el vivero y lo artesanal la carga va a ser manual de todos modos.

Completar con IA

Cuando el código no está en ningún catálogo, la empleada saca una foto de la etiqueta y toca Completar con IA: la IA lee hasta 4 fotos del producto y completa tipo, marca, modelo, medida, categoría, descripción, especificaciones, modo de uso y qué incluye. Solo llena campos vacíos y los marca en azul. Las fotos marcadas Solo IA (etiquetas, dorsos, códigos) se leen pero nunca se suben a la tienda.

• IAs (api/_ia.js), cada una se usa solo si su key está cargada: Gemini (GEMINI_API_KEY, gratis con límites), Mistral (MISTRAL_API_KEY, plan Experiment gratis sin tarjeta, modelo mistral-small-latest), ChatGPT (OPENAI_API_KEY, modelo gpt-6-luna), Grok (XAI_API_KEY, grok-4.7) y Claude (ANTHROPIC_API_KEY, claude-opus-5-5). Primero las gratis (Gemini y Mistral); si están saturadas o tardan 6 s, entran las pagas de la más barata a la más cara, en paralelo escalonado. Si todas las gratis dicen "saturada", espera 4 s y hace una segunda ronda solo con las gratis. Cada intento queda en los logs de Vercel ("IA intentos").
• En el plan gratis Google puede usar las fotos enviadas para mejorar sus productos. Solo viajan fotos de envases y etiquetas.
• Si no hay key cargada, el botón no aparece.

Respaldo en la nube

Cada producto que se guarda en el celular se copia solo a Vercel Blob (store privado riegos-respaldo, región São Paulo), aunque todavía no se haya publicado. Si se pierde el celular o se borran los datos del navegador: Cargados → Recuperar del respaldo.

• Un archivo por producto (productos/<id>.json) con datos y fotos (1600 px). Al publicarse en Tiendanube se reemplaza por una versión sin fotos, para ocupar poco.
• Lo que no se pudo copiar (sin conexión) se reintenta cada minuto y al volver la conexión. Cada producto muestra "respaldado ✓" o "respaldo pendiente".
• Plan Hobby de Vercel: 1 GB y 2.000 escrituras por mes gratis. Si se pasa, no cobra: el respaldo se pausa 30 días (Vercel avisa por mail antes).

Probar en local

node .claude/servidor.js

Abrí http://localhost:5173. En local el usuario es admin y la contraseña prueba (solo en tu compu; en Vercel se usan las variables de entorno).

Pendientes

• Base interna: api/_registro.js está listo para conectar, falta elegir la base. Mientras tanto, se publica igual en Tiendanube.

• Precio y stock vs. Contabilium: si Contabilium sincroniza por SKU, va a pisar lo que se cargue acá.

• Cambiar los colores y el logo "RS" por los de la marca.

• Para producción, reemplazar el Tailwind por CDN por un build (npx tailwindcss).

• Si se edita un producto ya publicado, hoy se hace desde el panel de Tiendanube (acá queda en solo lectura).