Cargar un documento

Para iniciar una extracción, carga un archivo con una solicitud multipart en el endpoint de subida. LOCRAI reconoce el tipo de documento y pone el procesamiento en cola de forma segura.

curl -X POST https://app.locrai.com/api/v1/documents/upload \
  -H "Authorization: Bearer idp_live_xxxxxxxxxxxxxxxxxxxx" \
  -F "[email protected]"

La respuesta es inmediata (202 Accepted): el procesamiento continúa en segundo plano. Conserva el campo id, lo necesitarás para recuperar los datos y para vincular los webhooks. El tipo de documento se reconoce durante el procesamiento, así que document_type puede ser todavía null en esta primera respuesta.

{
  "data": {
    "id": "9b1f0e2c-1c2d-4f5a-8e9b-0a1b2c3d4e5f",
    "original_name": "fattura-2026-123.pdf",
    "status": "pending",
    "document_type": null,
    "file_url": "/api/v1/documents/9b1f0e2c.../file"
  }
}

Formatos compatibles

PDF, JPG, JPEG, PNG, TIFF y XML (factura electrónica FatturaPA, interpretada como dato estructurado). Tamaño máximo de 25 MB por archivo.

Estados del documento

Un documento atraviesa una secuencia de estados. La mayoría continúa sola hasta extracted; solo los casos por debajo del umbral requieren una verificación humana.

• pending — en cola, recién cargado
• processing — en procesamiento
• extracted — datos listos, por encima del umbral
• review_needed — hace falta una verificación humana
• approved — aprobado tras la revisión
• failed — procesamiento fallido