Vai al contenuto principale
API per convertire fatture: guida semplice
Blog

API per convertire fatture: guida semplice

1 min di letturaVerificato: 29 agosto 2026
Esporta Markdown

Riferimenti ufficiali

Usa queste fonti per verificare date, formati e modifiche ufficiali delle regole.

Wiki tecnica correlata

Esplora la documentazione approfondita per sviluppatori e le linee guida normative corrispondenti a questo articolo.

Messaggi di errore API e automazione

Codici di errore di integrazione comuni spiegati per utenti non tecnici.

Guide di validazione export ERP

Guide pratiche per validare export fattura da DATEV, Lexware, SAP Business One, Odoo e Microsoft Dynamics.

Liste di codici e-fatture

Liste di codici comuni per e-fatture: codici categoria IVA, mezzi di pagamento, unità e tipi fattura.

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

Flusso interattivo

Premi play o fai clic su un passaggio per seguire una fattura attraverso questo canale.

Output:XRechnungZUGFeRDEN 16931UBLCII

Fase di elaborazione

Passaggio 1 di 6TuConfigurazione una tantum

Crea una chiave API

Con un abbonamento Enterprise attivo, crea una chiave nel profilo. Conservala sul tuo server.

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. Passaggi come descritti in questa guida e nella specifica dell’External API V1. Stato: ottobre 2026.
  1. Con un abbonamento Enterprise attivo, crea una chiave API nel profilo.
  2. Invia la fonte a POST /api/v1/invoices:convert con formato e chiave di idempotenza.
  3. Conserva l’ID del task restituito.
  4. Interroga GET /api/v1/tasks/{task_id} con intervalli crescenti fino allo stato finale.
  5. 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.

Domande frequenti

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.

Consulta l’API sviluppatori

Vedi autenticazione, endpoint, esempi, limiti ed errori.

API per fatture elettroniche

Articoli correlati