NuvemShop

A plataforma NuvemShop permite o envio e atualização de produtos, variações, preços e estoques diretamente do sistema, além da importação automática de pedidos, itens e clientes. Essa comunicação garante que as informações cadastradas e movimentadas no ERP estejam sempre alinhadas com a loja virtual, proporcionando maior agilidade e consistência nos processos de vendas online.

Configurações:

Para iniciar a configuração, é necessário possuir um login no painel NuvemShop Partners.

• A Excia Sistemas já mantém um login base na plataforma.
• Acesse pelo link: https://partners.nuvemshop.com.br

• Solicite o usuário e senha à equipe de Análise.

Criação do Aplicativo

• Após acessar o painel do NuvemShop Partners, clique em “Criar Aplicativo”.
• Defina um nome para o aplicativo e informe o e-mail de contato.

• • Padrão utilizado: EXCIA API {Nome da empresa do cliente}

Criação da Loja

• No painel de Lojas, clique em “Criar Loja”.
• Clique novamente em “Criar Aplicativo”.
• Defina o nome e o e-mail de contato conforme padrão.
  • Padrão utilizado: EXCIA API {Nome da empresa do cliente}
• Mantenha a opção “Loja de Aplicativos” selecionada.
• Clique em “Criar”.
• Após esta criação, será aberta a pagina de manutenção do aplicativo criado.
• No canto direito, poderá ser visualizado a caixa de “Chaves de Acesso”
• Copie em um bloco de notas o App ID e o ClientSecret.

Configuração no Excia Plugin:

• Abra o Configurador de E-commerce (Excia Plugin).
• Na aba Plataforma, no campo Integrações, selecione NuvemShop para iniciar a configuração.
• Filtros a serem preenchidos:
• • Endereço: informar a seguinte URL → https://api.tiendanube.com/v1/
  • ClienteID: informar o App ID salvo no site NuvemShop Partners.
  • ClientSecret: informar o Client Secret salvo no site NuvemShop Partners.
• Após preencher os campos acima, clique no botão verde ao lado do campo Token.
• Será exibida a mensagem:
  “Necessário informar o Código de Autorização para gerar o Token. Você será redirecionado para a página onde deve copiar a tag code= na URL. Continuar?”
• Clique em Sim. Você será redirecionado ao navegador para logar na loja do cliente.

Configuração da Loja

• Informe o e-mail e senha da loja. Em seguida, será exibida uma mensagem solicitando a permissão para que o aplicativo da Excia consulte e grave informações na loja. Clique em Confirmar.

  • Copie apenas o conteúdo após “code=” até antes do “&”.

•  Exemplo: 03a8f2876f4389afbbb9a7b2c8d7de92c869e60dApós a confirmação, será gerado um link semelhante a este:
  https://partners.nuvemshop.com.br/applications/authentication/18485?code=03a8f2876f4389afbbb9a7b2c8d7de92c869e60d&state=csrf-code

Esse código deverá ser informado no campo Autorização do configurador (Excia Plugin).

• Após inserir o código, clique novamente no botão verde ao lado do campo Token.
• O Token será gerado.

• Por fim, clique em Gravar para salvar as alterações.

Com isso o E-commerce já estará rodando corretamente, após isso é necessário configurar as informações de envio e retorno do E-commerce.

Envio:

No envio de produtos do ERP para a plataforma NuvemShop, é possível preencher, de forma opcional, alguns campos na aba “E-Commerce” do cadastro de produtos, que podem ser utilizados na integração entre o ERP e a NuvemShop.

• Título (titulo): Na plataforma NuvemShop este campo é denominado “name”, e pode ser usado para definir o nome do produto que vai ser enviado para loja.
• Descrição Detalhada (HTML): Na NuvemShop, este campo é chamado de “description”, e pode ser usado para descrever de forma mais completa sobre o produto que será enviado para loja.

Esses dois campos, caso preenchidos, serão enviados para a NuvemShop tanto na inclusão(POST) como na atualização(PATCH) para a plataforma.

Produtos: O envio do produto é considerado como chave CODIGO-COR, o envio é feito pelo produto principal seguidas das suas variações, atributos e associação das variações ao produto principal.

Estoque: O estoque = quantidade física + a quantidade em expedição – a quantidade pendente em pedido. O estoque total é feito pela tabela PA_ITEN, filtrando CODIGO, COR, TAM e o depósito selecionado no configurador. Quantidade em expedição parte da tabela PEDIDO3 e se relaciona com as tabelas PEDIDO e ENTIDADE. A quantidade pendente em pedido, calcula o total da quantidade (QTDE) da tabela PED_ITEN, partindo da tabela PEDIDO relacionando com as tabelas PED_ITEN.

Preço: O preço é enviado junto com a variação do produto, considerando a tabela de preço selecionada no configurador. Partindo da tabela TAB_PRECO, relacionando com as tabelas PRODUTO, PA_ITEN, CADCOR, ETQ_PROD e PRODUTO_ECOM. Filtrando campo REGIAO da tabela TAB_PRECO (Tabela de preço selecionada no configurador), campo DEPOSITO da tabela PA_ITEN (Depósito selecionado no configurador), campo ATIVO da tabela PA_ITEN deve ser igual a (‘S’), campo ATIVO da tabela PRODUTO deve ser igual a (‘S’), campo TIPO da tabela TAB_PRECO deve ser igual (‘P’) e o campo COLECAO da tabela PRODUTO (Coleção selecionada no configurador).

Retorno:

Importa pedidos, itens e clientes: A chave que é levado em consideração para importar os dados é o campo PED_CLI da tabela PEDIDO seguindo a nomenclatura (‘Identificador do Pedido’), a importação dos itens é considerada o ID do produto no site verificando pelo campo ID_ECOM da tabela PA_ITEN.