Use o módulo Importação de Produtos por Planilha Excel no Shop para cadastrar novos produtos e atualizar informações comerciais, fiscais e de fornecedores a partir de uma planilha externa. O recurso permite separar e validar o CST de Entrada e o CST de Saída do PIS/COFINS, além de tornar o registro da importação na Auditoria mais leve e rápido. Consulte o Detalhamento de Campos para entender o impacto de cada campo no processo.
Antes de começar
Confirme que o usuário possui permissão para acessar Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel e para cadastrar/alterar produtos.
Valide se a planilha contém os campos necessários para o cenário de importação, como códigos, descrição, custos, preços, impostos, fornecedor e, quando aplicável, iddetalhe.
Garanta que as tabelas auxiliares, como grupo, família, marca, categoria, característica, unidade, fornecedor, tipo de código auxiliar e modelo de dados fiscais, estejam revisadas.
Backup recomendado: antes de confirmar a importação, faça uma cópia da base de dados (Backup). Embora o Shop permita revisar alterações antes de aplicá-las, o backup assegura a recuperação do ambiente caso seja necessário desfazer a operação.
Guia Passo a Passo
Configuração
Configure as preferências e o padrão de leitura para que o Shop interprete corretamente os dados da planilha e aplique regras consistentes durante a importação.
Clique na aba Produtos e Serviços, na tela principal do Shop.
Acesse Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel.
Pressione F11 ou clique em Opções.
Na aba Preferências, habilite as opções necessárias para o processo, como geração de log, conversão de preços, localização por código, localização por nome, revisão dos dados antes da aplicação e edição de valores importados.
Preencha os campos técnicos aplicáveis: Fornecedor, Tipo de código auxiliar, Unidade Padrão e Modelo de dados fiscais.
Na aba Padrão de dados, defina as conversões de valores para que dados como Verdadeiro e Falso sejam interpretados corretamente pelo sistema.
Para incluir uma opção de conversão, clique no botão de inclusão, informe a descrição do novo valor e confirme.
Para excluir uma opção de conversão, selecione o valor desejado e clique no botão de exclusão.
Pressione F9 ou clique em Gravar para salvar as configurações.
Configuração das opções de importação: utilize os botões e ícones exibidos no Shop para habilitar preferências, pesquisar campos e manter o padrão de dados alinhado à planilha.
📋 Detalhamento de Campos - Configuração
Campo
Onde fica no sistema
Objetivo
Gerar log de produtos importados
Opções > Preferências
Registrar os dados dos produtos importados em log, permitindo análise e salvamento em arquivo.
Converter preços de unidade de compra para unidade de estocagem
Opções > Preferências
Converter o preço de venda conforme o fator de conversão da unidade de compra. Exemplo: Cx 12 com preço R$ 120,00 resulta em preço convertido de R$ 10,00.
Utilizar código do produto no fornecedor para cadastramento/pesquisa de produtos
Opções > Preferências
Usar o código informado na planilha como código do produto no fornecedor, substituindo a busca pelo código de chamada do item no Cadastro de Produtos.
Utilizar código auxiliar para localizar o produto e substituir o código do produto no fornecedor
Opções > Preferências
Usar o código auxiliar informado na planilha para localizar o produto e atualizar o código do produto no fornecedor indicado.
Atualizar as informações de Última Compra no cadastro do produto/fornecedor
Opções > Preferências
Atualizar a última compra para o fornecedor informado, usando a data da importação e o valor de custo presente no arquivo.
Utilizar o nome do produto para sua localização
Opções > Preferências
Localizar o item pelo nome do produto informado na planilha, ignorando o código do item.
Editar o nome do produto (apenas para produtos que não são grades)
Opções > Preferências
Atualizar o nome do produto no cadastro com o nome informado na planilha, quando a opção estiver marcada.
Revisar os dados importados antes de aplicar as alterações
Opções > Preferências
Exibir a tela de revisão ao final da leitura, permitindo ajustes manuais antes da importação definitiva.
Mostrar colunas inexistentes no arquivo importado
Opções > Preferências
Exibir campos que não existem na planilha para preenchimento manual antes da importação.
Permitir editar valores do arquivo importado
Opções > Preferências
Tornar os campos da planilha editáveis para correções manuais antes de importar os produtos.
Cadastrar grupo, família, marca, categoria e característica
Opções > Preferências
Criar automaticamente registros auxiliares inexistentes com base nos nomes informados na planilha.
Fornecedor
Opções > Preferências
Definir o fornecedor padrão quando ele não estiver informado na planilha; obrigatório para regras vinculadas a código do produto no fornecedor, código auxiliar e última compra.
Tipo de código auxiliar
Opções > Preferências
Definir o tipo de código usado para localizar, cadastrar ou atualizar o código auxiliar como código do produto.
Unidade Padrão
Opções > Preferências
Definir a unidade vinculada aos novos produtos quando a planilha não trouxer essa informação.
Modelo de dados fiscais
Opções > Preferências
Aplicar um modelo fiscal aos novos produtos importados do Excel® que ainda não existem no cadastro.
Padrão de dados
Opções > Padrão de dados
Definir como o Shop converterá valores da planilha, como “F” para False, para o tipo correto do campo.
Cadastro e Atualização
Use esta etapa para incluir novos produtos, atualizar produtos existentes ou executar apenas a atualização de cadastros já localizados no Shop.
Cadastrar novo produto e atualizar produto existente
Clique na aba Produtos e Serviços, na tela principal do Shop.
Acesse Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel.
Marque Cadastrar novo produto e atualizar produto existente e clique em Próximo.
Informe o arquivo que será importado para atualização da base de dados.
Se a planilha foi alterada após a seleção, clique em Ler arquivo e confirme a nova leitura.
Clique no ícone […^] para relacionar os dados da planilha com os campos do sistema.
📸 Relacionamento dos campos da planilha: confira a tela usada para vincular as colunas do arquivo aos campos do Shop antes de avançar.
Habilite Localizar pelo iddetalhe, quando esse campo estiver presente na planilha.
Atenção ao iddetalhe: o iddetalhe é um campo interno de identificação do sistema. Se ele estiver vazio para determinado produto, o Shop tentará localizar o item pelo código, quando existir.
Clique em Próximo.
Revise as abas Produtos localizados e Produtos não localizados.
Clique em Importar.
Clique em OK para visualizar a relação dos itens cadastrados pela importação da planilha.
Atualizar produto existente
Clique na aba Produtos e Serviços, na tela principal do Shop.
Acesse Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel.
Marque Atualizar produto existente.
Informe o arquivo que será importado para atualização da base de dados.
Se a planilha foi alterada após a seleção, clique em Ler arquivo e confirme a nova leitura.
Clique no ícone […^] para relacionar os dados da planilha com os campos do sistema.
📸 Atualização de produtos existentes: valide a relação entre colunas e campos antes de aplicar alterações em preço de venda, custo, impostos, grupo, família, códigos, fornecedor e demais dados técnicos.
Habilite Localizar pelo iddetalhe, quando esse campo estiver presente na planilha.
Atenção ao iddetalhe: mantenha o campo iddetalhe identificado na planilha para aumentar a precisão da localização. Se estiver vazio, o sistema tentará localizar pelo código, quando houver.
Clique em Próximo.
Revise os produtos localizados e os produtos não localizados.
Clique em Importar.
Clique em OK para visualizar a relação dos itens atualizados pela importação da planilha.
Validação de CST: durante a importação, o sistema valida automaticamente o CST de PIS/COFINS informado na planilha. Caso o valor seja inválido, o Shop importará o campo com o CST 99 para manter a integridade dos dados fiscais.
Log da importação
Para salvar o log de registros das ocorrências da Importação de Produtos por Planilha Excel, siga os passos:
Clique em Log.
Clique em Salvar Log.
Confirme que deseja salvar o log de importação.
O arquivo .txt será salvo em C:\Program Files (x86)\Alterdata\Shop.
Feche ou retorne para a tela anterior.
📋 Detalhamento de Campos - Cadastro e Atualização
Campo
Onde fica no sistema
Objetivo
Cadastrar novo produto e atualizar produto existente
Tela inicial da Importação de Produtos por Planilha Excel
Incluir produtos inexistentes e atualizar produtos já cadastrados com base na planilha.
Atualizar produto existente
Tela inicial da Importação de Produtos por Planilha Excel
Alterar apenas produtos já existentes no cadastro, preservando o controle da base atual.
Arquivo de importação
Etapa de seleção/leitura do arquivo
Indicar a planilha Excel® que será lida para atualizar a base de dados.
Ler arquivo
Etapa de seleção/leitura do arquivo
Reprocessar a planilha quando o arquivo selecionado tiver sido atualizado.
Ícone […^]
Etapa de relacionamento de campos
Relacionar os dados da planilha com os campos correspondentes do Shop.
CST de Entrada PIS/Cofins
Relacionamento de campos
Definir o Código de Situação Tributária específico para operações de entrada, separado do CST de saída.
CST de Saída PIS/Cofins
Relacionamento de campos
Definir o Código de Situação Tributária específico para operações de saída, permitindo configurações fiscais distintas.
Localizar pelo iddetalhe
Etapa de relacionamento/localização de produtos
Localizar produtos pelo identificador interno iddetalhe, quando informado no arquivo.
Produtos localizados
Tela de revisão após a leitura da planilha
Listar os produtos encontrados no cadastro para conferência antes da importação.
Produtos não localizados
Tela de revisão após a leitura da planilha
Listar os produtos não encontrados, permitindo análise antes de cadastrar ou ajustar dados.
Importar
Etapa final da importação
Aplicar as inclusões e atualizações revisadas na base do Shop.
Log
Resultado da importação
Registrar ocorrências do processo e permitir salvar evidências da importação.
Gerenciamento de Cenários
Os cenários permitem reutilizar configurações de importação, reduzindo tempo operacional e padronizando processos recorrentes no Shop.
Clique na aba Produtos e Serviços, na tela principal do Shop.
Acesse Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel.
Clique na opção de Seleção de cenários.
Acesso à Seleção de cenários: use o ícone disponível na tela da importação para carregar, salvar, localizar, renomear ou apagar cenários.
Carregar Cenário
Selecione o cenário que deseja aplicar na tela.
Dê duplo clique ou clique no botão de carregar/aplicar cenário.
Para remover o cenário aplicado, clique no botão de remoção correspondente.
Salvar Cenário
Salvar Cenário Atual
Clique em Salvar Cenário Atual.
Digite um nome amigável para o cenário.
Clique em OK para salvar.
Salvar em Diretório
Selecione o diretório em que o cenário será salvo.
Digite um nome amigável para o cenário.
Clique na opção de salvar em diretório.
Renomear Cenário Selecionado
Selecione o cenário.
Selecione a opção de renomear.
Digite um nome amigável para o cenário.
Clique em OK para salvar.
Localizar Cenário
Clique na opção de localizar cenário.
Localize e selecione o cenário desejado.
Clique em Abrir.
Informe um nome para o cenário localizado.
Use uma descrição intuitiva para facilitar a escolha do cenário ideal para a análise, especialmente em rotinas com personalização de Auditoria.
Clique em OK.
Apagar Cenário
Selecione o cenário a ser excluído.
Clique na opção de apagar cenário.
Considere que cenários pré-definidos pela Alterdata não podem ser excluídos.
Confirme a exclusão.
Feche a Seleção de cenários.
📋 Detalhamento de Campos - Gerenciamento de Cenários
Campo
Onde fica no sistema
Objetivo
Seleção de cenários
Importação de Produtos por Planilha Excel
Acessar os recursos de manutenção de cenários do módulo.
Carregar Cenário
Seleção de cenários
Aplicar uma configuração salva à tela de importação.
Salvar Cenário Atual
Seleção de cenários > Salvar Cenário
Salvar a configuração atual com um nome amigável para reutilização.
Salvar em Diretório
Seleção de cenários > Salvar Cenário
Exportar o cenário para um diretório escolhido pelo usuário.
Renomear Cenário Selecionado
Seleção de cenários > Salvar Cenário
Alterar o nome de um cenário já salvo para melhorar sua identificação.
Localizar Cenário
Seleção de cenários
Importar para o módulo um cenário salvo no computador.
Apagar Cenário
Seleção de cenários
Excluir cenários criados pelo usuário que não são mais necessários.
Cenários pré-definidos pela Alterdata
Seleção de cenários
Disponibilizar configurações padrão que não podem ser excluídas.
Detalhamento de Campos
Consulte os quadros expansíveis logo após cada seção do passo a passo para entender o objetivo de cada campo, onde ele fica no Shop e como contribui para uma importação mais segura.
Avaliar Recurso
Clique na aba Produtos e Serviços, na tela principal do Shop.
Acesse Produtos e Serviços > Reajuste de Preços > Importação de Produtos por Planilha Excel.
Clique em Avaliar recurso.
Informe os dados da sua avaliação do Gerenciador de Listas.
Informação: para mais detalhes sobre esta avaliação, consulte o tópico Feedback.
Aviso de Ecossistema: as operações realizadas neste módulo geram registros automáticos na Auditoria do Shop. O processo foi otimizado para garantir que o volume de dados importados não impacte a performance das consultas de rastreabilidade do sistema.
