Importação de dados

Tela t4-hu004-02, no hub Ferramentas.

Para que serve

Aqui se carregam dados no ERP a partir de uma planilha do Excel, sem digitar item por item. Todas as importações disponíveis ficam nesta mesma tela: o operador escolhe o modelo, baixa a planilha modelo, preenche, envia e confere o resultado antes de gravar.

A importação é tudo ou nada. Se uma única linha tiver pendência, nada é gravado.

Hoje há uma importação disponível: Inventário de estoque (modelo INV.IMPORT.XLSX.0001).

Quem acessa

Quem tem a tela liberada no template de acesso a telas do seu usuário. Sem essa liberação, Importação de dados não aparece em Ferramentas.

Todos os modelos de importação aparecem para quem acessa a tela. Ainda não há liberação por modelo.

Como chegar

Abra Ferramentas.
Escolha Importação de dados.

Voltar no cabeçalho retorna ao hub Ferramentas.

Como a tela funciona

A tela tem quatro passos, mostrados no topo: Tipo, Parâmetros, Planilha e Conferência. Use os botões ao pé de cada passo para avançar ou voltar. O botão Importar só fica disponível no último passo, depois que a conferência não encontrar pendência.

A planilha modelo

Cada importação tem a sua planilha modelo. Baixe sempre o modelo pela própria tela e preencha sobre ele.

Linha	Conteúdo
1	Aviso para não alterar as linhas de 1 a 5
2	Código do modelo, por exemplo `INV.IMPORT.XLSX.0001`
3	Reservada
4	Identificação interna de cada coluna, usada pelo ERP para reconhecer a planilha
5	Nome de cada coluna
6 em diante	Dados, uma linha por registro

As linhas 1 a 5 e a ordem das colunas são fixas. Não insira, apague nem mova colunas. As duas primeiras colunas são sempre as mesmas:

Coluna	Nome	O que informar
A	Ação	O que fazer com a linha: `I` para inclusão ou `A` para alteração. Cada modelo diz quais ações aceita.
B	Resposta	Deixe em branco. O ERP preenche esta coluna na planilha de retorno. O que for digitado aqui é ignorado.

As colunas seguintes são as do modelo escolhido. O modelo traz também a aba Instruções, com a explicação de cada coluna.

Regras do arquivo:

Só o formato XLSX (Excel 2007 ou superior).
Até 10 MB e até 5.000 linhas com dados.
Só a primeira aba é lida.
Linhas totalmente vazias são ignoradas.

Passo 1: Tipo

Os modelos disponíveis aparecem em cartões, com o módulo, o código do modelo, o nome e a descrição. Nenhum vem selecionado.
Para localizar um modelo, digite na pesquisa parte do módulo, do nome, do código ou da descrição. Se nada corresponder, aparece Nenhuma importação encontrada para a pesquisa.
Clique no cartão do modelo. O cartão fica destacado.
Abaixo aparece a seção Colunas da planilha, com o código do modelo e uma tabela com a letra de cada coluna, o nome, se é obrigatória, a descrição e um exemplo. Quando o modelo tem documentação própria, aparece o link Documentação do modelo.
Clique em Baixar modelo para obter a planilha modelo. O arquivo vem com o nome do código do modelo, por exemplo INV.IMPORT.XLSX.0001.xlsx.

Sem escolher um modelo não é possível avançar. A mensagem é Escolha o tipo de importação.

Trocar de modelo descarta a conferência feita antes.

Passo 2: Parâmetros

Aqui se informam os dados comuns a todas as linhas da planilha, para não repetir em cada linha. Os campos mudam conforme o modelo escolhido. Veja os do inventário em Inventário de estoque.

Passo 3: Planilha

Em Planilha, arraste o arquivo ou clique para selecioná-lo.
Avance. Ao sair deste passo, o ERP lê e confere a planilha inteira.

