# API per convertire fatture: guida semplice

- Date: 2026-07-29
- Modified: 2026-08-29
- Verificato: 29 agosto 2026
- Reading time: 1 min di lettura

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

> Verificato rispetto a API sviluppatori Invoice Converter, Specifica OASIS UBL 2.1.

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

## Il flusso API in cinque passi

- Con un abbonamento Enterprise attivo, crea una chiave API nel profilo.
- 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).

## 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)