Como Importar Trabalhos em Lote via Planilha CSV
"Aplica-se a: Studio Essencial, Studio Pro" "Keyword: importar obras csv planilha lote studio artista" "Title: Importar Trabalhos em Lote via CSV | Central de Ajuda - Acervo Vivo Studio" "Meta: Aprenda a importar dezenas de Trabalhos de uma só vez no Acervo Vivo Studio usando uma planilha CSV, com suporte a imagens, dimensões e valor base." "Slug: importar-csv-studio" "Alt-Capa: Ilustração mostrando uma planilha sendo carregada para um acervo digital de arte"
O que é este recurso?
O Importador de Planilha CSV permite que você traga dezenas ou centenas de Trabalhos para o seu acervo de uma só vez, sem precisar cadastrar obra por obra. É ideal para artistas que estão migrando de outro sistema (como Tainacan ou IPAC) ou que possuem catálogos legados em planilha.
💡 O importador é inteligente: ele reconhece automaticamente os nomes das colunas mais comuns, mapeia os dados para os campos corretos do sistema e evita duplicatas usando o "Código no Atelier" de cada obra como chave única.
Como acessar
No menu lateral esquerdo, navegue até Gestão do Acervo → Acervo Completo.
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 submeter 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.
Campos disponíveis para mapeamento
| Campo | O que é |
|---|---|
| Título (obrigatório) | Nome principal do Trabalho |
| Ano | Ano ou período de criação (ex: 2021 ou 2019–2021) |
| Técnica e Materiais | Descrição da técnica (ex: óleo sobre tela) |
| Altura (cm) | Altura principal em centímetros |
| Largura (cm) | Largura principal em centímetros |
| Profundidade (cm) | Profundidade (para esculturas e objetos 3D) |
| Dimensões (string bruta) | Dimensões já formatadas em texto (ex: "40 x 60 cm") |
| Código no Atelier | Código ou número de inventário legado — usado para evitar duplicatas |
| Assinatura | Informação sobre como/onde a obra está assinada |
| Inscrição | Inscrições, carimbos ou marcas no verso |
| Observação | Notas internas, anotações de conservação ou contexto |
| Localização (Detalhe/Texto) | Texto livre de localização física (ex: "Mapoteca 3, Gaveta A") |
| Descrição das Partes | Descrição de obras compostas (polípticos) |
| Cuidados de Conservação e Transporte | Instruções de manuseio e armazenamento |
| Valor Base / Preço | Valor de referência do Trabalho (ex: R$ 3.500,00) |
| URL da Imagem (Pública) | Link público para a foto principal — o sistema faz o download automaticamente |
| Linguagem Artística | Linguagem da obra (ex: Fotografia, Escultura) |
| Situação | Status atual do Trabalho (ex: Em Acervo, Consignado) |
| Série | Série à qual o Trabalho pertence |
| Materiais | Lista de materiais (ex: Tinta Acrílica, Carvão) |
| Suportes | Lista de suportes (ex: Tela, Papel Algodão) |
Destino Fixo do Lote — Série
Como artista (Studio), você deve indicar para qual Série os Trabalhos desta importação pertencem. Você pode fazer isso de duas formas:
- Campo Fixo (recomendado): Selecione a Série no campo "Série Fixa para o Lote". Todos os Trabalhos irão para essa Série.
- Coluna por linha: Mapeie a coluna de série do seu CSV — o sistema tentará encontrar ou criar a série automaticamente para cada linha.
Etapa 3 — Importar
Clique em Importar. O sistema irá:
- Verificar duplicatas — Trabalhos com o mesmo "Código no Atelier" são atualizados, não duplicados.
- Criar os dados de apoio — Materiais, Suportes e outros itens novos são criados automaticamente.
- Enviar os Trabalhos em lotes de 10, respeitando os limites da API.
- 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 Acervo automaticamente.
Ao final, um Relatório de Auditoria é exibido mostrando:
- Quantos Trabalhos foram criados
- Quantos foram atualizados
- 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 aceita o valor monetário em vários formatos. Você não precisa limpar a planilha antes de importar:
| Formato na planilha | O sistema interpreta como |
|---|---|
1500 |
R$ 1.500,00 |
1500.00 |
R$ 1.500,00 |
1.500,00 |
R$ 1.500,00 ✅ (padrão brasileiro) |
R$ 1.500,00 |
R$ 1.500,00 ✅ |
a combinar |
Ignorado (campo fica em branco) |
O valor importado é salvo como Valor Base na ficha do Trabalho e pode ser revisado individualmente após a importação.
Perguntas Frequentes
P: E se a minha planilha tiver erros de digitação nos nomes das colunas?
R: O sistema usa detecção inteligente por sinônimos. Por exemplo, "Titulo", "Título da Obra", "Denominação" e até o formato do Tainacan ("Titulo:|text|display_no") são todos reconhecidos como o campo Título. Se uma coluna não for detectada automaticamente, mapeie-a manualmente no menu suspenso da Etapa 2.
P: Posso importar apenas um trecho do catálogo para testar? R: Sim! Na Etapa 1, use o Seletor de Linhas (Linha Inicial e Linha Final) para importar apenas as primeiras 5 linhas, por exemplo. Verifique o resultado no acervo e, se estiver correto, importe o restante.
P: O que acontece se um Trabalho do meu CSV já existir no acervo? R: Se o CSV tiver um "Código no Atelier" que já existe no seu acervo, o sistema atualiza o registro existente com os novos dados — em vez de criar um duplicado.
P: Posso importar imagens de um servidor legado? R: Sim, desde que as imagens tenham uma URL pública acessível. Mapeie a coluna com os links de imagem para o campo "URL da Imagem". O sistema faz o download automaticamente e envia a foto para o Google Drive. Se o servidor bloquear downloads externos, o sistema tentará contornar a proteção usando um intermediário — mas este recurso funciona apenas na versão em produção (não em ambientes de teste local).
P: Se eu alterar o "Código no Atelier" de um Trabalho após a importação, a próxima importação vai criar um duplicado? R: Sim. O sistema usa o Código no Atelier como chave única. Se o código não bater com nenhum registro existente, ele cria um novo Trabalho. Mantenha os códigos consistentes entre importações.