Smart Importacao Ativos

Importação de Novo Ativo (121 - Ativo)

Este recurso orienta o cadastro em massa de novos ativos por meio de um smart, reduzindo digitação manual e padronizando o preenchimento das informações. Na prática, o processo acontece em duas telas: primeiro o smart é disponibilizado no recurso 1947 - Smart Component; depois ele é executado no 1957 - Iniciar Smart Component, onde o usuário gera a planilha modelo, preenche os dados e envia a planilha para importação. Ao final, o sistema devolve a própria planilha com uma coluna Status, indicando linha a linha o que foi importado com sucesso e o que precisa ser corrigido. Isso ajuda a acelerar o cadastro, evitar retrabalho e dar visibilidade rápida sobre erros de preenchimento.

Objetivo

A finalidade deste smart é permitir a importação de novos ativos do recurso 121 - Ativo de forma estruturada, especialmente quando há muitos cadastros para criar. Ele é útil para usuários operacionais que executam cargas de dados, analistas que validam consistência cadastral e gestores que precisam garantir rapidez e padronização no início de operação de equipamentos e demais ativos. O uso da planilha modelo ajuda a reduzir erros de cadastro, porque o sistema valida campos obrigatórios, formatos e vínculos com outros cadastros antes de concluir cada linha.

Pré-requisitos

• Ter acesso aos recursos 1947 - Smart Component, 1957 - Iniciar Smart Component e ao recurso 121 - Ativo.
• O smart Importação de Ativos deve estar previamente importado/disponibilizado no 1947 - Smart Component. Sem isso, ele não poderá ser iniciado no fluxo operacional.
• É necessário gerar a planilha modelo no 1957 - Iniciar Smart Component antes de preencher os dados, para garantir que o layout usado seja exatamente o esperado pelo sistema.
• Os cadastros relacionados já devem existir quando forem informados na planilha, como empresa, empresa proprietária, tipo de ativo, fabricante, veículo, localização, medida de consumo, bem, produtos combustíveis e tipos de ponto de controle.
• Quando forem informados centro de custo, conta contábil ou conta gerencial, eles devem atender às regras do sistema, especialmente quanto ao uso de registros do tipo analítico. No caso da conta gerencial, além de analítica, ela também precisa estar ativa.
• Se houver configuração de máscara para o código do ativo na empresa, o campo CODIGO deve seguir essa regra; caso contrário, a linha será rejeitada.
• Os campos obrigatórios mínimos para criar o ativo são: CODIGO, NOME, ID_EMPRESA, CNPJ_EMPRESA_PROPRIETARIA e ID_TIPO_ATIVO.

Fluxo Principal

1. Acesse o recurso 1947 - Smart Component e importe/disponibilize o smart Importação de Ativos. Essa etapa prepara o componente que será executado depois no fluxo operacional.
2. Acesse o recurso 1957 - Iniciar Smart Component. É nessa tela que o smart é iniciado para uso prático.
3. Solicite a geração da planilha modelo. O sistema gera o arquivo padrão com as colunas esperadas para a importação. Essa etapa é importante porque evita uso de layouts desatualizados ou incompletos.
4. Preencha a planilha com os dados dos novos ativos, respeitando os campos obrigatórios e os identificadores dos cadastros relacionados. Quando houver listas de vínculos, como combustíveis, tipos de ponto de controle ou subativos, informe os IDs separados por ;.
5. Ainda no 1957 - Iniciar Smart Component, importe a planilha preenchida e execute a importação. O sistema processa as linhas uma a uma, o que permite importar registros válidos mesmo quando uma linha específica contém erro.
6. Analise a planilha retornada pelo sistema. Ao final do processamento, a coluna Status mostra 1 para linhas importadas com sucesso e apresenta a mensagem do erro quando houver problema. Isso facilita a correção apenas do que falhou, sem precisar refazer toda a carga.

Orientação para preenchimento de campos

