Flusso di elaborazione Email Receiver: classificazione, mittente attendibile e tipo di documento con tre uscite
Email Receiver: ricevere e inviare fatture via e-mail

Ricevere e inviare fatture via e-mail con l'Email Receiver (Mittente attendibile) sulla piattaforma eConnect.

L'Email Receiver (anche Mittente attendibile) è un'App della piattaforma eConnect con cui ricevere e elaborare fatture via e-mail, parte di Scansione e riconoscimento. Imposti un indirizzo e-mail o un dominio attendibile: le fatture inviate da quell'indirizzo vengono elaborate automaticamente.

Attenzione: l'Email Receiver è un'App (sotto App nel menu della piattaforma), non una connessione. Se vuole che le fatture ricevute vengano inoltrate automaticamente a un indirizzo e-mail, usi il connettore Email. Appartiene a Connessioni. Veda Chiavi di connessione: connettore Email, inoltrare le fatture ricevute.

Molti pacchetti software usano l'Email Receiver come metodo principale di collegamento con eConnect. La piattaforma genera un indirizzo e-mail univoco per organizzazione. Il software invia le fatture come allegato a quell'indirizzo e la piattaforma le elabora in base al tipo di documento impostato.

Come funziona l'Email Receiver

Alla creazione di un Email Receiver, la piattaforma genera un indirizzo e-mail univoco. Passi questo indirizzo al fornitore del software o lo inserisca nel pacchetto. Non appena il software invia una fattura come allegato a quell'indirizzo, la piattaforma elabora la fattura automaticamente. Le fatture XML sono elaborate direttamente. Le fatture PDF sono convertite in formato fattura elettronica (UBL) tramite conversione IDR.

L'elaborazione dipende dal tipo di documento impostato: fattura bozza, fattura di vendita o fattura di acquisto.

Dalla mail del fornitore all'elaborazione

Una mail fornitore in arrivo raggiunge prima l'Email Receiver. Lì avvengono classificazione, controllo del mittente attendibile e assegnazione del tipo di documento. Poi il flusso si divide: fattura all'elaborazione, collegare una specifica, oppure ignorare logo e condizioni. Ogni fornitore riceve un indirizzo univoco su trust.econnect.eu.

Tipi di documento

Alla creazione di un Email Receiver sceglie un tipo di documento. Determina come viene elaborata la fattura ricevuta.

Fattura bozza

La fattura viene preparata come bozza sulla piattaforma. Può controllarla e poi inviarla manualmente al destinatario via Peppol. Se attiva l'invio automatico XML (auto-send), le fatture XML valide vengono inviate senza intervento manuale.

Fattura di vendita

La fattura va direttamente in archivio per l'elaborazione amministrativa. È adatta quando la fattura è già definitiva e non serve un ulteriore controllo prima dell'archiviazione.

Fattura di acquisto

La fattura viene consegnata al destinatario come fattura di acquisto. Se la fattura arriva già come UBL, la conversione viene saltata. Per una fattura PDF avviene la conversione IDR in formato fattura elettronica.

Configurare l'Email Receiver

Navigazione per i nuovi clienti: dopo la registrazione si arriva alla vista ambiente / gestione account. L'Email Receiver non è visibile lì in modo diretto. Nel menu, faccia clic su App → Ricevitore e-mail (Email Receiver) per aprire la panoramica. Sotto Tutto vede l'indirizzo e-mail di ricezione creato automaticamente per la sua organizzazione.

  1. Acceda a platform.econnect.eu.
  2. Apra l'app Email Receiver (sotto App nel menu a sinistra).
  3. Faccia clic su Nuovo mittente (il pulsante arancione con il segno più).
  4. Imposti questi campi:
    • Organizzazione: selezioni l'organizzazione per cui vuole elaborare le fatture.
    • Tipo di fattura: scelga Fattura bozza, Fattura di vendita o Fattura di acquisto.
    • Tipo di whitelist: inserisca l'indirizzo e-mail o il dominio del mittente autorizzato a inviare. Per Email Receiver si può inserire in whitelist un solo dominio o indirizzo e-mail.
    • Indirizzo e-mail di contatto: l'indirizzo a cui vengono inviati gli avvisi di rifiuto.
  5. Faccia clic su Salva. La piattaforma genera un indirizzo e-mail univoco per questa connessione.
  6. Attivi il mittente attendibile. Due modi: cambiare manualmente lo stato in "Attivo", oppure inviare un invito al mittente. Con un invito, il mittente riceve un'e-mail che spiega l'indirizzo generato. Al primo uso, l'Email Receiver si attiva automaticamente.
  7. Passi l'indirizzo generato al fornitore del software o lo inserisca nel pacchetto.

