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.
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 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.csv' \
-H 'x-api-key: PROJECT_API_KEY' -o invoice-review.csvColumnas: 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 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.xlsx' \
-H 'x-api-key: PROJECT_API_KEY' -o invoice-review.xlsxPOST /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 -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.xlsxPolí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.
