Integração ERP da Olist com a Shoppub

Acesse o site da Shoppub

Integração desenvolvida pela Shoppub, através da nossa API de integração.

Recursos disponíveis

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

Sincronização de pedidos

Notificações por e-mail

1. Na aba Estoque, defina os seguintes campos:

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

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.