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.
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.
Consulta l’API sviluppatori
Vedi autenticazione, endpoint, esempi, errori e contratto attuale.
Apri documentazione APIPronto a convertire le tue fatture?
Inizia oggi a convertire fatture PDF in XRechnung, ZUGFeRD e altri formati con crediti o un piano a pagamento.