- Inicio
- Documentación
- Mercado Libre
- Conectar tu cuenta de Mercado Libre
Conectar tu cuenta de Mercado Libre
Cómo autorizar a Toldo en tu cuenta de vendedor de Mercado Libre, qué permisos pide, cómo se protege la conexión y cuándo hay que volver a conectar.
Esta función está en despliegue: la estamos activando por etapas con los socios fundadores. Lo que describe esta guía puede cambiar antes del lanzamiento general.
En resumen
Conectas tu cuenta desde Toldo con el usuario principal de Mercado Libre: autorizas a Toldo en Mercado Libre, que le entrega un permiso de acceso y nunca tu contraseña, y después confirmas en Toldo a qué tienda se conecta. Si ese permiso vence o lo revocas, Toldo deja de sincronizar la cuenta y te pide volver a conectarla.
Antes de empezar
- Usa el usuario principal de la cuenta. Solo el titular de la cuenta de Mercado Libre puede autorizar apps. Los operadores y colaboradores no pueden.
- Tu cuenta debe estar validada. Mercado Libre no deja autorizar apps a cuentas con la validación de identidad incompleta o bloqueadas.
- Empezamos con Mercado Libre México. Hoy Toldo conecta una cuenta de Mercado Libre México por tienda, con el botón Conectar México. Las cuentas de otros países (Brasil, Argentina, Chile, Colombia) y una segunda cuenta en la misma tienda se están abriendo por etapas, primero con los socios fundadores: si las necesitas, escríbenos.
- Prepara tus SKU. En cuanto conectas, Toldo vincula tus publicaciones y les envía el stock de Shopify. Consulta Vincular publicaciones.
Pasos para conectar
- Abre Mercado Libre en Toldo. En tu admin de Shopify, entra a Toldo. En Inicio, la guía Primeros pasos empieza por este paso, con el botón Conectar Mercado Libre México; también puedes abrir Mercado Libre en el menú.
- Haz clic en Conectar México. En Conecta tu cuenta de Mercado Libre, haz clic en Conectar México. Toldo te lleva a la página de autorización de Mercado Libre.
- Autoriza a Toldo. Inicia sesión con el usuario principal de tu cuenta y acepta los permisos.
- Confirma la conexión. Mercado Libre te lleva a una página de Toldo que pregunta ¿Conectar [tu cuenta]? y muestra tu cuenta y tu tienda Shopify. Si son las correctas, haz clic en Conectar. Toldo te regresa a tu admin de Shopify, a la página de la cuenta. Si tardas más de 15 minutos, empieza de nuevo.
- Revisa tus publicaciones. En menos de un minuto, Toldo empieza a leer tus publicaciones activas y pausadas, las vincula con tus productos de Shopify y les envía el stock con las reglas predeterminadas: todas las ubicaciones, sin unidades de reserva y sin máximo. Los precios no cambian hasta que actives su envío. Solo se importan a Shopify los pedidos hechos después de conectar. Sigue con Vincular publicaciones.
Guía de configuración
Después de conectar, la página de la cuenta muestra una guía con los pasos que faltan, en orden, y marca como Listo los que ya terminaste. Se actualiza sola con lo que Toldo ve:
- Conecta tu cuenta de Mercado Libre. Listo mientras la cuenta está conectada.
- Vincula tus publicaciones. Listo cuando cada publicación tiene su producto de Shopify o está ignorada. Consulta Vincular publicaciones.
- Revisa tus reglas de sincronización. Listo cuando guardas las reglas de la cuenta o, en México, cuando confirmas quién factura tus ventas.
- Configura tu CFDI. Solo si elegiste que Toldo facture estas ventas: listo cuando conectas tu emisor de CFDI.
- Recibe tu primer pedido. Listo cuando tu primer pedido de Mercado Libre llega a Shopify.
La página de inicio de Toldo también muestra el siguiente paso de cada cuenta. Cuando terminas, la guía desaparece; también puedes ocultarla con Ocultar esta guía.
Qué permisos pide Toldo
Toldo pide permiso para leer y modificar tu cuenta de vendedor (publicaciones, stock, precios, pedidos y envíos) y para mantener la conexión activa sin que tengas que entrar cada vez.
Cada cuenta conectada tiene sus propias reglas: qué sincronizar, cómo calcular stock y precios, si importar pedidos y quién factura sus ventas. Una cuenta de Mercado Libre solo se puede conectar a una tienda Shopify a la vez: si ya está conectada a otra, desconéctala allí primero.
Cómo se protege la conexión
- Toldo nunca ve tu contraseña. La autorizas en el sitio de Mercado Libre, que le entrega a Toldo un permiso de acceso.
- La autorización va firmada. Toldo comprueba que la respuesta de Mercado Libre corresponde a la solicitud que hizo tu tienda, para que nadie pueda conectar otra cuenta a tu nombre.
- Los permisos se guardan cifrados y nunca aparecen en los registros. Se borran al desconectar la cuenta o al desinstalar Toldo, y en los dos casos Toldo retira también su acceso en tu cuenta de Mercado Libre. Si Mercado Libre no responde en ese momento, retíralo tú desde tu cuenta de Mercado Libre.
Cuándo hay que volver a conectar
Mercado Libre invalida el permiso de acceso, por ejemplo, cuando:
- cambias la contraseña de tu cuenta;
- revocas el acceso de Toldo desde Mercado Libre;
- pasan cuatro meses sin que la app use la cuenta;
- tu cuenta queda bloqueada o con la validación incompleta.
Cuando pasa, Toldo deja de sincronizar la cuenta, la marca como Hay que reconectar y te muestra un aviso en Inicio, en Mercado Libre y en la página de la cuenta. Haz clic en Volver a conectar, autoriza de nuevo en Mercado Libre y confirma con Conectar. Tus vínculos y tus reglas se conservan y la sincronización sigue donde se quedó; Toldo importa los pedidos que entraron mientras tanto, hasta 30 días atrás.
Avisos por correo
Cuando una cuenta te necesita, Toldo te escribe a los pocos minutos, además de registrarlo en la Actividad de la cuenta:
- hay que volver a conectarla (o, en Amazon, renovar pronto su autorización);
- un pedido no se pudo crear en Shopify;
- se acabaron los pedidos de tu plan de este mes;
- una cancelación que Shopify no pudo aplicar, o una que llegó después del envío (una devolución que atender);
- Toldo perdió el acceso a tu tienda y no puede sincronizar nada.
Si pasan varias cosas seguidas, llegan en un solo correo, con el enlace a la cuenta. El correo va a la dirección con la que Shopify te escribe sobre tu tienda. Para dejar de recibirlos en una cuenta, desmarca Avisarme por correo cuando esta cuenta me necesite en sus reglas de sincronización.
Si Toldo pierde el acceso a tu tienda
Toldo trabaja en tu tienda con un permiso que Shopify le renueva cada hora. Si Shopify deja de renovarlo, Toldo no puede leer tu stock ni crear pedidos: no se sincroniza nada, y las tareas pendientes se quedan en espera, sin perderse.
- El aviso. Toldo te escribe cuando el problema lleva media hora, por si era pasajero.
- Los recordatorios. Mientras siga igual, te lo recuerda al día siguiente, a los dos y a los tres días, y después una vez por semana, hasta cumplir un mes; después de eso ya no te escribe. Cada recordatorio dice cuántos días lleva y cuántas tareas de tu tienda esperan.
- Cómo se arregla. Abre Toldo en tu admin de Shopify: con eso Shopify le da un permiso nuevo. Cuando el acceso vuelve, las tareas en espera continúan y te llega un correo para avisarte que ya se arregló.
Estos correos solo llevan conteos: nunca datos de tus compradores. Si desinstalas Toldo, no recibes ninguno.
Desconectar una cuenta
Si solo quieres detener la sincronización un tiempo, usa Pausar la sincronización en la página de la cuenta: no se mueven stock, precios ni pedidos hasta que haces clic en Reanudar la sincronización, y los pedidos hechos mientras tanto se importan al reanudar, hasta 30 días atrás.
Para desconectarla, haz clic en Desconectar y confirma con Sí, desconectar. Toldo retira su acceso en Mercado Libre, borra los permisos de acceso y los vínculos de publicaciones y pedidos, y deja de sincronizar la cuenta. Tus reglas se guardan por si la vuelves a conectar, pero los pedidos hechos mientras estuvo desconectada no se importan. Tus publicaciones en Mercado Libre se quedan como están, con el último stock y precio enviados, y los pedidos que ya están en Shopify no cambian. Para borrar también las reglas y la actividad de la cuenta, haz clic en Eliminar.
Preguntas frecuentes
¿Puedo conectar más de una cuenta de Mercado Libre?
Sí. Cada cuenta tiene su propia página y sus propias reglas. Mercado Libre te pide autorizar con la cuenta que tiene la sesión abierta en tu navegador: para conectar otra, cierra esa sesión en Mercado Libre (o usa una ventana privada), entra con el usuario principal de la otra cuenta y repite los pasos. Antes de conectar, Toldo te muestra qué cuenta vas a conectar.
¿Un colaborador de mi cuenta puede conectarla?
No. Mercado Libre solo permite que el usuario principal de la cuenta autorice apps.
¿Toldo puede ver mi contraseña de Mercado Libre?
No. Inicias sesión en el sitio de Mercado Libre y Toldo solo recibe un permiso de acceso, que puedes revocar cuando quieras.
¿Toldo es una app oficial de Mercado Libre?
No. Toldo es una app independiente que usa la API pública de Mercado Libre con tu autorización.