Importacao de Produtos por Excel - Shop | erp4me.shop

Importação de Produtos por Planilha Excel

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.

Unknown Attachment

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.

Unknown Attachment

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.