1. Campos disponíveis no arquivo 
Ao abrir o template de importação, o usuário deve preencher os campos conforme sua necessidade. O arquivo disponibiliza as seguintes colunas para preenchimento:

OBS: Os campos sinalizados com (*) são obrigatórios: 

Coluna A - Código auxiliar do insumo* (Obrigatório): É o código de referência do insumo, aceita números e letras, eles deverão ser únicos; 

Atenção! Este campo não deve ter mais de 25 caracteres; 

Coluna B - Descrição do insumo (Opcional): Refere-se à descrição, ao nome do insumo utilizado para inserção de detalhes; 

Atenção! Coluna informativa para facilitar a montagem do arquivo de importação;

Coluna C - Código do detalhe* (Obrigatório apenas para atualização): Campo utilizado para identificar se a importação irá criar um novo detalhe ou atualizar um detalhe já existente.

• Para criar um novo detalhe: deixe a coluna vazia. O sistema entenderá que se trata de um novo registro e realizará a inclusão do detalhe no insumo informado.
• Para atualizar um detalhe existente: informe o ‘’Código do Detalhe’’ já cadastrado no sistema. O sistema localizará o registro correspondente e atualizará apenas os campos preenchidos no arquivo. 

Atenção!

• Campos deixados em branco não sobrescrevem informações já existentes no sistema.
• Mesmo em atualizações, permanecem obrigatórios o preenchimento das colunas Código do Insumo, Descrição do Detalhe e Código do Detalhe.
• No mesmo arquivo podem existir linhas de inclusão e atualização. Neste caso, o sistema processará primeiro as atualizações e depois as inclusões, evitando duplicidades no lote de importação.

Coluna D - Código auxiliar do detalhe* (Obirgatório): É o código de referência do detalhe, que será gravado no detalhe para utilização posterior em importações de composições e atualizações de preços por importação; 

Atenção! Este campo não deve ter mais de 25 caracteres e para atualizar o preço do detalhe é necessário que os códigos auxiliares do detalhe estejam previamente cadastrados e o detalhe deve estar na aba Preço do insumo; 

Coluna E - Descrição do detalhe* (Obrigatório): Refere-se à descrição, ao nome que daremos ao detalhe;

Atenção! Este campo não deve ter mais de 4000 caracteres;

Coluna  F - Produto fiscal (Opcional): É o código de referência do produto fiscal que será vinculado ao detalhe.

Atenção! O cadastro de produtos fiscais se encontra no menu Apoio > Produtos/Serviços > Produtos/Serviços Fiscais.

2. Selecione a tabela e o Tipo de Importação
Após finalizar o arquivo, retorne à tela de importação e selecione a tabela de custos unitários que receberá as informações. A tabela deve ter sido criada anteriormente e pode ser localizada pelo código ou pela descrição.

Atenção! A importação é incremental, ou seja, os registros já existentes serão mantidos e apenas novos registros serão adicionados ou atualizados.
   

 3. Inclua o arquivo
Clique no botão “Incluir Arquivo” e selecione o .CSV preenchido. O arquivo deverá aparecer anexado na tela.

4. Confirme a importação
Clique em Importar.

Será exibida uma modal de confirmação.

Digite:

• “concordo”
• e clique em Confirmar. 

5. Aguarde o processamento e verifique o resultado
Após confirmar:

• aguarde o carregamento da importação;
• não feche nem atualize a tela durante o processamento.

   
Ao final do processamento será exibida uma mensagem de sucesso ou uma mensagem de erro de importação.

6. Caso existam erros:

• A importação ocorre parcialmente. As linhas que não tiverem inconsistências são importadas com sucesso; 
• Será disponibilizado um arquivo .CSV com uma coluna adicional chamada [Erros]. 

Como corrigir erros de importação:

• Baixe o arquivo de erros;
• Corrija as informações indicadas na coluna [Erros];
• Salve novamente o arquivo;
• Realize uma nova importação. 

7. Regras de validação para uma importação bem sucedida  

Para garantir a consistência das informações, o sistema realiza algumas validações durante o processo de importação. Caso algum item não atenda aos critérios abaixo, será exibida uma mensagem de erro clara, seguindo o padrão das demais etapas do fluxo e sempre identificando o código da obra. 

Confira as validações aplicadas: 

• Existência do insumo na obra: Verifica se o insumo informado está cadastrado na obra selecionada. 
• Existência do detalhe na obra: Confirma se o detalhe associado ao insumo também existe na mesma obra. 
• Situação do insumo (ativo/inativo): Garante que o insumo esteja ativo para permitir seu uso. 
• Existência do produto fiscal: Valida se o produto fiscal informado está cadastrado no sistema. 
• Situação do produto fiscal (ativo/inativo): Verifica se o produto fiscal está ativo e disponível para uso. 
• Situação da obra: Confirma se a obra está aberta para edição. Obras encerradas ou com orçamento fechado não permitem alterações, não aceitam inclusão ou edição de insumos. 

Atenção! Caso utilize o próprio arquivo de erros para uma nova importação remova linhas em branco abaixo dos registros para garantir que não existam caracteres ocultos na planilha.

8. Como faço atualizações para as obras dos detalhes de insumo? 

Para incluir as atualizações de detalhes de insumos nas obras, é necessário selecionar a flag “Atualizar os detalhes nas obras selecionadas”, além de indicar as obras que devem receber a atualização. 

Ao considerar as obras para atualização, apenas os detalhes que já existem para o insumo em cada obra serão atualizados, desde que o “código de detalhe” (coluna C do template de importação) também seja informado. 

 

Esperamos que este artigo tenha ajudado!