# Manual de usuario — Stock Transfer Pro (ES)

## 1) Resumen
Stock Transfer Pro ayuda a gestionar inventario entre varias ubicaciones Shopify:
- crear y seguir transferencias de stock,
- recomendaciones de reposicion y transferencias inteligentes,
- definir objetivos de stock por ubicacion,
- usar previsiones para evitar roturas,
- modulo **Compras** (plan Pro): proveedores, pedidos de compra, inventarios fisicos y COGS ponderado.

## 2) Requisitos
- Una tienda Shopify con permisos admin necesarios.
- Aplicacion Stock Transfer Pro instalada.
- Ubicaciones Shopify bien configuradas.
- Para Compras: plan **Pro** o **Pro+** activo (salvo acceso partner).

## 3) Inicio rapido
1. Abrir la app desde Shopify Admin.
2. Revisar el **Dashboard**.
3. Ir a **Transfers** para crear la primera transferencia.
4. Si hace falta, elegir plan en **Suscripcion** (Pro para compras).
5. Configurar idioma y opciones en **Configuracion**.
6. (Plan Pro) Configurar **Proveedores**, luego crear un **Pedido de compra** o un **Inventario**.

## 4) Navegacion de la app
- **Dashboard**: vista general (transferencias, pedidos en borrador) y alertas de recepcion pendiente.
- **Transfers**: crear, enviar, recibir y seguir transferencias.
- **Smart Transfers**: sugerencias automaticas (plan Pro).
- **Stock Targets**: objetivo de stock por producto/ubicacion (plan Pro).
- **POS Receive**: confirmar recepcion en tienda via extension Shopify POS.
- **Stock Insights**: previsiones y analitica (segun plan).
- **Planificacion de compras** (plan Pro): sugerencias de reposicion.
- **Proveedores** (plan Pro): directorio, productos asignados y costes unitarios.
- **Pedidos de compra** (plan Pro): crear, enviar, recibir y seguir el pago.
- **Inventarios** (plan Pro): conteos fisicos por ubicacion.
- **Suscripcion**: gestion de planes Starter / Pro / Pro+ (oculto para algunas tiendas partner).
- **Configuracion**: idioma, ajustes de previsiones, IA, descarga del manual PDF.
- **Contacto**: abre el correo de soporte con el boton dedicado.

## 5) Flujo principal: crear una transferencia
1. Abrir **Transfers**, luego **Nueva transferencia**.
2. Elegir ubicacion origen y destino.
3. Agregar productos/variantes (busqueda o **campo scan** para lector de codigos).
4. Revisar cantidades.
5. Confirmar envio.
6. Confirmar recepcion en **POS Receive** (Shopify POS) o desde el admin.

Buenas practicas:
- Usar ciclos regulares en lugar de solo transferencias urgentes.
- Verificar stock disponible en origen antes de confirmar.
- Usar sugerencias inteligentes como apoyo a la decision.

## 6) Smart Transfers
Objetivo: proponer cantidades mas adecuadas segun:
- ventas recientes,
- stock disponible,
- estacionalidad y anticipacion por lead time,
- stock de seguridad.

Consejo: ajustar sugerencias al contexto local.

## 7) Stock Targets
En **Stock Targets** puedes definir niveles minimo/ideal por producto y ubicacion.

Uso recomendado:
1. Definir objetivos realistas para SKU criticos.
2. Revisar objetivos cada mes (o por temporada).
3. Combinar con previsiones.

## 8) Stock Insights
**Stock Insights** te ayuda a:
- ver tendencias de demanda,
- detectar riesgo de rotura de stock,
- preparar transferencias con antelacion.

Para mejores resultados:
- definir un **lead time** realista,
- mantener un **stock de seguridad** coherente,
- validar calidad de datos historicos de ventas.

## 9) Planes y limites
- **Starter**: transferencias manuales, extension POS, UI multilingue (1-2 ubicaciones).
- **Pro**: todo Starter + stock targets, smart transfers, prevision 30 dias, **modulo Compras** (proveedores, pedidos, inventarios, COGS ponderado).
- **Pro+**: todo Pro + previsiones multi-horizonte, alertas avanzadas, IA BYOK, Revenue-at-Risk detallado.

Regla importante:
- Si hay mas de 5 ubicaciones activas, el plan **Pro+** es obligatorio.

Acceso partner:
- Algunas tiendas tienen acceso completo sin pestana **Suscripcion**.