Nome do campo	Objetivo	Orientação de preenchimento
CODIGO	Identificar unicamente o ativo no sistema	Preencha com o código do ativo. É obrigatório e deve respeitar a máscara configurada pela empresa, quando existir. Use esse campo para manter padronização e facilitar buscas futuras.
NOME	Dar clareza sobre qual ativo está sendo cadastrado	Informe o nome do equipamento/ativo de forma objetiva. É obrigatório e deve permitir fácil reconhecimento por operadores, analistas e gestores.
ID_EMPRESA	Definir em qual empresa o ativo será cadastrado	Informe o identificador da empresa. É obrigatório e influencia validações como vínculo de centro de custo.
CNPJ_EMPRESA_PROPRIETARIA	Indicar a empresa proprietária do ativo	Informe o CNPJ da empresa proprietária. É obrigatório. O sistema considera apenas os números para localizar o cadastro correspondente.
ID_TIPO_ATIVO	Classificar o ativo pelo seu tipo	Informe o identificador do tipo de ativo/equipamento. É obrigatório e ajuda a organizar o cadastro e relatórios por categoria.
ATIVO	Definir se o cadastro entra ativo ou inativo	Informe 0 ou 1. Use 1 quando o ativo já deve ficar disponível para uso/cadastro operacional; use 0 quando o ativo ainda não deve entrar em operação.
DATA_COMPRA	Registrar a data de aquisição	Preencha quando essa informação for relevante para histórico, controle patrimonial ou análise de vida útil.
DATA_VENDA	Registrar baixa ou venda do ativo	Use quando o ativo já tiver sido vendido ou baixado. Esse dado é importante para manter o histórico correto.
NUMERO_SERIE	Identificar o ativo fisicamente	Informe o número de série ou chassi, quando aplicável. Ajuda a diferenciar ativos semelhantes e apoiar rastreabilidade.
MODELO	Detalhar a versão/modelo do ativo	Preencha para facilitar manutenção, comparação entre equipamentos e identificação operacional.
ESPECIFICACAO	Registrar detalhes técnicos importantes	Use para complementar informações relevantes do ativo, principalmente quando isso ajuda operação, manutenção ou compras.
QUANTIDADE_CONSUMO	Definir referência de consumo	Informe o valor de referência de consumo quando o ativo exigir esse controle. Isso apoia análises operacionais e comparações de desempenho.
CNPJ_FORNECEDOR	Relacionar o fornecedor do ativo	Informe o CNPJ do fornecedor. O sistema considera apenas os números para localizar o cadastro. Isso ajuda no histórico de aquisição e relacionamento comercial.
ID_FABRICANTE	Associar o fabricante	Informe o identificador do fabricante para melhorar rastreabilidade, manutenção e relatórios por marca.
ID_VEICULO	Vincular o ativo a um veículo, quando aplicável	Preencha apenas quando houver integração com o módulo de veículos/frotas. Isso evita cadastros desconectados entre módulos.
COD_CENTRO_CUSTO	Direcionar o ativo para o centro de custo correto	Informe o código do centro de custo. Se houver pontos ou traços, o sistema trata a busca, mas o centro precisa ser do tipo analítico e vinculado à empresa informada. Isso garante alocação gerencial correta.
COD_CONTA_CONTABIL	Relacionar o ativo à conta contábil correta	Informe a conta contábil do tipo analítica. O sistema também trata códigos com pontuação na busca. Isso ajuda no correto reflexo contábil do cadastro.
COD_CONTA_GERENCIAL	Relacionar o ativo à conta gerencial correta	Informe uma conta gerencial analítica e ativa. Isso é importante para relatórios gerenciais e acompanhamento de custos.
ID_LOCALIZACAO_ATIVO	Informar onde o ativo está fisicamente	Use o identificador da localização do ativo. A localização deve estar ativa. Isso facilita controle operacional e inventário.
ID_MEDIDA_CONSUMO_ATIVO	Definir a unidade de medida do consumo	Informe a medida usada para acompanhar consumo do ativo. Isso padroniza indicadores e comparações.
ID_BEM	Relacionar o ativo ao bem patrimonial	Preencha quando houver vínculo com o módulo patrimonial. O bem informado deve estar ativo. Isso ajuda na integração entre operação e patrimônio.
PRODUTO_COMBUSTIVEIS_IDS (;)	Vincular combustíveis permitidos ao ativo	Informe um ou mais IDs separados por ;. O sistema cria vínculo apenas com produtos ativos. Use quando o ativo consumir combustível e esse controle fizer parte da operação.
TIPO_PONTO_CONTROLE_IDS (;)	Associar pontos de controle ao ativo	Informe um ou mais IDs separados por ;. Se informado, cada item precisa ser válido e ativo. Isso é importante para monitoramento e controles operacionais vinculados ao ativo.
SUB_ATIVOS_IDS (;)	Relacionar ativos filhos ao novo ativo	Informe um ou mais identificadores separados por ;. Use quando o ativo principal precisar agrupar subativos, facilitando a estrutura operacional e o relacionamento pai/filho.
OBSERVACAO	Registrar informação complementar	Use para anotações livres que ajudem a operação, implantação ou futuras consultas. Evite inserir textos que deveriam estar em campos estruturados.

