Como integrar com o Mercado Livre (via Hub da Olist)
Conecte sua conta do Mercado Livre ao seu ERP através do Hub da Olist para centralizar sua operação.
Esta integração une o controle de estoque e faturamento do ERP com as ferramentas do Hub para simplificar a gestão de seus anúncios (incluindo o modelo user product) e sincronizando preços e saldos automaticamente em tempo real.
Para começar, clique nos blocos abaixo e siga o passo a passo para conferir todas as etapas para integração.
Como instalar a integração
Para integrar o Mercado Livre (via Hub da Olist) no ERP siga o caminho abaixo:
- Menu → Início → Integrações
- Pesquise por Mercado Livre e após localizar clique em instalar
Como configurar a integração
Organizamos as explicações de cada parâmetro divididas pelas mesmas abas que você encontra na tela de integração do seu ERP.
Selecione a aba desejada para ver a explicação e orientação de cada parâmetro:
Conexão
Após localizar e instalar a integração, o próximo passo é estabelecer a autenticação entre o Mercado Livre e o ERP permitindo que a troca de informações aconteça de forma segura e automática entre as plataformas.
-
Nome da integração no ERP: Defina um nome padrão ou específico para identificar essa conta do Mercado Livre no ERP da Olist.
- Autenticação: A conexão do Mercado Livre acontece por meio do usuário e senha (padrão). Insira suas credenciais habituai ( o mesmo e-mail/usuário e senha) que você usa para acessar sua conta de vendedor do Mercado Livre.
Canais de venda
A aba "Canais de Venda" pode ser desconsiderada neste momento.
Não preencha nenhum dado e clique no botão "salvar e avançar" para iniciarmos as configurações da integração com o Mercado Livre.
Produtos
Esta aba gerencia como o ERP troca dados de catálogo com o Mercado Livre.
Abra os blocos abaixo para conferir as 3 etapas de configuração desta tela:
Passo 1: Regras de estoque
Parâmetros para definir as regras de estoque que serão consideradas na integração.
Lançamento de estoque para saídas
Defina a regra para lançamento de estoque dos pedidos importados por meio desta integração. Escolha entre as opções:
- Usar configuração padrão da conta: Adota a regra inicial do sistema, que vem definida por padrão como Manual.
Atenção: Se você deseja usar esta opção acima, recomendamos que antes mude a regra geral em Configurações de estoque para um modo automático. Como o padrão do sistema é manual, se você não fizer esse ajuste prévio, seu estoque não atualizará automaticamente no Mercado Livre gerando furos de estoque.
- Manual: A baixa de estoque não é automática. Você precisará acessar o pedido no ERP e realizar o lançamento manualmente. Essa opção não é recomendada pois aumenta o risco de furos e rupturas de estoque.
-
Automático ao autorizar a nota fiscal: O sistema baixa o estoque assim que a Nota Fiscal (NF-e) é autorizada pela SEFAZ. (Recomendado)
-
Automático ao salvar a nota fiscal: O estoque é baixado assim que a nota é gerada e salva no sistema, mesmo antes da autorização da SEFAZ.
-
Automático ao salvar o pedido: O estoque é baixado no exato momento em que o pedido é incluído ou importado para o ERP. Essa opção é indicada apenas para quem não deseja trabalhar com o recurso de Reserva de Estoque do sistema, pois sua ativação invalida a utilização da reserva.
- Automático ao marcar pedido como enviado: A baixa só acontece quando o status do pedido é alterado para "Enviado".
Atualizar estoque na loja virtual a partir do ERP
Defina qual saldo do ERP deve ser enviado para atualizar o estoque da integração.
- Não atualizar: O ERP não enviará nenhuma atualização de estoque para este canal.
Atenção: Recomendamos esta opção se você estiver em período de testes, configuração inicial do sistema ou se utiliza outra ferramenta externa para controlar seu estoque.
- Enviar saldo físico: Envia para o canal de venda a quantidade bruta cadastrada no ERP, sem descontar as vendas que acabaram de acontecer e ainda estão sendo processadas.
- Enviar saldo disponível: Envia para o canal de venda apenas o estoque livre para novas vendas. O sistema pega a quantidade total (Saldo Físico) e subtrai as reservas de pedidos que ainda não foram aprovados. (Recomendado)
Depósito padrão da integração
Neste campo, você define qual depósito do seu ERP fornecerá as quantidades de estoque para o canal de venda.
- Geral: Escolha essa opção se você possui apenas um estoque.
- Todos os próprios: Escolha se você possui (ou pretende ter) mais de um depósito e quer somar o estoque desses depósitos (considerados como próprios).
Observação: se sua conta é nova, as duas opções acima geram o mesmo resultado
Atenção: Caso queira criar um depósito específico para atender a sua operação do Mercado Livre, é necessário cadastrá-lo previamente no ERP para que essa opção apareça nesta listagem. Para mais informações, acesse: Como controlar estoques de vários depósitos.
Observação: O campo depósito de estoque a ser considerado na integração será exibido apenas nas contas que possuem a extensão “Depósitos de estoque” instalada.
Utilizar estoque de segurança
Parâmetro opcional, utilizado para evitar a ruptura de estoque, especialmente em casos de vendas simultâneas em múltiplos canais.
Caso queira trabalhar com esse recurso, habilite o parâmetro e informe a quantidade de itens no estoque de segurança.
Quando o estoque real do item no ERP atingir a margem definida, o sistema automaticamente zera a disponibilidade no anúncio do canal de venda
Exemplo: ao definir um estoque de segurança igual a 5, todos os anúncios que atingirem a margem definida (5) irão refletir estoque igual a 0 no canal de venda.
Importante: essa margem de segurança se aplica a todos os anúncios da integração. Certifique-se que o valor é adequado para evitar anúncios zerados indevidamente.
Passo 2: Preços
Regras de utilização de preços para o e-commerce
Parâmetro para definir as regras de preço que serão consideradas na integração.
- Preço fixo: O anúncio será atualizado conforme o preço do produto cadastrado no ERP.
- Conforme lista de preços: Ter um preço diferenciado no momento da venda em relação ao preço cadastrado no produto.
Observação: Essa opção é mais utilizada para operações físicas, ou lojas que vendem no atacado e varejo. Para mais informações acesse: Listas de preços.
- Conforme regras de preço: Irá definir uma regra específica para o canal que está sendo integrado, podendo considerar margens que cobrem custos operacionais e garantem uma precificação mais eficiente.
- Calculadora de preços: Recurso avançado de precificação disponível para o Mercado Livre.
Importante: Para selecionar esta opção, é necessário que a sua calculadora de preços já esteja criada no sistema.
Recomendação: Se você ainda não criou a sua calculadora, selecione temporariamente outra regra de preço para avançar sem interromper o fluxo. Você poderá estruturar sua ferramenta com calma e atualizar este parâmetro quando desejar.
Passo 3: Receber produtos
Ao importar produtos
Defina como as imagens do produto vão ser recebidas e armazenadas no ERP a partir da integração.
- Importar imagens como anexo (Recomendado): O sistema importa e salva o arquivo da imagem diretamente no ERP. Suas fotos ficam protegidas, sempre visíveis em todas as telas do sistema e prontas para serem enviadas para novos canais de venda.
- Apenas importar a URL externa das imagens: O sistema salva apenas o link (URL) da imagem. O arquivo não fica guardado no ERP.
Atenção: se o link original quebrar ou mudar, você perde o acesso à imagem do produto, além de não conseguir visualizá-la dentro das telas do sistema.
Clique em “salvar e avançar” para seguir para a etapa de configuração de pedidos.
Pedidos
Aqui você define como o seu ERP vai receber e processar as vendas vindas do Mercado Livre, além de configurar as regras para a emissão das notas fiscais.
Passo 1: Fluxo de pedidos
Etapa para definir as regras no fluxo de recebimento dos pedidos da plataforma para o sistema ERP.
- Importar forma de recebimento nos pedidos
Configuração avançada e opcional para vincular automaticamente uma forma de recebimento padrão aos seus pedidos do Mercado Livre.
Recomendação: Deixe esse parâmetro desabilitado neste momento, para finalizar a integração e caso tenha interesse, você poderá retornar e configurar em um momento posterior.
Importar valor de frete nos pedidos
Habilite o parâmetro para que o pedido importado tenha o valor do frete discriminado junto à sua composição.
Atenção: Em caso de dúvidas, deixe essa opção ativa ou peça orientação da sua contabilidade.
Completar endereço do cliente a partir do CEP na importação de pedidos
Parâmetro para que o endereço do cliente seja atualizado no ERP ao importar os pedidos.
- Não: Ao assinalar essa opção, não haverá nenhum tipo de atualização do endereço do cliente a partir do CEP.
- Apenas se o bairro não está informado: Se o campo bairro no pedido de venda não estiver preenchido, o ERP irá completar essa informação faltante a partir do CEP.
- Sempre: O CEP sempre será validado junto aos Correios para possível atualização da Rua ou Bairro.
Recomendação: Utilizar a opção “Apenas se bairro não está informado” ou “Sempre”.
Enviar rastreamento ao alterar a situação no ERP para enviado
Com esse parâmetro habilitado, o código de rastreio será automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para enviado.
Marcar pedido como entregue ao alterar a situação no ERP
Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, o mesmo também terá o seu status alterado na plataforma.
Intermediador
Campo de preenchimento obrigatório.
- No campo “Nome” preencha: Mercado Livre
- No campo “CNPJ do intermediador da transação” preencha o CNPJ do Mercado Livre (plataforma responsável pela intermediação da venda): 03.361.252/0001-34
- No campo “CNPJ da Instituição de Pagamento” preencha o CNPJ do Mercado Pago (empresa responsável por realizar o repasse financeiro ao vendedor): 10.573.521/0001-91
Defina como processar valores diferentes entre nota fiscal e pagamento integrado
- Deixar assinalado a opção: Utilizar valor de pagamento integrado enviado pelo canal de venda (Recomendado)
Passo 2: Dados Fiscais
Esta etapa permite definir as Naturezas de Operação e as regras fiscais que serão aplicadas automaticamente aos pedidos importados por esta integração.
Importante: Para que a integração emita as Notas Fiscais Eletrônicas (NF-e) sem erros, é obrigatório que as suas Naturezas de Operação de Saída já estejam cadastradas e configuradas no ERP. Para mais informações, acesse: Natureza de operação de saída de mercadorias.
Natureza de operação para venda
Este é o campo onde você irá vincular a natureza de operação padrão que o sistema deve aplicar a cada nova venda vinda da integração com o Mercado Livre
Atenção: Não esqueça de, antes de iniciar a emissão das notas através da integração, validar todas as regras fiscais e tributações configuradas nas suas naturezas de saída diretamente com a sua contabilidade.
Definir natureza de operação diferente para destinatários contribuintes do ICMS
Habilite este parâmetro para definir uma natureza de operação específica para destinatários contribuintes do ICMS. Ela será aplicada automaticamente quando o ERP identificar que o pedido de venda é de um cliente contribuinte.
Natureza de operação para transferência de mercadorias
Campo para vincular a natureza de operação de transferência.
Atenção: Parâmetro exclusivo para clientes que operam com a modalidade de Fulfillment no Mercado Livre.
Modelo fiscal de operação
Este parâmetro define o cenário tributário da sua empresa em relação ao armazenamento e envio das suas mercadorias pelo Mercado Livre. Ele é fundamental para o envio correto das regras tributárias durante a venda.
Selecione a opção que corresponde à realidade do seu negócio:
-
Não possui Fulfillment: Selecione esta opção caso você utilize o modelo tradicional de envio (como Mercado Envios Coleta, Flex ou Correios), onde o estoque fica fisicamente armazenado no seu próprio galpão ou loja e o Mercado Livre não faz o armazenamento dos seus produtos.
-
Modelo self storage amparado pela Portaria CAT Nº 59 DE 06/07/2018: Opção destinada a sellers localizados no estado de São Paulo (SP) que utilizam o modelo de armazém terceirizado (Fulfillment) do Mercado Livre e operam sob as regras fiscais específicas desta portaria estadual para a movimentação de mercadorias depositadas.
- Modelo filial: Marque esta opção caso a sua operação utilize uma estrutura de filial fiscal configurada especificamente para gerenciar o estoque enviado para o centro de distribuição (Fulfillment) do marketplace.
Mapeamentos
Passo 1: Situações de Pedidos
Nesta etapa, o sistema gerencia a equivalência entre os status dos pedidos no Mercado Livre e no ERP da Olist.
Permitir retroceder situações dos pedidos na sincronização de situações
Define se o status do pedido pode voltar para uma etapa anterior no ERP durante a sincronização.
Importante: Mantenha este parâmetro desativado. Isso garante que o status do pedido siga o fluxo corretamente ao ser importado para o ERP.
Tabela de mapeamento de situações
Responsável pela sincronização automática dos status dos pedidos entre as plataformas.
A coluna da esquerda traz as nomenclaturas do Mercado Livre e a coluna da direita as equivalências no ERP.
Para a integração com o Mercado Livre, as configurações nesta tela já estão prontas, portanto, nenhuma ação é necessária da sua parte — basta clicar no botão "salvar e avançar" no rodapé da página para prosseguir.
Passo 2: Formas de Recebimento
Esse mapeamento na integração é opcional, e portanto, é possível avançar nesta etapa e retornar para a configuração em um momento posterior.
.png)
Esta configuração é recomendada para quem busca maior controle financeiro sobre os pedidos importados do canal de venda para o ERP.
Caso tenha interesse em seguir com essa configuração, acesse o artigo: Configuração das formas de recebimento nas Integrações
Outros
Defina os valores que serão preenchidos automaticamente toda vez que você for publicar um novo anúncio no Mercado Livre, poupando trabalho repetitivo no seu dia a dia.
Observação: Estas escolhas servem apenas como um facilitador. Caso precise aplicar uma regra diferente para um anúncio, você poderá alterar esses valores direto na tela de criação do anúncio.
Formas de envio
Define o método de entrega padrão que será sugerido nos seus novos anúncios.
Tipo de anúncio
Define o tipo de exposição padrão (Grátis, Clássico ou Premium) que seus novos anúncios terão ao serem enviados do ERP para o Mercado Livre.
Escolha a opção que você mais utiliza na sua rotina (ex: se a maioria das suas vendas é no Clássico, selecione-o aqui para que seus novos cadastros já venham pré-configurados, economizando tempo).
-
Seleção única: Define apenas um comportamento padrão. Você continuará tendo total autonomia para alterar o tipo de anúncio individualmente na tela de publicação, antes do envio final.
- Seleção múltipla (dois ou mais tipos): Caso selecione mais de uma opção (ex: Clássico e Premium), o sistema gerará automaticamente anúncios separados para cada modalidade no momento da criação.
Permite frete grátis
Define se os seus novos anúncios devem ser criados oferecendo o benefício de frete grátis por padrão.
Modelo de impressão de etiqueta
Escolha o formato em que o sistema deve gerar as suas etiquetas de envio para a expedição (como o formato PDF).
Importar pedidos Fulfillment pendentes como enviados
Configuração exclusiva para quem utiliza a operação logística do Mercado Livre Fulfillment.
Importante: A recomendação é deixar esse campo com a opção Sim.
Fulfillment
Aba destinada para quem deseja visualizar e gerenciar os pedidos que são operados pelo fulfillment.
Atenção: Esta etapa é exclusiva para vendedores que utilizam a modalidade Mercado Livre Full (Fulfillment). Se você não utiliza esse serviço, desconsidere esses parâmetros e aperte no botão: “finalizar instalação”.
Importar pedidos do Fulfillment
Ao habilitar essa opção, pedidos do Fulfillment serão importados no ERP com um marcador.
Depósito do Fulfillment
Para vincular um depósito exclusivo para o fulfillment é necessário previamente criar um depósito no ERP, conforme orientações: Como controlar estoques de vários depósitos
Importante: Ao criar o depósito escolha a opção “Exclusivo para um canal de venda” preencha os dados e habilite o parâmetro “Desconsiderar saldo deste depósito”.
Lançamento de estoque para saídas de pedidos Fulfillment
Para que os pedidos do fulfillment não realizem a reserva de estoque a recomendação é selecionar a opção:
- Automático ao marcar o pedido como enviado
Atenção: Evite utilizar outras opções para não interferir na lógica operacional dos demais pedidos da sua empresa no ERP.
Configurações (pós-integração)
Após finalizar a instalação inicial com o Mercado Livre, parâmetros avançados ficarão disponíveis no seu painel.
Conheça essas opções e saiba quando ajustar para garantir o fluxo correto de faturamento e recebimento de vendas.
Selecione a aba desejada para realizar esses últimos ajustes:
Pedidos
Fluxo de Pedidos
Na aba “Pedidos” > “Fluxo de Pedidos” existem três parâmetros que são liberados.
Formatar nome dos contatos no recebimento dos pedidos
Padroniza o cadastro dos seus clientes deixando as iniciais do Nome e Sobrenome em maiúsculas assim que a venda entra no ERP.
Sincronização automática de pedidos
Esta configuração ativa a importação automática e imediata das vendas do Mercado Livre para o seu sistema ERP.
Por padrão esse parâmetro vem desligado e a recomendação é manter inativo, para evitar que pedidos reais sejam importados antes que o seu ERP esteja completamente configurado, testado e pronto para processá-los.
Atenção: Recomendamos deixar este botão desligado neste momento. Só ative a sincronização automática quando o seu ERP estiver totalmente configurado e pronto para operar os pedidos reais.
Fulfilment
Importar automaticamente NF-e de devolução
Controla a entrada das notas fiscais de devolução geradas diretamente pelo Mercado Livre Full.
Observação: Ative este parâmetro para que o ERP puxe automaticamente todas as notas de devolução emitidas pelo faturador do Mercado Envios Full.
Natureza de operação de vendas (Fulfillment)
Vincula a regra fiscal que o sistema utilizará para emitir as notas fiscais das vendas cujos produtos saem direto do centro de distribuição do marketplace (fulfillment).
Atenção: Se você opera ou pretende operar na modalidade Mercado Envios Full, o preenchimento deste campo é obrigatório. Sem a natureza correta selecionada, o ERP não conseguirá enviar as regras tributárias para faturar os pedidos enviados pelo Full
