Guide · 03

Recuperare i dati estratti

Leggi i campi strutturati, la confidenza e gli esiti dei controlli.

Quando lo stato è extracted (o approved dopo la revisione), recupera il documento e i suoi dati strutturati con una semplice GET sull'id ottenuto in fase di upload.

GET /documents/{id}bash

curl https://app.locrai.com/api/v1/documents/9b1f0e2c-1c2d-4f5a-8e9b-0a1b2c3d4e5f \
  -H "Authorization: Bearer idp_live_xxxxxxxxxxxxxxxxxxxx"

200 OKjson

{
  "data": {
    "id": "9b1f0e2c-1c2d-4f5a-8e9b-0a1b2c3d4e5f",
    "status": "extracted",
    "document_type": "invoice",
    "extraction_path": "text",
    "confidence": 0.93,
    "validation_checks": [
      { "code": "totals_match", "ok": true, "label": "Imponibile + IVA = Totale" },
      { "code": "valid_vat", "ok": true, "label": "Partita IVA valida" },
      { "code": "valid_iban", "ok": true, "label": "IBAN valido" }
    ],
    "extracted_data": {
      "invoice_number": "2026/123",
      "invoice_date": "2026-06-10",
      "supplier": { "name": "Acme S.r.l.", "vat": "IT01234567890" },
      "subtotal": 1000.0,
      "vat_amount": 220.0,
      "total": 1220.0,
      "line_items": [
        {
          "description": "Servizi di consulenza",
          "quantity": 1,
          "unit_price": 1000.0,
          "vat_rate": 22,
          "line_total": 1000.0
        }
      ]
    }
  }
}

Cosa contiene la risposta

Oltre a extracted_data trovi confidence, un punteggio di affidabilità tra 0 e 1; extraction_path, il metodo usato per leggere il documento — uno tra xml, text, ocr e vision; e validation_checks, l'elenco dei controlli oggettivi eseguiti: ogni voce ha un code, l'esito ok e un'etichetta (ad esempio totals_match, valid_vat, valid_iban).

La soglia predefinita per la revisione umana è 0,85: sotto questo valore il documento passa in review_needed invece di proseguire da solo.

Apri la guidaEsportare in CSV, JSON o XML

Pronto a integrare LOCRAI?

Genera una chiave API dalla dashboard e inizia, oppure scrivici: ti aiutiamo a collegare LOCRAI ai tuoi sistemi, anche con connettori su misura.

Contattaci