- Início
- Documentação
- Mercado Livre
- Conectar sua conta do Mercado Livre
Conectar sua conta do Mercado Livre
Como autorizar o Toldo na sua conta de vendedor do Mercado Livre, quais permissões ele pede, como a conexão é protegida e quando reconectar.
Este recurso está em implantação: estamos liberando por etapas com os sócios fundadores. O que este guia descreve pode mudar antes do lançamento geral.
Em resumo
Você conecta sua conta pelo Toldo com o usuário principal do Mercado Livre (começando pelo Mercado Libre México): autoriza o Toldo no Mercado Livre, que entrega a ele uma permissão de acesso e nunca a sua senha, e depois confirma no Toldo a qual loja a conta se conecta. Se essa permissão expirar ou você a revogar, o Toldo deixa de sincronizar a conta e pede que você a conecte de novo.
Antes de começar
- Use o usuário principal da conta. Só o titular da conta do Mercado Livre pode autorizar apps. Operadores e colaboradores não podem.
- Sua conta precisa estar validada. O Mercado Livre não deixa autorizar apps em contas bloqueadas ou com a validação de identidade incompleta.
- Começamos pelo Mercado Libre México. Hoje o Toldo conecta uma conta do Mercado Libre México por loja, com o botão Conectar México. As contas de outros países (Brasil, Argentina, Chile, Colômbia) e uma segunda conta na mesma loja estão sendo abertas por etapas, primeiro com os sócios fundadores: se você precisar delas, escreva para nós.
- Prepare seus SKUs. Assim que você conecta, o Toldo vincula seus anúncios e envia a eles o estoque da Shopify. Veja Vincular anúncios.
Passos para conectar
- Abra Mercado Livre no Toldo. No admin da Shopify, entre no Toldo. Em Início, o guia Primeiros passos começa por este passo, com o botão Conectar o Mercado Livre México; você também pode abrir Mercado Livre no menu.
- Clique em Conectar México. Em Conecte sua conta do Mercado Livre, clique em Conectar México. O Toldo leva você à página de autorização do Mercado Livre.
- Autorize o Toldo. Entre com o usuário principal da sua conta e aceite as permissões.
- Confirme a conexão. O Mercado Livre leva você a uma página do Toldo que pergunta Conectar [sua conta]? e mostra sua conta e sua loja Shopify. Se estiverem certas, clique em Conectar. O Toldo leva você de volta ao admin da Shopify, à página da conta. Se você demorar mais de 15 minutos, comece de novo.
- Confira seus anúncios. Em menos de um minuto, o Toldo começa a ler seus anúncios ativos e pausados, vincula-os aos seus produtos da Shopify e envia o estoque com as regras padrão: todos os locais, nenhuma unidade de reserva e sem máximo. Os preços não mudam até você ativar o envio deles. Só os pedidos feitos depois de conectar são importados para a Shopify. Continue em Vincular anúncios.
Guia de configuração
Depois de conectar, a página da conta mostra um guia com os passos que faltam, em ordem, e marca como Concluído os que você já terminou. Ele se atualiza sozinho com o que o Toldo vê:
- Conecte sua conta do Mercado Livre. Concluído enquanto a conta está conectada.
- Vincule seus anúncios. Concluído quando cada anúncio tem o seu produto da Shopify ou está ignorado. Veja Vincular anúncios.
- Revise suas regras de sincronização. Concluído quando você salva as regras da conta ou, no México, quando confirma quem fatura suas vendas.
- Configure seu CFDI. Só se você escolheu que o Toldo fature essas vendas: concluído quando você conecta seu emissor de CFDI.
- Receba seu primeiro pedido. Concluído quando o seu primeiro pedido do Mercado Livre chega à Shopify.
A página inicial do Toldo também mostra o próximo passo de cada conta. Quando você termina, o guia desaparece; você também pode ocultá-lo com Ocultar este guia.
Quais permissões o Toldo pede
O Toldo pede permissão para ler e modificar sua conta de vendedor (anúncios, estoque, preços, pedidos e envios) e para manter a conexão ativa sem que você precise entrar toda vez.
Cada conta conectada tem suas próprias regras: o que sincronizar, como calcular estoque e preços, se deve importar pedidos e quem fatura as vendas. Uma conta do Mercado Livre só pode estar conectada a uma loja Shopify por vez: se ela já estiver conectada a outra, desconecte-a lá primeiro.
Como a conexão é protegida
- O Toldo nunca vê a sua senha. Você autoriza no site do Mercado Livre, que entrega ao Toldo uma permissão de acesso.
- A autorização vai assinada. O Toldo verifica se a resposta do Mercado Livre corresponde à solicitação feita pela sua loja, para que ninguém consiga conectar outra conta em seu nome.
- As permissões ficam guardadas criptografadas e nunca aparecem nos registros. Elas são apagadas quando você desconecta a conta ou desinstala o Toldo, e nos dois casos o Toldo também retira o acesso dele na sua conta do Mercado Livre. Se o Mercado Livre não responder nesse momento, retire-o você mesmo pela sua conta do Mercado Livre.
Quando é preciso reconectar
O Mercado Livre invalida a permissão de acesso, por exemplo, quando:
- você muda a senha da sua conta;
- você revoga o acesso do Toldo pelo Mercado Livre;
- passam quatro meses sem que o app use a conta;
- sua conta fica bloqueada ou com a validação incompleta.
Quando isso acontece, o Toldo deixa de sincronizar a conta, marca-a como Precisa reconectar e mostra um aviso em Início, em Mercado Livre e na página da conta. Clique em Conectar de novo, autorize de novo no Mercado Livre e confirme com Conectar. Seus vínculos e suas regras são mantidos e a sincronização continua de onde parou; o Toldo importa os pedidos feitos nesse meio-tempo, até 30 dias para trás.
Avisos por e-mail
Quando uma conta precisa de você, o Toldo avisa por e-mail em poucos minutos, além de registrar na Atividade da conta:
- é preciso conectá-la de novo (ou, na Amazon, renovar em breve a autorização);
- um pedido não pôde ser criado na Shopify;
- os pedidos do seu plano deste mês acabaram;
- um cancelamento que a Shopify não conseguiu aplicar, ou um que chegou depois do envio (uma devolução para tratar);
- o Toldo perdeu o acesso à sua loja e não consegue sincronizar nada.
Se várias coisas acontecerem em sequência, elas chegam em um só e-mail, com o link para a conta. O e-mail vai para o endereço que a Shopify usa para falar com você sobre a sua loja. Para deixar de recebê-los em uma conta, desmarque Avisar por e-mail quando esta conta precisar de mim nas regras de sincronização dela.
Se o Toldo perder o acesso à sua loja
O Toldo trabalha na sua loja com uma permissão que a Shopify renova a cada hora. Se a Shopify deixar de renová-la, o Toldo não consegue ler seu estoque nem criar pedidos: nada é sincronizado, e as tarefas pendentes ficam em espera, sem se perder.
- O aviso. O Toldo avisa por e-mail quando o problema já dura meia hora, caso fosse passageiro.
- Os lembretes. Enquanto continuar assim, ele lembra você no dia seguinte, aos dois e aos três dias, e depois uma vez por semana, até completar um mês; depois disso, não escreve mais. Cada lembrete diz há quantos dias isso dura e quantas tarefas da sua loja esperam.
- Como resolver. Abra o Toldo no admin da Shopify: com isso a Shopify dá a ele uma permissão nova. Quando o acesso volta, as tarefas em espera continuam e você recebe um e-mail avisando que está resolvido.
Esses e-mails trazem só contagens: nunca dados dos seus compradores. Se você desinstalar o Toldo, não recebe nenhum deles.
Desconectar uma conta
Se você só quer parar a sincronização por um tempo, use Pausar a sincronização na página da conta: nada de estoque, preços ou pedidos se move até você clicar em Retomar a sincronização, e os pedidos feitos nesse meio-tempo são importados quando você retoma, até 30 dias para trás.
Para desconectá-la, clique em Desconectar e confirme com Sim, desconectar. O Toldo retira o acesso dele no Mercado Livre, apaga as permissões de acesso e os vínculos de anúncios e pedidos, e deixa de sincronizar a conta. Suas regras ficam guardadas caso você a conecte de novo, mas os pedidos feitos enquanto ela esteve desconectada não são importados. Seus anúncios no Mercado Livre ficam como estão, com o último estoque e o último preço enviados, e os pedidos que já estão na Shopify não mudam. Para apagar também as regras e a atividade da conta, clique em Remover.
Perguntas frequentes
Posso conectar mais de uma conta do Mercado Livre?
Sim. Cada conta tem a sua própria página e as suas próprias regras. O Mercado Livre pede que você autorize com a conta que está com a sessão aberta no seu navegador: para conectar outra, saia dessa sessão no Mercado Livre (ou use uma janela anônima), entre com o usuário principal da outra conta e repita os passos. Antes de conectar, o Toldo mostra qual conta você vai conectar.
Um colaborador da minha conta pode conectá-la?
Não. O Mercado Livre só permite que o usuário principal da conta autorize apps.
O Toldo pode ver minha senha do Mercado Livre?
Não. Você entra no site do Mercado Livre e o Toldo só recebe uma permissão de acesso, que você pode revogar quando quiser.
O Toldo é um app oficial do Mercado Livre?
Não. O Toldo é um app independente que usa a API pública do Mercado Livre com a sua autorização.