Importações

Em uma frase. Carga de empresas e produtos em massa por planilha .xlsx, com validação prévia antes de gravar qualquer linha.

Quem usa: analista fiscal na implantação · Frequência: implantação e cargas pontuais · Pré-requisitos: planilha no modelo oficial

Para que serve

Cadastrar centenas de empresas ou milhares de produtos à mão não é viável. Esta tela recebe a planilha, valida linha a linha e grava — sempre em duas etapas, porque a primeira coisa que se quer saber de uma carga é o que está errado nela, não quantas linhas entraram.

O modo dry-run vem ligado: ele lê tudo, valida tudo, conta tudo e não grava nada. Só depois de o relatório sair limpo é que se desliga o dry-run e roda de verdade.

Como chegar

1. No Hub, abra o app Dados Mestres.
2. Selecione o tile Importações.

A tela

Enviar uma planilha

Campo	Obrigatório	Formato / domínio	Regra
Tipo	sim	Empresas · Produtos	Trocar recarrega o histórico daquele tipo
Arquivo	sim	.xlsx, até 50 MB	Arraste ou escolha. .xls, .csv e .ods são recusados
Dry-run (valida sem inserir)	—	Sim/não, marcado	Marcado, o botão diz Validar; desmarcado, Importar

O botão Baixar template entrega a planilha no formato certo, com os cabeçalhos que o sistema espera. É o caminho mais curto para não errar nome de coluna.

Colunas esperadas

Empresas — obrigatórias: cnpj, razao_social. Opcionais: nome_fantasia, inscricao_estadual, uf, cnae_fiscal, regime_tributario.

Produtos — obrigatórias: codigo, descricao, unidade, tipo_item. Opcionais: ncm, cest, cfop_padrao, ean.

Acompanhar o andamento

O processamento é assíncrono: a tela mostra a barra de progresso e quatro contadores — Lidas, Inseridas, Puladas e Erros — atualizados sozinhos até terminar.

Situação	Significado
na fila	Aguardando o processador
processando	Em andamento
concluído	Terminou; ver os contadores
falhou	Interrompido; ver a mensagem
selo dry-run	Foi só validação — nada foi gravado

O bloco Ver N erro(s) lista cada problema com linha, coluna e mensagem, o que basta para corrigir a planilha sem adivinhação.

Histórico

As últimas 10 importações do tipo selecionado, com arquivo, situação, contadores e data.

Regras de negócio

• RN-IMP-001 — Só .xlsx, até 50 MB. Outros formatos são recusados no envio.
• RN-IMP-002 — Dry-run é o padrão. Validar antes de gravar é o fluxo esperado, não uma opção avançada.
• RN-IMP-003 — Sucesso parcial. Cada linha é gravada por conta própria: erro numa linha não desfaz as demais. A carga termina com o que deu certo gravado e o que falhou listado.
• RN-IMP-004 — A importação só cadastra; não atualiza. CNPJ ou código de produto que já existe na conta é pulado, sem alterar o cadastro existente. Para corrigir cadastro, edite pela tela.
• RN-IMP-005 — O casamento é por CNPJ (empresas) e por código (produtos).
• RN-IMP-006 — Linha pulada não é erro. Entra no contador Puladas quando o CNPJ ou o código já existe na conta ou se repete dentro do próprio arquivo.
• RN-IMP-007 — A carga roda em segundo plano, com arquivo de até 50 MB; a tela acompanha o andamento sozinha.
• RN-IMP-008 — O relatório guarda os primeiros 500 erros. Acima disso, o problema é a planilha inteira, não a linha.
• RN-IMP-009 — Conflito de código de referência tem tratamento por origem. Código EFD é transferido ao novo dono; código interno e alternativo geram aviso e o valor existente é mantido.

O que esta tela não faz

• Não importa participantes, unidades ou responsáveis. Só empresas e produtos. Os demais têm carga por API.
• Não desfaz uma importação. Não há botão de reverter: é para isso que o dry-run existe.
• Não cancela job em andamento. Uma vez enviado, o processamento vai até o fim.
• Não aceita .csv. A planilha tem de ser .xlsx.

Erros e mensagens

Mensagem	Quando aparece	O que fazer
«Selecione um arquivo .xlsx»	Enviou sem escolher arquivo	Escolha a planilha
«Falha no upload»	Arquivo recusado ou serviço indisponível	Confira formato e tamanho; persistindo, chame o suporte
«Template indisponível»	Falha ao baixar o modelo	Tente de novo; persistindo, chame o suporte
linha 42, cnpj: … no relatório	Erro de validação numa linha	Corrija a linha na planilha e reenvie

Perguntas frequentes

Rodei sem dry-run por engano. O que era válido foi gravado. Reenviar a planilha corrigida cadastra as linhas que tinham erro — as que já entraram são puladas. Registros criados indevidamente, ou gravados com dado errado, precisam ser corrigidos ou removidos pela tela.

Quantas linhas cabem? Até 50 MB de arquivo. Na prática são dezenas de milhares de linhas por planilha.

Posso reimportar a mesma planilha? Pode, sem duplicar: o que já existe é pulado. Mas a reimportação não atualiza cadastros — para isso, edite pela tela.

A importação diz "Puladas: 30". Isso é erro? Não. São linhas cujo CNPJ ou código já existia na conta, ou que se repetiam no próprio arquivo — ignoradas de propósito.