Mercado Livre
A integração com o Mercado Livre conecta a sua conta de vendedor ao idworks, sincroniza estoque e preço dos anúncios e importa pedidos, perguntas, mensagens e reclamações para o operacional. É a integração mais completa do catálogo — com 86 parâmetros distribuídos em 7 grupos — porque cobre praticamente todos os fluxos do canal (vendas normais, Fulfillment FULL, Flex, User Product, Vendedor B2B, estoque multi-origem, conciliação financeira).
A configuração tem dois grandes momentos. Primeiro, a autenticação: ao cadastrar a integração, ela nasce com status Não Autenticado; a ação Autenticar Integração abre uma nova aba no site do Mercado Livre para você fazer login e autorizar o idworks a acessar a sua conta. Depois, o preenchimento das parametrizações em si — divididas em Credenciais de Acesso, Integração de Vendas, Integração de Produtos, Integração de Perguntas e Mensagens, Conciliação, Importação de Anúncios e Logística (WMS) → Picking. Cada grupo controla um fluxo independente, e nem todos precisam estar preenchidos: ative só o que faz sentido para a sua operação.
Categoria no catálogo do idworks: Marketplace. Suporta os modos de logística ME1 (envio próprio), ME2 (Mercado Envios), Fulfillment (FULL) e Self Service (Flex).
Índice
Conceito
Cadastro e autenticação
- Como ativar a integração?
- Como autenticar a conta do Mercado Livre?
- Como verificar se a autenticação está funcionando?
Parâmetros por grupo
- Credenciais de Acesso
- Integração de Vendas
- Integração de Produtos
- Integração de Perguntas e Mensagens
- Conciliação
- Importação de Anúncios
- Logística (WMS) — Picking
Referência rápida
O que é a integração Mercado Livre?
É a conexão oficial entre o Mercado Livre e o idworks. Uma vez autenticada, o idworks passa a:
- Importar pedidos (incluindo Fulfillment, Flex e transferências para o FULL).
- Sincronizar anúncios — criar, atualizar, ajustar preço e estoque, atualizar descrições, imagens e atributos.
- Importar perguntas e respostas, mensagens do pedido e reclamações.
- Conciliar a parte financeira — taxa de marketplace, antecipação, comissão de frete, comissão de cupom — gerando lançamentos automáticos em contas a receber e a pagar.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Mercado Livre.
Quais fluxos a integração cobre?
A integração com o ML cobre 5 fluxos principais. Cada um é controlado por um grupo separado de parâmetros — ative só o que precisa:
| Fluxo | Grupo de parâmetros |
|---|---|
| Sincronizar anúncios (preço, estoque, descrição, imagem, especificações) | Integração de Produtos |
| Importar pedidos (normais, fulfillment, flex, transferências) | Integração de Vendas |
| Importar perguntas, mensagens e reclamações | Integração de Perguntas e Mensagens |
| Conciliar taxas, comissões e repasses | Conciliação |
| Importar anúncios já cadastrados no ML para dentro do idworks | Importação de Anúncios |
Há ainda um parâmetro isolado em Logística (WMS) → Picking que controla emissão automática de NF ao iniciar o picking.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Mercado Livre e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias contas (Mercado Livre — Loja Principal, Mercado Livre — Outlet).
- Clique em Salvar. A integração nasce com status Não Autenticado.
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar a conta do Mercado Livre?
- Na aba Minhas Integrações, localize a integração recém-criada e clique em Autenticar Integração (ícone de cadeado).
- Confirme na janela que abre.
- Uma nova aba do navegador abre na tela de login do Mercado Livre. Faça login com a conta de vendedor que você quer conectar.
- Autorize o idworks a acessar a conta.
- O Mercado Livre redireciona de volta — o idworks recebe a credencial e o status muda para Ativo.
A partir desse momento, o idworks renova o acesso automaticamente sempre que precisar. Se a autorização for revogada (por exemplo, você desautorizou o idworks no painel do Mercado Livre), o status volta para Erro — basta repetir o fluxo de autenticação para liberar de novo.
Como verificar se a autenticação está funcionando?
Use a ação Validar credenciais (botão dentro da configuração da integração). Ela faz uma chamada de teste ao Mercado Livre e devolve sucesso ou a mensagem de erro recebida. Use sempre que mudar algo nas credenciais ou tiver dúvida sobre o status.
Outra forma indireta: o Status da listagem (Ativo / Erro / Não Autenticado) reflete o resultado das últimas chamadas automáticas — se a integração entra em Erro, é sinal de que a autorização expirou ou foi revogada.
Credenciais de Acesso
Os identificadores do vendedor no Mercado Livre e os dados de autorização. A maioria é preenchida automaticamente pelo fluxo de autenticação — você não precisa digitar manualmente.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Acess Token | Interno | Credencial usada pelo idworks para falar com o Mercado Livre. Preenchida automaticamente após autenticação e renovada sozinha. |
| Authorization Code | Interno | Código de autorização recebido do Mercado Livre durante o login. Apenas o sistema usa. |
| Refresh Token | Interno | Credencial que permite ao idworks renovar o acesso automaticamente. Apenas o sistema usa. |
| Usuário | Cópia | Código numérico do vendedor no Mercado Livre. Preenchido após autenticação. |
| Apelido conta | Cópia | Apelido público da conta no Mercado Livre (ex.: LOJA_EXEMPLO). Preenchido após autenticação. |
| Validar credenciais | Botão | Dispara uma chamada de teste ao Mercado Livre para confirmar que a integração está respondendo. |
| Ativo User Product | Indicador | Indica se a empresa usa o modelo User Product (UP) do Mercado Livre — agrupamento de anúncios sob um item canônico. Preenchido pelo Mercado Livre. |
| Ativo Vendedor B2B | Cópia | Sinaliza se a conta do vendedor está habilitada a anunciar preço por quantidade (B2B). |
| Ativo Estoque Multi Origem | Cópia | Sinaliza se a conta tem estoques multi-origem habilitados. Quando Sim, o idworks consegue mapear armazéns para múltiplos depósitos do Mercado Livre. |
Os campos do tipo Cópia / Indicador / Interno são somente leitura — vêm do próprio Mercado Livre e servem para você confirmar que está conectado na conta certa.
Integração de Vendas
Controla o que entra como pedido no idworks vindo do Mercado Livre — quais modalidades importar, datas de corte, regras fiscais e ações automáticas em cima do pedido.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar pedidos | Sim/Não | Liga ou desliga a importação de pedidos do canal. Quando desligado, o Mercado Livre continua autenticado mas nenhum pedido entra. |
| Incluir pedidos normais | Sim/Não | Importa pedidos da modalidade ME2 / envio padrão. |
| Incluir pedidos fulfillment | Sim/Não | Importa pedidos da modalidade Fulfillment (FULL). |
| Incluir pedidos flex | Sim/Não | Importa pedidos da modalidade Self Service (Flex). |
| Incluir pedidos transferencia fulfillment | Sim/Não | Importa as transferências de produto para o FULL. Se desligado, a NF de remessa para o canal não é gerada. |
| Incluir somente pedidos não faturados | Sim/Não | Restringe a importação aos pedidos ainda sem NF no canal. Útil quando o canal mesmo emite parte das notas. |
| Não importar NF de retorno simbólico fulfillment | Sim/Não | Ignora NFs de retorno simbólico que o canal emite na modalidade FULL. |
| Data inicial para importação de pedidos | Data | Filtra a primeira importação por data de criação do pedido no canal. Útil ao ativar a integração com histórico de vendas antigo que você não quer importar. |
| Empresa Faturadora | Empresa | Quando preenchido, força os pedidos a serem faturados por uma filial específica (em vez da empresa autenticada). |
| Detalhar forma de pagamento | Sim/Não | Importa o detalhe do meio de pagamento usado (cartão, boleto, Pix). Pode exigir o privilégio comercial extra do Mercado Livre. |
| Excluir valor frete na NF para PF | Sim/Não | Em vendas para pessoa física, retira o valor do frete da nota fiscal. |
| Excluir valor comissão na NF para PF | Sim/Não | Em vendas PF, retira o valor da comissão do marketplace da NF. |
| Excluir valor de cupom do total do pedido | Sim/Não | Quando o Mercado Livre aplica cupom, desconta o valor do total importado para o idworks. |
| Emails para enviar NFe fulfillment | E-mails | Lista (separada por vírgula) para envio automático da NF gerada para pedidos FULL. |
| Criar oferta automaticamente | Sim/Não | Cria a vinculação produto × anúncio automaticamente quando o SKU é encontrado no idworks ao importar pedido. |
| Cancelar pedido automaticamente | Sim/Não | Reflete o cancelamento feito no canal — cancela o pedido no idworks também. |
| Criar nota fiscal pendente devolução | Sim/Não | Para pedidos com devolução, gera uma NF de entrada em status "aguardando devolução" no idworks. |
| Fechar pedido automaticamente | Sim/Não | Ao receber o pedido do canal, fecha automaticamente. Desligado, o pedido fica "Em digitação" para revisão manual. |
| Alterar status em espera etiqueta | Sim/Não | Quando a data estimada de expedição é futura e a logística é ME2/FULL, troca o status para "Aguardando etiqueta". |
| Alterar status Já tenho produto | Sim/Não | Move o pedido para o status interno "Já tenho produto" automaticamente quando aplicável. |
| Utilizar data estimada expedição como data entrega | Sim/Não | Preenche o campo Data estimada de entrega do idworks com o valor da data estimada de expedição do canal. |
| Consultar etiqueta automaticamente | Sim/Não | Consulta e baixa a etiqueta do ME2/FULL automaticamente assim que o pedido tem etiqueta disponível. |
A maioria dos campos aqui é Sim/Não — você liga só o que faz sentido. A combinação típica é Importar pedidos, Incluir pedidos normais e Incluir pedidos fulfillment ativos, e os demais conforme a operação.
Integração de Produtos
Controla a sincronização idworks → Mercado Livre dos anúncios (produtos). Define o que enviar, como ajustar preços, como tratar estoque, e padrões de criação de anúncio.
Ações sincronizadas (o que enviar)
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar produto | Sim/Não | Permite enviar atualizações do cadastro do SKU para o Mercado Livre. |
| Atualizar preço | Sim/Não | Permite enviar atualizações de preço para os anúncios. |
| Atualizar saldo estoque | Sim/Não | Permite enviar atualizações de estoque para os anúncios. |
| Atualizar descrição | Sim/Não | Permite enviar atualizações de descrição. |
| Atualizar Imagem | Sim/Não | Permite enviar atualizações de imagem. |
| Atualizar Especificações (atributos) | Sim/Não | Permite enviar atualizações dos atributos/especificações para o anúncio. |
Ajuste de preço
O Mercado Livre não puxa o preço cru do idworks — você pode aplicar regras para compor o preço final considerando custos do canal (frete, comissão).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Percentual de ajuste no preço | % | Percentual a somar ao preço por (base/original) ao montar o preço de venda no Mercado Livre. Cobre comissão e frete embutido. |
| Valor de ajuste no preço | R$ | Valor fixo (em reais) a somar ao preço por (base/original). |
| Frete grátis? | Sim/Não | Liga a marcação de frete grátis no anúncio quando o valor do produto ultrapassar o limite. |
| Valor frete grátis | R$ | Limite acima do qual o anúncio é enviado com Frete grátis. |
| Valor de ajuste no preço frete grátis | R$ | Valor fixo a somar quando o anúncio for com frete grátis. |
| Percentual de ajuste no preço frete grátis | % | Percentual a somar quando o anúncio for com frete grátis. |
| Percentual de ajuste no preço adicional para Premium Gold Pro | % | Percentual extra aplicado quando o tipo de anúncio é Premium Gold Pro (taxa de marketplace mais alta). |
| Arredondamento dos centavos do preço | R$ | Valor (entre 0,01 e 0,99) para arredondar o preço final. Útil para deixar o preço terminando em ,90, ,99 etc. |
| Mostrar o preço setado SKU | Sim/Não | Quando ativo, exibe o preço setado do SKU em vez de aplicar os ajustes. |
Estoque
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Estoque de segurança | Inteiro | Quantidade mínima — abaixo disso, o anúncio é enviado com estoque zerado para evitar overselling. |
| Estoque fixo | Inteiro | Envia ao canal um valor fixo de estoque. Se o SKU tem estoque infinito ativo, esse valor é o usado. |
| Ativar estoque fictício | Sim/Não | Envia ao canal um estoque "fictício" maior que o real — útil quando você quer manter o anúncio sempre visível. |
| Percentual disponibilidade de estoque | % | Porcentagem do estoque real a enviar ao canal (ex.: 80% = se há 100 unidades, envia 80). |
| Armazéns para somar quantidade | Lista | Quais armazéns do idworks devem contribuir para o estoque enviado ao Mercado Livre. Em branco = soma todos. |
| Selecionar armazém com saldo ao criar pedido | Sim/Não | Ao importar um pedido, escolhe automaticamente o primeiro armazém da lista acima que tenha saldo. |
| Remover flex estoque zerado | Sim/Não | Remove automaticamente do modo Flex os anúncios que zerarem estoque. |
| Incluir flex quando tiver estoque | Sim/Não | Adiciona ao Flex automaticamente os anúncios que voltarem a ter estoque. |
Padrões de criação de anúncio
Valores padrão usados quando um anúncio novo é criado a partir do idworks.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Padrão tipo de anúncio | Lista múltipla | Tipo do anúncio (Classic, Premium Gold Pro, etc.). |
| Padrão tipo garantia | Lista | Tipo de garantia padrão. |
| Padrão modo de envio | Lista | Modo de envio padrão. |
| Padrão frete grátis | Lista | Frete grátis padrão. |
| Padrão retirar pessoalmente | Lista | Configuração padrão de retirada presencial. |
| Utilizar título como nome SKU | Sim/Não | Usa o título do anúncio (gerado pelo Mercado Livre/idworks) como nome do SKU ao enviar. |
| Ignorar código referencia ao vincular anúncio | Sim/Não | Ao vincular anúncio do Mercado Livre ao produto do idworks, ignora o casamento pelo código de SKU da empresa. |
Outros
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Loja Oficial | Inteiro | Código da loja oficial do Mercado Livre (caso a empresa tenha). |
Integração de Perguntas e Mensagens
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importação de perguntas e respostas (anúncio) | Sim/Não | Importa as perguntas feitas pelos compradores nos anúncios e as respostas dadas. |
| Importação de mensagens (pedido) | Sim/Não | Importa as mensagens trocadas com o comprador dentro de cada pedido. |
| Importação de reclamações (pedido) | Sim/Não | Importa as reclamações abertas no Mercado Livre para o operacional do idworks. |
Para gerenciar perguntas, mensagens e reclamações na tela do idworks, é preciso ter os módulos correspondentes ativos e a permissão de visualização das telas equivalentes.
Conciliação
Gera os lançamentos automáticos em contas a receber e a pagar a partir das transações do Mercado Livre (vendas, taxas, antecipações).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Ativar conciliação | Sim/Não | Liga a conciliação para importar as transações financeiras do Mercado Livre. |
| Conta bancária para realizar conciliação | Lista | Conta bancária própria desta integração onde os repasses entram. Recomendado ter uma conta exclusiva por integração. |
| Plano de contas taxa | Lista | Para qual plano de contas a taxa do marketplace vai. |
| Tipo documento taxa | Lista | Tipo do documento usado para o lançamento da taxa. |
| Centro de custo taxa | Lista | Centro de custo para rateio da taxa. |
| Plano de contas antecipação | Lista | Plano de contas para antecipações do Mercado Livre. |
| Plano de contas comissão frete | Lista | Plano de contas para a comissão de frete cobrada pelo Mercado Livre. |
| Plano de contas cupom | Lista | Plano de contas para o valor de cupom que o Mercado Livre repassa. |
| Diferença dias data venda para conciliação automática | Inteiro | Tolerância de dias entre data do repasse e data esperada para a conciliação automática casar. |
| Diferença valor para conciliação automática | R$ | Tolerância de valor (a mais ou a menos) para a conciliação automática casar. |
Para os campos de plano de contas / tipo documento / conta bancária, os cadastros precisam existir antes — ver Financeiro → Plano de Contas, Financeiro → Tipo Documento e Financeiro → Contas Bancárias.
Importação de Anúncios
Quando você já tem anúncios publicados no Mercado Livre antes de ativar a integração, este grupo controla a importação de anúncios em massa do canal para dentro do idworks.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Preços na ficha do Anúncio | Sim/Não | Traz o preço do anúncio publicado para a ficha do anúncio. Quando desligado, usa o preço do SKU. |
| Incluir Título na ficha do Anúncio | Sim/Não | Traz o título do anúncio publicado para a ficha. |
| Incluir Descrição na Ficha do Anúncio | Sim/Não | Traz a descrição do anúncio publicado. |
| Incluir URL do Video no Cadastro do Produto | Sim/Não | Traz o vídeo do anúncio (quando há) para a ficha do produto. |
| Incluir Imagem dentro do Produto | Sim/Não | Traz as imagens do anúncio para o cadastro do produto. |
| Incluir Imagem dentro do Anúncio | Sim/Não | Traz as imagens para a ficha do anúncio (em vez de para o produto). |
| Importar somente anúncios inexistentes dentro | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. Evita duplicar. |
| Não Realizar o vínculo do Anúncio ao Produto/SKU | Sim/Não | Ignora o vínculo automático anúncio × produto. Você decide manualmente depois. |
| Criar Produto/SKU, com base no Anúncio Importado | Sim/Não | Cria o produto/SKU automaticamente usando o código de SKU presente no anúncio. |
| Criar Produto ou SKU Único (Todos Anúncios têm o mesmo SKU) | Sim/Não | Variação do anterior: cria um único SKU comum para todos os anúncios importados. |
Logística (WMS) — Picking
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Emitir NF após iniciar picking | Sim/Não | Emite a NF de forma automática assim que o picking do pedido é iniciado. |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |