Nuvemshop

SOBRE O NUVEMSHOP

A NUVEMSHOP é um site e-commerce que permite criar sua própria loja online auto gerenciável, sem a necessidade de conhecimentos técnicos. Ela oferece uma solução tecnológica pensada em micro, pequenas, médias e grandes empresas. 

O conteúdo aqui incluso referencia-se a uma integração entre ERP X NUVEMSHOP, permitindo ao usuário novas opções de recursos para melhor organização do seu negócio. 

Siga os passos abaixo, sem pular nenhuma etapa, e no fim poderá utilizar essa melhoria corretamente. 

LOGIN NO NUVEMSHOP

Caso o cliente não possua uma conta, é necessário criar. Importante ressaltar que a Ema é parceira do NS, então a conta disponibilizada é uma conta DEMO para testes. Mesmo que apareçam avisos de plano ou encerramento de teste gratis, a conta possui todas as funções necessárias para os testes com o ERP. 

image-1687279139909.png

O aplicativo é o responsável pela comunicação da API com a loja, neste exemplo é usado a loja 'Demo Casa das Maquinas', que é uma loja base para testes.

image-1688391186957.png

OBTENDO O TOKEN

image-1688390058855.png

Isso o levará para uma pagina onde estará o código para obter acesso a API. 

image-1688390237701.png

OBTENDO O TOKEN - API
{
"client_id": "7433",
"client_secret": "2e6156a1b496e8552cfc656e71e3c66d5db4e2b008ecf1eb",
"grant_type": "authorization_code",
"code": "e4a01f5ac80ab8f8d3e3c8ef8c3403df7447bbce"
}

Sendo:

image-1688390491339.png

Exemplo de retorno:

{
    "access_token": "7de79ca10bf0a3eaa059f6e226d4890202fd1ae9",
    "token_type": "bearer",
    "scope": "read_content,write_content,read_products,write_products,read_coupons,write_coupons,read_customers,write_customers,read_orders,write_orders,read_shipping,write_shipping,read_discounts,write_discounts,read_draft_orders,write_draft_orders,write_scripts,read_locations,write_locations,read_fulfillment_orders,write_fulfillment_orders",
    "user_id": 2847442
}

* Ao configurar as informações no POSTMAN, não é necessário informar nada nas abas de 'Params', 'Authorization', 'Headers' ets. Apenas o endereço POST e a aba 'Body': 

image-1688391432952.png

CONFIGURANDO A INTEGRAÇÃO NO ERP

image-1688392121178.png

image-1705667214183.png

Url do ambiente de teste: https://api.nuvemshop.com.br/v1/3324150

Token do ambiente de teste: bearer ea136f8dae7e7361fcb4dfd25c645da1c88df815

image-1688392620438.png

Importante!

image-1706551240749.png

Ao marcar o parâmetro 'Utiliza 'De/Para' na transportadora ao importar pedido para ERP, a aba 'Transportadoras' ficará visível para configuração. 

Marcando o parâmetro "Insere na observação do pedido os itens sem valor ou sem SKU", ao sincronizar o pedido do NUVEMSHOP para o ERP com itens sem SKU, ou seja, item criados diretamente no NUVEMSHOP, o sistema irá informar na observação do pedido importado. 

Ex: 

image-1706556813306.png

image-1705667490287.png

image-1689945523063.png

image-1706550914960.png

image-1690995058992.png

E está pronto! integração concluída! 

INFORMAÇÕES ADICIONAIS: 
ITEM = PRODUTO 

Vamos mostrar abaixo a relação de Item e Produto de ERP x Nuvemshop. Com a integração E-commerce devidamente configurada, acesse: 

image-1689353763345.png

image-1705668134530.png

Importante!

image-1705667608365.png

image-1705667757463.png

SINCRONIZAÇÃO NUVEMSHOP 

image-1689354695651.png

Com isso, a sincronização será realizada. E isso já basta para cadastrar no NUVEMSHOP um produto (sendo denominado como "ITEM" no ERP). 

EX: 

