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 a bancos | Planilha XLS, XLSX e .zip | Para atualizar movimentações da tela de Caixas e bancos. |
Contas a pagar e a 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.
Na tela de registros, clique em "Importar arquivo". Deste modo, você será redirecionado à tela de importação, a qual é dividida em 3 etapas:
- Seleção de modelo
- Carregamento de arquivo
- Validação de envio
1. Seleção de modelo
Nesta etapa, é necessário selecionar um dos modelos disponibilizados pela Eccosys. Veja o exemplo abaixo:
Ao fazer isso, será possível baixar uma planilha modelo e visualizar as instruções específicas para importar cada tipo de arquivo.
Após selecionar o modelo desejado, clique no botão "Avançar", no canto inferior direito da tela.
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. |
2. Carregamento do arquivo
Preencha as informações desejadas na planilha ou prepare os arquivos de imagem para importação.
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 na área para localizar o arquivo em seu computador. Caso o arquivo tenha o formato esperado e não exceda o limite, você poderá avançar para a próxima etapa.
Importando produtos
Caso deseje editar registros do tipo Produto, é possível utilizar uma planilha com os dados já cadastrados em sua base. Para isso, acesse Cadastros > Produtos e, no botão "Ações, clique em "Exportar dados para planilha".

Importando imagens
No caso das imagens, siga as orientações informadas na primeira etapa (seleção de modelo) para nomear os arquivos corretamente.
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 (linhas na planilha) 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 (nome) 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.

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.
4. Situação e ações das planilhas
Cada arquivo enviado será exibido na listagem de importações com sua respectiva situação:
- Na fila: Esta 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.


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ível no menu de contexto das importações, permite verificar a situação de cada registro ou linha da planilha.
- Iniciada: Indica a data e hora de início da importação do arquivo;
- Importada: Indica que o registro foi importado com sucesso;
- Não importada: Indica que não foi possível importar o registro;
- Finalizada: Indica a data e hora de fim da importação do arquivo.
Limites da importação
O limite de tamanho para importação de arquivos varia conforme o plano contratado.
Plano | Quantidade de registros (número de linhas) | Tamanho máximo |
Básico | 1.000 | 2 MB |
Avançado | 2.000 | 4 MB |
Master | 5.000 | 8 MB |
Pro | 10.000 | 15 MB |
Legado | Consultar setor Comercial | 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.