How-to3 min de lectura

Exportación de tabla vacía (204): tu PDF probablemente no tiene columnas

PDF a Excel y PDF a CSV devuelven HTTP 204 si no hay bloques de tabla: es intencional, no un fallo. Aplica OCR antes en escaneos; un PDF solo de prosa seguirá vacío.

By the PDF123 team · Updated 2026-10-02
Exportación de tabla vacía (204): tu PDF probablemente no tiene columnas

Si PDF a Excel o PDF a CSV termina con HTTP 204 No Content y sin cuerpo de descarga, el extractor encontró cero bloques de tabla. Ese estado es deliberado: la API se niega a inventar una hoja de cálculo vacía cuando la heurística de maquetación no ve columnas.

Qué busca el extractor

Las dos herramientas comparten el mismo proceso. El servidor ejecuta pdftotext -layout, divide las páginas en los saltos de página y agrupa las líneas que parecen bloques de columnas. Una línea cuenta como tabular cuando contiene al menos dos espacios consecutivos (los canales entre columnas del modo layout). Un bloque solo se conserva si tiene al menos dos de esas líneas; una línea con espacios aislada se descarta para que los encabezados no se conviertan en «tablas» de una sola fila.

PDF a CSV (POST /api/v1/convert/pdf/csv) genera un CSV por tabla detectada (con nombre de página e índice de tabla), o un ZIP cuando hay varias. PDF a Excel (POST /api/v1/convert/pdf/xlsx) escribe un libro con una hoja por tabla detectada.

Cuando esa lista está vacía, las dos devuelven Output::no_content(), que se traduce en 204. Un 200 con un .xlsx en blanco sería más fácil de malinterpretar como un éxito; 204 significa «no hay nada que exportar».

Motivos habituales de un 204

  • PDF solo con prosa: texto narrativo sin una alineación de columnas clara. Usa PDF a texto o PDF a Markdown.
  • Páginas escaneadas sin capa de texto: la salida de pdftotext está vacía, así que no aparece ninguna tabla. Ejecuta OCR primero (texto Markdown en este sitio) y reinténtalo solo si las palabras forman columnas de verdad.
  • Tablas dibujadas solo con líneas o imágenes: las cuadrículas visuales sin texto de celda extraíble no se convierten en hojas.
  • Maquetaciones de revista a varias columnas y desordenadas: la heurística puede no ver bloques que una persona llamaría «tabla», o mezclar mal el orden de lectura.
  • «Tablas» de una sola fila: una línea con espacios nunca forma un bloque; hacen falta al menos dos líneas tabulares.

Los archivos cifrados necesitan un Desbloquear autorizado antes de la extracción. Repara un archivo dañado con Reparar si Get Info o la exportación no consiguen abrirlo.

Qué no es un 204

204 no es un fallo de transporte, ni un tiempo de espera agotado, ni «el servidor se ha olvidado del adjunto». Trátalo como una decisión correcta: no hay bloques de tabla. Volver a intentarlo con el mismo archivo sin cambiar la capa de texto o la maquetación devolverá 204 otra vez. Los scripts deben decidir por el código de estado, no por un nombre de archivo vacío.

El Markdown del OCR es una extracción de texto para agentes, no una hoja de cálculo. Si pegas la salida del OCR en un archivo .md y más tarde necesitas columnas, seguirás necesitando una maquetación que pdftotext -layout (o una persona) pueda ver como canales; volver a exportar el mismo PDF escaneado sin capa de texto seguirá devolviendo 204.

Qué hacer a continuación

  1. Abre el PDF y confirma que puedes seleccionar el texto de las celdas. Si no puedes, aplica OCR y decide después si el texto recuperado tiene suficientes columnas para esta heurística.
  2. Prefiere PDF a Excel cuando esperes varias tablas (una hoja para cada una). Prefiere PDF a CSV para un único archivo plano o un ZIP de CSV.
  3. Si la página es narrativa, cambia de herramienta: la exportación de tablas seguirá devolviendo 204.
  4. Para gestionar el estado en agentes o pipelines, interpreta 204 como «no se detectaron tablas», no como un bucle de reintentos genérico.
  5. Si solo necesitas las palabras, quédate en PDF a texto o PDF a Markdown; forzar una forma de hoja de cálculo sobre prosa seguirá devolviendo 204.

La ruta del navegador no pide cuenta. Los mismos endpoints por HTTP: Desarrolladores. Envía un Idempotency-Key en los reintentos si tu cliente puede llegar a hacer POST dos veces (Idempotency-Key).

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool