1. Fluxo da integração;
2. Particularidades da Nuvemshop;
3. Pré-requisitos para configuração;
4. Como instalar o aplicativo do Eccosys na loja da Nuvemshop;
5. Como configurar a integração Eccosys - Nuvemshop;
6. Como mapear atributos da ficha técnica;
7. Como funciona a atualização de estoque, produtos e pedidos;
8. Como funciona a importação de pedidos com Multi CD;
9. Como enviar código de rastreio para Nuvemshop.

Leia atentamente às instruções a seguir antes de alterar qualquer parâmetro da integração. Se necessário, solicite o auxílio de nosso time de suporte.

Fluxo da integração

	Importamos para o Eccosys	Enviamos para a plataforma
Árvore de categorias	✔	✔
Produtos	✔	✔
Atributos	✔	✔*
Imagens		✔*
Marcas		✔*
Depósitos	✔

(*) Enviados apenas em conjunto, quando informados no cadastro do produto.

Particularidades da Nuvemshop

1. Os atributos da Nuvemshop não possuem referência quando importados, e por isso precisam ser mapeados no Eccosys;
2. É possível importar pedidos manualmente (auditoria);
3. Caso o transportador não esteja corretamente mapeado, os pedidos de venda não serão importados;
4. Atualiza status "Entregue" por meio de tarefa própria;
5. Permite trabalhar com múltiplos centros de distribuição.

Pré-requisitos para configuração

1. Domínio;
2. Access token;
3. User ID.

Note que estas informações podem ser obtidas automaticamente a partir da Loja de Aplicativos da Nuvemshop (ver próxima seção).

Como instalar o aplicativo do Eccosys na loja da Nuvemshop

Caso o número máximo de integrações disponíveis em seu plano Eccosys já tenha sido utilizado ou não seja possível configurar sua integração automaticamente, você verá uma mensagem solicitando que entre em contato com nosso time de atendimento.

Como configurar a integração Eccosys - Nuvemshop

Caso deseje migrar sua operação para uma outra plataforma ou serviço já integrado ao Eccosys, notifique o time de suporte com antecedência mínima de 30 dias. Desta forma, poderemos fornecer as orientações necessárias e avaliar quaisquer ajustes relacionados à migração.

Caso o processo não ocorra de forma automática ou seja necessário ajustar algum detalhe nas configurações da integração, siga os passos abaixo:

Em Configurações > Plataforma > Multiplataforma, clique no botão "Incluir uma plataforma" para adicionar uma nova integração.

Caso deseje alterar os dados de uma plataforma já cadastrada, clique no botão "Editar", indicado na imagem abaixo.

Aba Conexão

Aba Parâmetros da Plataforma

1. Importação de Produtos - Origem Padrão: Define qual será a origem para produtos novos importados através dos pedidos de venda;
2. Importação de Produtos - Apenas Ativos: Define se produtos inativos devem ser importados para o Eccosys;
   
3. Importação de Produtos - Deduzir Código do Pai pelo Código dos Filhos: Por padrão, o código do produto será o seu id na Nuvemshop. Este parâmetro define se o Eccosys deve tentar identificar um padrão no código dos SKUs e utilizá-lo como código para o produto pai (ex.: se o código dos SKUs for 1234-M e 1234-G, o padrão "1234" será usado como código do pai);
4. Importação de Produtos - Vincular Produtos pelo Código: Define se os vínculos de produtos entre Eccosys e Nuvemshop serão iguais aos códigos dos produtos;
   
5. Envio de Produtos - Sincronizar Imagens: Define se as imagens serão enviadas do Eccosys para a plataforma;
   
6. Controla exclusão de imagens- Define se as imagens existentes na plataforma deverão ser substituídas pelas imagens cadastradas em seu ambiente Eccosys;
   
7. Importação de Pedidos - Situação: Define se o Eccosys irá importar apenas pedidos pagos;
8. Importação de Pedidos - Data de Corte Mínima e Máxima: Permite definir um intervalo de datas para a importação de pedidos. As datas de início e fim devem ser separadas por vírgula e estar no formato DD/MM/AAAA (ex.: 01/01/2023,31/01/2023);
9. Regra de envio de status para a Plataforma- Define quando o Eccosys deve enviar as informações de faturamento para a plataforma;
10. Atualização Status de Pedido - Obrigatória URL de Rastreio: Quando preenchido com "Sim", não irá atualizar pedidos sem URL de rastreio;
    
