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

> **Converti, interroga, scarica**
>
> L’External API è asincrona: il tuo sistema crea un task, ne interroga lo stato e scarica il risultato validato. 1. Crea una chiave API: Con un abbonamento Enterprise attivo, crea una chiave nel profilo. Conservala sul tuo server. 2. Invia la sorgente: Carica un PDF, DOCX o TXT con il formato di destinazione e una chiave di idempotenza. È disponibile anche una route per dati strutturati. 3. Salva l’ID del task: L’API risponde subito con un ID task. La fattura viene convertita in background. 4. Interroga con backoff: Controlla lo stato a intervalli crescenti finché è completato o fallito. Un task si completa solo se il file ha superato la validazione per il profilo richiesto. 5. Scarica file e report: Recupera il risultato e il suo report di validazione. 6. Affida gli errori a una persona: Indirizza gli errori di validazione alla correzione invece di ritentarli senza modifiche. Output: XRechnung, ZUGFeRD, EN 16931, UBL, CII.

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