Documentación

1. Ve a la Shopify App Store y busca FreshStock FIFO.

2. Haz clic en Agregar app y selecciona la tienda donde instalarla.

3. Acepta los permisos requeridos — la app necesita acceso a productos e inventario para funcionar.

4. Una vez instalada, serás redirigido al Dashboard de la app dentro de tu admin de Shopify.

Al abrir la app por primera vez, configura:

• Días de anticipación para alertas: cuántos días antes del vencimiento quieres recibir una notificación.
• Ubicaciones: selecciona las ubicaciones de tu tienda que quieres gestionar con FIFO.
• Notificaciones: activa o desactiva alertas por email (próximamente).

El dashboard es la pantalla principal de la app. Muestra en tiempo real:

• Inventario próximo a vencer: productos que vencen dentro del rango configurado.
• Costos en riesgo: valor monetario del inventario próximo a expirar.
• Productos expirados: lotes que ya superaron su fecha de vencimiento.
• Ofertas activas: descuentos automáticos creados por la app actualmente vigentes.

La sección de Discrepancias compara el stock reportado por Shopify con el stock registrado en FreshStock FIFO, detectando diferencias por producto y sucursal. Es la herramienta principal para identificar y corregir inconsistencias de inventario.

📍 Cómo funciona:

• FreshStock consulta el inventario actual en Shopify y lo compara con su propio registro de lotes por sucursal.
• Los productos con diferencias aparecen en la lista de discrepancias, mostrando el total de la diferencia (positivo = Shopify tiene más stock que FreshStock, negativo = FreshStock tiene más que Shopify).
• Al hacer clic en un producto, se despliegan las diferencias por cada sucursal o bodega.

🔧 Cómo resolver una discrepancia:

Desde la vista de detalle de un producto, tienes dos opciones por cada sucursal:

Opción 1 — Crear lote:

1. Haz clic en "Crear lote" en la sucursal con discrepancia.
2. Se abrirá el formulario de creación de lote con la sucursal y producto pre-seleccionados.
3. Ingresa la cantidad, fecha de ingreso y fecha de vencimiento para registrar el stock faltante en FreshStock.
4. Guarda el lote. La discrepancia debería resolverse o reducirse en la próxima sincronización.

Opción 2 — Revisar lotes:

1. Haz clic en "Revisar lotes" para ver todos los lotes existentes de ese producto en la sucursal.
2. Desde esa vista puedes:
   • Reajustar stock de un lote existente (si la cantidad registrada no coincide con la física).
   • Ver la bitácora de movimientos del lote para entender el origen de la discrepancia.
   • Identificar lotes duplicados o vencidos que puedan estar afectando el conteo.

Importante: La discrepancia se calcula comparando el stock disponible de Shopify con la suma de lotes activos en FreshStock. Si Shopify reporta stock que no tiene lote asociado en FreshStock, aparecerá como diferencia positiva. Crea un lote para sincronizar ambos sistemas.

Tip: Resuelve las discrepancias con regularidad — inventario desalineado entre Shopify y FreshStock puede generar alertas de vencimiento incorrectas, ofertas sobre productos sin stock real, y errores en las transferencias entre sucursales.

El módulo de inventario permite gestionar tu stock por lotes, cada uno con fecha de ingreso y fecha de vencimiento.

Cómo agregar un lote:

1. Ve a la sección Inventario en la app.
2. Selecciona el producto y variante.
3. Ingresa la cantidad, fecha de ingreso y fecha de vencimiento.
4. Guarda el lote.

El sistema priorizará automáticamente los lotes más antiguos al mostrar alertas y al crear ofertas (First In, First Out).

FreshStock FIFO permite crear transferencias de inventario entre sucursales con trazabilidad completa por lote, integradas directamente con la API de Shopify.

📦 Cómo crear una transferencia:

