Oltre ai webhook, la PSB offre la possibilità di inviare notifiche via e-mail. Un e-mail hook (detto anche mailhook o mailto hook) invia un'e-mail ad ogni evento su un topic scelto. Comodo per organizzazioni che non dispongono di un proprio endpoint webhook, o come integrazione ai webhook esistenti.

Registrare un hook tramite l'API con un'action mailto::

{
  "action": "mailto:finanza@sua-azienda.it",
  "topics": ["InvoiceReceived"]
}

Ad ogni fattura ricevuta, la PSB invierà un'e-mail di notifica all'indirizzo indicato. L'indirizzo e-mail nell'action può contenere anche un placeholder: [senderEmailAddress] o [receiverEmailAddress] per inviare dinamicamente all'indirizzo e-mail del mittente o del destinatario.

Attenzione: Con i placeholder utilizzare sempre il parametro fallbackEmail. Se l'indirizzo e-mail non è disponibile nel documento, la PSB invierà la notifica all'indirizzo di fallback.

Gli e-mail hook supportano una configurazione estesa tramite parametri query nell'URL dell'action. L'URL si costruisce come mailto:indirizzo@dominio.it?param1=valore&param2=valore.

La PSB supporta due versioni del template e-mail:

Suggerimento: Utilizzare sempre la versione 1.0 per le nuove configurazioni. La versione 0.9 invia dal vecchio dominio eVerbinding, che non viene più attivamente mantenuto.

Un e-mail hook che ad ogni fattura ricevuta invia un'e-mail con la fattura come allegato PDF, senza l'XML:

mailto:finanza@sua-azienda.it?includeAttachment=true&excludePrimaryAttachment=true&version=1.0

Un hook che invia dinamicamente al mittente, con un fallback:

mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@sua-azienda.it

Desidera il pieno controllo sul layout dell'e-mail? Faccia configurare da eConnect un template SendGrid personalizzato e utilizzi il parametro templateId. È possibile collegare anche un account SendGrid proprio aggiungendo un oggetto init con la propria API key alla configurazione dell'hook.

Se un cliente rileva che le fatture in entrata inoltrate contengono solo il file XML e non il PDF, ciò è causato da excludeAdditionalAttachments=true. Al momento della creazione di un connettore e-mail/mailhook, questo parametro è impostato di default su true, il che significa che gli allegati PDF non vengono inviati.

Soluzione: impostare excludeAdditionalAttachments=false sul mailhook. Gli allegati aggiuntivi (PDF/PNG dall'XML) verranno quindi inclusi nell'e-mail.

Esecuzione: se è coinvolto il connettore e-mail creato automaticamente (piattaforma Collabrr), solo TechSupport può apportare questa modifica. Non modificare manualmente il connettore dopo la correzione — una modifica manuale sovrascriverà la correzione e sopprimerà nuovamente l'allegato PDF. Se il cliente gestisce il proprio mailhook PSB in autonomia, può impostare il parametro su false da solo.

È possibile specificare più indirizzi e-mail creando hook separati, oppure utilizzando il parametro bcc per destinatari aggiuntivi.

Un e-mail hook invia notifiche da un indirizzo no-reply (noreply@everbinding.nl per la versione 0.9, noreply@econnect.email per la versione 1.0). Se la casella di posta ricevente risponde automaticamente — ad esempio tramite un messaggio di assenza — tale risposta spesso torna indietro come Undeliverable o NDR (non-delivery report), tipicamente con codice di errore 550 5.1.10 Recipient not found.

Se si riceve un Undeliverable/NDR di questo tipo con un oggetto che fa riferimento a una notifica PSB come InvoiceSent, ciò non significa che la fattura non sia stata consegnata tramite Peppol. Il topic InvoiceSent indica che la fattura in uscita è stata consegnata con successo alla parte ricevente (vedere configurare i webhook: topic di uso comune). Il bounce si verifica perché la casella del cliente ha risposto automaticamente a un indirizzo no-reply — non a causa di un errore di consegna Peppol.

Verifica:

1. Leggere l'allegato del NDR: l'oggetto originale o il mittente busta fa riferimento a un indirizzo no-reply (noreply@everbinding.nl o noreply@econnect.email)?
2. Se si tratta di una notifica come InvoiceSent, la fattura è già stata consegnata con successo. Il bounce è una reazione all'e-mail di notifica stessa, non un errore di consegna.
3. Chiedere al cliente di disabilitare la risposta automatica o il messaggio di assenza per le e-mail provenienti da everbinding.nl e econnect.eu, oppure di escludere gli indirizzi no-reply dalle risposte automatiche.

Un vero errore di consegna della piattaforma appare come stato Delivery Failed nella posta in uscita — non come NDR su un indirizzo no-reply.

Consultare la specifica API completa su psb.econnect.eu per tutte le configurazioni ed esempi possibili.