# API per convertire fatture: guida semplice

- Date: 2026-07-29
- Reading time: 4 min di lettura

Integra la conversione via API: ottieni accesso, carica con chiave di idempotenza, controlla il task e scarica il risultato.

## Panoramica dell’articolo

        Questo articolo spiega API per convertire fatture: guida semplice come riferimento pratico per la fatturazione elettronica europea. Definisce il tema in modo chiaro, lo colloca nel contesto di conformità e collega la spiegazione ai formati XRechnung, ZUGFeRD/Factur-X, UBL e CII.

L’API di conversione collega ERP, contabilità o applicazioni personalizzate. È asincrona: il sistema crea un task, ne controlla lo stato e scarica il risultato.

        ## Come usare questa guida

        Usa l’articolo come punto di partenza prima di modificare un workflow finance o ERP: identifica la regola nazionale o lo standard applicabile, scegli il formato strutturato richiesto, valida l’XML generato e mantieni un processo di eccezione documentato per le fatture che richiedono revisione manuale.

## Il flusso API in cinque passi

Per Il flusso API in cinque passi, questa sequenza indica l’ordine operativo pratico.

- Richiedi l’accesso e crea una chiave con fatturazione approvata o crediti prepagati.
- Invia la fonte a POST /api/v1/invoices:convert con formato e chiave di idempotenza.
- Conserva l’ID del task restituito.
- Interroga GET /api/v1/tasks/{task_id} con intervalli crescenti fino allo stato finale.
- Scarica risultato e report. Invia gli errori di validazione alla correzione invece di riprovare senza modifiche.
## Input e formati

L’upload accetta PDF, DOCX e TXT. Una rotta separata accetta input strutturati. I target includono XRechnung, ZUGFeRD, EN 16931, UBL e CII. ZUGFeRD richiede un PDF.

## Quando usare l’API?

Usala per flussi sistema-sistema con task, idempotenza e download espliciti. Per caselle controllate e volumi bassi usa il [canale e-mail](/it/blog/invoice-conversion-by-email).

## Consulta l’API sviluppatori

Vedi autenticazione, endpoint, esempi, errori e contratto attuale.

[Apri documentazione API](/it/developer-api)

## FAQ

### L’API restituisce subito la fattura?

No. Restituisce un ID task. L’integrazione controlla il task e scarica il risultato pronto.

### L’API offre webhook?

Il flusso partner attuale usa polling con backoff, non webhook.

## Riferimenti ufficiali

- [API sviluppatori Invoice Converter](https://www.invoice-converter.com/en/developer-api)
- [Specifica OASIS UBL 2.1](https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html)