Funcionalidades

• Importação do smart no 1947 - Smart Component: permite disponibilizar o componente necessário para a operação de importação. Sem essa etapa, o fluxo não chega ao uso prático no 1957.
• Geração de planilha modelo no 1957 - Iniciar Smart Component: cria o layout padrão que deve ser usado no preenchimento. Isso reduz risco de colunas incorretas ou ausência de campos esperados.
• Importação linha a linha: o sistema processa cada registro individualmente, permitindo que linhas válidas sejam importadas mesmo quando outras apresentarem erro. Isso evita perda de tempo com reprocessamento total.
• Retorno da planilha com coluna Status: ao final, o usuário recebe a própria planilha com resultado por linha. Quando tudo está correto, a linha recebe 1; quando há falha, o sistema informa o motivo no próprio status.
• Validação de obrigatoriedade: o smart valida se os campos mínimos para criação do ativo foram informados, como código, nome, empresa, empresa proprietária e tipo de ativo. Isso impede cadastros incompletos.
• Validação de padrão do código do ativo: quando a empresa usa máscara para o código, o sistema verifica se o valor digitado segue esse padrão. Isso mantém consistência cadastral.
• Tratamento automático de formatação: para campos como CNPJ, centro de custo e contas, o sistema considera a limpeza de caracteres como pontos e traços para localizar o cadastro correto. Isso ajuda quando a planilha vem de fontes diferentes.
• Vínculo com cadastros relacionados: o smart associa automaticamente empresa, empresa proprietária, tipo de ativo, fabricante, veículo, localização, medida de consumo, bem e outros relacionamentos a partir dos identificadores informados. Isso reduz trabalho manual posterior.
• Vínculo múltiplo por lista separada por ponto e vírgula: combustíveis, tipos de ponto de controle e subativos podem ser informados em lista, o que agiliza cadastros mais completos em uma única carga.
• Validação de cadastros analíticos e ativos: centro de custo, conta contábil e conta gerencial passam por regras de consistência, e alguns vínculos exigem também que o cadastro esteja ativo. Isso melhora a qualidade dos dados e evita erros de uso futuro.

Problemas e Soluções

Problema	Solução
A planilha foi importada, mas a linha retornou erro informando que o código do equipamento é obrigatório.	Preencha o campo CODIGO em todas as linhas e execute novamente a importação. Esse campo é indispensável para identificar o ativo no sistema.
O código foi informado, mas o sistema rejeitou por máscara inválida.	Ajuste o valor do campo CODIGO para o padrão configurado pela empresa. Isso garante que o cadastro siga a regra corporativa de identificação.
A linha retornou erro porque o tipo de ativo não foi informado.	Preencha o campo ID_TIPO_ATIVO com um identificador válido antes de reimportar. Sem essa classificação, o sistema não consegue criar o ativo corretamente.
O nome do ativo ficou em branco e a linha não foi aceita.	Informe o campo NOME com uma descrição clara do ativo. Isso facilita identificação no dia a dia e é uma regra obrigatória.
A empresa proprietária não foi localizada ou não foi informada.	Revise o campo CNPJ_EMPRESA_PROPRIETARIA e confirme se o cadastro existe. Informe o CNPJ correto para que a propriedade do ativo fique registrada adequadamente.
A empresa do cadastro não foi informada.	Preencha ID_EMPRESA com um identificador válido. Esse dado direciona o cadastro do ativo e influencia outras validações, como centro de custo.
O tipo de ponto de controle informado gerou erro.	Revise a lista em TIPO_PONTO_CONTROLE_IDS (;), mantendo apenas identificadores válidos e ativos, separados por ;.
O centro de custo foi informado, mas a linha não importou.	Verifique se o código informado corresponde a um centro de custo analítico e vinculado à empresa indicada na linha. Se necessário, revise o cadastro antes de reimportar.
A conta contábil foi rejeitada.	Confira se a conta informada em COD_CONTA_CONTABIL é do tipo analítica. Se o código vier com pontuação, revise se corresponde ao cadastro correto.
A conta gerencial foi rejeitada.	Confirme se a conta gerencial é analítica e está ativa. Só depois reimporte a linha.