1. Ve a Transferencias en la app.
2. Selecciona la sucursal de origen, sucursal de destino, el producto y la cantidad.
3. FreshStock sugiere automáticamente los lotes a transferir usando lógica FEFO/FIFO (primero vence, primero sale).
4. Ajusta manualmente los lotes si lo necesitas y confirma la transferencia.
5. La transferencia se crea en Shopify y queda en estado READY_TO_SHIP hasta que se reciba en destino.

🔄 Estados de transferencia:

📱 Vista responsive:

Las transferencias se agrupan por documento en un acordeón expandible, con paginación de 50 items y lazy loading para una navegación ágil incluso en dispositivos móviles.

Nota: Actualmente cada transferencia mueve una variante por documento. Solo se registra trazabilidad de transferencias creadas desde FreshStock, no de las creadas manualmente en Shopify.

El módulo de ajuste de stock permite corregir manualmente las cantidades de un lote, registrando cada cambio con motivo y trazabilidad completa.

✏️ Cómo reajustar el stock de un lote:

1. Ve a Inventario y selecciona la sucursal.
2. Busca el producto y expande el lote que quieres ajustar.
3. Haz clic en "Reajustar stock".
4. En el modal, usa los controles +/- o ingresa la cantidad directamente (valores negativos para descontar, positivos para añadir).
5. Escribe el motivo del ajuste (obligatorio).
6. Haz clic en "Reajustar stock" para confirmar.

Cada ajuste queda registrado en el Historial de ajustes del producto, accesible desde la misma vista de inventario. El historial muestra:

• Tipo de movimiento ("Corrección de inventario")
• Timestamp y responsable
• Desglose de cantidades: disponible, en existencia, no disponible, comprometido, entrante
• Filtro por sucursal

Importante: El botón "Reajustar stock" solo se habilita cuando el motivo está completo. Esto asegura que todo ajuste tenga justificación documentada para auditoría.

Cada lote tiene una bitácora cronológica que registra todos los eventos de su ciclo de vida. Esto permite trazabilidad completa desde el ingreso hasta la venta o vencimiento.

🔍 La bitácora incluye:

• Creación del lote: fecha, cantidad inicial, costo y origen.
• Reservas de venta: unidades comprometidas a órdenes no completadas.
• Ventas completadas: unidades despachadas y facturadas.
• Transferencias: movimientos entre sucursales con vínculo al lote origen.
• Ajustes manuales: correcciones de stock con motivo y responsable.
• Ediciones: cambios en fechas de vencimiento, costos u otros atributos.
• Eventos de Shopify: sincronización de cambios detectados vía webhooks.

La trazabilidad unifica eventos de ventas, transferencias, webhooks de Shopify y acciones manuales en un solo timeline, dando visibilidad completa del ciclo de vida de cada lote.

Nota: Los lotes creados por transferencia heredan el número de lote y costo del origen. La fecha de recepción corresponde al momento real de llegada a destino, permitiendo rastrear el camino completo entre sucursales.

La app genera alertas automáticas cuando algún lote está próximo a vencer, según los días de anticipación configurados.

Las alertas aparecen en el Dashboard y en la sección Alertas de la app.

Configurar días de anticipación:

1. Ve a Configuración en la app.
2. Ajusta el campo Días de anticipación (por defecto: 30 días).
3. Guarda los cambios.

FreshStock FIFO puede crear descuentos automáticos en Shopify para los productos próximos a vencer, ayudándote a recuperar el valor del inventario.

Cómo crear una oferta automática:

1. Ve a la sección Ofertas en la app.
2. Selecciona el lote al que quieres aplicar descuento.
3. Define el porcentaje de descuento, fecha de inicio y fecha de término.
4. La app crea automáticamente el descuento en tu tienda Shopify.

Nota: Los descuentos creados por la app aparecerán en la sección Descuentos de tu admin de Shopify.

La sección de reportes muestra estadísticas históricas de tu inventario:

• Rotación de inventario: qué tan rápido se mueven tus productos.
• Productos vencidos: historial de lotes expirados y costos asociados.
• Costos recuperados: valor recuperado gracias a las ofertas automáticas.
• Tendencias de stock: evolución del inventario en el tiempo.