Qué debe resolver una integración entre Shopify y WMS
Una integración Shopify–WMS coordina disponibilidad, pedidos, preparación, envíos y devoluciones entre la tienda y el almacén. Su objetivo no es mover todos los datos en ambas direcciones, sino conservar un estado coherente y recuperable.
El punto más delicado es el inventario: stock físico, stock reservado y cantidad vendible no son necesariamente el mismo número. Antes de desarrollar endpoints hay que decidir qué sistema calcula cada estado.
Para diseñar la capa completa, consulta integraciones Shopify. Aquí nos centramos en logística.
Modelo de ubicaciones e inventario
Shopify representa inventario por artículo y ubicación. Un WMS puede manejar almacenes, zonas, contenedores, cuarentena o stock dañado con mucho más detalle.
No copies toda esa complejidad en Shopify. Mapea solo lo que afecta a venta y asignación:
| Concepto WMS | Posible representación Shopify |
|---|---|
| Almacén expedidor | Location |
| SKU físico | Inventory item relacionado con variante |
| Stock vendible | Cantidad disponible según regla acordada |
| Reserva | Puede mantenerse en WMS y reflejarse en disponibilidad |
| Cuarentena | Excluida de la cantidad vendible |
| Tienda física | Location si participa en inventario o fulfillment |
La regla debe cubrir transferencias, pedidos simultáneos y retrasos de sincronización. Publicar stock físico bruto puede provocar sobreventa si el WMS ya ha reservado unidades para otros canales.
Elegir la fuente de verdad
En una operación omnicanal, el WMS suele gobernar stock físico y preparación. Shopify gobierna el pedido comercial y comunica lo que el cliente compró. El ERP puede seguir controlando referencias y contabilidad.
Escribe decisiones por dato:
- disponibilidad vendible;
- asignación de almacén;
- estado de preparación;
- número de seguimiento;
- cancelación;
- devolución y recepción;
- motivo y condición de la unidad;
- ajuste final de inventario.
Evita sincronización bidireccional del mismo campo sin una regla de precedencia.
Flujo de pedido a fulfillment
- Shopify crea y valida el pedido.
- La integración confirma pago, riesgo y campos necesarios.
- El WMS recibe una instrucción idempotente.
- El WMS acepta, rechaza o divide la preparación.
- La integración conserva la correspondencia entre líneas.
- El almacén prepara y expide.
- Shopify recibe fulfillment, tracking y transportista.
- El cliente ve un estado coherente.
El flujo debe soportar fulfillment parcial: una línea puede salir desde una ubicación y otra quedar pendiente. No marques todo el pedido como enviado al recibir el primer tracking.
Cancelaciones y cambios
Una cancelación puede llegar cuando el pedido aún no se ha enviado, cuando ya está en picking o cuando ha salido. El WMS debe responder con un estado, no aceptar silenciosamente algo imposible.
Define una ventana de cancelación y qué equipo decide fuera de ella. Si se modifica dirección, cantidad o producto, valora cancelar y recrear la instrucción en vez de editar campos que el almacén ya está procesando.
Los reintentos necesitan la misma clave idempotente. Un timeout no confirma que el WMS rechazó el pedido; puede haberlo recibido sin devolver respuesta.
Devoluciones y logística inversa
La devolución conecta autorización comercial, transporte, recepción física, evaluación y reembolso. No todos los pasos ocurren a la vez.
Un modelo útil separa:
- devolución solicitada;
- autorizada o rechazada;
- etiqueta o instrucciones emitidas;
- paquete en tránsito;
- unidad recibida;
- condición evaluada;
- restock, reparación o descarte;
- reembolso realizado.
El WMS confirma recepción y condición. Shopify puede reflejar la devolución y el reembolso, pero el orden exacto depende de la política. No devuelvas stock vendible al recibir la solicitud si la unidad todavía no ha llegado.
Conciliación diaria
Los eventos en tiempo real no eliminan la necesidad de conciliar. Una tarea periódica debería comparar:
- pedidos Shopify pendientes de aceptación en WMS;
- pedidos WMS sin correspondencia;
- líneas y cantidades;
- fulfillments y tracking;
- inventario por location;
- devoluciones estancadas;
- errores sin reintento;
- mensajes repetidos.
La conciliación debe generar excepciones accionables, no enviar un archivo enorme que nadie revisa.
Observabilidad y alertas
Mide tiempo desde pedido hasta aceptación, errores por tipo, reintentos, diferencias de stock y antigüedad de pedidos bloqueados. Conserva IDs de Shopify, WMS y sistema intermediario en cada registro.
Una alerta necesita umbral y destinatario. Un pedido fallido puede ser urgente; una diferencia transitoria de una unidad durante una sincronización puede resolverse sola. Diseña el nivel con el equipo operativo.
Pruebas antes de activar
Incluye:
- pedido de una línea y varias líneas;
- dos ubicaciones;
- fulfillment parcial;
- producto sin stock;
- cancelación antes y durante picking;
- timeout y reintento;
- tracking corregido;
- devolución completa y parcial;
- unidad no apta para restock;
- alta demanda con pedidos simultáneos.
Prueba también la recuperación tras detener temporalmente un endpoint. La integración debe saber continuar sin duplicar resultados.
Preguntas frecuentes
¿Shopify o el WMS debe controlar el inventario?
Depende de la operación. Con varios canales y almacenes, el WMS suele calcular la disponibilidad; Shopify recibe la cantidad vendible. La responsabilidad debe quedar escrita por location y tipo de stock.
¿Un webhook garantiza que el pedido llegó al almacén?
No. Confirma que se emitió o entregó un evento según el punto observado. Hace falta registrar la aceptación del WMS y conciliar pedidos pendientes.
¿Cómo se evita duplicar pedidos en el WMS?
Con una clave idempotente estable, correspondencias guardadas y reintentos que consultan el estado antes de crear otra instrucción.
Fuentes oficiales revisadas
Referencias usadas para contrastar recomendaciones técnicas, documentación de plataforma y criterios de búsqueda.
