# Integrare le fatture via e-mail

- 2026-07-10

Configurate un mittente verificato, usate la casella specifica per formato indicata nel profilo e ricevete messaggi di risposta supportati da prova nel thread originale, suddivisi solo quando lo richiede la dimensione degli allegati.

## Canale e-mail abilitato per account

Usate questo canale per flussi di fatture controllati e a basso volume.

La conversione via e-mail è disponibile nel pilot corrente solo per account Enterprise abilitati. Servono un abbonamento attivo, l’importazione e-mail abilitata e almeno un mittente verificato.

Fanno fede gli indirizzi delle caselle specifiche per formato mostrati nel profilo. Possono cambiare tra ambienti; non inserite quindi nel codice un indirizzo copiato da esempi o documentazione interna.

> **Disponibilità**: Abilitazione e verifica del mittente avvengono durante l’onboarding. Un account ordinario non attiva il canale semplicemente inviando un’e-mail.

## Preparare il mittente prima della prima fattura

Completate questi passaggi nel profilo prima di automatizzare una regola di casella o ERP.

1. Chiedete al team Invoice-Converter di abilitare il canale e-mail per l’account Enterprise.
2. Aggiungete l’indirizzo mittente e completate il link di verifica ricevuto in quella casella.
3. Scegliete se restituire le risposte al mittente originale o a un indirizzo collettivo verificato e selezionate la lingua.
4. Copiate gli indirizzi XRechnung e ZUGFeRD dal profilo e provate ogni rotta necessaria con un PDF rappresentativo.

## Selezionare il formato con l’indirizzo destinatario

| Destinazione | Indirizzo da usare | Risposta riuscita |
| --- | --- | --- |
| XRechnung | La casella XRechnung mostrata nel profilo abilitato. | XML validato più rapporto HTML legato all’artefatto. |
| ZUGFeRD / Factur-X | La casella ZUGFeRD mostrata nel profilo abilitato. | PDF/A-3 ibrido validato più rapporto HTML legato all’artefatto. |

## Dalla ricezione alla risposta

Il canale conferma rapidamente il provider e poi esegue la conversione rigorosa in modo asincrono.

1. Un mittente verificato invia veri allegati PDF a una o più caselle specifiche per formato.
2. Il provider in ingresso registra il messaggio; il servizio risolve account abilitato, mittente, destinazione di risposta e formati selezionati.
3. Ogni PDF accettato diventa un’attività rigorosa con validazione dell’artefatto obbligatoria e senza override di bozza o avviso.
4. L’output viene emesso solo dopo validazione autorevole, prova persistita e controllo di parità dell’artefatto.
5. I messaggi di risposta nello stesso thread restituiscono artefatti e rapporti HTML; vengono suddivisi quando lo richiede la dimensione degli allegati, mentre messaggio, elemento, evento d’uso, prova e file di risposta durevoli restano tracciabili tramite ID.

## Unità di fatturazione e contesto e-mail

Contate l’intero messaggio prima dell’invio e trattate il testo come input di conversione.

- Ogni PDF accettato consuma un’unità di conversione per ogni formato di destinazione corrispondente. Ad esempio, due PDF inviati a entrambe le caselle di formato richiedono quattro unità.
- Prima della conversione il servizio riserva tutte le unità del messaggio: prima dal plafond mensile incluso, poi dai crediti API disponibili.
- Se la copertura non basta per tutte le unità, l’intero messaggio viene rifiutato prima della conversione. Solo le unità riuscite vengono addebitate dopo la memorizzazione durevole degli artefatti di risposta; le unità fallite vengono rilasciate.
- Quando è presente il corpo del messaggio, oggetto e corpo dell’e-mail verificata sono input di conversione supplementari. Possono fornire modifiche, correzioni, riferimenti o dati di fattura mancanti. In caso di conflitto prevalgono importi, totali fiscali e righe del PDF; il solo testo e-mail non può creare righe di fattura. Il contesto e-mail è limitato e può essere troncato; mantenete quindi firme e testo circostante concisi, pertinenti e inequivocabili.
- I dati anagrafici del venditore salvati nel profilo completano i campi venditore mancanti (nome, indirizzo, partita IVA, contatto) quando l’uso predefinito è attivo; non sovrascrivono mai i valori estratti dal PDF.

## Stati finali e artefatti

| Esito | Contenuto della risposta | Allegati |
| --- | --- | --- |
| Emesso | Il file è completato e la validazione autorevole è superata. | Artefatto principale richiesto e relativo rapporto HTML. |
| Parziale | Almeno un file è riuscito e almeno uno è fallito o è stato ignorato. | Solo artefatti provati dei file completati e stato per ogni file. |
| Validazione interrotta | I dettagli bloccanti spiegano perché l’emissione si è fermata. | Nessun risultato non verificato e nessun rapporto HTML legato a un artefatto. |
| Rifiuto tecnico | La risposta identifica il problema di mittente, file, diritto, limite o elaborazione. | Nessun risultato; seguite le indicazioni prima di riprovare. |

## File accettati e limiti del pilot

- Allegate veri file PDF. Un’immagine rinominata o un altro documento viene rifiutato anche se estensione o tipo MIME indicano PDF.
- Un messaggio può contenere più PDF, ma il canale è per flussi controllati a basso volume, non per importazioni massive.
- Mantenete ogni allegato sotto il limite comunicato durante l’onboarding; i limiti del provider e dell’ambiente possono cambiare.
- Se un messaggio raggiunge più caselle formato riconosciute, ogni PDF accettato viene elaborato una volta per ogni formato scelto.
- Gli allegati di risposta sono raggruppati con una soglia di 15 MB per messaggio. Se l’aggiunta di un altro file supera la soglia, gli allegati restanti continuano in un altro messaggio dello stesso thread; un singolo file non viene suddiviso.

## Cosa richiede ancora revisione umana

- Confrontate fornitore, acquirente, numero, date, valuta, imposte, totali, pagamento e ogni riga con la fattura sorgente.
- Confermate riferimenti di instradamento, identificativi endpoint, dati d’ordine e regole di canale specifici del destinatario.
- Esaminate le prove sorgente a bassa affidabilità e ogni avviso o dettaglio di validazione prima di inoltrare il risultato.
- Una validazione tecnica riuscita prova il file emesso rispetto alle regole scelte; non sostituisce l’approvazione commerciale, fiscale o del destinatario.

## Scegliere consapevolmente e-mail o API

| Canale | Uso adatto | Controllo di integrazione |
| --- | --- | --- |
| Canale e-mail | Flussi umani o con regole di casella a basso volume nei quali il thread di risposta è utile. | Casella formato, mittente verificato, indirizzo di ritorno, lingua e risultato per messaggio. |
| External API V1 | Flussi server-to-server che richiedono idempotenza, polling, stato strutturato e controllo esplicito del download. | Richieste autenticate, riferimenti cliente, ID di correlazione, intestazioni di limite ed endpoint per artefatti. |

## Onboarding e supporto

Durante l’onboarding condividete mittenti attesi, formati, destinazione di risposta, lingua e volume mensile.

- [Consultare la documentazione External API V1](/developer-api)
- [Richiedere l’onboarding del canale e-mail](mailto:contact@invoice-converter.com?subject=Onboarding%20canale%20fatture%20e-mail)