Como integrar o ERP com o E-commerce da Olist
O que é a integração
O E-commerce 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 Olist Vnda Commerce e clique em instalar.
- Preencha o campo Token, com o código de integração obtido no painel da plataforma.
- 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 Olist Vnda Commerce.
- 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: é importante, que ao criar o seu token API no painel de E-commerce da Olist, você habilite as seguintes permissões:
- Pedidos
- Produtos
- Pacotes
- Rastreios
- Tags
- Dados de SEO
- Shop Infos
- Inventário
- Variantes
- Estoque
Como configurar no ERP
Ao finalizar a instalação e autenticação da conta do ERP com a Shopee, siga com o ajuste das configurações, conforme o artigo Como configurar uma integração e as especificações listadas abaixo.
Aba produtos
- 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ê pode definir como o sistema deve tratar financeiramente esses itens e identificar rapidamente quais pedidos contêm mimos.
- Preço de Venda (Recomendado): o sistema aplica um desconto integral que anula o valor do item. É a opção ideal para evitar erros na aprovação da NF.
- Valor Zerado: o item entra sem valor atribuído (comportamento anterior), o que pode gerar rejeições fiscais dependendo da SEFAZ.
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.
