Integração ERP da Olist com a Shoppub
Integração desenvolvida pela Shoppub, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos Solução desenvolvida pela Shoppub | ✔ |
| Receber produtos Solução desenvolvida pela Shoppub | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
Configuração no ERP
Configurar integração com a Shoppub
Acesse as configurações de e-commerce do ERP em Menu → Configurações → Aba E-commerce → Integrações.
Agora, clique no botão Incluir integração para adicionar as configurações de integração.
Caso já possua integrações configuradas em sua conta, as mesmas serão exibidas e indicadas com suas respectivas situações.
Cada situação indica:
- Ativa: Representa que a configuração da integração foi realizada com sucesso e a mesma encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no ERP, a mesma não será utilizada ou mostrada para sincronização de pedidos, produtos e demais ações pertinentes.
- Não configurada: Esta situação indica que a configuração ainda não foi realizada.
- Não instalada: Representa que ainda não houve a comunicação com o e-commerce para ativar a integração.
Na aba Integração , selecione Shoppub no campo Integração. Abaixo, no campo Nome informe o nome da sua loja.
Em Configurações , defina os seguintes campos abaixo:
Sincronização de produtos
| Enviar dias para preparação ao sincronizar | Habilite a opção para enviar a informação do campo Dias para preparação no envio de produtos para Americanas Marketplace. Para preencher este campo, acesse o Cadastro do seu produto , clique em Editar e na aba Dados gerais , na seção Estoque preencha o campo Dias para preparação. Lembramos que esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes (Carrefour, por exemplo). |
|---|
Sincronização de pedidos
| Enviar rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos. |
|---|
Notificações por e-mail
| Enviar e-mail de rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática via e-mail conforme layout estabelecido nas configurações da expedição. |
|---|---|
| Enviar e-mail de entrega ao alterar a situação no ERP para entregue | Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, será enviado de forma automática um e-mail conforme layout estabelecido nas configurações da expedição. |
- Na aba Estoque, defina os seguintes campos:
| Atualizar estoque na loja virtual a partir do ERP | Selecione a opção Enviar saldo físico sempre que houver alguma movimentação de estoque de um produto no ERP, o saldo em estoque desse produto será automaticamente atualizado na loja virtual. |
|---|---|
| Depósito a ser considerado na integração |
Escolha qual será o depósito padrão para as ações: Importar pedido , Importar produtos e Enviar estoque. * O campo Depósito a ser considerado na integração será exibido nas contas que possuem a extensão Depósitos de estoque instalada |
Na aba Dados Fiscais , no campo Natureza de operação para venda desta integração selecione uma Natureza de venda padrão para essa plataforma. A natureza selecionada será atribuída na Importação dos pedidos no ERP e no momento em que gerar a Nota Fiscal através do pedido importado.
Observação:
Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.
Na aba Notificações preencha os campos URL do notificações de estoque , URL para envio de produtos , URL para envio da nota fiscal e URL para envio dos preços com as URLs utilizadas para webhook de sua loja virtual.
Observação:
Estes links devem ser solicitados ao suporte da Shoppub.
Ao final, não esqueça de Salvar as configurações.
Adicionar extensão token api
Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Loja de extensões.
Na seção Vendas , adicione a extensão Token API.
Agora, clique em Instalar e Confirme a instalação da extensão.
Gerar token api
Acesse as configurações de e-commerce do ERP em Menu → Configurações → Aba E-commerce → Token API.
No campo Token , encontra-se o Token identificador da sua conta.
Esse token deve ser adicionado no momento que integrar com o ERP na Shoppub, conforme orientação integrar o ERP com a plataforma Shoppub.
Como enviar produtos do ERP para Shoppub
Enviar apenas um produto
Para enviar apenas um produto para Shoppub, acesse em Menu → Cadastros → Produtos.
Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.
A seguir, no campo Plataforma selecione sua loja Shoppub e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Unidade;
- Preço;
- Preço promocional;
- NCM;
- Origem;
- GTIN;
- Peso bruto;
- Estoque;
- Estoque mínimo;
- Preço de custo;
- Situação;
- Imagens;
- Dimensões;
- Variações;
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para Shoppub, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Shoppub e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Unidade;
- Preço;
- Preço promocional;
- NCM;
- Origem;
- GTIN;
- Peso bruto;
- Estoque;
- Estoque mínimo;
- Preço de custo;
- Situação;
- Imagens;
- Dimensões;
- Variações;
Como mapear o cadastro dos produtos para integração do estoque
Para mapear o cadastro de um produto que já está no ERP e na Shoppub, você deverá acessar o produto na plataforma e copiar o ID do produto na plataforma, presente na URL de acesso.
Feito esse processo na Shoppub, edite o produto no ERP e na aba Anúncios , insira um novo mapeamento.
No campo Identificador , insira o mesmo ID que você buscou na Shoppub.
Aplique e Salve as alterações.
Como visualizar os pedidos do e-commerce no ERP
Caso nas configurações da Shoppub o campo Enviar pedidos estiver marcado como Sim , cada vez que um novo pedido for gerado, o mesmo será enviado automaticamente para o ERP.
Para visualizar os pedidos, acesse sua conta no ERP em Menu → Vendas → Pedidos de venda.
Configuração na Shoppub
Como integrar o ERP com a plataforma Shoppub
Para ativar e configurar a integração da loja com o sistema ERP, siga os passos a seguir:
Acesse o menu lateral, em ERPs → Integrações com ERPs.
Selecione a integração com o ERP e clique em Editar.
Clique em Adicionar ERP da Olist ERP.
Informe o Nome, Token e Código da loja.
Salve a integração.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à Shoppub , alguns dados são sincronizados entre as duas plataformas, evitando que você precise fazer o cadastro de produtos duas vezes.
É importante que você entenda quais campos serão sincronizados. Segue abaixo a lista com a especificação de cada campo:
| Código (SKU) | Este campo é OBRIGATÓRIO. Sem ele a exportação não funcionará. Ele é a chave de conexão do produto entre as duas plataformas, então preencha preferencialmente apenas com números. Ele será registrado na Dooca Commerce como ID_ERP, localizado nos detalhes da variação de um produto. |
|---|---|
| Descrição | O campo descrição no ERP equivale ao campo Nome do produto no painel de controle da Shoppub. |
| Descrição complementar | O campo de descrição complementar no ERP equivale a descrição complementar do produto na Shoppub. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da Shoppub. |
| Preço promocional | O campo preço promocional no ERP equivale ao campo Preço de no painel de controle da Shoppub. |
| Preço de custo | O campo de Preço de custo equivale ao campo Preço custo no painel de controle da Shoppub. |
| Peso bruto | O peso bruto equivale ao campo peso no painel de controle da Shoppub. O peso líquido não será importado. |
| Largura | Preencha o campo largura no ERP com a largura exata do produto. Este campo será vinculado ao campo largura no painel Shoppub. |
| Altura | O campo altura no ERP equivale ao campo altura no painel de controle da Shoppub. |
| Comprimento | O campo comprimento no ERP equivale ao campo comprimento no painel de controle da Shoppub. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Shoppub. |
| Estoque mínimo | O estoque mínimo do produto no ERP será enviado para a Shoppub e será cadastrado no item da plataforma. |
| NCM | O campo NCM no ERP equivale ao campo NCM no painel de controle da Shoppub. |
| GTIN | O campo GTIN no ERP corresponde ao campo GTIN na Shoppub. |
| Unidade | A unidade do produto cadastrado no ERP representará a mesma informação a partir da Shoppub. |
| Origem | A origem do produto no ERP representará essa informação, também, na Shoppub. |
| Anexos | Os anexos cadastrados nos produtos do ERP (imagens, por exemplo) serão importados para a Shoppub. |
| Código (SKU) | Este campo é OBRIGATÓRIO. Sem ele a exportação não funcionará. Ele é a chave de conexão do produto entre as duas plataformas, então preencha preferencialmente apenas com números. Ele será registrado na Dooca Commerce como ID_ERP, localizado nos detalhes da variação de um produto. |
|---|---|
| Descrição | O campo descrição no ERP equivale ao campo Nome do produto no painel de controle da Shoppub. |
| Descrição complementar | O campo de descrição complementar no ERP equivale a descrição complementar do produto na Shoppub. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da Shoppub. |
| Preço promocional | O campo preço promocional no ERP equivale ao campo Preço de no painel de controle da Shoppub. |
| Preço de custo | O campo de Preço de custo equivale ao campo Preço custo no painel de controle da Shoppub. |
| Peso bruto | O peso bruto equivale ao campo peso no painel de controle da Shoppub. O peso líquido não será importado. |
| Largura | Preencha o campo largura no ERP com a largura exata do produto. Este campo será vinculado ao campo largura no painel Shoppub. |
| Altura | O campo altura no ERP equivale ao campo altura no painel de controle da Shoppub. |
| Comprimento | O campo comprimento no ERP equivale ao campo comprimento no painel de controle da Shoppub. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Shoppub. |
| Estoque mínimo | O estoque mínimo do produto no ERP será enviado para a Shoppub e será cadastrado no item da plataforma. |
| NCM | O campo NCM no ERP equivale ao campo NCM no painel de controle da Shoppub. |
| GTIN | O campo GTIN no ERP corresponde ao campo GTIN na Shoppub. |
| Unidade | A unidade do produto cadastrado no ERP representará a mesma informação a partir da Shoppub. |
| Origem | A origem do produto no ERP representará essa informação, também, na Shoppub. |
| Anexos | Os anexos cadastrados nos produtos do ERP (imagens, por exemplo) serão importados para a Shoppub. |
Saiba como cadastrar no ERP produtos Simples e Com variações.
Enviar estoque dos produtos no ERP ao e-commerce
Enviar quantidade em estoque em lote
Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos. Na lista que será exibida, selecione as integrações que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar quantidade em estoque de forma individual
Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.
No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto. Na lista que será exibida, selecione aquelas que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar preço dos produtos no ERP ao e-commerce
Enviar preços em lote
Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Enviar preço de forma individual
Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Reajustar preço dos produtos no ERP e atualizar no e-commerce
Para realizar os ajustes nos preços dos produtos cadastrados no ERP e após atualizar na loja virtual, acesse em Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.
Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.
Após isso, será exibido a lista dos produtos, clique em Informar reajuste.
Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços, por reajuste de Percentual , ou adicione o novo preço em cada produto na coluna Novo preço , marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.
Enviar dados da chave de acesso ao e-commerce
Ao utilizar a integração com a Shoppub, assim que as notas forem emitidas através das vendas importadas de sua plataforma, os dados das notas fiscais serão enviados de forma automática.
Dicas e informações adicionais
- Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse Configurações → Aba E-commerce → Integrações e marque a integração desejada. Depois, clique em Mais ações → Excluir todos os anúncios no ERP. É importante mencionar que esta ação, depois de concluída, não poderá ser desfeita.
- Os campos sincronizados devem ser corrigidos/modificados apenas no ERP. Caso você corrija/modifique alguma destas informações no painel de controle da Shoppub, estas informações serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.