Un'organizzazione deve ricevere fatture da più domini? Crei un indirizzo Email Receiver separato per ogni dominio.

Impostazioni e opzioni
  • Notifica alla ricezione: riceve un'e-mail quando una fattura è stata inviata ed elaborata.
  • Requisito SSL/TLS: elaborare solo e-mail inviate tramite una connessione protetta.
  • Invio automatico XML (auto-send): le fatture XML valide vengono inviate senza controllo manuale. Richiede SSL/TLS attivo e XML valido.
  • Tipi di documento consentiti: indichi se accetta solo fatture elettroniche (XML), solo fatture digitali (PDF) o entrambe.
  • Riconoscimento fornitore: indichi quale campo e-mail serve a riconoscere il fornitore. Il valore predefinito è l'indirizzo del mittente. Con alias o inoltri può scegliere un altro campo (per esempio Reply-To). L'indirizzo riconosciuto è incluso anche nell'XML consegnato al sistema contabile.
  • Conversione per più organizzazioni (Conversion for multiple organizations): rilevamento amministrazione / conversione multiparty. L'IDR determina automaticamente per quale amministrazione dello stesso account è destinata una fattura PDF, anche se è stata inviata tramite l'email receiver di un'altra organizzazione. Richiede almeno Professional (indicato a parte nel contratto), l'opzione feature pack Allow multi party for IDR conversion (scheda IDR Features) e l'opzione sull'email receiver. All'attivazione nasce un gruppo IDR (gruppo di amministrazioni) con le organizzazioni dell'account. Il valore predefinito è l'organizzazione dell'email receiver. Con una corrispondenza migliore, il sistema colloca la fattura sull'altra amministrazione. In caso di dubbio resta il valore predefinito. La fase piattaforma instrada su Invoice/AccountingCustomerParty/Party/PartyLegalEntity/CompanyID ed è determinante per l'arricchimento XML (tra cui partita IVA e nome organizzazione). Un Leitweg-ID fittizio in CompanyID (Germania) può far fallire la corrispondenza: resta l'organizzazione predefinita. Dettagli: Ricevitore e-mail.

Attenzione: una fattura definitiva dal software non deve più essere modificata su debitore e righe fattura dopo l'arrivo come fattura bozza sulla piattaforma eConnect. Controlli solo la correttezza della fattura e poi la invii.

Le fatture non arrivano: Email Receiver difettoso o inattivo

Un Email Receiver difettoso o inattivo non va necessariamente riparato creandone uno nuovo. Spesso il Mittente attendibile non è ancora attivo o è configurato in modo errato. Con "e-mail non ricevuta", controlli prima questi punti:

  1. Indirizzo e-mail copiato correttamente. Controlli refusi nell'indirizzo generato …@trust.econnect.eu passato al pacchetto software.
  2. Stato Email Receiver Attivo. Se il Mittente attendibile è ancora su "Creato bozza", l'Email Receiver non è ancora attivo e non si può usare. Il mittente riceve allora un bounce (salvo un altro Email Receiver attivo con un altro indirizzo di contatto).
  3. Whitelist corretta. Controlli che indirizzo o dominio del mittente sia impostato correttamente nella whitelist dell'Email Receiver.
  4. Tipo di documento corretto. Con un tipo di documento errato, le fatture vengono elaborate in modo errato. Esempio: un Mittente attendibile creato con tipo Fattura di acquisto elabora le fatture come fattura di acquisto invece che come fattura bozza. Creare un nuovo Email Receiver con tipo Fattura bozza può essere stato scelto come soluzione temporanea, ma corregga preferibilmente il tipo di documento sull'Email Receiver esistente.
Fattura sulla piattaforma, non (ancora) in UBW/ERP

La fattura è visibile sulla piattaforma dopo la ricezione via Email Receiver, ma non (ancora) in UBW/Agresso, Unit4 o un altro pacchetto collegato? Distingua prima un ritardo temporaneo di batch o di inoltro da un inoltro che manca in modo permanente: veda Risoluzione problemi ERP.

