Como integrar o ERP com o Ecommerce da Olist
O que é a integração
O Ecommerce da Olist é a plataforma de e-commerce disponível para integração direta com o nosso ERP. Essa integração permite que o sistema se conecte diretamente à plataforma de vendas, possibilitando o processamento dos pedidos através do ERP.
Pré-requisitos
- Disponível para os todos os planos Olist.
Recursos disponíveis
| Receber produtos |
✓ |
| Enviar produtos |
✓ |
| Enviar e atualizar estoque |
✓ |
| Enviar e atualizar preços |
✓ |
| Efetuar cotações de fretes | X |
| Receber pedidos |
✓ |
| Sincronizar situações dos pedidos da plataforma para o ERP |
✓ |
| Enviar dados das NF-es |
✓ |
| Enviar rastreamentos |
✓ |
| Enviar situação de Entregue para os pedidos |
✓ |
Como instalar a integração passo a passo
- Acesse menu > início > Integrações.
- Clique em adicionar integração, busque por Ecommerce da Olist e clique em instalar.
- Preencha o campo Token, com o código de integração obtido no painel da plataforma.
Dica: para obtenção do Token dentro do Ecommerce, siga os passos informados no artigo API da plataforma de ecommerce da Olist.
Importante: é importante, que ao criar o seu token API no painel de Ecommerce da Olist, você habilite as seguintes permissões:
- Pedidos
- Produtos
- Pacotes
- Rastreios
- Tags
- Dados de SEO
- Shop Infos
- Inventário
- Variantes
- Estoque
- No campo URL da loja, preencha o URL de acesso a sua loja no e-commerce (Ex.: sualoja.com.br)
- Clique no botão conectar com Ecommerce da Olist.
Atenção: a plataforma de e-commerce valida em tempo real se a integração está operacional. Se as credenciais estiverem inválidas ou se o processo de conexão no ERP não for concluído, o status será reportado como "Inativo". Nestes casos, o fluxo de configuração será bloqueado no e-commerce para evitar falhas operacionais. Certifique-se de que a integração no ERP esteja marcada como "Ativa" para liberar o uso.
- Conclua a autorização do aplicativo na plataforma.
- Após autorizar o aplicativo, a página será redirecionada para a página do ERP.
Importante: Limite de uma integração ativa
Para otimizar a gestão da sua conta e evitar erros de sincronização por duplicidade, o sistema agora permite apenas uma instância ativa da integração com o Ecommerce da Olist por lojista.
- Como funciona: Ao tentar instalar a integração, o sistema realiza uma Validação Automática. Se já existir uma conexão ativa, o botão de instalação será bloqueado.
- Mensagem de Alerta: Caso tente criar uma segunda integração, verá o aviso: "Verifique com a equipe de suporte: Você já possui uma integração ativa com o Ecommerce da Olist".
- O que fazer se precisar de ajustes: Se precisar de alterar configurações ou corrigir erros, não tente criar uma nova ligação. Vá até ao menu de integrações e gira a conexão já existente.
Como configurar no ERP
Ao finalizar a instalação e autenticação da conta do ERP com o Ecommerce da Olist, siga com o ajuste das configurações, conforme o artigo Como configurar uma integração e as especificações listadas abaixo.
Importante – Validação de Status: a comunicação entre o ERP e o E-commerce ocorre integralmente via API. A liberação das funcionalidades na plataforma de e-commerce depende exclusivamente da confirmação de que a conexão está estabelecida e ativa no ERP. Ressaltamos que apenas o preenchimento das configurações de setup não valida a integração; é necessário que a comunicação direta via API tenha sido realizada com sucesso.
Aba produtos
Campos enviados
- Descrição
- Código (SKU)
- Descrição complementar
- Tags
- Linha de produto
- Imagens
- Variações
- GTIN
- Preço de venda
- Preço promocional
- Estoque atual
- Peso bruto
- Título para SEO
- Descrição para SEO
- Slug
- Link do vídeo
Campos importados
- Descrição
- Preço de venda
- Preço promocional
- Peso líquido
- Peso bruto
- Descrição complementar
- Código (SKU)
- GTIN
- GTIN Embalagem
- Estoque atual
- Imagens
- Variações
- Título para SEO
- Descrição para SEO
- Slug
- Link do vídeo
- Ao importar produtos: aqui você escolhe o formato que irá receber as imagens ao importar os anúncios da plataforma para o ERP, podendo escolher entre duas opções:
- Importar imagens como anexos: esta opção traz as imagens em formato de arquivo, anexadas ao cadastro do produto no ERP.
- Apenas importar a URL externa das imagens: esta opção traz as imagens em formato de URL externa, ou seja, a imagem fica armazenada externamente, e no ERP temos apenas o link que dá acesso à mesma em seu local de armazenamento.
- Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): este parâmetro, se ativado, quando um anúncio é importado da plataforma e já existe aqui no ERP, mas com SKU diferente, o produto aqui do ERP será atualizado com o SKU conforme está na plataforma. Se desativado, ao receber o anúncio, o SKU vai permanecer sem alteração aqui no ERP.
- Enviar descrição complementar: com esse parâmetro habilitado, o sistema irá enviar para a integração a descrição complementar, conforme está cadastrada no produto.
- Criar produtos com status ativo: com esse parâmetro habilitado, os anúncios serão criados na plataforma com o status de ativo, caso contrário, eles serão criados com o status de inativo.
-
Enviar imagens dos produtos ao sincronizar: este parâmetro permite escolher se as imagens dos anúncios existentes no ERP serão enviadas somente para anúncios novos ou se também serão enviadas para anúncios já existentes na plataforma.
- Sim: as imagens serão enviadas para todos os anúncios.
- Apenas para novos produtos: as imagens serão enviadas somente quando os anúncios enviados ainda não existirem na plataforma.
- Enviar dias para preparação ao sincronizar: ao habilitar esse parâmetro, a informação da quantidade de dias necessários para preparação do envio do item será enviada para a plataforma junto aos demais dados do cadastro. A informação pode ser verificada no campo Dias para preparação, no cadastro do produto no ERP.
Aba Pedidos
-
Ao importar produtos: aqui você escolhe o formato que irá receber as imagens ao importar os anúncios da plataforma para o ERP, podendo escolher entre duas opções:
- Importar imagens como anexos: esta opção traz as imagens em formato de arquivo, anexadas ao cadastro do produto no ERP.
- Apenas importar a URL externa das imagens: Esta opção traz as imagens em formato de URL externa. A imagem fica armazenada externamente e, no ERP, consta apenas o link que dá acesso à mesma em seu local de armazenamento.
- Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): este parâmetro, se ativado, define que quando um anúncio é importado da plataforma e já existe no ERP, mas com SKU diferente, o produto no ERP será atualizado com o SKU conforme está na plataforma. Se desativado, ao receber o anúncio, o SKU vai permanecer sem alteração no ERP.
- Enviar descrição complementar: com esse parâmetro habilitado, o sistema enviará para a integração a descrição complementar, conforme está cadastrada no produto.
- Criar produtos com status ativo: com esse parâmetro habilitado, os anúncios serão criados na plataforma com o status de ativo. Caso contrário, serão criados com o status de inativo.
-
Campo do pedido para observações: define como as observações do pedido serão importadas para o campo observação, no pedido de venda.
- Observações internas: as observações serão exibidas somente no pedido de venda.
- Observações externas: as observações serão exibidas no pedido de venda e nas notas fiscais.
- Formatar nome dos contatos no recebimento dos pedidos: ao ativar este parâmetro, os pedidos importados passarão a ter o nome do contato validado e formatado, ficando sempre com a escrita padrão, conforme o exemplo: "José da Silva".
- Importar bônus como desconto no pedido de venda: com o parâmetro habilitado, o bônus de compras prévias aplicado pelo cliente no carrinho de compras da plataforma será considerado como um desconto no valor total da venda importada para o ERP.
- Defina como importar valores de brindes no pedido de venda: com o parâmetro você
Configurações na Plataforma de E-commerce
Se você for utilizar a opção de importação automática de pedidos desta integração, após salvar a configuração no ERP, será necessário adicionar a URL de notificação do sistema no painel administrativo da plataforma de e-commerce. Isso permite que as notificações dos pedidos sejam recebidas e importadas para o ERP.
Para obter a URL de notificação do sistema:
- Acesse a configuração da integração no ERP.
- Clique na aba Conexão.
- Na seção Urls de notificação no ERP, copie a chave disponível no campo Importação de pedidos.
Para que a URL de notificações seja apresentada e os pedidos sejam importados automaticamente, é necessário que o módulo OMS esteja instalado em sua conta.
Na plataforma
Acesse o painel administrativo da plataforma e siga o caminho: configurações > integrações > webhooks. Clique no botão + adicionar webhook e, no campo seletor, escolha uma das opções:
- order-received: para importar os pedidos ao serem salvos.
- order-confirmed: para importar os pedidos ao serem confirmados.
No campo URL, preencha com a URL copiada no ERP e salve a configuração.
Se você possui esta mesma conta da plataforma E-commerce da Olist integrada ao ERP pela versão API (antiga), é necessário desativar o cadastro da URL de notificação dela para evitar duplicidade na importação dos pedidos
A integração entre a plataforma de e-commerce e o ERP, da Olist, facilita a gestão das suas vendas, permitindo a importação de pedidos, controle de estoque e preços. Com essa integração, os lojistas otimizam operações, economizam tempo e melhoram a eficiência do negócio.
Como usar o ERP com o E-commerce da Olist
Acesse o artigo Como usar uma integração no dia a dia para saber mais sobre o uso e descobrir como aproveitar ao máximo a integração.
