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

- Acquisisci una chiave API di produzione dalla dashboard dello sviluppatore.
- Autentica tutte le richieste utilizzando l'intestazione `Authorization` con un token `Bearer`.
- Invia una richiesta `POST` a `/api/v1/convert` con 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`, `ZUGFeRD` o `UBL`.

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

- Specifica sempre un profilo di conformità esplicito, come `XRechnung` o `ZUGFeRD`, 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.