Cambio de plan:
- Upgrade/downgrade desde **Suscripcion**.
- Prueba gratuita de 14 dias en la suscripcion Shopify.

## 10) Configuracion
En **Configuracion** puedes:
- cambiar idioma (FR/EN/DE/IT/ES),
- ajustar lead time y stock de seguridad,
- activar/desactivar soporte IA y elegir proveedor/modelo (Pro+),
- descargar el **manual de usuario** en PDF,
- revisar scopes API activos.

## 11) Escaneo y recepcion en tienda

### Scan al crear transferencia (admin)
En **Nueva transferencia**, el **campo scan** acepta codigos de barras via **lector hardware** (USB/Bluetooth). Enfocar el campo, escanear, confirmar.

### Modo scan de transferencia (admin)
Ruta dedicada para recibir por escaneo:
- **Lector hardware**: campo activo, scan + Enter incrementa cantidad recibida.
- **Camara**: boton **Activar camara** para escanear en el navegador (vista previa, no pantalla completa).

### Instalar el mosaico STP en tienda (multi-establecimiento)
El mosaico POS forma parte del **Smart Grid**, propio de **cada dispositivo/ubicacion**. Para cada tienda:
- cada establecimiento debe tener la app **Shopify POS** conectada a la tienda, con una **ubicacion asignada** al dispositivo — esa ubicacion es el **origen** de las transferencias creadas desde el POS,
- **anadir el mosaico** en cada dispositivo: pantalla de inicio POS -> **... Anadir mosaico** -> **Mosaico de aplicacion** -> **Stock Transfer Pro**.

**Despliegue multi-tienda (p. ej. cadena de 40 tiendas)**: en lugar de anadir el mosaico dispositivo por dispositivo, configurar un diseno de pantalla de inicio compartido en **Punto de venta -> Roles** del admin de Shopify y aplicarlo al rol usado por los dispositivos. Todos los dispositivos de ese rol heredan el mosaico STP.

> Crear transferencias desde el POS requiere el plan **Pro+**. La **Recepcion POS** sigue disponible en todos los planes.

### Recepcion POS (Shopify POS)
La extension **Stock Transfer Pro** en **Shopify POS** permite:
- listar transferencias pendientes en la ubicacion conectada,
- escanear con **camara nativa** (visor a pantalla completa) o lector,
- validar cantidades recibidas linea por linea.

Ideal para recepcion en tienda en tablet o movil.

### Crear transferencias desde POS (Shopify POS)
Desde la misma extension, pantalla **Crear transferencia**:
- el **origen** es siempre la tienda conectada al POS,
- elegir un **destino** entre las demas ubicaciones activas,
- anadir productos por **busqueda** o **escaneo** (camara / lector),
- ajustar cantidades linea por linea,
- **Guardar borrador** para retomar mas tarde, o **Enviar transferencia** (el stock de origen se descuenta al enviar).

**Borradores**: una transferencia no enviada sigue siendo editable (lineas, cantidades, destino) y se guarda automaticamente. Se retoma desde la pantalla **Borradores** del POS. Un borrador creado en el POS es el mismo objeto que en el admin, por lo que un responsable puede finalizarlo desde el admin. Disponible en el plan Pro+.

## 12) Contacto y soporte
- Boton **Contacto** en barra de app, pagina Suscripcion y Configuracion.
- Abre tu cliente de correo con la direccion de soporte y el asunto precargado.

## 13) Resolucion de problemas (FAQ)
**No veo algunas paginas (ej. Stock Insights, Compras).**  
Revisar el plan activo en **Suscripcion**. Compras requiere al menos **Pro**.

**Me redirige a Suscripcion.**  
Revisar estado de facturacion y compatibilidad plan/ubicaciones.

**No tengo pestana Suscripcion.**  
Tu tienda puede tener acceso partner. Recargar la app tras la instalacion.

**Las sugerencias son demasiado bajas/altas.**  
Ajustar lead time, stock de seguridad y stock target.

**El boton Contacto no abre el correo.**  
Revisar la aplicacion de correo predeterminada.

**No veo Pedidos de compra / Proveedores / Inventarios.**  
Pasar a **Pro** o **Pro+** en **Suscripcion**.

**Editar borrador no responde.**  
Recargar la pagina. Solo pedidos en estado **Borrador** son editables.

**La recepcion del pedido no actualiza el stock.**  
Verificar que el inventario este activado en la ubicacion elegida.

**Mi inventario muestra 0 articulos.**  
Revisar el **alcance** al crear: elegir **Todos los productos**.

