Importação de dados em lote

A importação em lote permite cadastrar vários registros de uma vez a partir de uma planilha (CSV/XLSX/ODS). Opcionalmente, você também pode enviar um arquivo .zip com mídias (representantes digitais) para associar aos registros.

Quem pode fazer

• Admin de Lugar: envia importações em lote no escopo permitido.
• Técnico: pode operar a importação quando tiver permissão no Lugar.

Onde a importação aparece

A importação em lote aparece como um botão na página de detalhe do componente pai.

No Farinha:

• Em Fundos: a importação em lote aparece em Série e Subsérie.
• Em Coleções: a importação em lote aparece em Série e Subsérie.

Como importar (passo a passo)

1. Abra a página do componente pai (por exemplo, uma Série).
2. Clique em "Importar … em lote".
3. Baixe um dos modelos (ODS/CSV/XLSX) e preencha.
4. Envie o arquivo preenchido.
5. (Opcional) Envie também um arquivo .zip com as mídias.
6. Clique em "Enviar para processamento…".

Observação importante:

• O processamento acontece de forma assíncrona. Você não verá o resultado imediatamente após enviar.
• Você receberá e-mails no início e no fim do processamento com um resumo do que foi cadastrado e do que falhou.
• A importação é tratada como uma operação única: em caso de falha, tudo o que foi criado naquela importação é revertido, para evitar dados pela metade.
• Por segurança, arquivos .zip de mídia com caminhos inválidos (tentativa de "Zip Slip") são recusados e a operação é cancelada.

Baixe um modelo, envie a planilha preenchida e, se necessário, inclua um arquivo .zip com mídias.

Regras do arquivo (planilha)

• Formatos aceitos: .csv, .xlsx, .ods
• A primeira linha do modelo é apenas um guia visual.
• Os cabeçalhos "de verdade" estão na segunda linha. Não renomeie nem remova colunas do modelo.
• Limite: até 100.000 registros por arquivo.

Mídias via arquivo .zip

Se você enviar mídias, elas precisam estar compactadas em um .zip.

Regras essenciais:

• Cada linha da planilha referencia arquivos do .zip pelo nome exato na coluna "Arquivos de Mídia".
• A coluna "Tipo de Mídia" define o formato esperado em "Arquivos de Mídia".
• Os valores são separados por ponto e vírgula (;).

Padrões por tipo:

• Imagem Simples: Título da Imagem;Nome do arquivo
• Imagem Dupla: Título da Imagem;Nome do arquivo da frente;Nome do arquivo de trás
• Álbum: Título do Álbum;Posição do arquivo 1;Título do arquivo 1;Nome do arquivo 1;Posição do arquivo 2;Título do arquivo 2;Nome do arquivo 2;...
• Áudio: Título do Áudio;Nome do arquivo
• Vídeo: Título do Vídeo;Nome do arquivo

Problemas comuns

• "Formato de arquivo não suportado": envie apenas CSV, XLSX ou ODS.
• "O arquivo está vazio": confira se há pelo menos uma linha de dados.
• "O arquivo ultrapassa o limite": divida em mais de um arquivo.
• "Cabeçalhos ausentes": use o modelo e não renomeie colunas.
• Mídias não associadas: confira se os nomes dos arquivos no .zip batem exatamente com o que está na coluna "Arquivos de Mídia".
• Nada foi cadastrado, mesmo com o arquivo certo: a importação é uma operação única; se qualquer registro falhar, tudo é revertido. Confira o e-mail de resumo para identificar a linha com problema e reenvie.
• "Arquivo ZIP contém caminhos inválidos": o arquivo .zip foi recusado por segurança (tentativa de Zip Slip). Gere o .zip novamente, sem pastas ou caminhos com .., e reenvie.
• Não recebi os e-mails de início/fim: verifique a caixa de spam e se o servidor de e-mail da instância está configurado.
• A importação parece "travada": o processamento é assíncrono; aguarde o e-mail de conclusão antes de reenviar o mesmo arquivo.

Boas práticas

• Baixe sempre o modelo da própria tela e não renomeie nem remova colunas: os cabeçalhos "de verdade" estão na segunda linha.
• Teste primeiro com um arquivo pequeno (algumas linhas) para validar o preenchimento antes de importar milhares de registros.
• Mantenha os nomes dos arquivos de mídia idênticos aos do .zip, incluindo maiúsculas/minúsculas e extensão.
• Não reenvie o mesmo arquivo enquanto o processamento anterior não terminar, para evitar duplicidades.
• Guarde o .zip e a planilha usados: eles ajudam a auditar e a corrigir reenvios.