Integrazione · 2026-07-10
Esporta MarkdownIntegrare le fatture via e-mail
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.
- Chiedete al team Invoice-Converter di abilitare il canale e-mail per l’account Enterprise.
- Aggiungete l’indirizzo mittente e completate il link di verifica ricevuto in quella casella.
- Scegliete se restituire le risposte al mittente originale o a un indirizzo collettivo verificato e selezionate la lingua.
- 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.
- Un mittente verificato invia veri allegati PDF a una o più caselle specifiche per formato.
- Il provider in ingresso registra il messaggio; il servizio risolve account abilitato, mittente, destinazione di risposta e formati selezionati.
- Ogni PDF accettato diventa un’attività rigorosa con validazione dell’artefatto obbligatoria e senza override di bozza o avviso.
- L’output viene emesso solo dopo validazione autorevole, prova persistita e controllo di parità dell’artefatto.
- 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
Usa questi punti come controlli pratici per questa sezione.
- 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
Usa questi punti come controlli pratici per questa sezione.
- 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.
Diagrammi di flusso
I diagrammi riassumono lo stesso contratto delle sezioni ricercabili sopra.
Cosa entra nella conversione e cosa ricevete
Cosa entra
Allegato PDF
Fonte primariaLetto sia tramite il livello di testo sia con OCR. Importi, totali fiscali e righe di fattura provengono sempre dal PDF.
Oggetto e corpo dell’e-mail
ComplementareIl testo verificato può fornire riferimenti, correzioni e dati mancanti. Non prevale mai sugli importi del PDF e non può creare righe di fattura.
Dati anagrafici del profilo
Completa i campiI dati anagrafici del venditore salvati nel profilo (nome, indirizzo, partita IVA, contatto) completano i campi venditore mancanti quando l’uso predefinito è attivo; non sovrascrivono i valori estratti.
Conversione rigorosa
Estrazione, arricchimento e validazione autoritativa con controlli di prova e parità.
Cosa ricevete
Artefatto validato
XML XRechnung o PDF/A-3 ibrido ZUGFeRD / Factur-X, in base alla casella usata.
Rapporto di validazione HTML
Il rapporto legato all’artefatto prova la validazione esattamente del file consegnato.
Risposta nel vostro thread
Tutto arriva come risposta al messaggio originale.
Dalla casella alla risposta provata
Mittente verificato
Un account abilitato invia veri PDF.
Casella formato
L’indirizzo sceglie XRechnung o ZUGFeRD.
Attività rigorosa
Estrazione e generazione avvengono senza override di bozza.
Varco di prova
Validazione, persistenza della prova e parità devono riuscire.
Risposta nel thread
Artefatto e rapporto tornano in uno o più messaggi; le divisioni restano nel thread.
Ogni stato finale
- Emesso
Artefatto più rapporto
Vengono allegati solo byte supportati da prova.
- Parziale
I file riusciti restano disponibili
Artefatti completati ed errori condividono il thread di risposta.
- Validazione interrotta
Dettagli, nessun artefatto
Le regole bloccanti fermano l’output non verificato.
- Rifiuto tecnico
Percorso di nuovo tentativo
La risposta spiega cosa modificare o riprovare.