11. Regra de Envio de Estoque- Define qual será o tipo de comunicação sobre o estoque dos produtos entre Eccosys e plataforma;
    
12. Lista de preço da Plataforma- Permite selecionar uma lista de preços cadastrada no Eccosys para atualizar os valores dos produtos na plataforma;
13. Idioma da integração de catálogo: Escolha o idioma de envio das informações do Eccosys para a Nuvemshop - português ou inglês. O ERP não traduz as informações, apenas comunica à Nuvemshop qual idioma a plataforma deve considerar;
14. Controla exclusão de imagens: Define se as imagens existentes na plataforma deverão ser substituídas pelas imagens cadastradas em seu ambiente Eccosys;
15. Importação de pedidos: Situação: Define se o Eccosys irá importar apenas pedidos pagos;
16. Importação de pedidos: Data de Corte Mínima e Máxima: Permite definir um intervalo de datas para a importação de pedidos. As datas de início e fim devem ser separadas por vírgula e estar no formato DD/MM/AAAA (ex.: 01/01/2023,31/01/2023);
17. Regras de envio de status à Nuvemshop: Define quando o Eccosys deve enviar as informações de faturamento para a plataforma;
18. Atualização status do pedido: Obrigatória URL de Rastreio: Quando preenchido com "Sim", não irá atualizar pedidos sem URL de rastreio;
19. Regra de envio de estoque: Define qual será o tipo de comunicação sobre o estoque dos produtos entre Eccosys e plataforma;
20. Lista de preço da plataforma: Permite selecionar uma lista de preços cadastrada no Eccosys para atualizar os valores dos produtos na plataforma.
    

A partir da criação do Multi CD, o envio de estoque à Nuvemshop considera as seguintes regras:

1. Envia estoque do depósito padrão da plataforma: Atualizará apenas o depósito informado nas configurações da plataforma;
   
2. Envia estoque consolidado de todos os depósitos: Soma o estoque de todos os depósitos do Eccosys e envia um valor único para a plataforma;
   
3. Envia estoque de depósitos mapeados que consideram saldos: Atualiza o estoque de todos os depósitos que possuírem referência e que estiverem selecionados para considerar saldo. O envio para a plataforma é feito de forma individual.

Como mapear atributos da ficha técnica

Os atributos dos produtos são importados da plataforma ao Eccosys. No entanto, é necessário que estes atributos sejam mapeados para a devida identificação dos produtos.

Para efetuar esta configuração, acesse Configurações > Multiplataforma > Mapeamentos.

Nesta tela, será possível fazer o De/Para das variações.

 

Ao clicar em "Salvar", o Eccosys fará a identificação dos atributos entre o ERP e a plataforma.

Como funciona a atualização de estoque, produtos e pedidos

A atualização do estoque e demais campos dos cadastros dos produtos será feita por meio de tarefas agendadas. Para gerenciar as tarefas disponíveis em seu ambiente, acesse Configurações > Outros > Tarefas agendadas. 

A importação de pedidos ocorrerá por meio de tarefa agendada. Esta integração também possui uma tela própria para seleção e importação manual de pedidos. Você pode acessá-la em Configurações > Plataforma > Pedidos de venda.

Como funciona a importação de pedidos com Multi CD

Para entender o fluxo de pedidos e atualização de estoque entre Eccosys e Nuvemshop, considere o seguinte exemplo:

1. Um cliente do estado de São Paulo efetua a compra de 5 camisas sociais e 2 calças. Sua loja possui saldo disponível para estes produtos, mas eles se encontram em depósitos diferentes;
2. A compra do cliente será confirmada, porém cada produto será entregue por uma transportadora, em datas distintas;
3. Ao importar o pedido, o Eccosys irá identificar que o pedido possui dois centros de distribuição. Neste caso serão baixados dois pedidos para a mesma ordem de compra;
4. As reservas dos produtos no Eccosys, assim como sua na plataforma, serão sempre para o depósito informado pela Nuvemshop. Neste caso, as 5 camisas para o CD SP capital e as 2 calças para o CD Campinas;
5. O Eccosys irá enviar todas as movimentações sobre a compra do cliente, porém na plataforma elas ficarão como "Separados parcialmente" e "Enviado parcialmente", até conclusão do fluxo para todos os produtos.

Atenção: o cancelamento de um pedido parcial no Eccosys irá cancelar todo o pedido na plataforma!

Como enviar código de rastreio para Nuvemshop

No Eccosys é possível montar a URL de rastreio e enviar essa informação para a Nuvemshop.