Guida · Aggiornato a maggio 2026
Esporta MarkdownAutomazione della conversione da PDF a fattura elettronica su scala tramite API
Automatizza la conversione da PDF a fattura elettronica ad alto rendimento, configura il polling asincrono, gestisci gli eventi webhook ed elabora più file a livello di codice.
Passaggi chiave dell'integrazione
Usa questi punti come controlli pratici per questa sezione.
- Acquisisci una chiave API di produzione dalla dashboard dello sviluppatore.
- Autentica tutte le richieste utilizzando l'intestazione
Authorizationcon un tokenBearer. - Invia una richiesta
POSTa/api/v1/convertcon il file PDF e i parametri del profilo di conformità . - Gestisci la risposta dell'attività asincrona ed effettua il polling per lo stato o ascolta i webhook.
- Recupera l'output XML convalidato in formato
XRechnung,ZUGFeRDoUBL.
Polling asincrono e webhook
L'integrazione della conformità per la fatturazione elettronica su scala richiede il passaggio dal caricamento manuale dei file a flussi di lavoro API completamente automatizzati e asincroni. Invoice Converter fornisce un backend ad alte prestazioni ottimizzato per l'elaborazione batch ad alto rendimento.
Per ambienti ad alto rendimento, consigliamo un'integrazione asincrona. Quando si carica un PDF, l'API restituisce immediatamente uno stato 202 Accepted con un ID attività univoco.
Il tuo sistema può interrogare l'endpoint dello stato dell'attività su GET /api/v1/tasks/{id} ogni pochi secondi o registrare un URL di webhook per ricevere una notifica POST automatica non appena la conversione è pronta.
Best practice per la scalabilitÃ
Usa questi punti come controlli pratici per questa sezione.
- Specifica sempre un profilo di conformità esplicito, come
XRechnungoZUGFeRD, per evitare ritardi dovuti al rilevamento automatico. - Implementa un backoff esponenziale durante il polling dello stato dell'attività per evitare inutili limiti di frequenza (rate limit).
- Memorizza gli UUID delle attività restituiti nel tuo database locale per facilitare la tracciabilità e la registrazione dei controlli.
- Abilita la verifica della firma del webhook per garantire che gli eventi in arrivo provengano da Invoice Converter.