En plus des webhooks, la PSB offre la possibilité d'envoyer des notifications par e-mail. Un e-mail hook (aussi appelé mailhook ou mailto-hook) envoie un e-mail lors de chaque événement sur un topic choisi. Pratique pour les organisations qui ne disposent pas de leur propre endpoint webhook, ou en complément de webhooks existants.

Enregistrez un hook via l'API avec une action mailto: :

{
  "action": "mailto:finance@votre-entreprise.fr",
  "topics": ["InvoiceReceived"]
}

À chaque facture reçue, la PSB envoie désormais un e-mail de notification à l'adresse spécifiée. L'adresse e-mail dans l'action peut également contenir un placeholder : [senderEmailAddress] ou [receiverEmailAddress] pour envoyer dynamiquement à l'adresse e-mail de l'expéditeur ou du destinataire.

Attention : Lors de l'utilisation de placeholders, spécifiez toujours le paramètre fallbackEmail. Si l'adresse e-mail n'est pas disponible dans le document, la PSB envoie la notification à l'adresse de secours.

Les e-mail hooks supportent une configuration étendue via des paramètres de requête dans l'URL de l'action. Vous construisez l'URL comme suit : mailto:adresse@domaine.fr?param1=valeur&param2=valeur.

La PSB prend en charge deux versions du template d'e-mail :

Conseil : Utilisez toujours la version 1.0 pour les nouvelles configurations. La version 0.9 envoie depuis l'ancien domaine eVerbinding, qui n'est plus activement maintenu.

Un e-mail hook qui envoie un e-mail à chaque facture reçue avec la facture en pièce jointe PDF, sans le XML :

mailto:finance@votre-entreprise.fr?includeAttachment=true&excludePrimaryAttachment=true&version=1.0

Un hook qui envoie dynamiquement à l'expéditeur, avec un fallback :

mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@votre-entreprise.fr

Vous souhaitez un contrôle total sur la mise en page de l'e-mail ? Faites configurer un template SendGrid personnalisé par eConnect et utilisez le paramètre templateId. Vous pouvez également connecter votre propre compte SendGrid en ajoutant un objet init avec votre clé API à la configuration du hook.

Si un client constate que les factures entrantes transférées ne contiennent que le XML et non le PDF, cela est causé par excludeAdditionalAttachments=true. Lors de la création d'un connecteur e-mail/mailhook, ce paramètre est par défaut à true, ce qui signifie que les pièces jointes PDF ne sont pas envoyées.

Solution : définissez excludeAdditionalAttachments=false sur le mailhook. Les pièces jointes supplémentaires (PDF/PNG issus du XML) seront alors incluses dans l'e-mail.

Exécution : si le connecteur e-mail créé automatiquement (plateforme Collabrr) est concerné, seul TechSupport peut effectuer cette modification. Ne modifiez pas le connecteur manuellement après la correction — une modification manuelle écrasera la correction et supprimera à nouveau la pièce jointe PDF. Si le client gère son propre mailhook PSB, il peut définir le paramètre sur false lui-même.

Vous pouvez spécifier plusieurs adresses e-mail en créant des hooks séparés, ou en utilisant le paramètre bcc pour des destinataires supplémentaires.

Un e-mail hook envoie des notifications depuis une adresse no-reply (noreply@everbinding.nl pour la version 0.9, noreply@econnect.email pour la version 1.0). Si la boîte de réception répond automatiquement — par exemple via un message d'absence — cette réponse revient souvent sous forme d'Undeliverable ou de NDR (non-delivery report), généralement avec le code d'erreur 550 5.1.10 Recipient not found.

Si vous recevez un tel Undeliverable/NDR dont l'objet fait référence à une notification PSB telle qu'InvoiceSent, cela ne signifie pas que la facture n'a pas été livrée via Peppol. Le topic InvoiceSent signifie que la facture sortante a été livrée avec succès à la partie destinataire (voir configurer les webhooks : topics fréquemment utilisés). Le rebond survient parce que la boîte mail du client a répondu automatiquement à une adresse no-reply — et non en raison d'une erreur de livraison Peppol.

Vérification :

1. Lisez la pièce jointe du NDR : l'objet d'origine ou l'expéditeur envelope fait-il référence à une adresse no-reply (noreply@everbinding.nl ou noreply@econnect.email) ?
2. S'il s'agit d'une notification comme InvoiceSent, la facture a déjà été livrée avec succès. Le rebond est une réaction à l'e-mail de notification lui-même, pas une erreur de livraison.
3. Demandez au client de désactiver la réponse automatique ou le message d'absence pour les e-mails provenant de everbinding.nl et econnect.eu, ou d'exclure les adresses no-reply des réponses automatiques.

Une véritable erreur de livraison plateforme apparaît avec le statut Delivery Failed dans la boîte d'envoi — et non sous forme de NDR sur une adresse no-reply.

Consultez la spécification API complète sur psb.econnect.eu pour toutes les configurations et exemples possibles.