Antes de olhar as linhas, o ERP verifica se a planilha é do modelo escolhido e se a linha 4 está intacta. Se não estiver, a planilha é recusada por inteiro e a tela continua neste passo. Veja as mensagens em O que a tela bloqueia.

Trocar o arquivo descarta a conferência feita antes.

Passo 4: Conferência

A conferência mostra três totais:

Total	O que significa
Linhas lidas	Linhas com algum dado a partir da linha 6
Prontas para importar	Linhas sem pendência
Pendências	Quantidade de problemas encontrados. Uma linha pode ter mais de um.

Quando há pendências, a tela mostra uma lista com a linha da planilha, a coluna e a descrição de cada problema. Aparecem até 200 pendências; se houver mais, a tela avisa quantas existem no total. O botão Importar fica bloqueado.

Quando não há pendências, a tela mostra uma prévia das primeiras 20 linhas, já com os valores como serão gravados. Confira e clique em Importar.

Planilha de retorno

Em ambos os casos aparece Baixar planilha de retorno. Ela é uma cópia da planilha enviada com a coluna Resposta preenchida em cada linha:

OK, em verde, quando a linha está correta.
ERRO;Coluna;Descrição, em vermelho, para cada problema da linha. Quando há mais de um, eles aparecem um abaixo do outro na mesma célula.

O arquivo vem com o nome do código do modelo seguido de -retorno, por exemplo INV.IMPORT.XLSX.0001-retorno.xlsx.

Para corrigir:

Baixe a planilha de retorno.
Corrija as linhas marcadas com ERRO. Não é preciso apagar a coluna Resposta: ela é ignorada no reenvio.
Volte ao passo Planilha, envie o arquivo corrigido e avance de novo.

A planilha de retorno fica disponível por 24 horas. Depois disso, a tela avisa A planilha de retorno expirou. Envie a planilha novamente.

Quando o problema não é de uma linha (por exemplo, um parâmetro da tela inválido), não há planilha de retorno para baixar.

Importar

No passo Conferência, sem pendências, clique em Importar.
O ERP confere a planilha mais uma vez e grava todas as linhas de uma só vez.
A mensagem Importação concluída aparece com o resultado e permanece até ser fechada. A tela volta ao início, pronta para outra importação.

Se acontecer uma falha durante a gravação, nada é gravado. A mensagem é Não foi possível concluir a importação. Nada foi gravado.

Inventário de estoque

Modelo INV.IMPORT.XLSX.0001, do módulo Estoque. Cada planilha inclui um inventário novo, do tipo Contagem de estoque, em digitação. A importação não altera inventário que já existe.

O inventário é gravado com a observação Inventário de contagem de estoque incluído através de importação. Todos os itens entram na sessão padrão do inventário, na localização geral da filial e no lote geral de cada produto.

Parâmetros

Campo	Obrigatório	O que informar
Filial	Sim	Filial em que o inventário será incluído. Só aparecem as filiais liberadas para o seu usuário. Vem preenchida com a unidade em que você está logado, quando ela está liberada.
Responsável	Sim	Funcionário que supervisionou a contagem. Digite ao menos 2 letras do nome ou o documento para localizar. Precisa ser uma pessoa ativa cadastrada como Funcionário. Também fica registrado como quem confirmou as quantidades.

Colunas

Coluna	Nome	Obrigatória	O que informar
A	Ação	Sim	Sempre `I`. O inventário aceita só inclusão.
B	Resposta	—	Deixe em branco.
C	Código do produto	Sim	Código interno do produto de venda, com a variação. Exemplo: `000031.02`. Mantenha os zeros à esquerda.
D	Quantidade	Sim	Quantidade contada. Número inteiro, zero ou maior. Exemplo: `10`.
E	Data da contagem	Sim	Dia em que o produto foi contado, no formato dd/mm/aaaa ou como célula de data. Precisa ser anterior a hoje.

Cada produto aparece uma única vez na planilha.

