Exportació de taula buida (204): el teu PDF probablement no té columnes
PDF a Excel i PDF a CSV retornen HTTP 204 quan no es detecten blocs de taula: és intencionat, no una fallada. Feu OCR dels escanejos; els PDF de prosa queden buits.

Si PDF a Excel o PDF a CSV acaba amb HTTP 204 No Content i sense cos de descàrrega, l'extractor ha trobat zero blocs de taula. Aquest estat és deliberat: l'API es nega a inventar un full de càlcul buit quan l'heurística de composició no veu columnes.
Què busca l'extractor
Totes dues eines comparteixen la mateixa canalització. El servidor executa pdftotext -layout, divideix les pàgines pels límits de salt de formulari i agrupa les línies que semblen blocs columnars. Una línia compta com a tabular quan conté com a mínim dos espais consecutius (els canals de columna del mode layout). Un bloc només es conserva quan té com a mínim dues línies d'aquest tipus; una línia aïllada amb espais es descarta perquè els títols no es converteixin en «taules» d'una sola fila.
PDF a CSV (POST /api/v1/convert/pdf/csv) emet un CSV per cada taula detectada (anomenat amb la pàgina i l'índex de taula), o un ZIP quan n'hi ha diverses. PDF a Excel (POST /api/v1/convert/pdf/xlsx) escriu un llibre de treball amb un full per cada taula detectada.
Quan aquella llista és buida, tots dos retornen Output::no_content() mapat a 204. Un 200 amb un .xlsx en blanc seria més fàcil de confondre amb un èxit; un 204 vol dir «no hi ha res a exportar».
Motius habituals de rebre un 204
- PDF només de prosa: text narratiu sense una alineació clara de columnes. Feu servir PDF a text o PDF a Markdown.
- Pàgines escanejades sense capa de text: la sortida de
pdftotextés buida, de manera que no apareix cap taula. Executeu OCR primer (text Markdown en aquest lloc) i reintenteu-ho només si les paraules formen columnes de debò. - Taules dibuixades només amb línies o imatges: les graelles visuals sense text de cel·la extractible no es converteixen en fulls.
- Composicions de revista de diverses columnes i desordenades: l'heurística pot passar per alt blocs que una persona anomenaria «taula» o pot barrejar malament l'ordre de lectura.
- «Taules» d'una sola fila: una línia amb espais no es converteix mai en bloc; calen com a mínim dues línies tabulars.
Els fitxers xifrats necessiten un Desbloqueja autoritzat abans de l'extracció. Repareu un fitxer danyat amb Reparar si Get Info o l'exportació no el poden obrir.
Què no és un 204
Un 204 no és una fallada de transport, ni un temps d'espera, ni «el servidor s'ha oblidat de l'adjunt». Tracteu-lo com una decisió correcta: no hi ha blocs de taula. Tornar a intentar el mateix fitxer sense canviar la capa de text ni la composició tornarà a donar 204. Els scripts haurien de bifurcar-se pel codi d'estat, no per un nom de fitxer buit.
El Markdown de l'OCR és una extracció de text per a agents, no un full de càlcul. Si enganxeu la sortida de l'OCR en un fitxer .md i després necessiteu columnes, encara us cal una composició que pdftotext -layout (o una persona) pugui veure com a canals; tornar a exportar el mateix PDF escanejat sense capa de text continuarà donant 204.
Què cal fer a continuació
- Obriu el PDF i confirmeu que podeu seleccionar el text de les cel·les. Si no, feu OCR i després decidiu si el text recuperat té prou columnes per a aquesta heurística.
- Preferiu PDF a Excel quan espereu diverses taules (un full per cadascuna). Preferiu PDF a CSV per a un sol fitxer pla o un ZIP de CSV.
- Si la pàgina és narrativa, canvieu d'eina; l'exportació de taules continuarà donant 204.
- Per a la gestió d'estats d'agents o canalitzacions, mapeu 204 → «no s'han detectat taules», no un bucle genèric de reintents.
- Si només necessiteu les paraules, atureu-vos a PDF a text o PDF a Markdown; forçar una forma de full de càlcul sobre prosa continuarà donant 204.
No cal compte per al camí del navegador. Els mateixos punts de destinació per HTTP: Desenvolupadors. Envieu una Idempotency-Key en els reintents si el vostre client pot fer POST dues vegades (Idempotency-Key).