FreshStock FIFO

Changelog

Historial de actualizaciones de FreshStock FIFO. La app recibe mantenimiento y mejoras continuas.

✨ Nueva función 🔗 Integración ⚡ Impacto en sistema 📋 Estados ⚠️ Limitaciones

Stock en Transferencia

Nueva dimensión de inventario: unidades comprometidas a una transferencia que ya no están disponibles en origen. La fórmula de disponibilidad ahora es: disponible = quantity − sold − reserved − transferredOut.

Transferencia como Entidad de Dominio

La transferencia es ahora un objeto explícito del sistema con estado propio: tienda, sucursal origen/destino, producto/variante, cantidad solicitada, cantidad recibida, vínculo con Shopify y detalle de lotes.

Asignaciones por Lote Origen

Una transferencia puede consumir uno o varios lotes. Se registra un detalle interno con unidades comprometidas, unidades recibidas y snapshot del lote (número, vencimiento, costo, fecha de recepción original).

Recepciones Parciales y Totales

Cada recepción confirmada por Shopify crea nuevos lotes en destino sin fusionar con lotes existentes. El lote hereda número, vencimiento y costo del origen, pero la fecha de recepción corresponde al momento real de llegada.

Sugerencia Automática FEFO/FIFO

FreshStock calcula automáticamente qué lotes usar al crear una transferencia: primero prioriza la fecha de vencimiento más próxima; en empate, la fecha de recepción más antigua. El usuario puede ajustar manualmente antes de confirmar.

Distribución Proporcional de Recepciones

Si la transferencia usa varios lotes origen, las recepciones parciales se distribuyen en el orden confirmado al crear la transferencia, generando lotes destino separados con metadata correcta por cada lote origen.

CREATING

FreshStock está registrando y creando la transferencia.

READY_TO_SHIP

Transferencia creada y pendiente de recepción en destino.

PARTIALLY_RECEIVED

Shopify confirmó recepción parcial de la transferencia.

COMPLETED

Toda la cantidad fue recibida en destino.

CANCELLED

Shopify canceló la transferencia; se restaura stock no recibido en origen.

FAILED

Falló la creación o sincronización crítica con Shopify.

MANUAL_REVIEW

Shopify modificó la transferencia externamente; requiere revisión humana.

API de Transferencias de Inventario

FreshStock crea activamente transferencias en Shopify. Si Shopify rechaza la creación, se revierte el estado local sin dejar inconsistencias.

Webhooks Nuevos

Se agregaron listeners para: recepción de items, completado, cancelación y cambios externos en cantidades.

Nuevos Permisos Requeridos

La app requiere permisos adicionales para operar sobre transferencias y leer recepciones desde Shopify.

Ventas y Reservas

Ahora consideran el stock en transferencia para calcular disponibilidad, evitando sobreasignación.

Discrepancias por Bodega

La comparación entre stock local y Shopify locations ahora incluye el stock en tránsito.

Vista de Inventario

Muestra explícitamente unidades "en transferencia" para mejorar la interpretación operativa.

Una variante por documento

Cada transferencia mueve solo una variante.

Solo transferencias desde FreshStock

No se reconstruye trazabilidad de transferencias creadas manualmente en Shopify.

Cambios externos → revisión manual

Si Shopify modifica una transferencia por fuera, el sistema no reconcilia automáticamente.

Comentarios y preguntas

¿Tienes preguntas sobre alguna versión? Déjalas aquí.