Integração com a Loja da Olist

Por Monique Tostes Oliveira Atualizado em 26/11/2025

Confira como ativar a integração do ERP com a Loja da Olist. Se ainda não tem uma conta ativa, confirmar mais detalhes, pré-requisitos e regras para começar a vender.

Como configurar a integração

Ao configurar a integração, sua conta do ERP será conectada à plataforma, permitindo a sincronização de produtos, pedidos, preços, estoque e demais configurações.

Importante: ao instalar a integração pela primeira vez, apenas as configurações principais serão exibidas. As demais aparecerão após salvar a integração, sendo necessário acessá-la novamente.

Aba Conexão

Para conectar a integração, acesse em menu → início → integrações.
Clique em adicionar integração, busque por Olist Store e clique em instalar.
Em Conectar integração, confirme, clicando no botão conectar com Olist Store.
Faça o login na sua conta da Loja da Olist. Após logar, você será redirecionado para o ERP para concluir suas configurações.

Aba Produtos

Defina as regras de envio e recebimento de produtos, estoque e preço. Essas definições serão aplicadas a todas as ações desta integração.

Enviar produtos

Enviar dias para preparação ao sincronizar: com o parâmetro habilitado, a informação da quantidade de dias necessários para preparação do envio do item vai ser enviada para a plataforma.

Para preencher o campo, acesse o menu → cadastro → produto → editar, na aba dados gerais, na seção estoque clique em dias para preparação.

Esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes.

Receber produtos

Ao importar produtos: define, ao receber os produtos da plataforma, como as imagens do produto vão ser recebidas no ERP:
Importar imagens como anexo:as imagens do produto vão ser registradas no cadastro do produto.
Apenas importar a URL externa das imagens: apenas as URLs das imagens dos produtos serão salvas no ERP.

Regras de estoque

Atualizar estoque na loja virtual a partir do ERP: define, a forma de atualização dos estoques na plataforma:
- Não atualizar: nenhum produto vai ter o estoque atualizado.
- Enviar saldo físico: envia o estoque total dos produtos, sem considerar a reserva de estoque.
- Enviar saldo disponível: envia somente o estoque disponível, pois considera a reserva de estoque.
Depósito a ser considerado na integração: define qual o depósito vai ser considerado para as ações de importar pedido, importar produtos e enviar estoque, ou seja, toda movimentação de produtos vai ser atribuída a este depósito padrão.
- O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada.

Aba Mapeamentos

Define o vínculo entre os códigos do ERP com os códigos da plataforma para categorias, variações, situação dos pedidos, formas de recebimento e de frete, e a definição dos horários de envio de mercadorias.

Situação dos pedidos

Define o vínculo entre os pedidos no ERP e na plataforma de acordo com a situação do pedido através do mapeamento da situação dos pedidos no e-commerce com as respectivas situações no ERP, definindo também o fluxo da sequência das situações no ERP.

As situações padrão e as respectivas situações dos pedidos no ERP são preenchidas de forma automática pelo sistema, ao acessar a aba Situação dos Pedidos.
Para adicionar novas situações, clique em Adicionar Mapeamento de Situação, localizado ao final da página, após os mapeamentos existentes.
Ao habilitar o Permite Retroceder Situação dos Pedidos na Sincronização de Situações, será possível alterar a situação de um pedido para uma situação anterior à atual. Por exemplo, um pedido Enviado poderá voltar para a situação Preparando Envio. No entanto, caso você utilize o recurso do OMS, recomendamos manter este parâmetro desabilitado.

Importante: ao importar um pedido de venda do e-commerce para o ERP, ele assumirá a situação configurada. Caso nenhuma situação esteja definida, o pedido importado será atribuído à situação Em aberto.

Formas de recebimento

Define o vínculo entre as formas de recebimento dos seus pedidos da loja virtual com a forma de recebimento no ERP. Esta configuração fará com que suas contas a receber sejam geradas no ERP com as mesmas informações da plataforma.

Ao habilitar o parâmetro importar forma de recebimento nos pedidos, será possível relacionar as formas de pagamento presentes em sua plataforma com os respectivos destinos no ERP. Para isso, clique em adicionar forma de recebimento.
A seguir, no campo de forma de recebimento, selecione a forma de recebimento do ERP a ser relacionada com a da integração. No campo código na integração, clique sobre o botão relacionar forma de recebimento 🔗 e selecione a forma de recebimento de sua plataforma que corresponderá à do ERP.
Se a forma de recebimento correspondente não for exibida, é possível buscar por um pedido que possua a mesma forma de recebimento selecionada para realizar o relacionamento. Para isso, é necessário informar o identificador do pedido na integração, através do Order ID ou Shipment ID. Ou, caso saiba o código de integração, clique em Informar Código Manualmente e digite o código.

Importante: ao adicionar as formas de recebimento selecionadas, o ERP busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de recebimento, acesse formas de recebimento.

Para confirmar o relacionamento, clique em relacionar.
No campo forma de recebimento padrão, defina a forma de recebimento que será utilizada sempre que o pedido importado não possua nenhuma forma relacionada.
No campo categoria financeira padrão dos pedidos, selecione a categoria financeira padrão para esta integração, se assim desejar. As categorias financeiras exibidas são previamente cadastradas em categorias de receitas e despesas, nas configurações de finanças.

Formas de frete

Define o vínculo entre as formas de frete dos seus pedidos da loja virtual com a forma de frete no ERP. Esta configuração fará com que os pedidos no ERP sejam gerados com as mesmas informações de frete da plataforma.

Para fazer o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no ERP, clique em adicionar e no campo forma de envio e forma de frete, selecione as formas que deseja mapear.
Em código na integração, clique no botão relacionar forma de frete 🔗. E, na listagem exibida, selecione a forma de envio correspondente em sua plataforma.
Se a forma de frete correspondente não for exibida, é possível obter por pedido que tenha a mesma forma de frete selecionada para realizar o relacionamento, informando o identificador do pedido na integração. Ou, caso saiba o código de integração, clique em informar código manualmente e digite o código. Para confirmar o relacionamento, clique em relacionar.

Observação: ao adicionar as formas de frete selecionadas, o ERP busca as formas de envio já configuradas em sua conta. Para cadastro de novas formas de envio, consulte formas de envio. Para mapear as formas de frete da Frenet, acesse a ajuda mapear formas de frete Frenet.

Variações

Define a grade variações dos seus produtos que devem ser vinculados com os produtos da plataforma ao sincronizar como e-commerce.

Ao clicar em Abrir Edição Avançada, o ERP busca identificar as variações e opções no e-commerce para criar um vínculo com as existentes no ERP.
O campo Variação no E-commerce mostra as variações cadastradas na plataforma. No campo Variação no ERP, selecione a correspondente no ERP.
O campo Opção no E-commerce mostra os valores das variações cadastradas na plataforma. No campo Opção no ERP, selecione a correspondente no ERP.

Observações:

Os campos Variação e Opção no ERP exibem as variações e valores previamente cadastrados. Maiores informações sobre variações estão disponíveis em variações dos produtos.
A aba Variações só aparecerá se a extensão Variações estiver instalada e após salvar as configurações.
Em produtos com variação, o anúncio será vinculado ao mapeamento apenas nas variações. O produto pai não apresentará mapeamento.

Aba Outros - Configurações adicionais

Selecione o tipo da impressão das etiquetas, PDF ou ZPL.
Para impressão de etiquetas com a forma de envio Olist, acesse formas de envio Olist
Ao final, clique em salvar.

Após finalizar a instalação e configuração, confira como usar na sua conta do ERP.