A Olist é um software ERP de gestão empresarial que ajuda os lojistas a automatizarem e organizarem suas operações. Ele centraliza processos essenciais, como controle de pedidos, gestão de estoque, emissão de notas fiscais e atualização de preços, facilitando o dia a dia do e-commerce.
Neste artigo, vamos mostrar como funciona integração e como você pode configurar para a gestão da sua operação.
⚠️Atenção: Já tinha uma integração da Olist ativa?
Se você fez a nova integração pela Loja de Aplicativos da Yampi e manteve a integração anterior ativa, os pedidos serão duplicados. Antes de continuar, acesse o seu painel da Yampi, localize a integração anterior da Olist e clique em Desinstalar (ou Desativar). Mantenha apenas a nova integração ativa.
Como funciona a integração Yampi + Olist?
partir do momento em que a integração é realizada, os pedidos, produtos, estoques e informações logísticas da Yampi passam a ser sincronizados com a Olist ERP.
Funções da integração
✅ Gestão de pedidos
✅ Sincronização de status dos pedidos
✅ Cancelamento na Olist ERP de pedidos cancelados na Yampi
✅ Envio de preços
✅ Gestão de produtos (importação e exportação para a Olist ERP)
✅ Gestão de estoques
✅ Emissão de NF-e dos pedidos
✅ Rastreamento
✅ Separação e embalagem de produtos para controle de expedição
✅ Conexão com canais de venda
✅ OMS
Pontos de atenção antes de integrar ⚠️
Reunimos aqui os pontos que mais geram dúvidas durante a configuração, com o passo a passo para resolver cada um. Confira antes de finalizar a integração para evitar divergências na sua operação.
Formas de pagamento não são sincronizadas
Formas de pagamento não são sincronizadas
A integração não envia a forma de pagamento do pedido (Pix, boleto, cartão etc.) para a Olist ERP. Essa informação continua disponível na Yampi.
O que fazer:
1. Consulte a forma de pagamento diretamente no pedido, dentro do painel da Yampi.
2. Se você precisa dessa informação no ERP, registre-a manualmente no pedido de venda da Olist ERP.
Como configurar o mapeamento de frete
Como configurar o mapeamento de frete
O envio das formas de frete funciona normalmente, mas é necessário mapear cada uma para que a transportadora seja preenchida automaticamente no pedido de venda.
1. Antes de mapear, cadastre no ERP todas as formas de envio e transportadoras usadas na sua loja. Acesse Configurações → Formas de frete → Adicionar forma de frete e preencha a descrição, o código do serviço, o tipo de entrega e o transportador.
2. Acesse a configuração da integração em Configurações → Integrações → Yampi.
3. No mapeamento de frete, em Forma de envio, selecione a forma cadastrada no ERP.
4. Em Forma de frete correspondente, selecione a forma equivalente da Yampi.
5. Salve. A transportadora passa a ser preenchida automaticamente nos pedidos importados.
⚠️ Todas as formas de envio e gateways logísticos usados na loja precisam estar cadastrados no ERP antes de fazer o mapeamento.
Como enviar o rastreamento para a Yampi
Como enviar o rastreamento para a Yampi
Com a configuração correta, o código de rastreio é enviado à Yampi e o status do pedido muda automaticamente para "Em transporte".
1. No Passo 2 da integração, habilite a opção Enviar rastreamento ao alterar a situação no ERP para enviado.
2. Ao despachar o pedido, adicione o código de rastreio no pedido dentro da Olist ERP.
3. Altere a situação do pedido para Enviado no ERP. O código é enviado à Yampi e o status é atualizado.
Como configurar a reserva de estoque
Como configurar a reserva de estoque
Se sua conta usa reserva de estoque, alguns cuidados evitam que o saldo enviado à Yampi fique incorreto.
1. No Passo 2, em Atualizar estoque na loja virtual a partir do ERP, selecione Enviar saldo disponível. Essa opção considera o saldo físico menos as reservas e aparece quando o módulo de Reservas de estoque está ativo na conta.
2. Em Lançamento de estoque para saídas, evite a opção Automático ao salvar o pedido, pois ela invalida o uso da reserva.
3. Prefira Usar configuração padrão da conta ou Automático ao autorizar a nota fiscal.
4. Salve as configurações.
Como configurar o Olist ERP na Yampi?
Para configurar o Olist na Yampi, é necessário seguir duas etapas, confira abaixo:
Passo 1 - Conectando com a Yampi
1. Acesse seu painel da Olist.
2. Clique em "Integrações" → "Adicionar integração" → "Yampi".
3. Preencha com as credenciais da Yampi.
- Nome da loja: Cole a credencial "Alias" do seu painel da Yampi.
- Token: Cole a credencial "Token" do seu painel da Yampi.
- Chave secreta: Cole a credencial "Secret Key" do seu painel da Yampi.
4. Clique em "Conectar com a Yampi".
🔍 Não conseguiu localizar as credenciais da Yampi? Ensinamos aqui.
Passo 2 - Configurando a integração
1. Preencha as regras da sua integração nessa etapa:
▶️Clique na setinha para abrir o conteúdo*
Regras de produtos e estoque
Regras de produtos e estoque
Regras de Estoque
Realize as definições das regras para a gestão de estoque através do Sistema ERP e assegure o melhor desempenho da sua rotina de operações.
Atualizar estoque na loja virtual a partir do ERP
Atualizar estoque na loja virtual a partir do ERP
Determine como o estoque será refletido na integração. A opção de estoque disponível equivale ao físico menos as reservas de estoque.
⬜Não atualizar
⬜Enviar saldo físico
⬜Enviar saldo disponível
Depósito a ser considerado na integração
Depósito a ser considerado na integração
Entre as opções cadastradas previamente, escolha o depósito a ser considerado para o envio de estoque à integração.
⬜Geral
⬜Todos próprios
Lançamento de estoque para saídas
Lançamento de estoque para saídas
A sua conta possui a reserva de estoque habilitada, que realiza automaticamente a reserva de estoque conforme a situação do pedido. Neste caso, não recomendamos o lançamento automático ao salvar o pedido, pois invalida a utilização da reserva de estoque.
⬜Usar configuração padrão da conta
⬜Manual
⬜Automático ao autorizar a nota fiscal
⬜Automático ao salvar a nota fiscal
⬜Automático ao salvar o pedido
⬜Automático ao marcar pedido como enviado
Preços
Realize as definições das regras para a gestão de preços através do Sistema ERP e garanta mais assertividade na precificação do seu negócio.
Regra de utilização de preços para o e-commerce
⬜Preço fixo
⬜Conforme lista de preços
⬜Conforme regras de preço
Fluxo de Produtos
Realize as definições para a gestão do envio e recebimento de produtos através do Sistema ERP e assegure o melhor desempenho da sua rotina de operações.
Ao importar produtos
Ao importar produtos
Defina o formato das imagens para o armazenamento no ERP após a importação dos anúncios da integração.
⬜Importar imagens como anexos
⬜Apenas importar a URL externa das imagens
Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU)
Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU)
Define a tualização automática do código SKU, conforme os dados da integração, na importação de anúncios com códigos diferentes
Regras de pedidos
Regras de pedidos
Fluxo de pedidos
Realize as definições para a gestão do recebimento de pedidos através do Sistema ERP e assegure o melhor desempenho da sua rotina de operações.
Importar valor do frete nos pedidos
Importar valor do frete nos pedidos
Habilite para identificar e destacar no pedido de venda o valor correspondente ao frete
Enviar rastreamento ao alterar a situação no ERP para enviado
Enviar rastreamento ao alterar a situação no ERP para enviado
Habilite para enviar o rastreamento assim que o status do pedido for alterado para “Enviado”.
Marcar pedido como entregue ao alterar a situação no ERP
Marcar pedido como entregue ao alterar a situação no ERP
Habilite para marcar o pedido como "entregue"quando o status do pedido for alterado para “Entregue” no ERP.
Dados fiscais
Natureza de operação para venda
Natureza de operação para venda
Determine uma natureza padrão para ser aplicada aos pedidos importados
Definir natureza de operação diferente para destinatários contribuintes do ICMS.
Definir natureza de operação diferente para destinatários contribuintes do ICMS.
O Tiny irá identificar caso o cliente seja contribuinte e aplicar a natureza selecionada
Custos
Configure os custos para a integração e custos específicos para cada canal de venda que serão aplicados aos pedidos no módulo de custos do e-commerce
Custos da minha loja virtual
Custos da minha loja virtual
Comissão cobrada pelos pedidos criados diretamente na minha plataforma.
Valor fixo (R$): R$ 0
Taxa: Insira aqui a taxa correspondente ao seu plano da Yampi.
Base de cálculo da comissão: Marque a opção "Total da venda".
Mapeamento
Mapeamento
Define o vínculo entre os pedidos na Olist e a Yampi 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 na Olist definindo também o fluxo da sequência das situações na Olist.
Recomendamos que deixe da forma que já vem pré-definida na Olist.
Para mais informações, leia o conteúdo: Fluxo de situações dos pedidos de venda no Olist
2. Clique em "Finalizar integração" e pronto 🥳
Agora você pode importar os seus produtos e realizar os próximos passos orientados pela plataforma.
Uso a Olist ERP com Shopify ou WooCommerce: o que configurar?
Se a sua loja usa a Yampi como Checkout junto com a Shopify ou o WooCommerce e integra a Olist ERP por essas plataformas, alguns ajustes são necessários para que os pedidos cheguem completos ao ERP.
Yampi + Shopify + Olist ERP
Yampi + Shopify + Olist ERP
Endereço chega incorreto na Olist ERP
A Yampi envia o endereço em campos específicos para a Shopify. Quando a Olist ERP é integrada à Shopify, o endereço pode ficar incorreto por causa desse formato. Para corrigir, acesse a Olist ERP em Configurações → Integrações → Shopify → Pedidos e ajuste a configuração de leitura do endereço:
Se a loja tem o módulo de enviar mais informações para a Shopify, ative essa opção:
Se não tem o módulo de enviar mais informações para Shopify, utilize a opção padrão de leitura do endereço.
Rastreamento
Olist ERP envia o código de rastreio corretamente para a Shopify, no campo "tracking number". Assim, a Yampi recebe o código e altera o status do pedido para "Em transporte". 😊
Formas de pagamento
Essa integração não envia as formas de pagamento (Pix, boleto etc.).
Como contatar o suporte do Olist ERP?
Como a integração foi desenvolvida pela Olist, o suporte deve ser feito diretamente com eles, pelos canais abaixo:
💬 Chat: ícone no canto direito da tela do painel da Olist ERP.
📩 Ticket: abrir um ticket de suporte
📖 Central de ajuda: Integração ERP da Olist com a Yampi
Dúvidas frequentes 🤔
▶️Clique na setinha para abrir o conteúdo de Dúvidas frequentes*
Como funciona o Mapeamento e Códigos da situação no E-commerce?
Como funciona o Mapeamento e Códigos da situação no E-commerce?
O mapeamento define o vínculo entre os pedidos na Olist ERP e na Yampi, conforme a situação do pedido, além do fluxo da sequência das situações na Olist ERP.
Recomendamos manter da forma que já vem pré-definida. Para mais informações, leia Fluxo de situações dos pedidos de venda na Olist.
As formas de pagamento (Pix, boleto, cartão) são enviadas para a Olist ERP?
As formas de pagamento (Pix, boleto, cartão) são enviadas para a Olist ERP?
Não. A integração não sincroniza a forma de pagamento do pedido para o ERP.
A transportadora não aparece no pedido de venda. O que fazer?
A transportadora não aparece no pedido de venda. O que fazer?
Verifique o mapeamento das formas de frete na configuração da integração. O envio funciona, mas depende do mapeamento correto para preencher a transportadora no pedido.
O estoque não está sendo baixado como esperado. O que verificar?
O estoque não está sendo baixado como esperado. O que verificar?
O mapeamento define o vínculo entre os pedidos na Olist ERP e na Yampi, conforme a situação do pedido, além do fluxo da sequência das situações na Olist ERP. Recomendamos manter da forma que já vem pré-definida. Para mais informações, leia Fluxo de situações dos pedidos de venda na Olist.
Uso a Yampi com Shopify ou WooCommerce e os pedidos chegam incorretos na Olist ERP. O que fazer?
Uso a Yampi com Shopify ou WooCommerce e os pedidos chegam incorretos na Olist ERP. O que fazer?
Consulte a seção Usando a Olist ERP junto com outra plataforma deste artigo. Ela cobre os ajustes de endereço (Shopify) e de CPF (WooCommerce) necessários nesses cenários.
Em caso de dúvidas, clique no balãozinho de atendimento em seu painel ou nos encaminhe por e-mail para [email protected] 😉