Allegare documenti per destinatari fuori Peppol

Quando le fatture sono inviate via e-mail a destinatari che non sono in Peppol, l'account cliente definisce quali documenti sono allegati nel fallback e-mail. Vuole che nel fallback e-mail siano allegati documenti? Ci contatti per le possibilità e gli eventuali costi.

Alternative consigliate per destinatari fuori Peppol:

  • Registrazione Peppol del destinatario: la via più solida. Le fatture passano allora via Peppol invece che via e-mail.
  • Account sulla piattaforma: il destinatario crea un account e usa un connettore Email (Connessioni) per inoltrare automaticamente le fatture ricevute. Veda Chiavi di connessione: connettore Email.
Messaggi di errore e rifiuti

In caso di rifiuto, l'Email Receiver invia un messaggio di errore all'indirizzo e-mail di contatto di quel receiver. Quel campo non è l'indirizzo e-mail di fallback. Dove vanno le notifiche del receiver e come si modifica da soli l'indirizzo di fallback: vedere Indirizzo e-mail di fallback.

XML non valido o non riconosciuto viene rifiutato e non compare come fattura elaborata sulla piattaforma. Un blocco whitelist è un percorso a parte (mittente non consentito). La presenza del mittente in whitelist non esclude un rifiuto XML.

  • Nessun allegato elaborabile: nessun file fattura riconosciuto nell'e-mail.
  • Blocco whitelist: il mittente non è in whitelist. Nessun file viene elaborato.
  • Errore SSL/TLS: l'e-mail non è stata inviata tramite una connessione protetta e non viene elaborata.
  • XML non valido o non riconosciuto: messaggio di errore con istruzioni su validità UBL e codifica UTF-8. Se l'e-mail contiene anche un PDF accanto all'XML, il PDF viene comunque elaborato. L'avviso per l'XML rifiutato non si può sopprimere finché il PDF viene elaborato.
  • Errore di validazione UBL sull'allegato XML (per esempio BR-CO-18 / BR-Z-01 / BR-Z-05 Zero rated / aliquota zero): il rifiuto riguarda solo l'XML allegato. Se la stessa e-mail contiene anche un PDF, quel PDF viene elaborato normalmente mentre l'XML rifiutato genera il messaggio di errore ("Elaborazione non possibile" / "Non abbiamo potuto elaborare la fattura UBL in allegato").

Suggerimento per invio strutturale di XML e PDF: se un fornitore invia sempre sia XML sia PDF ma si vuole solo il PDF, ci sono due vie: (1) il fornitore corregge l'XML oppure omette l'allegato XML (togliere l'XML); (2) il supporto può impostare l'Email Receiver solo su fatture digitali (PDF). Con la via 2 l'XML non viene più offerto alla validazione e il messaggio di errore collegato sparisce. È una modifica di configurazione del supporto, su richiesta del cliente.

Più allegati, rotazione pagina, merge e generazione PDF

L'Email Receiver classifica gli allegati di un'e-mail in arrivo e decide quale documento è la fattura e quale è un allegato. eConnect controlla ogni documento inviato separatamente sullo stato allegato/fattura. I documenti sono uniti nell'ordine di invio: il primo documento diventa la prima pagina della fattura, anche se è un allegato. Appena un file è riconosciuto come allegato, anche tutti i file successivi della stessa mail sono trattati come allegato.

Con più file PDF:

  • Un file riconosciuto come fattura, gli altri sono altri tipi di documento. Gli altri documenti della stessa mail sono trattati come allegato e aggiunti alla fattura per impostazione predefinita. Pensi a una nota danni, una bolla o una specifica accanto al vero PDF fattura: può chiamare entrambi i documenti "fattura", ma se Detect non ne riconosce uno come fattura, non è un errore di divisione ma il comportamento atteso. Il documento non fattura diventa allegato della fattura riconosciuta. Dubbio se il secondo documento sia comunque una fattura (numero fattura, IVA, importo da pagare, fornitore/destinatario presenti)? Chieda gli allegati PDF originali e l'XML dalla posta in arrivo per un controllo.
  • Più allegati riconosciuti come fattura. Ogni PDF fattura è elaborato individualmente (fatture separate). Il sistema non collega automaticamente gli altri allegati a una fattura specifica della stessa mail. In dubbio, invii 1 fattura per e-mail.

Logica di unione con e senza XML nell'e-mail: se l'e-mail non contiene XML, vale la logica sopra in base alla classificazione Detect (una dichiarazione o fattura, gli allegati vengono aggiunti; due o più dichiarazioni o fatture, tutto è elaborato separatamente). Se l'e-mail contiene una fattura XML valida, vale un'altra regola: un PDF con esattamente lo stesso nome file dell'XML viene aggiunto a quell'XML. Gli altri allegati sono classificati via Detect ed eventualmente elaborati separatamente. Con due o più XML validi nella stessa e-mail, un allegato con esattamente lo stesso nome viene aggiunto all'XML corrispondente. Gli altri file sono elaborati separatamente.

Se Detect riconosce per errore un PDF isolato di riepilogo o specifica come fattura, nasce una fattura extra accanto alla fattura vera. Veda Più allegati PDF in un'unica e-mail per evitarlo.

Allegato Excel/ODS/CSV accanto a una fattura PDF: un allegato Excel non blocca l'elaborazione della fattura PDF, purché il file sia in un formato supportato e non superi 5 MB. Comportamento per scenario:

  • Formato supportato e non oltre 5 MB (.xlsx, .ods, .csv): il file è aggiunto alla fattura come allegato secondario (non inviato a IDR). La fattura PDF è elaborata normalmente.
  • Formato supportato e oltre 5 MB: l'intera e-mail è rifiutata con una mail di bounce.
  • Formato non supportato (.xls, .doc, .docx): l'elaborazione non è possibile.

Tipi MIME supportati: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx), application/vnd.oasis.opendocument.spreadsheet (.ods), text/csv (.csv). Non supportati: application/msword (.doc), application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx), application/vnd.ms-excel (.xls).

