Guías · 03

Recuperar los datos extraídos

Lee los campos estructurados, la confianza y los resultados de las comprobaciones.

Cuando el estado es extracted (o approved tras la revisión), recupera el documento y sus datos estructurados con un simple GET sobre el id obtenido en la fase de subida.

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
        }
      ]
    }
  }
}

Qué contiene la respuesta

Además de extracted_data encuentras confidence, una puntuación de fiabilidad entre 0 y 1; extraction_path, el método usado para leer el documento — uno entre xml, text, ocr y vision; y validation_checks, la lista de comprobaciones objetivas realizadas: cada entrada tiene un code, un resultado ok y una etiqueta (por ejemplo totals_match, valid_vat, valid_iban).

El umbral predeterminado para la revisión humana es 0,85: por debajo de este valor el documento pasa a review_needed en lugar de continuar solo.

Abrir la guíaExportar a CSV, JSON o XML

¿Listo para integrar LOCRAI?

Genera una clave API desde el panel y empieza, o escríbenos: te ayudamos a conectar LOCRAI con tus sistemas, también con conectores a medida.

Contáctanos