Sviluppatori

Un’API di estrazione progettata per la produzione.

Carica file, interroga lo stato, ricevi webhook firmati e leggi campi normalizzati con ID richiesta, idempotenza, token di test e contratto OpenAPI.

Ottieni accesso API Documentazione API

Ciclo dell’API

Progettata per nuovi tentativi, elaborazione asincrona e contesto di assistenza chiaro.

I caricamenti sono asincroni e idempotenti. I documenti completati restituiscono campi normalizzati; quelli bloccati o non riusciti restituiscono contesto utilizzabile.

Caricamento

curl -X POST "https://www.exdata.app/api/v1/documents" \
  -H "Authorization: Bearer $EXDATA_API_TOKEN" \
  -H "Idempotency-Key: invoice-upload-001" \
  -F "file=@invoice.pdf" \
  -F "locale=en" \
  -F "custom_types[]=invoice"

Risultato

{
  "status": "completed",
  "mode": "live",
  "is_e_invoice": true,
  "extractions": {
    "type": {
      "value": "invoice",
      "candidates": ["invoice"]
    },
    "document_number": {
      "value": "RE-2026-1048",
      "candidates": ["RE-2026-1048"]
    },
    "sender_name": {
      "value": "Meyer Supply GmbH",
      "candidates": ["Meyer Supply"]
    },
    "recipient_name": {
      "value": "Northwind Operations Ltd.",
      "candidates": ["Northwind Operations"]
    },
    "payment_due_date": {
      "value": "2026-06-14",
      "candidates": ["14.06.2026"]
    },
    "net_amount": {
      "value": "1079.50",
      "candidates": ["1,079.50"]
    },
    "tax_breakdowns": {
      "value": [
        {
          "taxable_amount": "1079.50",
          "tax_amount": "205.10",
          "tax_rate": "19.00",
          "tax_collection_mechanism": "seller_collected"
        }
      ],
      "candidates": ["VAT 19% 205.10"]
    },
    "gross_amount": {
      "value": "1284.60",
      "candidates": ["EUR 1,284.60"]
    },
    "currency": {
      "value": "EUR",
      "candidates": ["EUR"]
    },
    "iban": {
      "value": "DE89370400440532013000",
      "candidates": ["DE89 3704 0044 0532 0130 00"]
    }
  },
  "latest_extraction_run": {
    "extraction_schema_version": "2026-08-28.1",
    "normalization_version": "base:2026-10-21.3"
  }
}

Percorso di integrazione

Sviluppa e testa la tua integrazione prima di consumare crediti di produzione.

Crea un token di test

I token di test usano gli stessi endpoint, validazione, idempotenza, webhook ed errori dei token live.

Carica file rappresentativi

Usa PDF rappresentativi, etichette personalizzate e la lingua corrispondente a ogni documento. Le chiavi di idempotenza impediscono che i caricamenti ripetuti creino duplicati.

Passa ai token live

Passa quando polling, webhook, gestione degli errori e mappatura a valle sono stati provati in sicurezza.

Dopo il lancio

I dettagli dell’integrazione sono visibili quando servono.

Se un documento fallisce, viene bloccato o produce un risultato inatteso, l’integrazione dispone di contesto leggibile dalle macchine e di un percorso chiaro nell’area di lavoro.

ID richiesta: Ogni risposta API contiene un ID che consente all’assistenza di collegare una segnalazione alla richiesta esatta.
Header webhook firmati: Le consegne includono header di evento, consegna, timestamp e firma che consentono al destinatario di verificarle.
Errori leggibili dalle macchine: Gli errori includono messaggio, codice e ID richiesta per gestire in modo pulito nuovi tentativi e assistenza.
Contratto OpenAPI: Il contratto API v1 è pubblicato e validato per mantenere allineati SDK, integrazioni e documentazione.
Limiti e backoff: I limiti per token e account proteggono il servizio e offrono un modello chiaro per i nuovi tentativi.

Documentazione

Inizia dalla guida rapida, quindi collega il polling o i webhook.

Documentazione API OpenAPI YAML