API per convertire fatture: guida semplice
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.
Codici di errore di integrazione comuni spiegati per utenti non tecnici.
Guide pratiche per validare export fattura da DATEV, Lexware, SAP Business One, Odoo e Microsoft Dynamics.
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
- 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.
Pronto a convertire le fatture?
Converti le fatture PDF in XRechnung, ZUGFeRD e altri formati. Abbonamenti da 10 €/mese con fatturazione annuale (imposte escluse), con una prova di 3 giorni sul primo abbonamento. Oppure senza abbonamento: 5 € per conversione (imposte escluse).