
Para no vender dos veces la última unidad, uso una misma reserva de stock para la tienda, WhatsApp e Instagram. El order sync reduce la sobreventa, pero no reemplaza la reposición.
Mi punto de partida es calcular cuánto puedo vender por SKU y depósito, sin descontar dos veces una unidad. Después, ordeno el circuito:
La prueba es concreta: si recibo 100 intentos sobre 20 unidades, puedo reservar como máximo 20. <u>Sin stock confirmado, no confirmo la venta.</u>
Order sync: cómo evitar la sobreventa
Asigná una autoridad por dato, no por aplicación. Dejá claro quién controla cada campo y qué hacer ante un error: reintentar, enviarlo a una cola o bloquear la operación.
Después, vinculá cada pedido con una reserva y un evento único. No alcanza con compartir datos: hay que definir quién puede mover cada unidad.
| Sistema | Datos que controla | Eventos que recibe | Eventos que emite | Riesgo si falla |
|---|---|---|---|---|
| Checkout | Stock visible, carrito y pago | Disponibilidad y confirmaciones de reserva | Solicitudes de reserva y pagos confirmados | Puede vender sin stock o mostrar cantidades desactualizadas. |
| OMS | Pedidos, reservas y prioridad | Pedidos, pagos y movimientos confirmados | Reservas, liberaciones y órdenes de preparación | Puede duplicar pedidos o no liberar stock. |
| WMS | Stock físico y operaciones de depósito | Órdenes de preparación y ajustes | Movimientos físicos confirmados | Puede descontar mal o informar un inventario incorrecto. |
| Catálogo | Productos, variantes, SKU, precio y atributos | Cambios de producto y saldo vendible | Productos y disponibilidad publicada | Puede mostrar la variante o el precio equivocados. |
El checkout debe enviar SKU o variante, cantidad, ubicación, canal y una clave de idempotencia. La respuesta de reserva debe incluir reservation_id, cantidad, SKU, ubicación y vencimiento. El pago tiene que quedar vinculado a esa reserva. Luego, el OMS registra el pedido y la asignación, y el WMS recibe la orden de preparación. Usá IDs estables de pedido, línea, variante y ubicación durante todo el flujo.
El WMS informa preparación, empaque y despacho, además de recepciones, diferencias y ajustes. Confirma los movimientos físicos, pero no actualiza los canales directamente. Definí cuándo la autoridad de inventario registra la baja física: debe consumir el compromiso una sola vez, sin volver a descontarlo del ATS. Cada evento necesita un event_id único para evitar que un reintento duplique el movimiento.
Las cancelaciones liberan compromisos; no crean unidades físicas. Las devoluciones, en cambio, requieren una inspección antes de volver a ofrecerse. El catálogo publica el saldo que resulta de las reservas, liberaciones y movimientos, para no ofrecer unidades ya comprometidas.
Estas reglas también se aplican a los canales conversacionales.
En WhatsApp e Instagram, la disponibilidad debe salir de la misma reserva que usa el checkout. Estos canales no tienen reglas propias de stock ni modifican directamente las cantidades del depósito.
Burbuxa sincroniza productos, pedidos e inventario en WhatsApp e Instagram.
Antes de habilitar las ventas, verificá qué consultas, reservas y estados admite la integración que vas a usar. Si el pago ya está aprobado pero falta confirmar la reserva, derivá el pedido a revisión manual y avisá a operaciones. Si la API falla o el dato está desactualizado, pausá la venta y derivá el caso a revisión humana. Al reintentar, no generes otro pedido.
Con el saldo vendible definido, fijá cuándo se reserva y cómo se reparte.
Partí del ATS por SKU y ubicación: stock físico menos reservas, bloqueos, transferencias salientes y stock de seguridad. Cuando una reserva pasa a comprometida, no la vuelvas a descontar del ATS. Las asignaciones por canal reparten ese saldo; no descuentan otra vez del stock físico.
Elegí un único disparador - inicio de checkout o confirmación del pedido - y reservá en una sola operación atómica. Definí vencimientos distintos para checkout y pagos pendientes. Registrá canal, pedido, SKU, ubicación, cantidad, vencimiento y estado, junto con el ID de evento y los estados anterior y nuevo. Cuando se aprueba el pago, pasá la reserva a comprometida.
El OMS gestiona la reserva y su liberación. Si la preparación ya comenzó, debe coordinar la liberación con el WMS. Liberá por rechazo del pago, cancelación previa a la preparación, vencimiento o excepción aprobada. Si el pago está autorizado pero falla la reserva, anulá la autorización.
Para Rapipago y Pago Fácil, definí si retenés el stock hasta el vencimiento del pago o lo liberás antes. Si el pago se acredita después de la liberación, volvé a reservar antes de preparar el pedido. Un reembolso no repone stock: hace falta la devolución física y su inspección.
Después, ajustá la disponibilidad publicada por canal para cubrir la demora de sincronización.
Calculá el buffer de canal = ventas pico por minuto × latencia máxima + margen. Expresá la latencia en minutos y medila hasta que el canal confirme la actualización, no solo hasta el envío. Ajustá el buffer por SKU y ubicación. Luego, distribuí el ATS con prioridades explícitas, sin que la suma de las asignaciones supere el saldo compartido. El buffer solo reduce el stock que podés publicar en ese canal.
| Control | Propósito | Disparador | Cómo ajustarlo | Tratamiento |
|---|---|---|---|---|
| Bloqueo de seguridad | Cubrir incertidumbre | Demanda variable o demoras de reposición | Según rotación, error de previsión y plazo de reposición | Excluir del ATS |
| Bloqueo operativo | Cubrir capacidad de preparación o restricciones operativas | Congestión operativa o mínimo de operación | Según capacidad por ubicación, proceso o nivel de servicio | Excluir del ATS afectado |
| Buffer de canal | Absorber demoras de sincronización | Latencia y ventas simultáneas | Según ventas durante la demora más incertidumbre | Restar solo de la asignación del canal |
| Bloqueo de calidad | Bloquear unidades pendientes de revisión | Inspección, devolución o cuarentena | Liberar con aprobación registrada | Excluir hasta su liberación |
Aplicá estas mismas reglas de reservas y buffers al inventario físico, los lotes y los kits.
Estos controles evitan prometer stock incorrecto entre depósitos y en ventas combinadas. Excluí recepciones no confirmadas, stock en tránsito, ubicaciones no habilitadas, unidades dañadas, lotes retenidos y transferencias salientes. Aplicá FEFO: primero vence, primero sale, solo entre lotes aptos y con vida útil suficiente.
Para kits, dividí el ATS de cada componente por la cantidad requerida, redondeá cada resultado hacia abajo y tomá el menor resultado como disponibilidad del kit. Reservá todos los componentes en una sola operación atómica. Si el flujo requiere varias operaciones y alguna falla, compensá las anteriores con liberaciones idempotentes. Las ventas individuales y los kits deben consumir el mismo saldo de componentes.
Con las reservas y los buffers definidos, el siguiente paso es registrar cada movimiento sin desfasar el stock publicado.
Documentá cómo afecta cada evento al inventario para que el catálogo no siga vendiendo unidades que ya no están disponibles. La recepción validada suma al stock físico; la cancelación o el vencimiento libera lo reservado; el despacho descuenta el físico una sola vez. La preparación y el empaque solo cambian el estado: no vuelven a descontar la reserva. Registrá las devoluciones aprobadas después de su inspección y clasificación, y cada ajuste con su motivo. Ese historial debe permitir reconstruir los saldos.
Procesá los movimientos por SKU y ubicación. Usá una clave de idempotencia por movimiento y controles de versión para detectar duplicados o eventos fuera de orden. Guardá el movimiento y su efecto en una sola transacción; recién después, confirmá el mensaje. Limitá los reintentos y aumentá la espera entre ellos. Si la falla persiste, enviá el caso a una cola de excepciones con el error, el historial y la versión afectada.
Dejá claro quién resuelve cada problema: el equipo técnico se ocupa de autenticación, API o colas; OMS/WMS, de estados inválidos; catálogo, de disponibilidad errónea; y depósito, de diferencias físicas.
Fijá un límite de demora por canal, de segundos para productos escasos o de alta rotación. Medí cuánto tarda el cambio en aplicarse en destino, incluida la disponibilidad que muestran WhatsApp e Instagram. Si se supera el límite, reducí la cantidad publicada o pausá el SKU afectado.
Cuando un evento falla o llega tarde, la conciliación debe detectarlo antes de que afecte una venta.
Compará el stock por SKU, ubicación y estado, y agregá lote y unidad de medida cuando corresponda. Ambos sistemas deben usar el mismo corte temporal. En los picos de actividad, considerá controles cada 5–15 minutos; para productos de menor riesgo, controles diarios.
Definí umbrales absolutos y porcentuales según el riesgo de vender unidades inexistentes. Si hay diferencias que superan esos umbrales, hacé un reconteo; si aparece stock negativo o riesgo de sobreventa, reducí la cantidad publicada o bloqueá la venta. Aplicá las correcciones desde la autoridad de inventario designada, con motivo y aprobación, sin sobrescribir reservas válidas.
Seguí las diferencias de stock, los eventos fallidos, los duplicados, las reservas vencidas y las sobreventas. Medí también la latencia promedio, el p95 o p99 y el tiempo de resolución de excepciones. Separá los resultados por canal y depósito: un promedio general puede ocultar fallas.
Con los desvíos a la vista, el siguiente paso es probar ventas simultáneas y excepciones.
Con las reglas y la conciliación definidas, probá el flujo bajo carga y ante excepciones antes de ampliar las ventas. Verificá que checkout, OMS, WMS y catálogo actualicen el stock en el momento correcto.
Usá esta matriz en un entorno de prueba. Los valores son hipotéticos y cada fila parte de un estado independiente. F = stock físico; V = vendible. Registrá también SKU, ubicación, pedido, versión del evento y horarios de recepción, aplicación y publicación.
Caso de prueba Inventario esperado Reserva Cantidad publicada por canal Evento de prueba Condición de alerta WhatsApp e Instagram intentan comprar la última unidad en 2 segundos F: 1; V: 0 Una confirmada; otra rechazada 0 en ambos evt-order-whatsapp-001/evt-order-instagram-002Se aprueban ambas reservas, el stock queda negativo o la publicación supera 0. Pago fallido a las 10:04, con reserva desde las 10:00 F: 1; V: 1 tras liberar Liberada 1 evt-payment-failed-003La unidad sigue reservada. Pago aprobado a las 10:16, tras vencer la reserva a las 10:15 F: 1; V: 1 tras revalidar Vencida; nueva reserva solo si sigue habiendo saldo 1 evt-payment-success-004Se confirma sin volver a verificar stock. Cancelación de 2 unidades antes del picking F: 2; V: 2 Liberada 2 evt-oms-cancel-005Se omite o duplica la liberación. Picking de 2 unidades antes de actualizar el catálogo F: 0; V: 0 Preparada; no descontar otra vez 0 evt-wms-pick-006Catálogo desactualizado o cancelación incompatible. Devolución de 1 unidad pendiente de inspección F: 1; V: 0 Sin reserva de venta; unidad bloqueada 0 evt-return-0042Se publica antes de aprobar la inspección. Ajustes incompatibles: WMS informa +3 y conteo informa −2 Sin cambio hasta resolver la discrepancia Sin cambios Sin cambio evt-wms-adjust-008/evt-count-adjust-009Versiones incompatibles o diferencia sin resolver. Webhook duplicado y versión antigua recibida después de una nueva Sin segundo efecto ni retroceso del saldo Sin cambios adicionales Último saldo válido evt-oms-reserve-010, repetido; v12 antes de v11Doble descuento o v11 sobrescribe v12. Buenos Aires tiene 1 unidad; Córdoba, 2; se reserva una en cada ubicación BA: F 1/V 0; Córdoba: F 2/V 1 Una por depósito 1 en el depósito habilitado para ese destino evt-oms-route-011/evt-oms-route-012Reserva duplicada o stock de ubicación no habilitada. Kit de 1 shampoo y 2 acondicionadores; saldo inicial: 5 y 3 Tras reservar: V 4 y 1; kits disponibles: 0 Componentes reservados: 1 y 2 0 kits evt-bundle-001Reserva incompleta o liberación incorrecta. Venta relámpago: 100 intentos sobre 20 unidades en 60 segundos F: 20; V: 0 si se reservan todas Máximo 20 unidades 0 al agotarse evt-checkout-attempt-001-100Sobreventa, pedidos duplicados o cola fuera del límite acordado.
Después, repetí los casos con reintentos y demoras. La prueba de última unidad debe validar una reserva atómica. Un pago tardío no puede recuperar automáticamente una reserva vencida, ni un webhook repetido descontar stock otra vez.
Cruzá el conteo físico con los movimientos del WMS, las reservas y los pedidos abiertos del OMS, las devoluciones y las cantidades publicadas por canal. Bloqueá la salida si quedan diferencias sin resolver. Empezá con determinados SKU, depósitos o canales. Dejá registrado quién monitorea e-commerce, quién valida el depósito, quién atiende incidentes y quién autoriza la reversión.
La reversión debe conservar las reservas válidas e incorporar los pedidos ingresados durante el despliegue. Antes de republicar un estado anterior, compará versiones o marcas de tiempo: volver atrás el software no significa restaurar un inventario viejo. Revisá también los eventos pendientes antes de reabrir las ventas.
Asigná responsables de e-commerce y operaciones para recibir alertas inmediatas por sobreventas o reservas fallidas. Establecé una revisión diaria de fallas y demoras, y una semanal de buffers, vencimientos, quiebres y precisión de preparación.
Ampliá el alcance solo con cero sobreventas, ninguna excepción crítica pendiente, reintentos resueltos y publicaciones dentro del límite acordado. Ajustá los controles según la demanda observada y el desempeño del depósito. Registrá cada cambio con fecha y hora en formato argentino, responsable y motivo.
Ejemplo de fecha y hora: “15/03/2026, 14:30”.
Con el flujo definido, asigná una sola regla de control por sistema para evitar sobreventas y quiebres con order sync. El WMS confirma el stock físico; el OMS gestiona pedidos y reservas; el catálogo publica la disponibilidad; y el checkout valida la compra. Así evitás que dos sistemas descuenten la misma unidad.
Completá el circuito con reservas atómicas, buffers según el riesgo y reglas por lote y depósito. WhatsApp, Instagram y la tienda deben consultar la misma disponibilidad. Los reintentos no deben duplicar efectos, y la conciliación debe ser continua.
El order sync reduce la sobreventa, pero no crea mercadería. Si las diferencias bajan y los quiebres siguen, revisá los pronósticos, la reposición y los plazos del proveedor. Separá los errores de sincronización de los faltantes reales de abastecimiento para corregir la causa, en vez de limitarte a ajustar el stock publicado.
Compará el stock físico con el que muestran tus canales de venta. Si hay mercadería en el depósito, pero no aparece en los canales, probablemente haya una falla de sincronización entre los sistemas.
Si el sistema indica correctamente que el stock está en cero o es muy bajo, pero no se compró al proveedor a tiempo, el problema es de reposición. Revisá los plazos del proveedor, el stock de seguridad y las tendencias de ventas.
Evitá calcular el buffer a ojo. Estimalo según los atributos del producto, las ventas de artículos similares de tu catálogo y el contexto: precio, promociones, campañas, clima y eventos. Validá las estimaciones en orden cronológico, tomando como referencia la estacionalidad.
A medida que registres ventas, ajustá el stock de seguridad según tu política de inventario disponible. Así podés cubrir las variaciones de demanda y vender solo lo que esté listo para despachar.
Priorizá los webhooks en tiempo real en lugar de las consultas periódicas para sincronizar pedidos e inventario con una demora de menos de 5 minutos. Centralizá ventas, catálogo e inventario para que Burbuxa sincronice tu tienda con WhatsApp e Instagram.
Definí reglas de reserva y stock de seguridad. Al principio, supervisá la operación y exigí aprobación humana para los cambios sensibles. Monitoreá los días de cobertura y el punto de reposición según los plazos reales de abastecimiento y tu presupuesto.