Passar para o conteúdo principal

Como configurar a Olist ERP na Yampi?

Conecte a Olist ERP à Yampi e automatize pedidos, estoque, notas fiscais e logística em um só lugar. Veja o passo a passo, os pontos de atenção e as dúvidas mais comuns da integração.

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

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

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

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

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 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

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

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

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

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)

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

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

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

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

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

Determine uma natureza padrão para ser aplicada aos pedidos importados


​

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

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

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

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.).

Yampi + WooCommerce + Olist ERP

CPF chega vazio na Olist ERP Se o CPF estiver indo vazio para a Olist ERP, preencha o campo personalizado de CPF dentro da integração do WooCommerce na Olist ERP.

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:

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?

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?

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?

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 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?

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] 😉

Respondeu à sua pergunta?