image-1689354730489.png

Loja do ambiente de teste casadasmaquinas2:  https://www.nuvemshop.com.br/login

Login: desenvolvimento@ema.net.br

Senha: Dev@Ema#2023

image-1689354950506.png

TABELA DE PREÇO 

No NUVEMSHOP existe o campo "Promocional", que difere o valor do campo preço normal

image-1706549615884.png

Para realizar a configuração desse preço promocional é necessário vincular o item do ERP em uma tabela de preço. Acessar: 

image-1706550025007.png

Ao editar a tabela de preços, na aba 'Itens' é onde vincula o item/produto. O campo promocional é "Valor tabela" 

image-1706550233608.png

Importante ressaltar que, na aba 'Versões', é onde está a data em que este valor promocional é valido. Caso já tenha passado da data, o valor promocional não será enviado. 

* Verificar o campo 'Versão vigente' da tabela de preço. 

Após, realizar a alteração, acesse os parâmetros gerais do e-commerce e vincule a tabela de preço 

image-1706550686863.png

image-1706551031312.png

GRUPOS = CATEGORIA

Agora vamos complementar esse item, incluindo um grupo em seu cadastro. Acesse: 

image-1689355469686.png

image-1690996045905.png

Vincule esse grupo no item escolhido e realize a sincronização novamente. Em seguida verifique no NUVEMSHOP a categoria criada: 

image-1689355657431.png

image-1689355951856.png

image-1689356007180.png

* Os subgrupos vinculados também serão enviados ao NUVEMSHOP caso o parâmetro esteja marcado. 

CATALOGOS = CATEGORIA 

Assim como na configuração de grupo acima, é possível vincular o item do NUVEMSHOP com uma categoria, esta sendo um CATALOGO DE ITEM no ERP. Para isso, antes precisamos alterar as configurações da integração E-commerce para considerar a exportação de CATALOGO e não GRUPO. 

image-1690997698685.png

Feito, salve e acesse o cadastro de catálogos de itens:

image-1690997192299.png

image-1690997350629.png

image-1690997552556.png

Importante: 

image-1690999059465.png

ITEM COM MARCAS 

Para o envio de marcas vinculados ao item no NUVEMSHOP, acessar:

image-1705668293305.png

image-1705668429049.png

image-1705668574498.png

ITEM = ABA 'INTEGRAÇÕES'

image-1710953939064.png

image-1705669086738.png

Importante!

SINCRONIZAÇÃO ESTOQUE

Após realizar a inclusão do item no ERP e sincronizar para o NUVEMSHOP, precisamos atualizar o estoque do item. Acesse: 

image-1689623629408.png

image-1689623962484.png

image-1689624205256.png

Importante!

Outras informações como preço, descrição, observação são atualizadas ao editar no ERP e sincronizar novamente. Abaixo algumas regras implementadas na integração em relação ao estoque do item:

image-1705667869520.png

AGRUPAMENTO = VARIAÇÕES 

Vamos vincular um item em um agrupador no ERP e configurar sua grade/tamanho/cor. Porém, antes de iniciar, vamos verificar alguns parâmetro da integração E-commerce NUVEMSHOP: 

image-1705667902685.png

importante!

Abaixo algumas regras implementadas na integração em relação a este parâmetro: 

Agora vamos configurar o agrupamento para enviar. Acesse: 

image-1689599944728.png

image-1690995788978.png

Após isso, precisamos configurar a grade + tamanho + cores do agrupamento. Acesse: 

image-1689600748246.png

image-1689602132050.png

image-1689602221601.png

image-1689602610887.png

Importante!

O que acontece aqui é que o item enviado para o NS com um agrupamento é incluído como uma VARIAÇÃO. E o agrupamento em si é incluído como um produto.  

image-1689622198596.png

SINCRONIZAÇÃO CLIENTE

Existe apenas uma forma de incluir um novo cliente no ERP pelo NUVEMSHOP, que seria ao incluir um pedido, colocando as informações do cliente (Nome, Sobrenome, E-mail, Telefone e CPF/CNPJ).  

