Importação de planilhas e imagens

A importação de arquivos no ERP oferece uma maneira eficiente e segura de gerenciar cadastros e atualizações em massa, como produtos, contatos e outros registros, utilizando modelos de planilhas fornecidos pela Eccosys. 

Além disso, é possível enviar arquivos com imagens de produtos de forma ágil e prática. A novidade é que, agora, você pode realizar outros processos no sistema enquanto a importação acontece, sem a necessidade de manter a página aberta. A importação será concluída normalmente, garantindo mais flexibilidade e produtividade.

Neste manual, você aprenderá:

  • Quais arquivos podem ser importados no Eccosys

  • Como importar planilhas e imagens

  • Situações e ações das Planilha

  • Detalhes da importação

  • Limites de Importação

Quais arquivos podem ser importados no Eccosys

Atualmente, o Eccosys permite importar os seguintes tipos de registro:


Tipo de registro

Formato

Descrição

Produtos

Planilha XLS, XLSX, e .zip

Para editar produtos existentes em seu ambiente ou cadastrar novos produtos.

Planilha de imagens

Planilha XLS, XLSX, e .zip

Para adicionar links (URLs) de imagens aos cadastros dos produtos existentes.

Clientes e fornecedores

Planilha XLS, XLSX, e .zip

Para cadastrar ou editar contatos do tipo Cliente e/ou Fornecedor.

.zip com imagens

Arquivos de imagem .png ou .jpeg compactados em um arquivo .zip

Para importar arquivos de imagens em lote para o cadastro de produtos.

Caixas e bancos

Planilha XLS, XLSX, e .zip

Para atualizar movimentações da tela de Caixas e bancos.

Contas a Pagar / Receber

Planilha XLS, XLSX, e .zip

Para incluir, editar, baixar ou excluir contas a pagar ou a receber.

Receitas de itens produzidos

Planilha XLS, XLSX, e .zip

Para cadastrar os insumos de um ou mais produtos produzidos.

Localizações de produto

Planilha XLS, XLSX, e .zip

Para cadastrar localizações de um ou mais produtos no formato Corredor-Coluna-Nível.

Vincular pais e filhos

Planilha XLS, XLSX, e .zip

Para associar produtos pai e SKUs a partir do código dos produtos.

Como importar planilhas e imagens

Para importar uma planilha ou arquivo .zip com imagens, acesse Configurações > Outros > Importação de planilha e imagens.

Você será redirecionado à tela de importação, a qual é dividida em 3 etapas;

  1. Seleção de modelo

  2. Carregamento de arquivo

  3. Validação e envio

1. Seleção de modelo

Nesta etapa, é necessário selecionar um dos modelos disponibilizados pela Eccosys. Ao fazer isso, será possível baixar uma planilha modelo e visualizar as instruções específicas para importar cada tipo de registro.


Modelo

Nome do arquivo modelo (sugestão)

Instruções para importação

Produtos

produtos.xls

Ao preparar o arquivo, inclua somente as colunas que deseja atualizar. Colunas enviadas sem nenhum valor (em branco) apagarão as informações previamente cadastradas no Eccosys.


Para atualizar atributos da ficha técnica, certifique-se de incluir TODOS os atributos existentes. Os atributos não informados terão seus valores apagados.

Planilha de imagens

imagens.xls

Colunas obrigatórias: Id ou Codigo Sku, Nome Imagem, URL Imagem.

Coluna opcional: Label.


Ao preparar o arquivo, inclua somente as colunas que deseja atualizar. Colunas enviadas sem nenhum valor (em branco) apagarão as informações previamente cadastradas no Eccosys.

Clientes e fornecedores

contatos.xls

Ao preparar o arquivo, inclua somente as colunas que deseja atualizar. Colunas enviadas sem nenhum valor (em branco) apagarão as informações previamente cadastradas no Eccosys.

.zip com imagens

-

Para o nome das imagens, utilize o modelo:

Código do produto _ nome do produto.jpg (Ex.: 998234_Cama Verde.jpg).


Caso possua mais de uma imagem, utilize o seguinte formato: "998234_A Cama Verde.jpg998234_B Cama Verde.jpg."


Para definir o grupo de imagens, utilize o ID do grupo como nome do arquivo .zip. O ID está disponível no cadastro de grupos de imagens. O label da imagem ficará vazio.

Caixas a bancos

caixa_bancos.xls

Certifique-se de enviar todas as colunas em ordem, caso contrário a importação não será bem-sucedida.

Contas a Pagar / Receber

contas.xls

Certifique-se de enviar todas as colunas em ordem, caso contrário a importação não será bem-sucedida.

Receitas de itens produzidos

receitas.xls

Certifique-se de enviar todas as colunas em ordem, caso contrário a importação não será bem sucedida.

Localizações de produto

localizacoes.xls

Deve conter as colunas Código, Depósito, Localização, Quantidade e Preço Custo (seguir mesma ordem).


A coluna Localização, deve conter o Corredor, a Coluna e o Nível, separados por hífen.


Exemplo: CORR1-COL1-NIV1.


O Código deve ser exatamente o do cadastro do produto.


Na etapa de validação do arquivo, é possível definir se a planilha deve gerar apenas os lançamentos de Entrada informados na planilha (padrão) ou incluir lançamentos do tipo Balanço antes de cada entrada (opção "Incluir balanço igual a zero antes da entrada nos depósitos informados"). Neste segundo caso, será lançado um balanço com quantidade 0 e, na sequência, a entrada com a quantidade informada na planilha.

Vincular pais e filhos

vinculos.xls