Exemplos de Uso

• Cenário 1 — Operador cadastrando novos equipamentos de uma filial: o operador importa o smart no 1947 - Smart Component, gera a planilha no 1957 - Iniciar Smart Component, preenche três linhas com códigos, nomes, empresa, empresa proprietária e tipos de ativo, e executa a importação. Duas linhas retornam com Status = 1 e uma retorna erro por falta do ID_TIPO_ATIVO. Nesse caso, ele corrige apenas a linha com falha e reprocessa, sem precisar refazer as demais.
• Cenário 2 — Analista estruturando ativos com vínculos completos: o analista preenche dados de localização, centro de custo, conta contábil, conta gerencial, combustíveis permitidos e tipos de ponto de controle. O smart cria os vínculos automaticamente durante a importação, o que evita vários cadastros manuais posteriores e melhora a consistência das informações desde o início.
• Cenário 3 — Gestor acompanhando qualidade da carga: após a execução, o gestor usa a coluna Status para identificar rapidamente quantos registros entraram com sucesso e quais falharam. Isso dá visibilidade imediata sobre a qualidade da base recebida e ajuda a cobrar correções pontuais da equipe.
• Cenário 4 — Cadastro de ativo principal com subativos: ao criar um novo ativo principal, o usuário informa em SUB_ATIVOS_IDS (;) os identificadores dos ativos filhos separados por ;. O sistema monta o relacionamento pai/filho, o que ajuda no controle operacional de estruturas compostas.

Observações Gerais

• Sempre gere uma nova planilha modelo antes de começar uma carga importante. Isso reduz o risco de usar uma versão antiga ou incompleta do layout.
• Preencha primeiro os campos obrigatórios e só depois os complementares. Essa prática acelera a validação inicial e reduz erros básicos de importação.
• Quando usar listas com ;, evite espaços desnecessários e confira se todos os identificadores realmente existem. Isso é especialmente importante em combustíveis, tipos de ponto de controle e subativos.
• Embora o sistema trate alguns formatos com pontuação, como CNPJ e certos códigos, o ideal é revisar previamente a origem dos dados para evitar associações incorretas.
• Se a importação tiver linhas com erro, não descarte toda a planilha. Use a coluna Status para corrigir somente o necessário. Isso torna o processo mais rápido e mais seguro.
• Em campos contábeis e gerenciais, confirme com antecedência se o cadastro é do tipo analítico, pois esse é um ponto comum de rejeição.

Benefícios do Recurso

• Reduz o tempo de cadastro quando há muitos ativos para criar.
• Padroniza o preenchimento por meio de uma planilha modelo única.
• Diminui erros ao validar obrigatoriedade, formato e consistência dos vínculos.
• Permite corrigir apenas linhas com falha, graças ao processamento individual e ao retorno por Status.
• Melhora a integração entre cadastro operacional, estrutura patrimonial e controles gerenciais.
• Dá mais segurança para decisões e acompanhamento, porque os ativos entram já relacionados a empresa, tipo, localização e demais parâmetros importantes.

Glossário de Termos

• Smart — Componente executável do sistema usado para automatizar uma rotina, como a importação em massa de dados.
• Planilha modelo — Arquivo padrão gerado pelo sistema com as colunas corretas para preenchimento da importação.
• Status — Coluna devolvida ao final da importação que informa, em cada linha, se houve sucesso ou qual erro ocorreu.
• Analítico — Tipo de cadastro aceito em determinados campos, como centro de custo e contas, por representar um nível válido para uso operacional/gerencial.
• Subativo — Ativo vinculado como filho de um ativo principal, formando uma relação pai/filho.
• Identificador — Código usado pelo sistema para localizar registros relacionados, como empresa, tipo de ativo, localização e fabricante.

Links Relacionados

• 1947 - Smart Component — recurso usado para importar/disponibilizar o smart.
• 1957 - Iniciar Smart Component — recurso usado para gerar a planilha modelo, importar a planilha preenchida e executar o processamento.
• 121 - Ativo — recurso de destino do cadastro dos novos ativos importados.
• Cadastros de apoio — empresa, empresa proprietária, tipo de ativo, fabricante, veículo, localização do ativo, medida de consumo, bem, centro de custo, conta contábil, conta gerencial, produtos combustíveis e tipos de ponto de controle.