Panel de Importación de Contenido – Referencia de Errores de Validación

Este artículo lista todos los errores que puedes encontrar en el Panel de Importación de Contenido, agrupados por sección y etapa. Para cada error encontrarás el mensaje exacto que se muestra en el panel y qué hacer para solucionarlo.

Para una descripción general del panel y cómo ejecutar una importación, consulta Panel de Importación de Contenido.

NUEVA SUBIDA

El Panel de Importación muestra errores en cinco etapas durante una nueva subida. Recibirás información accionable en cada etapa antes o durante la importación final.

Etapa 1: Antes de subir un archivo

Estas verificaciones ocurren de forma instantánea en tu navegador, antes de que se envíe cualquier archivo al servidor.

Condición	Mensaje mostrado
Extensión de archivo no permitida (permitidas: pdf, epub, mp3, jpg, jpeg, png)	`Tipo de archivo no soportado: .{ext}`
Archivo mayor de 500 MB	`Archivo demasiado grande (máx. 500 MB)`
Ya se alcanzó el límite de 500 archivos para esta importación	`Número máximo de archivos por importación alcanzado (500)`

Etapa 2: Durante el análisis de la planilla

Estas verificaciones se ejecutan cuando el sistema lee tu planilla de metadatos tras la subida.

Condición	Resultado
Más de 10.000 filas	Se muestra un mensaje de error: La planilla supera el máximo de 10.000 filas.
Ningún formato conocido coincide con al menos el 60% de los encabezados	Un modal te solicita seleccionar el formato manualmente (Publica.la o VitalSource)
El archivo está vacío, corrupto o no se puede leer	El analizador devuelve cero filas; todos los encabezados aparecen como no coincidentes en la vista previa

Etapa 3: Durante la validación de filas (antes del inicio)

Una vez subidos ambos archivos, el sistema valida cada fila antes de que puedas iniciar la importación. Si se encuentran errores, verás una lista con los 50 problemas principales. Puedes corregirlos y volver a subir el archivo, o elegir Continuar con errores para omitir las filas inválidas y procesar solo las válidas.

Condición	Mensaje mostrado
El título requerido está ausente (`name` para Publica.la, `title` para VitalSource)	`El nombre es obligatorio`
El tipo de archivo no es uno de: pdf, epub, audio, physical	`Tipo de archivo inválido: {value}`
El ID externo (ISBN o VBID) ya fue importado para este equipo e ingesta	`Ya importado: {externalId}`
El archivo referenciado no coincide con ningún archivo subido	`Ningún archivo subido coincide con: {filename}`
El archivo de portada referenciado no coincide con ningún archivo subido	`Ningún archivo subido coincide con: {filename}`
Solo VitalSource: ningún archivo de contenido subido coincide con el prefijo del VBID	`Ningún archivo de contenido subido coincide con el ID externo: {externalId}`

|| Los productos físicos omiten la verificación de archivos. Las URLs externas (que comiencen con http:// o https://) se procesan sin verificación de archivos locales.

Etapa 4: Durante la subida de cada archivo a S3

Estos errores aparecen en tiempo real junto a la barra de progreso de cada archivo durante el paso de subida.

Condición	Mensaje mostrado
Error HTTP de S3	`Subida fallida (HTTP {status})`
Error de red del navegador	`Error de red, verifica tu conexión`
La subida supera el tiempo límite de 10 minutos	`Tiempo de subida agotado`
El usuario navega a otra página o cancela la solicitud	`Subida cancelada`

Etapa 5: Durante el procesamiento en segundo plano (después de iniciar la importación)

Una vez que haces clic en Importar, el sistema procesa las publicaciones en segundo plano. La mayoría de los problemas en esta etapa se manejan automáticamente. Los resultados son visibles en la sección Historial una vez que finaliza la importación.

Condición	Resultado
La planilla de metadatos expiró entre la subida y el inicio	La importación se marca como fallida; vuelve a subir la planilla e inténtalo de nuevo
Límite de solicitudes del servidor (429)	Reintento automático tras 30 segundos — no se requiere ninguna acción
Error del servidor (5xx)	Hasta 3 reintentos automáticos con un intervalo de 30 segundos; si todos fallan, el lote se marca como fallido
Error del cliente (4xx) para un lote completo	El lote se marca como fallido con un motivo de error de cliente
El servidor rechaza una fila individual	Esa fila se marca como fallida; el error se almacena en el informe CSV
El trabajo en segundo plano falla	Los registros se restablecen automáticamente; un watchdog redistribuye el trabajo tras 5 minutos

|| La lista completa de errores por fila está disponible en el informe CSV que puedes descargar desde la sección Historial una vez que finaliza la importación.

ACTUALIZACIÓN DE ARCHIVOS

La sección de Actualización de Archivos ejecuta sus propias validaciones antes de que comience cualquier reemplazo. Solo se aceptan archivos de contenido: EPUB, PDF, MP3.

Condición	Mensaje mostrado
El nombre de archivo no tiene extensión	`El archivo no tiene una extensión válida: {filename}`
Extensión no permitida (permitidas: epub, pdf, mp3)	`Extensión de archivo no soportada: {ext}`
El mismo nombre de archivo aparece dos veces en el mismo lote	`Archivo duplicado para external_id: {externalId}`
El ID externo no coincide con ningún producto importado previamente	`No se encontró ningún producto existente para external_id: {externalId}`
El nuevo tipo de archivo difiere del tipo del producto original	`Incompatibilidad de tipo de archivo: se subió {newType} pero el producto es {originalType}`
El nombre de archivo del audiolibro no tiene número de pista o es inválido	`Número de pista faltante o inválido en el nombre de archivo: {filename} (se esperaba nombre_{track}.mp3)`
Dos archivos de audiolibro comparten el mismo número de pista para el mismo producto	`Pista duplicada {order} para external_id: {externalId}`
Los números de pista del audiolibro no son contiguos (p. ej. 1, 2, 4 en lugar de 1, 2, 3)	`Órdenes de pista no contiguos para external_id: {externalId} (se obtuvo {actual}, se esperaba {expected})`

Esperamos que esta referencia haya sido de ayuda. Si tienes alguna pregunta, contáctanos en [email protected].