Ao importar, a mensagem informa o número do inventário criado e a quantidade de itens, por exemplo Inventário nº 123 incluído em digitação com 45 itens. O inventário segue depois pelo fluxo normal do estoque.

Pendências do inventário

Coluna	Pendência	O que fazer
Ação	Informe a ação (I).	Preencha `I` na coluna A.
Ação	Ação "A" não aceita neste modelo. Use I.	O inventário só inclui. Troque para `I`.
Código do produto	Informe o código do produto.	Preencha o código.
Código do produto	Produto "…" não encontrado.	Confira o código e a variação no cadastro de produtos.
Código do produto	Produto "…" está desativado.	Reative o produto ou retire a linha.
Código do produto	Código "…" pertence a mais de um produto ativo. Corrija o cadastro antes de importar.	Ajuste o cadastro para que o código identifique um único produto.
Código do produto	Produto já informado na linha N. Cada produto é contado uma única vez no inventário.	Some as quantidades numa única linha e apague a repetida.
Quantidade	Informe a quantidade.	Preencha a quantidade.
Quantidade	Quantidade "…" não é um número.	Use só dígitos.
Quantidade	A quantidade não pode ser negativa.	Informe zero ou mais.
Quantidade	A quantidade confirmada do inventário é inteira.	Retire as casas decimais.
Quantidade	Quantidade acima do limite aceito.	Confira o valor digitado.
Data da contagem	Informe a data da contagem.	Preencha a data.
Data da contagem	Data da contagem "…" inválida. Use dd/mm/aaaa.	Corrija o formato da data.
Data da contagem	A data da contagem deve ser anterior a hoje.	Use a data real da contagem. Hoje e datas futuras não são aceitos.

O que a tela bloqueia

Situação	O que acontece
Nenhum modelo escolhido	Não avança do passo Tipo. A mensagem é Escolha o tipo de importação.
Nenhum arquivo enviado	Não avança do passo Planilha. A mensagem é Envie a planilha.
Arquivo que não é XLSX	O envio é recusado. A mensagem é Formato de arquivo não aceito. Use XLSX (Excel 2007 ou superior).
Arquivo acima de 10 MB	O envio é recusado.
Arquivo que não abre como planilha	A mensagem é Não foi possível abrir a planilha. Use o formato XLSX (Excel 2007 ou superior).
Linha 2 sem o código do modelo	A planilha é recusada. A mensagem é A linha 2 da planilha não tem o código do modelo. Baixe o modelo e preencha a partir da linha 6.
Planilha de outro modelo	A planilha é recusada. A mensagem informa o modelo da planilha e o esperado: A planilha é do modelo …, mas a importação escolhida usa o modelo ….
Linha 4 alterada ou colunas fora de ordem	A planilha é recusada. A mensagem indica a coluna: A linha 4 da planilha foi alterada: na coluna … era esperado …. Baixe o modelo novamente.
Planilha sem dados a partir da linha 6	A mensagem é A planilha não tem linhas com dados a partir da linha 6.
Mais de 5.000 linhas com dados	A mensagem é A planilha passa de 5.000 linhas. Divida o arquivo e importe em partes.
Qualquer pendência de linha	O botão Importar fica bloqueado até a planilha ser corrigida e reenviada.
Filial do inventário em branco	A mensagem é Informe a filial do inventário.
Filial não liberada para o usuário	A mensagem é A filial informada não está liberada para o seu usuário.
Responsável do inventário em branco	A mensagem é Informe o responsável pelo inventário.
Responsável desativado ou que não é funcionário	A mensagem é O responsável pelo inventário precisa ser um funcionário ativo.
Falha na leitura da planilha	A mensagem é Não foi possível ler a planilha. Confira o arquivo e tente de novo.
Falha durante a gravação	Nada é gravado. A mensagem é Não foi possível concluir a importação. Nada foi gravado.