Guía

Cómo sincronizar el stock entre MercadoLibre y WooCommerce

Por qué la sobreventa aparece incluso con dos paneles bien atendidos, y qué tiene que resolver una sincronización de stock para evitarla: sentido, frecuencia, rebotes y la red de abajo.

Todas las guías6 minutos de lectura

La sobreventa no es un descuido. Es lo que pasa cuando la misma unidad figura disponible en dos lugares y los dos pueden venderla: se vende dos veces, y una de las dos ventas termina en cancelación. En MercadoLibre esa cancelación se paga con reputación, que es lo que decide si tus publicaciones se ven.

Sincronizar el stock parece copiar un número de un lado al otro. No lo es. Hay cuatro cosas que resolver, y si falta una, la sincronización o llega tarde o se persigue la cola.

1
Decidir quién manda
Si los dos canales pueden cambiar el stock, hay que definir qué pasa cuando los dos cambian. Lo más simple y lo más seguro para empezar es un solo sentido: uno de los dos es la verdad y el otro la refleja. Una vez que se ve que funciona, se pasa a bidireccional. La decisión se toma por conexión, así que podés tener una tienda mandando stock a MercadoLibre y otra recibiéndolo, en la misma cuenta.
Consejo
Arrancá en sentido único y en modo manual. Nada se mueve hasta que apretás el botón, y podés mirar el resultado antes de automatizar.
2
Que el cambio viaje cuando ocurre, no cada tanto
Una sincronización cada quince minutos deja una ventana de quince minutos donde la sobreventa es posible. Las dos plataformas avisan de los cambios: MercadoLibre notifica cuando una publicación cambia y WooCommerce dispara sus webhooks al crear, editar o borrar un producto. Escuchando las dos puntas, el cambio se procesa en el momento.
3
Evitar que el sistema se persiga la cola
Cuando dos sistemas se sincronizan entre sí, la escritura de uno parece un cambio nuevo para el otro, que responde escribiendo de vuelta, y así indefinidamente. Es el problema real de cualquier integración bidireccional. Se resuelve marcando las escrituras propias antes de hacerlas y descartándolas cuando vuelven como notificación. Es la diferencia entre una conexión bidireccional y un bucle infinito.
4
Tener una red abajo
Los webhooks fallan. Se pierde una notificación, la plataforma tiene un mal día, el proceso se reinicia justo ahí. Por eso el tiempo real no puede ser sólo webhooks: hace falta una reconciliación programada que vuelva a comparar el estado de las dos tiendas cada tanto y arregle lo que haya quedado distinto. La velocidad la dan las notificaciones; la garantía la da la reconciliación.
Ojo con esto
Una integración que sólo escucha webhooks funciona perfecto hasta el día que no, y ese día nadie se entera hasta que aparece la venta cancelada.
5
El stock de una variante no es el del producto
Si vendés con talles, lo que se agota no es "la zapatilla": es el talle 42. La sincronización tiene que bajar hasta la variante y emparejarla con la del otro lado, una a una dentro del producto. Sincronizar sólo el total del producto es lo mismo que no sincronizar cuando la mitad de tu catálogo es variable.

Lo que esto no resuelve

Ninguna sincronización elimina del todo la ventana de sobreventa: entre que alguien aprieta "comprar" en MercadoLibre y que el descuento llega a tu tienda pasan segundos. Lo que se elimina es la ventana de minutos u horas, que es donde ocurre casi siempre.
Si además vendés en un local físico y descontás a mano, esa punta también tiene que escribir en el canal que manda, o el problema vuelve por ahí.

Preguntas

Sobre esta guía

¿Cada cuánto se sincroniza?

Se elige por conexión: manual, cada 5, 15, 30 o 60 minutos, o en tiempo real. En tiempo real los webhooks de las dos plataformas empujan el cambio apenas ocurre, y una reconciliación programada pasa igual cada tanto a verificar que nada haya quedado desalineado.

¿Una venta en MercadoLibre descuenta el stock en mi tienda?

Sí, y es el sentido que más importa: es el que evita la sobreventa. Lo que no se hace es crear la venta de MercadoLibre como si fuera una venta de tu tienda — eso falsearía tus métricas. El pedido sí puede importarse, que es otra cosa.

¿Consume mucho si tengo un catálogo grande?

Depende de cuánto cambie, no de cuán grande sea. Antes de escribir, se compara el estado del producto contra un espejo de la última sincronización: si nada cambió, no se llama a la API. Un catálogo grande y quieto es barato; uno chico que cambia todo el día, no tanto.

Cómo está hecho, en detalle:

Sincronización Catálogo

Seguir leyendo