Caricare un documento

Per avviare un'estrazione, carica un file con una richiesta multipart sull'endpoint di upload. LOCRAI riconosce il tipo di documento e accoda l'elaborazione in modo sicuro.

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

La risposta è immediata (202 Accepted): l'elaborazione prosegue in background. Conserva il campo id, ti servirà per recuperare i dati e per collegare i webhook. Il tipo di documento viene riconosciuto durante l'elaborazione, quindi document_type può essere ancora null in questa prima risposta.

{
  "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"
  }
}

Formati supportati

PDF, JPG, JPEG, PNG, TIFF e XML (fattura elettronica FatturaPA, interpretata come dato strutturato). Dimensione massima 25 MB per file.

Stati del documento

Un documento attraversa una sequenza di stati. La maggior parte prosegue da sola fino a extracted; solo i casi sotto soglia richiedono una verifica umana.

• pending — in coda, appena caricato
• processing — in elaborazione
• extracted — dati pronti, sopra soglia
• review_needed — serve una verifica umana
• approved — approvato dopo la revisione
• failed — elaborazione non riuscita