Certifique-se de enviar todas as colunas em ordem, caso contrário a importação não será bem sucedida.


Os arquivos a serem importados podem ser nos formatos .zip, XLS e XLSX.

Após selecionar o modelo desejado, clique no botão "Avançar", no canto inferior direito da tela.

2. Carregamento do arquivo

Com a planilha modelo, preencha ou edite as informações desejadas e salve o arquivo.

Caso deseje, também é possível atualizar produtos já registrados em sua base. Para isso, acesse Cadastros > Produtos e, no botão "Ações", clique em "Exportar dados para planilha".

Remova todos os filtros ou colunas com destaques em cores, pois estes podem interferir na importação.


Imagens

No caso das imagens, siga as orientações informadas na primeira etapa, onde será selecionado o modelo do arquivo;

O arquivo .xls ou o conjunto de imagens devem ser compactados em um arquivo .zip.

Na etapa "Carregamento do arquivo" você poderá arrastar o arquivo desejado para a área de upload, ou clicar nesta área para localizar o arquivo em seu computador. Caso o arquivo tenha o formato esperado e não exceda o limite conforme seu plano, você poderá avançar para a próxima etapa.

3. Validação do arquivo

Na terceira etapa, o Eccosys irá validar as colunas da planilha importada em relação ao modelo esperado.

Um resumo com o total de registros será exibido na tela, separando os registros a atualizar dos novos. Esta distinção é feita com base na coluna ID, sendo que:

  • Registros com valor informado na coluna ID serão considerados "a atualizar", independentemente de este ID ser válido.

  • Registros sem valor informado na coluna ID serão considerados "novos" e serão criados ao importar a planilha na etapa seguinte.



As colunas informadas de acordo com o modelo serão listadas com a observação "Validação".

As colunas destacadas em amarelo trarão a observação "Colunas com valores vazios ou nulos". Esta observação não inviabiliza a importação, mas indica que um ou mais registros da planilha não possuem um valor válido para esta coluna.

Se necessário, revise a planilha original.



Se houver alguma coluna destacada em vermelho, não será possível avançar para a próxima etapa. Isto porque a coluna em questão não foi encontrada no modelo. Neste caso, você terá que revisar a planilha original, identificando qualquer inconsistência entre as colunas informadas e o modelo esperado pelo Eccosys.

Após revisar a planilha,  volte à etapa 2 para enviar o arquivo novamente. 

Caso a planilha passe na etapa de validação, clique em "Importar planilha" para realizar a importação dos registros.

Uma mensagem de sucesso será exibida caso a importação seja concluída sem erros.

Situações e ações das Planilha

Ao importar a planilha, o Eccosys irá apresentar os arquivos registrados  por diferentes situações:


  • Na fila: Está situação identifica os arquivos que estão aguardando processamento. O processamento será iniciado após 1min e 30seg de sua importação.

  • Processando: Identifica os arquivos que estão sendo carregados apresentando a porcentagem do carregamento em tela.
    Caso o processamento dure mais de 10:00h o carregamento será interrompido.

  • Interrompido: Indica que a importação do registro foi interrompida, processando apenas uma parte do arquivo, sem possibilidade de retomar o processo a partir desse ponto.

  • Concluída: Identifica que o arquivo já foi processado.

  • Concluída com erro: Indica que o arquivo foi concluído, porém alguns registros apresentaram erros e não foram importados.

  • Erro: Arquivo não importado.

Atenção!

Importações interrompidas não podem ser retomadas, caso necessário re-importe o arquivo.

Cada situação oferece ações disponíveis aos usuários, acessíveis pelo menu de contexto:

Na fila:

  • Baixar planilha: Permite extrair a planilha de Origem importada.

  • Interromper Importação: Permite suspender a importação.


Processando:

  • Ver detalhes: Demonstra o histórico da importação possibilitando consultar pelo código do produto ou ID do contato (cliente / fornecedor).

  • Baixar planilha: Permite extrair a planilha de Origem importada.

  • Interromper Importação: Permite suspender a importação.


Interrompido, Concluído e Concluído com erros:

  • Ver detalhes: Demonstra o histórico da importação possibilitando consultar pelo código do produto ou ID do contato (cliente / fornecedor).

  • Baixar Planilha: Permite extrair a planilha de Origem importada.

Erros:

  • Ver detalhes: Demonstra o histórico da importação.

Detalhes da Importação

A ação “Ver detalhes” disponíveis no menu de contexto das importações permite ao usuário a identificação detalhada por registro.

  • Iniciado: Indica data/hora que iniciou a importação do arquivo.

  • Importada: Identifica que o registro foi importado.

  • Não importada: Identifica que o registro não foi importado.

  • Finalizada: Indica data/hora que finalizou a importação do arquivo.

Limites de Importação

O limite de tamanho para importação de arquivos varia conforme o plano contratado. 

  • Básico: 1000 registros (linhas) ou 2 mega

  • Avançado: 2000 registros ou 4 mega

  • Master: 5000 registros ou 8 mega

  • Pro: 10000 registros ou 15 mega

  • Legado: Consultar setor comercial

Conclusão

A tela "Importação de planilhas e imagens" oferece todos os modelos e orientações necessárias para manter sua base de dados atualizada.

Ao seguir as etapas na sequência correta e realizar os ajustes recomendados durante a validação, você garante uma atualização mais eficiente, reduzindo a possibilidade de erros ou comportamentos inesperados.

Em caso de dúvidas, nosso time de suporte está à disposição para auxiliar.


Atualizado em 25/07/2025
Este artigo foi útil?  
Agradecemos sua avaliação.