Histórico de importações

Importações em massa (membros, doações, presença a partir de CSV) rodam como jobs em segundo plano para que o navegador não tenha que manter uma conexão aberta para 30.000 linhas. A aba Histórico de Importações em Dados e Registros mostra os últimos 50 jobs que sua org rodou, com contagens de linha para você ver de relance se a importação terminou de forma limpa.

Abra em Dados e Registros → Histórico de Importações na barra lateral.

Lendo a tabela

Cada linha é um job de importação. As colunas são:

Coluna	Significado
Status	queued, processing, complete, ou failed. Um badge verde significa completo; cinza significa ainda em execução ou na fila.
Total	Número de linhas de dados no CSV enviado (exclui a linha de cabeçalho).
Processed	Linhas que o worker terminou. Enquanto o job está rodando, isso sobe em tempo real ao atualizar.
Failed	Linhas que deram erro — e-mails ruins, campos obrigatórios faltando, violações de chave estrangeira, duplicatas que bateram na regra de pular duplicatas.
Created	Quando o upload foi disparado, no fuso horário da sua org.

Um job saudável termina com status = complete, processed = total, failed = 0. Qualquer outra coisa precisa de atenção.

Ciclo de vida do job

Quando você sobe um CSV pelo módulo Ações em Massa:

1. O arquivo é parseado e uma linha é inserida em import_jobs com status = queued.
2. Um worker o pega, define status = processing, e começa a inserir linhas em lotes de 100.
3. Cada linha bem-sucedida incrementa processed_rows; cada falha incrementa failed_rows e anexa um erro a uma lista de falhas por linha.
4. Quando todas as linhas são tentadas, o worker define status = complete (mesmo que algumas linhas tenham falhado — sucesso parcial ainda é sucesso).
5. Se o worker em si trava (lapso de rede, timeout de edge function para um job de 50k linhas), o job é deixado em status = processing até o próximo worker pegá-lo de volta; jobs com mais de 30 minutos nesse estado são marcados como failed.

TIP

Você pode navegar para fora de Ações em Massa enquanto uma importação está rodando. O job continua no servidor e você pode voltar a essa página para verificar o progresso.

O que "linhas com falha" realmente significa

A contagem failed_rows são linhas que o worker rejeitou, não linhas que não pôde processar de jeito nenhum. Motivos comuns:

• Falha de validação — email não é um e-mail válido; phone não bate com o formato do país; um campo obrigatório está em branco.
• Falta de chave estrangeira — o CSV referencia um grupo, ministério, ou fundo que ainda não existe. Crie as linhas pai primeiro, depois reimporte.
• Pulo de duplicata — se você ligou "pular duplicatas" na UI de upload, linhas que batem com um membro existente por e-mail ou telefone contam como falhadas (tecnicamente puladas, mas a coluna não diferencia).
• Permissão negada — seu papel não tem permissão de escrita na tabela alvo para algumas linhas. Raro; geralmente só acontece com configurações de RBAC personalizadas.

Os primeiros 100 erros em nível de linha são armazenados no registro de erro do job. A UI de ações em massa mostra os primeiros 10 inline com um botão "baixar todos os erros" CSV.

Triagem de uma importação com falha parcial

1. Abra o job com falha em Histórico de Importações.
2. Clique em Baixar CSV de erros — é o arquivo original com duas colunas extras: __row e __error.
3. Conserte os erros no CSV (ou separe as linhas problemáticas).
4. Re-suba apenas as linhas corrigidas. A regra de pular duplicatas vai prevenir reimportar linhas que já tiveram sucesso.

WARNING

Não re-suba o CSV original sem pular duplicatas ligado após uma falha parcial. Você vai criar duplicatas de cada linha que teve sucesso na primeira vez.

Diferenças vs o registro de auditoria

O registro de auditoria captura o que a importação fez (uma linha por membro inserido, com actor_email = system). O histórico de importações captura se o job em si terminou. Use:

• Histórico de Importações quando você quer saber "minha importação funcionou, e quantas linhas não funcionaram?"
• Registro de auditoria quando você quer saber "o que especificamente essa importação tocou?" — filtre o registro de auditoria pela janela de tempo do job.

Uma importação típica de 1.000 linhas de membros escreve 1.000 linhas no registro de auditoria e 1 linha no histórico de importações.

Retenção

Jobs de importação e seus registros de erro são mantidos por 1 ano em todos os planos pagos (90 dias no Starter). O CSV original enviado é excluído do storage após 30 dias independente do plano — tempo suficiente para reimports e forense, curto o suficiente para manter custos de storage sãos.

Se você precisa do CSV original para conformidade, baixe de Ações em Massa → Histórico (uma visão diferente que expõe o arquivo bruto) antes da janela de 30 dias fechar.

Veja também

• Ações em Massa para rodar as próprias importações
• Registro de auditoria da organização para ver as inserções em nível de linha
• Exportar registros para arquivamento fora da plataforma