**El coste Shopify no cambia tras la recepcion.**  
Activar **Actualizar coste producto Shopify en la recepcion** en la ficha del pedido.

**La camara no funciona en movil (admin).**  
Permitir acceso a la camara en el navegador. Para uso en tienda, usar **Shopify POS**.

## 14) Checklist operativa
- Revisar transferencias pendientes cada dia.
- Confirmar recepciones rapidamente (POS o admin).
- Revisar previsiones cada semana (Pro+).
- Ajustar objetivos y stock de seguridad cada mes.
- Verificar plan al agregar nuevas ubicaciones.
- Mantener **Proveedores** y costes unitarios actualizados.
- Finalizar o cancelar pedidos en borrador.
- Recibir pedidos pendientes y seguir el **pago**.

## 15) Modulo Compras (plan Pro)

> **Acceso:** **Planificacion de compras**, **Proveedores**, **Pedidos de compra** e **Inventarios** estan disponibles con el plan **Pro** o **Pro+**. La recepcion actualiza el stock y, opcionalmente, el **COGS ponderado** en Shopify.

### Dashboard ampliado
El **Dashboard** muestra:
- contadores de transferencias (total, borrador, enviadas, recibidas);
- **Pedidos de compra en borrador**;
- alerta si **transferencias** esperan recepcion;
- alerta si **pedidos de compra** (Pedido o Recibido parcialmente) esperan recepcion.

### Proveedores
1. Abrir **Proveedores**.
2. Crear proveedor (nombre, e-mail, datos).
3. **Asociar productos** con **coste unitario** por variante.
4. Estos costes alimentan pedidos y calculo COGS en la recepcion.

### Planificacion de compras
Pagina de **sugerencias de reposicion** segun stock y demanda.

### Crear un pedido de compra
1. Abrir **Pedidos de compra** y crear uno nuevo.
2. Elegir **ubicacion**, **proveedor** y campos opcionales.
3. **Buscar productos** en vivo; variantes ya anadidas se ocultan.
4. Ajustar **cantidades pedidas** y **coste unitario** por linea.
5. Validar: estado **Borrador**.

### Editar un borrador
1. Abrir el pedido, clic en **Editar borrador**.
2. Actualizar proveedor, ubicacion, lineas, costes, fechas o notas.
3. **Guardar borrador**.

Solo los **Borradores** son editables.

### Enviar al proveedor
1. Seccion **Enviar al proveedor**.
2. Verificar o completar el e-mail del proveedor.
3. Opcion: **Copia a mi**.
4. Enviar: e-mail con PDF; estado **Pedido**.

El estado **Pedido** solo se establece tras un envio correcto.

### Seguimiento del pago
En pedidos **Pedido**, **Recibido parcialmente** o **Recibido**:
- definir **estado de pago** (no pagado, parcial, pagado),
- registrar importes y fechas de pago.

### Descargar PDF
**Descargar PDF** en la ficha del pedido.

### Recibir un pedido
Con estado **Pedido** o **Recibido parcialmente**:
1. Seccion **Recepcion**: cantidades por linea o **Recibir todo**.
2. Opcional: **gastos de envio** y **ajustes**.
3. Activar **Actualizar coste producto Shopify en la recepcion** para COGS ponderado.
4. Confirmar recepcion.

Efectos:
- el stock aumenta en la ubicacion;
- **coste medio ponderado** recalculado;
- historial COGS en la ficha;
- estado **Recibido** o **Recibido parcialmente**.

### Lista y filtros
- Lista con estado, proveedor, ubicacion, pago y numero de lineas.
- Filtros y orden por estado, fecha, proveedor.
- Enlace dashboard **Ver pedidos pendientes**.

### Estados del pedido
- **Borrador**: en preparacion, editable.
- **Pedido**: enviado al proveedor.
- **Recibido parcialmente**: recepcion parcial.
- **Recibido**: recepcion completa.
- **Cancelado**: cancelado.

### Inventarios fisicos
1. Abrir **Inventarios**, crear nuevo inventario.
2. Elegir **ubicacion** y **alcance** (**Todos los productos** recomendado).
3. Articulos rastreados cargados desde Shopify.
4. Introducir **cantidades contadas** por linea.
5. **Guardar conteos**, luego **Aplicar ajustes**.

Estados: **Borrador** → **Conteo** → **Aplicado** (o **Cancelado**).

Consejo: si el inventario muestra 0 articulos, recrearlo con alcance **Todos los productos**.