Logotipo de PDFHQ

Documentos

DocumentaciónDocumentos e inteligencia

API de exportación de CSV de facturas

Descargue un archivo CSV privado, de solo revisión, de campos de factura respaldados en origen con protección de fórmulas de hoja de cálculo y citas de auditoría.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Exportar una extracción de factura completada#

Ejecuta pdfhq.ai.extract usando una cotización HQTools aceptada y espera a que se complete el trabajo. GET /v1/ai/jobs/{job_id}/invoice.csv responde con una descarga privada de texto/csv. Solo el mismo propietario/proyecto propietario del trabajo de IA puede recuperarlo. Los trabajos fallidos, pendientes o sin factura no se pueden exportar.

cURL
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.csv' \
  -H 'x-api-key: PROJECT_API_KEY' -o invoice-review.csv

Columnas: field, value, source_citations, review_required. Los siete campos de factura están presentes, los valores faltantes están en blanco y todas las filas están marcadas review_required=true. Los valores CSV que podrían interpretarse como fórmulas de hojas de cálculo están escapados. Cache-Control es private, no-store; nunca publiques exportaciones ni registres contenidos de documentos.

Libros de trabajo de revisión de facturas estructuradas#

GET /v1/ai/jobs/{job_id}/invoice.xlsx genera un archivo Excel privado con el encabezado de la factura, las líneas de pedido, los extractos de origen y las notas de conciliación/revisión. El servidor valida la revisión de la fuente y las compensaciones de citas y almacena cantidades como texto para preservar los decimales exactos y defenderse contra la inyección de fórmulas en hojas de cálculo. No se realiza ninguna segunda llamada de proveedor ni reserva HQTools.

cURL
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.xlsx' \
  -H 'x-api-key: PROJECT_API_KEY' -o invoice-review.xlsx

POST /v1/ai/jobs/invoices/batch.xlsx acepta 1 a 10 ID de trabajos de factura distintos, propios y completados del mismo proyecto de API. La solicitud es todo o nada: un trabajo expirado, extranjero, duplicado o inválido impide toda la exportación. Cada factura se cobra solo cuando se procesó su trabajo de IA original.

cURL
curl -X POST 'https://api.pdfhq.io/v1/ai/jobs/invoices/batch.xlsx' \
  -H 'x-api-key: PROJECT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"job_ids":["FIRST_JOB_UUID","SECOND_JOB_UUID"]}' \
  -o invoice-batch-review.xlsx

Política de revisión antes de importar#

La validación de formato verifica fechas ISO, códigos de moneda de tres letras en mayúsculas, totales decimales no negativos y referencias de citas vinculadas a revisiones. Puede rechazar reclamaciones de números de factura o numéricos no admitidos. No establece que una factura sea genuina ni que un monto sea la cantidad legalmente correcta adeudada. Revisa contra el PDF original antes de exportar a contabilidad, ERP o pagos.

La exportación CSV es de solo lectura: no crea otra solicitud al proveedor ni genera cargos adicionales del modelo de IA. La tarea de procesamiento de IA original utiliza una cotización aprobada de créditos HQTools.

Logotipo de PDFHQ

Herramientas PDF y análisis de documentos. Prepara, comprende y trabaja con tus documentos.

© 2026 PDFHQ. Todos los derechos reservados.