Como Importar Obras em Lote via Planilha CSV

"Aplica-se a: Galleria Essencial, Galleria Pro" "Keyword: importar obras csv planilha lote galleria galeria arte" "Title: Importar Obras em Lote via CSV | Central de Ajuda - Acervo Vivo Galleria" "Meta: Aprenda a importar dezenas de Obras para a sua galeria de uma só vez usando uma planilha CSV, incluindo valor base, imagens e dados de catálogo." "Slug: importar-csv-galleria" "Alt-Capa: Ilustração mostrando uma planilha de catálogo de galeria sendo importada para um sistema digital"

O que é este recurso?

O Importador de Planilha CSV permite que você traga dezenas ou centenas de Obras para a sua galeria de uma só vez, sem precisar cadastrar peça por peça. É ideal para galerias que estão digitalizando um catálogo legado, recebendo um acervo de um artista representado ou migrando de outro sistema de gestão.

💡 O importador foi projetado especialmente para catálogos comerciais: ele reconhece automaticamente colunas de valor, importa fotos de URLs públicas e evita duplicatas usando o código de inventário de cada Obra como chave única.

Como acessar

No menu lateral esquerdo, navegue até Obras da Galeria → Obras da Galeria.

No canto superior direito da tela, clique no ícone de planilha (importar CSV). O painel do Importador se abrirá em 3 etapas.

Como usar

Etapa 1 — Carregar o arquivo

Arraste o seu arquivo .csv para a área de upload ou clique para selecionar do computador.

⚠️ Limite: até 500 linhas por importação. Para catálogos maiores, divida em lotes e importe sequencialmente.

Seletor de linhas: após carregar o arquivo, você pode definir a Linha Inicial e a Linha Final para importar apenas um trecho. Isso é útil para testar com um lote pequeno (ex: linhas 1 a 5) antes de enviar o catálogo completo.

Codificação do arquivo: se os acentos aparecerem errados no preview, alterne entre UTF-8 e Windows-1252. CSVs exportados do Excel geralmente usam Windows-1252.

Etapa 2 — Mapear as colunas

O sistema exibe as colunas encontradas no seu CSV e sugere automaticamente para qual campo do Acervo Vivo cada uma deve ir.

Revise os mapeamentos e corrija os que estiverem errados usando os menus suspensos. Clique em Limpar Tudo para recomeçar o mapeamento do zero sem fechar o painel.

Campos disponíveis para mapeamento

Destino Fixo do Lote — Artista Representado

Como galerista, você deve indicar a qual artista representado as Obras desta importação pertencem. Você pode fazer isso de duas formas:

• Campo Fixo (recomendado para cargas por artista): Selecione o artista no campo "Artista Fixo para o Lote". Todas as Obras irão para esse artista.
• Coluna por linha: Mapeie a coluna de autoria do seu CSV — o sistema criará o artista automaticamente na sua galeria se ele ainda não existir.

Etapa 3 — Importar

Clique em Importar. O sistema irá:

1. Verificar duplicatas — Obras com o mesmo "Código no Atelier" são atualizadas, não duplicadas.
2. Criar os dados de apoio — Artistas, Materiais, Suportes e Gêneros novos são criados automaticamente, vinculados exclusivamente à sua galeria.
3. Enviar as Obras em lotes de 10, respeitando os limites do sistema.
4. Processar as imagens — Se você mapeou uma coluna de URL de imagem, o sistema faz o download e envia a foto para o Google Drive e o inventário automaticamente.

Ao final, um Relatório de Auditoria é exibido mostrando:

• Quantas Obras foram criadas
• Quantas foram atualizadas
• Quantas imagens foram processadas
• Avisos sobre dimensões ou valores que precisam de revisão manual

Sobre o campo "Valor Base / Preço"

O Importador foi otimizado para catálogos comerciais e aceita o valor monetário em vários formatos. Você não precisa limpar a planilha antes de importar:

O valor importado é salvo como Valor Base na ficha da Obra. Após a importação, você pode criar Listas de Preços em Operações Comerciais → Listas de Preços para aplicar descontos e margens por cliente ou evento.

Perguntas Frequentes

P: Meu catálogo tem colunas com nomes diferentes dos padrões. O sistema vai reconhecer? R: O sistema usa detecção inteligente por sinônimos. Termos como "valor", "preço", "price" e "valor de mercado" são todos reconhecidos automaticamente para o campo Valor Base. Se uma coluna específica não for detectada, mapeie-a manualmente no menu suspenso da Etapa 2.

P: Posso importar catálogos de artistas diferentes em uma mesma importação? R: Sim, desde que seu CSV tenha uma coluna de Autoria. Mapeie essa coluna para o campo "Autoria" e deixe o campo "Artista Fixo" em branco. O sistema irá criar ou localizar cada artista automaticamente linha por linha.

P: O que acontece se uma Obra do CSV já existir na galeria? R: Se o CSV tiver um "Código no Atelier" que já existe na sua galeria, o sistema atualiza o registro existente com os novos dados — incluindo o Valor Base, se for diferente. Nenhuma duplicata é criada.

P: Posso importar as fotos das obras direto pelo CSV? R: Sim. Mapeie a coluna que contém as URLs públicas das fotos para o campo "URL da Imagem". O sistema faz o download e envia automaticamente para o Google Drive da galeria, organizando as imagens na pasta de cada artista. As fotos devem ser URLs públicas e diretas para o arquivo de imagem (não links de visualizador ou páginas web).

P: O valor importado aparece nas Listas de Preços automaticamente? R: O valor é salvo como Valor Base na ficha da Obra. As Listas de Preços são construídas separadamente em Operações Comerciais → Listas de Preços — elas referenciam o Valor Base e permitem aplicar ajustes por cliente, evento ou política comercial.

P: Se eu alterar o Valor Base de uma Obra diretamente na ficha, e depois reimportar o CSV, o valor é sobrescrito? R: Sim. O importador com Upsert (atualização por código de inventário) sobrescreve todos os campos mapeados, incluindo o Valor Base. Se quiser preservar os valores editados manualmente, não mapeie a coluna de preço em reimportações de atualização de outros campos.