Hubiss
Conexão Oficial • 4 min de leitura

Como Conectar e Autorizar suas Contas de Mercado Livre e Shopee

Passo a passo seguro via OAuth 2.0 para integrar seus canais de vendas em 1 clique sem digitar senhas.


title: Como conectar e autorizar contas do Mercado Livre e da Shopee group: Operação Dropshipper order: 1 description: Passo a passo para conectar, autorizar e reconectar sua conta de marketplace dentro do assistente Nova Operação, com explicação do que a autorização permite e do que fazer quando ela expira.

O que é a autorização da conta

A Hubiss é integrada oficialmente às APIs do Mercado Livre e da Shopee pelo protocolo OAuth 2.0. Na prática:

  • você não digita a senha do marketplace dentro da Hubiss;
  • a autorização é feita na tela oficial do canal, com o login do vendedor;
  • o canal devolve um token de acesso que permite à Hubiss ler pedidos, publicar anúncios, calcular frete e emitir etiqueta em seu nome.

Autorizar a conta não publica anúncios. Publicação é sempre o resultado de uma Nova Operação concluída.

Caminho único: Nova Operação, Passo 2

  1. Clique em Nova Operação no topo do painel (ou abra /admin/nova-operacao).
  2. Passo 1, Fornecedor: escolha o catálogo que será publicado.
  3. Passo 2, Marketplace: clique em + Conectar Mercado Livre ou + Conectar Shopee.
  4. Na janela do canal, faça login, confira as permissões e clique em Permitir/Autorizar.
  5. Você volta para a Hubiss com a conta marcada como Autorizado: SIM.
  6. Siga para o Passo 3 (Regra de Preço) e o Passo 4 (Revisão). O 5º passo é o processamento automático.

A tela Catálogo & Integrações > Contas > Marketplace também permite conectar e reconectar, mas ela não publica. O anúncio só nasce ao concluir a Nova Operação.

Como conectar a Shopee

  1. Abra Nova Operação > Passo 2.
  2. Clique em + Conectar Shopee.
  3. No portal da Shopee Open Platform, confirme a região Brazil (BR).
  4. Entre como Seller (Vendedor) e autorize os acessos de produtos e pedidos.
  5. Depois do redirecionamento, a conta aparece com o selo verde Autorizado.

Como conectar o Mercado Livre

  1. Abra Nova Operação > Passo 2.
  2. Clique em + Conectar Mercado Livre.
  3. Na tela do Mercado Livre, entre com a conta que vende e revise as permissões.
  4. Clique em Permitir e aguarde o retorno para a Hubiss.

Reconexão: token expirou ou autorização foi revogada

Os tokens têm validade por segurança. A Hubiss renova em segundo plano, mas a conta fica com Autorizado: NÃO se:

  • você trocou a senha do marketplace;
  • o canal revogou as permissões;
  • o token expirou e o refresh falhou.

Para resolver, repita o Passo 2 da Nova Operação e autorize de novo. Nenhum anúncio, pedido ou operação é perdido nesse processo.

Autorizado x Problema para Anunciar

Indicador O que significa Como resolver
Autorizado (SIM/NÃO) A chave OAuth está ativa e comunicando com o canal. Se estiver NÃO, reconecte pelo Passo 2.
Problema para Anunciar (SIM/NÃO) O canal bloqueou temporariamente novos anúncios (KYC, dados fiscais ou política). Regularize no próprio canal. Isso nunca bloqueia a sincronização de pedidos já vendidos.

Como testar a conta depois de conectar

Depois que a conta já está autorizada, você pode pedir o teste ao Copiloto:

  • "minha conta está ok?"
  • "testar minhas contas"
  • "meu Mercado Livre está funcionando?"

O Copiloto consulta as APIs oficiais e devolve o diagnóstico conta por conta, incluindo Requer Reconexão OAuth e Alerta de Postagem com código e mensagem.

Atenção: o teste confirma uma autorização que já existe. Ele não conecta a conta. Se o canal não aparece no Passo 2, ele ainda não foi conectado.

Perguntas frequentes

A Hubiss guarda minha senha do marketplace? Não. A senha é digitada apenas no site oficial do canal. A Hubiss recebe somente o token de autorização.

Posso me conectar com outras lojas? Quantas lojas posso conectar? Sim. Hoje a Hubiss integra Shopee e Mercado Livre como marketplaces, e dá para conectar várias lojas na mesma conta Hubiss, inclusive mais de uma conta do mesmo marketplace (por exemplo, duas lojas da Shopee). Se a sua pergunta for sobre outro tipo de conexão, também atendemos:

  • Loja virtual própria na Shopify: a Hubiss publica e sincroniza o catálogo da sua loja Shopify.
  • ERP Bling ou Tiny: conexão por chave de API em Canais de Venda > Sistemas ERP, para sincronizar catálogo, estoque e pedidos com o seu sistema de gestão.

O limite de contas do plano (Free 2, Small 5, Standard 16 e Expert ilimitadas) vale para contas de marketplace, tanto na tela Contas quanto na Nova Operação.

Cada conta é uma operação separada, com a própria autorização no canal. Os produtos vêm do mesmo catálogo de fornecedores da sua conta e o estoque é compartilhado entre os canais, então o mesmo item não é vendido duas vezes.

Ao atingir o limite, nenhuma conta é desconectada: a tela avisa e oferece o upgrade em Minha Conta > Planos.

Conectei e o canal não aparece no Passo 2. O que faço? A autorização não foi concluída. Repita o passo de conectar e finalize a autorização na tela do canal.

Preciso abrir a tela de endereços de remetente para conectar? Não. Conexão e autorização acontecem no Passo 2 da Nova Operação. Endereço de coleta é um assunto separado, tratado apenas quando o próprio pedido ou o canal sinaliza divergência.

Pronto para colocar em prática?

Acesse seu painel agora mesmo para aplicar as configurações e acelerar suas vendas automatizadas.