Al hacer comercio electrónico en Chile, muchos pedidos no provienen del sitio web propio, sino de MercadoLibre. El sitio web y la plataforma tienen cada uno su propio panel, por lo que el inventario, los pedidos y los envíos se consultan por separado. KingCMS X1 incluye el módulo MercadoLibre, que integra los pedidos de la plataforma en un mismo panel y los contabiliza por separado según el canal de venta.
En qué casos es útil
Los casos habituales son: primero, tener una tienda en MercadoLibre y, al mismo tiempo, usar KingCMS para una tienda independiente, y querer ver los pedidos en una sola lista; segundo, vender el mismo producto en ambos lados y necesitar vincular el SKU de la plataforma con el SKU del sitio web para evitar sobreventas; tercero, cuando aumenta el volumen de envíos, no querer copiar manualmente las etiquetas de envío y el estado del inventario en ambos lados.
Si solo vendes en la plataforma y no tienes una tienda independiente, este módulo no es necesario.
Paso 1: activar el módulo y preparar las credenciales de la aplicación
El módulo está desactivado de forma predeterminada; mientras no se active, no aparece la entrada en el panel y las rutas y las tareas programadas tampoco se activan. Después de activar MercadoLibre en «Gestión de módulos», aparecerá la entrada en «Tienda» de la barra lateral.
Antes de conectar, debes crear una aplicación en el panel de desarrolladores de MercadoLibre, obtener el Client ID y el Client Secret, y configurar la URL de callback con la misma dirección que el sitio. La página de configuración del panel muestra la URL de callback que utiliza realmente este sitio; basta con copiarla. Si ambas no coinciden, la autorización fallará.
En la página de configuración hay varias opciones clave: selecciona Chile (MLC) como sitio; los días recientes a sincronizar van de 1 a 30 días, con 7 días por defecto; el intervalo de sincronización automática no debe ser inferior a 5 minutos, con 30 minutos por defecto; la sincronización automática programada está desactivada de forma predeterminada y debe activarse manualmente. Se recomienda hacer una prueba primero con un número reducido de días, confirmar que los pedidos y los importes sean correctos y luego ampliar el rango.
Paso 2: autorizar la conexión
Al hacer clic en «Conectar MercadoLibre», se abrirá la página de autorización de la plataforma y, tras confirmar, volverás a este sitio. El token se guarda cifrado; la página solo muestra «Conectado», la cuenta de vendedor y la hora de vencimiento, sin mostrar el texto plano. Si faltan menos de 5 minutos para que venza, se actualizará antes de llamar a la API; si se produce un error 401, se actualizará una vez y se reintentará.
Hay una restricción de seguridad estricta: la autorización, el callback, la sincronización, el envío de datos y las etiquetas de envío solo aceptan dominios públicos con https; se rechazan siempre localhost, las direcciones de red interna y las IP sin dominio. Para depurar en local, utiliza un dominio oficial con un proxy inverso.
Paso 3: sincronizar pedidos y revisar las cuentas por canal
En «Sincronizar pedidos», puedes dejar el campo vacío para obtener los pedidos de un período reciente o indicar un número de pedido para sincronizar solo algunos pedidos concretos. Cuando ingresan pedidos de la plataforma, el canal se registra como MercadoLibre y se separa de los pedidos del sitio web: la lista de pedidos del panel se puede filtrar por canal, y las estadísticas de ventas y la exportación también se dividen por canal.
El número de pedido se forma siempre con ML- más el número de pedido de la plataforma; las sincronizaciones repetidas se omiten, no se genera un segundo pedido ni se sobrescriben los importes y productos modificados manualmente en el panel. Los importes se guardan en centavos multiplicando el entero en pesos chilenos por 100, de modo que el total del pedido, el subtotal de las líneas, el envío y los descuentos sigan cuadrando. Los estados se asignan según el estado de la plataforma: pendiente de pago, pagado, reembolso parcial, reembolsado y cancelado; en los pedidos pagados también se consulta la logística: si se ha enviado, pasa a «Enviado», y si se ha entregado, a «Completado»; solo avanza, nunca retrocede.
Paso 4: asignación de SKU, etiquetas de envío y actualización de inventario
Para sincronizar el inventario y los precios, primero vincula los productos de la plataforma con los SKU del sitio web en la página de asignación de SKU. Puedes hacerlo uno por uno o mediante importación y exportación masiva en CSV. Los productos de la plataforma sin asignar aparecerán en el informe de productos no asignados y desaparecerán automáticamente una vez asignados.
Las etiquetas de envío se descargan directamente desde el pedido; el enlace usa una firma temporal y es válido durante 1 hora de forma predeterminada. El envío de inventario y precios está desactivado de forma predeterminada; una vez activado, tanto el botón manual como las tareas programadas enviarán los datos según la asignación, y no se enviarán productos sin asignación.
Consideraciones
Primero, los pedidos de la plataforma son pedidos importados y no pueden pasar por el flujo de pago dentro del sitio; el pago y el reembolso se siguen realizando en MercadoLibre. Segundo, la sincronización automática está desactivada de forma predeterminada; no olvides configurar el intervalo según tu volumen de pedidos y activarla. Tercero, si los productos de la plataforma no están asignados, el envío de inventario no tendrá efecto; primero completa la asignación y luego activa el envío. Cuarto, si vendes el mismo producto en ambos lados, define de antemano qué lado manda para el inventario y así evitar sobreventas.
Resumen
El módulo MercadoLibre no resuelve «tener un canal de venta más», sino «que las cuentas sigan cuadrando cuando hay más canales»: los pedidos entran en el mismo panel, se contabilizan por canal, los SKU quedan vinculados y las etiquetas de envío y el estado del inventario no hay que trasladarlos manualmente. Para los equipos que gestionan a la vez una tienda independiente y una tienda en plataformas latinoamericanas, esto ahorra la parte más tediosa del trabajo diario.