image-1698684469480.png

Importante!

Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de CLIENTE: 

Coloque as informações do cliente e acesse o ERP para realizar a sincronização.

SINCRONIZAÇÃO PEDIDOS 

Antes de tudo, acesse a configuração do E-commerce e vamos verificar algumas informações dos pedidos. 

image-1705667983646.png

Os pedidos importados do E-commerce devem seguir o padrão de método/condição configurados nesses dois campos. Agora, vamos criar um pedido no NUVEMSHOP e sincronizar para o nosso ERP.

image-1689622679255.png

Ex: 

Pedido - NUVEMSHOP

image-1691000352050.png

Pedido - ERP 

image-1691000408660.png

Importante!

Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de PEDIDO:

DE/PARA NA INTEGRAÇÃO DE PEDIDOS

Assim como informado acima, ao realizar a importação de um pedido do NUVEMSHOP, o sistema irá vincular o método e condição de pagamento automaticamente com o que está configurado na integração E-commerce.

Porém, existe um parâmetro permite com que o sistema traga diferentes métodos e condições de acordo com a forma de pagamento escolhida no site NUVEMSHOP. 

image-1705668014705.png

Em seguida, na aba 'Métodos', informe os métodos escolhidos para cada forma de pagamento no NUVEMSHOP. No exemplo abaixo, criamos uma forma de pagamento PERSONALIZADA (PIX) no site e o retorno dessa personalização é descrito como "custom". 

image-1691002551568.png

Com isso, todo pedido criado no NUVEMSHOP que possua o método de pagamento PIX (custom) será importado no ERP com o método 'Boleto' e a condição 'Em espécie (dinheiro)'. 

Importante! 

TABELAS E LOG E-COMMERCE 

Tabelas relacionadas à integração E-commerce (NÃO TODAS). Utilizamos os comando abaixo para "zerar" a base de teste e podermos começar a exportar novos registros sem dar nenhum conflito com sincronizações anteriores.

** IMPORTANTE realizar em uma base de teste e verificar se necessário adicionar a clausula WHERE, para não afetar registros importantes. 

DELETE 
  FROM INTEGRACAOECOMMERCE_GRUPO
UPDATE GRUPO 
   SET EXPORTAWEB = 'N'
DELETE 
  FROM INTEGRACAOECOMMERCE_ITEM
UPDATE ITEM 
   SET EXPORTAPALM = 'N'

Sobre os logs do E-commerce, toda vez que algum problema surge durante a sincronização o sistema guarda o retorno para consulta. Acesse: 

image-1689626716731.png

Importante que sempre depois de uma integração bem sucedida, ter o costume de verificar o log para garantir que pequenos detalhes não passem despercebidos. Assim como foi descrito ao longo deste conteúdo, algumas mensagens de erro são auto entendíveis ou de fácil solução para o usuário: 

Porém ainda existem outras mensagens mais técnicas que são mostradas em log e dependendo do contexto, são importantes serem verificadas. 

É necessário ABRIR TAREFAS sobre melhorias no log, caso necessário. 

TESTE / QA 

Para realizar os testes dessa integração com possíveis melhorias e correções, leia o conteúdo desde o começo e acesse o ambiente demo (para testes): 

Tudo o que for feito no ERP (conforme os exemplos acima) e depois sincronizado, aparecerá nesse ambiente demo (devidamente configurado nessa loja). 

Importante ressaltar que a Ema é parceira do NUVEMSHOP, então a conta disponibilizada é uma conta DEMO para testes. Mesmo que apareçam avisos de plano ou encerramento de teste grátis, a conta possui todas as funções necessárias para os testes com o ERP. Se houver duvidas, contatar o suporte do NUVEMSHOP e informar o e-mail, passando as duvidas em seguida. 

image-1691003139898.png

image-1691003232568.png

image-1691003337222.png

 

Revisão #80
Criado 20 June 2023 13:32:09 por Nicolly Andrielly
Atualizado 20 May 2025 14:57:44 por Felipe Gulert Rodrigues