Painel de Importação de Conteúdo - Referência de Erros de Validação

Este artigo lista todos os erros que você pode encontrar no Painel de Importação de Conteúdo, agrupados por seção e etapa. Para cada erro, você encontrará a mensagem exata exibida no painel e o que fazer para resolvê-lo.

Para uma visão geral do painel e como executar uma importação, consulte Painel de Importação de Conteúdo.

NOVO ENVIO

O Painel de Importação exibe erros em cinco etapas durante um novo envio. Você receberá informações práticas em cada etapa antes ou durante a importação final.

Etapa 1: Antes de enviar um arquivo

Essas verificações ocorrem instantaneamente no seu navegador, antes de qualquer arquivo ser enviado ao servidor.

Condição	Mensagem exibida
Extensão de arquivo não permitida (permitidas: pdf, epub, mp3, jpg, jpeg, png)	`Tipo de arquivo não suportado: .{ext}`
Arquivo maior que 500 MB	`Arquivo muito grande (máx. 500 MB)`
O limite de 500 arquivos para esta importação já foi atingido	`Número máximo de arquivos por importação atingido (500)`

Etapa 2: Durante a análise da planilha

Essas verificações são executadas quando o sistema lê a sua planilha de metadados após o envio.

Condição	Resultado
Mais de 10.000 linhas	É exibida uma mensagem de erro: A planilha excede o máximo de 10.000 linhas.
Nenhum formato conhecido corresponde a pelo menos 60% dos cabeçalhos	Um modal solicita que você selecione o formato manualmente (Publica.la ou VitalSource)
O arquivo está vazio, corrompido ou não pode ser lido	O analisador retorna zero linhas; todos os cabeçalhos aparecem como não correspondentes na pré-visualização

Etapa 3: Durante a validação das linhas (antes do início)

Depois que os dois arquivos forem enviados, o sistema valida cada linha antes de você poder iniciar a importação. Se forem encontrados erros, você verá uma lista com os 50 principais problemas. Você pode corrigi-los e enviar o arquivo novamente, ou escolher Continuar com erros para ignorar as linhas inválidas e processar apenas as válidas.

Condição	Mensagem exibida
O título obrigatório está ausente (`name` para Publica.la, `title` para VitalSource)	`O nome é obrigatório`
O tipo de arquivo não é um dos seguintes: pdf, epub, audio, physical	`Tipo de arquivo inválido: {value}`
O ID externo (ISBN ou VBID) já foi importado para esta equipe e ingestão	`Já importado: {externalId}`
O arquivo referenciado não corresponde a nenhum arquivo enviado	`Nenhum arquivo enviado corresponde a: {filename}`
O arquivo de capa referenciado não corresponde a nenhum arquivo enviado	`Nenhum arquivo enviado corresponde a: {filename}`
Somente VitalSource: nenhum arquivo de conteúdo enviado corresponde ao prefixo do VBID	`Nenhum arquivo de conteúdo enviado corresponde ao ID externo: {externalId}`

|| Os produtos físicos ignoram a verificação de arquivos. As URLs externas (que comecem com http:// ou https://) são processadas sem verificação de arquivos locais.

Etapa 4: Durante o envio de cada arquivo para o S3

Esses erros aparecem em tempo real ao lado da barra de progresso de cada arquivo durante a etapa de envio.

Condição	Mensagem exibida
Erro HTTP do S3	`Falha no envio (HTTP {status})`
Erro de rede do navegador	`Erro de rede, verifique sua conexão`
O envio excede o tempo limite de 10 minutos	`Tempo de envio esgotado`
O usuário navega para outra página ou cancela a solicitação	`Envio cancelado`

Etapa 5: Durante o processamento em segundo plano (após iniciar a importação)

Depois que você clica em Importar, o sistema processa as publicações em segundo plano. A maioria dos problemas nesta etapa é tratada automaticamente. Os resultados ficam visíveis na seção Histórico assim que a importação é concluída.

Condição	Resultado
A planilha de metadados expirou entre o envio e o início	A importação é marcada como falha; envie a planilha novamente e tente de novo
Limite de solicitações do servidor (429)	Nova tentativa automática após 30 segundos - nenhuma ação necessária
Erro do servidor (5xx)	Até 3 novas tentativas automáticas com intervalo de 30 segundos; se todas falharem, o lote é marcado como falha
Erro do cliente (4xx) para um lote inteiro	O lote é marcado como falha com um motivo de erro do cliente
O servidor rejeita uma linha individual	Essa linha é marcada como falha; o erro é armazenado no relatório CSV
O trabalho em segundo plano falha	Os registros são redefinidos automaticamente; um watchdog redistribui o trabalho após 5 minutos

|| A lista completa de erros por linha está disponível no relatório CSV que você pode baixar na seção Histórico assim que a importação for concluída.

ATUALIZAÇÃO DE ARQUIVOS

A seção de Atualização de Arquivos executa suas próprias validações antes de qualquer substituição começar. São aceitos apenas arquivos de conteúdo: EPUB, PDF, MP3.

Condição	Mensagem exibida
O nome do arquivo não tem extensão	`O arquivo não tem uma extensão válida: {filename}`
Extensão não permitida (permitidas: epub, pdf, mp3)	`Extensão de arquivo não suportada: {ext}`
O mesmo nome de arquivo aparece duas vezes no mesmo lote	`Arquivo duplicado para external_id: {externalId}`
O ID externo não corresponde a nenhum produto importado anteriormente	`Nenhum produto existente encontrado para external_id: {externalId}`
O novo tipo de arquivo difere do tipo do produto original	`Incompatibilidade de tipo de arquivo: foi enviado {newType} mas o produto é {originalType}`
O nome do arquivo do audiolivro não tem número de faixa ou é inválido	`Número de faixa ausente ou inválido no nome do arquivo: {filename} (esperado nome_{track}.mp3)`
Dois arquivos de audiolivro compartilham o mesmo número de faixa para o mesmo produto	`Faixa duplicada {order} para external_id: {externalId}`
Os números de faixa do audiolivro não são contíguos (p. ex. 1, 2, 4 em vez de 1, 2, 3)	`Ordens de faixa não contíguas para external_id: {externalId} (obtido {actual}, esperado {expected})`

Esperamos que este artigo tenha sido útil. Se tiver dúvidas, escreva para [email protected].