# 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 3 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).

### 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.

## 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**.