A integração do Alfa Market com a Nuvemshop permite administrar a loja virtual diretamente pelo sistema. Os produtos são publicados a partir do próprio cadastro, o estoque destinado às vendas online fica separado do estoque da loja física e os pedidos realizados na loja chegam automaticamente, prontos para a emissão da NF-e. Este guia apresenta o processo completo, da conexão da conta ao faturamento, e serve tanto para a implantação de novos clientes quanto para quem já possui produtos publicados na Nuvemshop.

Conexão da conta e configuração inicial

A configuração começa nos Parâmetros do Sistema, onde a conta da Nuvemshop é vinculada ao sistema e a localização de estoque exclusiva das vendas online é definida. Antes de iniciar, deixe a conta da Nuvemshop aberta e logada no navegador, pois a autorização é feita diretamente nela.

1. Clique na engrenagem do canto superior direito, acesse Parâmetros do Sistema, abra a aba Marketplaces e expanda a seção Nuvemshop.
2. Clique em Conectar. O sistema redireciona para a conta da Nuvemshop logada no navegador, onde a autorização deve ser concluída.
3. Clique em Registrar webhooks. Os webhooks são avisos automáticos que a Nuvemshop envia ao sistema sempre que um novo pedido é realizado, sem necessidade de consulta manual.
4. Caso ainda não exista uma localização própria para o marketplace, acesse Cadastros → Produto → Localização, crie uma localização com uma descrição clara, como “Estoque Nuvemshop”, e salve.
5. Retorne à seção Nuvemshop dos parâmetros, selecione a localização criada no campo Localização do Estoque e clique em Salvar.

Preparação dos produtos e reserva de estoque

Para ser publicado, o produto precisa estar liberado para a Nuvemshop no cadastro e ter estoque reservado na localização do marketplace. O cadastro segue a estrutura padrão do sistema, com as informações fiscais, tributárias e de estoque, complementada pelos dados que a venda online exige.

Para produtos simples, sem variação de grade:

1. Em Cadastros → Produto → Cadastro de Novos Produtos, preencha as informações fiscais, tributárias e de estoque e, se desejar, a marca do produto.
2. Na aba Informações Adicionais, altere o campo Disponível na Nuvemshop para Sim.
3. Na seção Imagens do Produto, envie as fotos e defina qual será a imagem principal do anúncio. O sistema aceita imagens de até 1 MB, nos formatos PNG, JPG e JPEG.
4. Salve o cadastro.

Nos produtos com grade, como roupas e calçados vendidos em diferentes cores e tamanhos, o produto também deve ser liberado em Informações Adicionais, e as variações são informadas na seção Grade de Produtos. Para cada variação, preencha Cor, Tamanho, Quantidade e Preço de Venda e clique em Inserir. Complemente o cadastro com imagens específicas das variações, para que o cliente visualize cada opção na loja, e salve.

Com o produto cadastrado, reserve a quantidade que ficará disponível para as vendas online. É essa reserva que mantém o estoque da loja física e o da Nuvemshop separados e organizados.

1. Acesse Cadastros → Produto → Movimentação Estoque e selecione o produto para visualizar o estoque total disponível.
2. Escolha a localização destinada à Nuvemshop e informe a quantidade que será transferida para as vendas online.
3. Salve a movimentação.

Publicação e importação de anúncios

A publicação é feita em Marketplace → Produtos, na tela Produtos Marketplace. Com o filtro Canal em Nuvem Shop, a tela lista os produtos liberados para a loja, a situação de cada anúncio (publicado ou não publicado) e o controle de estoque separado nas colunas Estoque Total, Estoque Disponível e Estoque Depósito.

1. Localize o produto e clique no menu de ações (três pontos).
2. Selecione Publicar na Nuvemshop.
3. Nos produtos com grade, a janela de publicação permite escolher quais atributos de cor e tamanho e quais variações serão enviados ao anúncio. Marque ao menos uma variação e confirme.

Depois de publicado, o anúncio pode receber dados complementares diretamente na loja da Nuvemshop, quando necessário.

Quando a loja já possui produtos publicados na Nuvemshop, não é preciso cadastrá-los do zero. Na mesma tela, clique em Importar publicações para listar os anúncios da loja, com a imagem, o valor e o estoque da Nuvemshop, e defina o tratamento de cada um:

• Vincular: associa a publicação a um produto que já existe no sistema.
• Adicionar: cria o cadastro quando o produto ainda não existe no sistema. Na janela de cadastro, dê preferência ao uso de uma regra fiscal para preencher os dados tributários, complete as demais informações e salve. O estoque inicial informado é transferido automaticamente para a localização da Nuvemshop parametrizada no sistema.
• Excluir: desfaz um vínculo ou cadastro feito por engano. A exclusão apenas desvincula a publicação, sem apagar o produto da loja ou do sistema.

Se o anúncio importado tiver variações, o produto é criado sem grade e o vínculo é feito no nível do anúncio. Para controlar o estoque por grade, cadastre o produto com grade no sistema e utilize a opção Vincular.

Sincronização e conferência de estoque e preço

Com os anúncios publicados, a própria tela Produtos Marketplace mantém o sistema e a loja alinhados. A sincronização de estoque pode ser feita em massa, pelo botão Sincronizar estoque, ou individualmente, pelo menu de ações de cada produto, que reúne também as demais opções de manutenção do anúncio:

• Atualizar publicação: envia à Nuvemshop as alterações feitas no cadastro, como preço, marca e grade. Nos produtos com grade, a janela de seleção de atributos e variações é aberta novamente.
• Sincronizar estoque e preço: atualiza na loja o estoque e o preço de venda do produto.
• Conferir estoque Nuvem Shop: compara, por variação e SKU, o estoque do sistema com o da Nuvemshop. Qualquer divergência encontrada é destacada em vermelho.

Sempre que houver alteração de preço ou nova movimentação de estoque, sincronize o produto e utilize a conferência para confirmar que os saldos estão iguais nos dois lados.

Recebimento de pedidos e emissão da NF-e

Os pedidos realizados na Nuvemshop chegam automaticamente em Marketplace → Pedidos, na tela Pedidos Marketplace, por meio dos webhooks registrados na configuração. Caso algum pedido não apareça, clique em Sincronizar pedidos para buscar as vendas mais recentes. A listagem exibe o comprador, o CPF ou CNPJ, a data, o valor dos produtos, o frete, o valor total e o status de cada pedido, e o cliente é cadastrado automaticamente no sistema com nome e endereço.

Enquanto o pagamento não é confirmado, o pedido permanece pendente. Após a aprovação na Nuvemshop, o status passa para Pago e a emissão da nota é liberada:

1. No menu de ações do pedido, abra Detalhes do Pedido para conferir os itens e as informações de pagamento.
2. Com o status Pago, selecione Gerar NF-e. O sistema abre a tela de emissão da NF-e já preenchida com o cliente, os produtos, os valores e a forma de pagamento.
3. Confira os dados e emita a nota.

Concluídas essas etapas, a loja passa a operar com estoque próprio para as vendas online, anúncios mantidos a partir do cadastro do sistema e pedidos que chegam prontos para o faturamento. Os pontos que exigem mais atenção são manter a localização da Nuvemshop vinculada nos parâmetros, fazer toda reserva de estoque por essa localização para não misturar os saldos da loja física e da loja virtual, acompanhar as divergências na conferência de estoque e emitir a NF-e somente para pedidos com pagamento aprovado.