Rotazione pagina: le pagine non vengono ruotate automaticamente. Il cliente è responsabile dell'orientamento corretto all'invio.

Allegati grandi: un allegato molto grande viene ridotto affinché il PDF resti gestibile.

Unire gli allegati: la piattaforma può unire tutti gli allegati di una fattura elettronica in un solo PDF.

Generare PDF da XML: c'è un'opzione per generare automaticamente un PDF della fattura XML. Si combina con il merge e si imposta su: sempre, mai, oppure solo se non esiste ancora un PDF.

PDF inviato invariato: eConnect si occupa solo di traduzione/elaborazione e non modifica il file PDF inviato (un PDF può comunque essere generato).

Bounce "allegato o specifica" mentre la fattura è stata elaborata

Un mittente riceve un bounce o un avviso che un documento è "un allegato o una specifica", mentre la fattura collegata della stessa e-mail è stata elaborata normalmente? Lo stesso avviso compare anche come "Tipo di documento non corretto" o "Il file presentato (Fattura di acquisto) non può essere trattato perché il tipo di documento non è corretto". L'oggetto inglese dello stesso avviso è "This is an attachment/specification". Il bounce può riguardare anche un'immagine inline (image012.png) o un riepilogo fatture in un'e-mail inoltrata. Non è una contraddizione. Sono due esiti distinti dentro una sola e-mail.

  1. L'avviso è separato dallo stato della fattura. Non dice nulla sul fallimento o meno della fattura stessa. Controlli lo stato della fattura separatamente nella posta in arrivo.
  2. Avvio falso positivo di un'attività di conversione. Un PDF o un'immagine con abbastanza segnale di fattura (per esempio la parola "Fattura" con un numero) avvia una propria attività di conversione. Se quel documento non è una fattura, il bounce su quel documento è corretto, a parte la fattura vera nella stessa mail.
  3. Nessun ricollegamento tardivo. Una volta avviata un'attività di conversione per un allegato, quell'allegato non viene collegato in seguito alla fattura.
  4. Le attività di conversione separate non si uniscono. Più file che sono partiti come fattura restano attività di conversione separate. Non si possono unire in seguito.

Roadmap di prodotto: un miglioramento strutturale della classificazione "alla porta d'ingresso" è previsto in una futura versione PSB dell'Email Receiver (orizzonte di circa 12 mesi da settembre 2026). Fino ad allora vale il comportamento sopra.

Inoltro da Office 365 / Exchange

I clienti con Microsoft 365 / Exchange possono inoltrare la mail delle fatture da indirizzi propri (per esempio fatture@cliente.it) all'Email Receiver senza dare agli utenti finali diritti extra sulla cassetta postale. È un inoltro lato cliente verso un indirizzo di ricezione eConnect. Non è la connessione Office 365 in cui PSB legge la cassetta via Graph/OAuth.

Schema: contatto di posta + gruppo di distribuzione (mantiene il mittente originale):

  1. Crei un indirizzo Email Receiver sulla piattaforma e imposti lo stato su Attivo.
  2. Nel Centro amministrativo di Exchange, crei un contatto di posta il cui indirizzo esterno è l'indirizzo Email Receiver della piattaforma.
  3. Crei un gruppo di distribuzione con l'indirizzo fatture rivolto al cliente. Membro = il contatto di posta. Facoltativo: un alias extra sullo stesso gruppo.
  4. Provi la ricezione sulla piattaforma.

Con un solo indirizzo fatture generico, il receiver è spesso in whitelist Accetta tutto (non con Fattura bozza). Se Exchange blocca l'inoltro esterno, scelga la connessione cassetta Office 365. Eviti loop di inoltro: non inoltri mail dai domini everbinding.nl o econnect.eu.

Veda anche Ricevitore e-mail per il percorso nell'interfaccia della piattaforma.

Domande frequenti
Qual è la differenza tra i tipi di documento Fattura bozza, Fattura di vendita e Fattura di acquisto?

Con Fattura bozza, la fattura è preparata come bozza per controllo e invio manuale. Con Fattura di vendita, la fattura va direttamente in archivio. Con Fattura di acquisto, la fattura è consegnata al destinatario come fattura di acquisto. Il tipo di documento determina il percorso di elaborazione.

Posso elaborare fatture PDF tramite l'Email Receiver?

Sì. Le fatture PDF sono convertite automaticamente in formato fattura elettronica (UBL) tramite conversione IDR. Le fatture XML sono elaborate direttamente senza conversione. Per Email Receiver può indicare se accetta solo XML, solo PDF o entrambi.

Posso consentire più domini e-mail per organizzazione?

Per Email Receiver si può mettere in whitelist un solo dominio o indirizzo e-mail. Se un'organizzazione deve ricevere fatture da più domini, crei un indirizzo Email Receiver separato per ogni dominio.

Come imposto il riconoscimento fornitore per piattaforme SaaS con un indirizzo mittente generico?

Alcune piattaforme SaaS (come Harvest, Moneybird o WeFact) inviano fatture da un indirizzo e-mail generico. In quel caso imposti il riconoscimento fornitore su Reply-To Email e metta in whitelist l'indirizzo proprio del fornitore. La fattura viene così collegata al fornitore corretto.

Qual è la differenza tra l'Email Receiver e il connettore Email?

L'Email Receiver è un'App: il software invia una fattura come allegato a un indirizzo eConnect e la piattaforma elabora quella e-mail in arrivo. Il connettore Email è una Connessione: eConnect inoltra automaticamente le fatture ricevute a un indirizzo e-mail a sua scelta, tramite chiavi di connessione sulla piattaforma. Non viene inviato nulla. Il nome "connettore" può confondersi con l'Email Receiver, ma sono due funzioni diverse con direzione opposta. Veda Chiavi di connessione: connettore Email per la funzione di inoltro.

Cosa succede se invio più allegati PDF?

Se un allegato è riconosciuto come fattura e gli altri sono altri tipi di documento, quegli altri documenti sono aggiunti come allegato. Se più allegati sono riconosciuti come fattura, ogni PDF fattura è elaborato individualmente come fattura separata. Il sistema non collega automaticamente gli altri allegati a una fattura specifica della stessa mail.

Le pagine vengono ruotate automaticamente?

No. Le pagine non vengono ruotate automaticamente. Il cliente è responsabile dell'orientamento corretto all'invio.

Le fatture non arrivano: da dove inizio la diagnosi?

Controlli in ordine: (1) l'indirizzo …@trust.econnect.eu è stato copiato senza refusi, (2) il Mittente attendibile è nello stato Attivo e non "Creato bozza", (3) l'indirizzo del mittente è in whitelist in modo corretto, (4) il tipo di documento impostato è corretto. Un Email Receiver difettoso o inattivo non va necessariamente sostituito con uno nuovo. Corregga prima la configurazione.


Vuole sapere quali metodi di integrazione esistono per il suo software? Veda la panoramica dei metodi di integrazione.

Colleghi il software