Además de los webhooks, la PSB ofrece la posibilidad de enviar notificaciones por correo electrónico. Un e-mail hook (también llamado mailhook o mailto-hook) envía un correo electrónico con cada evento en un topic elegido. Resulta útil para organizaciones que no disponen de un endpoint webhook propio, o como complemento de webhooks existentes.

Registre un hook a través de la API con una acción mailto::

{
  "action": "mailto:finanzas@su-empresa.es",
  "topics": ["InvoiceReceived"]
}

Con cada factura recibida, la PSB envía ahora un correo electrónico de notificación a la dirección indicada. La dirección de correo electrónico en la acción también puede contener un placeholder: [senderEmailAddress] o [receiverEmailAddress] para enviar dinámicamente a la dirección de correo del remitente o del destinatario.

Atención: Al utilizar placeholders, especifique siempre el parámetro fallbackEmail. Si la dirección de correo electrónico no está disponible en el documento, la PSB envía la notificación a la dirección de respaldo.

Los e-mail hooks admiten una configuración amplia mediante parámetros de consulta en la URL de la acción. Construya la URL de la siguiente forma: mailto:direccion@dominio.es?param1=valor&param2=valor.

La PSB admite dos versiones de la plantilla de correo electrónico:

Consejo: Utilice siempre la versión 1.0 para nuevas configuraciones. La versión 0.9 envía desde el antiguo dominio eVerbinding, que ya no se mantiene activamente.

Un e-mail hook que envía un correo electrónico con cada factura recibida, con la factura como adjunto PDF, sin el XML:

mailto:finanzas@su-empresa.es?includeAttachment=true&excludePrimaryAttachment=true&version=1.0

Un hook que envía dinámicamente al remitente, con un fallback:

mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@su-empresa.es

¿Desea un control total sobre el diseño del correo electrónico? Solicite a eConnect que configure una plantilla SendGrid personalizada y utilice el parámetro templateId. También puede conectar su propia cuenta SendGrid añadiendo un objeto init con su clave API a la configuración del hook.

Si un cliente constata que las facturas entrantes reenviadas contienen solo el XML y no el PDF, esto se debe a excludeAdditionalAttachments=true. Al crear un conector de correo/mailhook, este parámetro está configurado por defecto en true, lo que significa que los adjuntos PDF no se envían.

Solución: establezca excludeAdditionalAttachments=false en el mailhook. Los adjuntos adicionales (PDF/PNG del XML) se incluirán entonces en el correo electrónico.

Ejecución: si el conector de correo creado automáticamente (plataforma Collabrr) está implicado, solo TechSupport puede realizar este cambio. No modifique el conector manualmente tras la corrección — una modificación manual sobreescribirá la corrección y volverá a suprimir el adjunto PDF. Si el cliente gestiona su propio mailhook PSB, puede establecer el parámetro en false por sí mismo.

Puede especificar múltiples direcciones de correo electrónico creando hooks separados, o utilizando el parámetro bcc para destinatarios adicionales.

Un e-mail hook envía notificaciones desde una dirección no-reply (noreply@everbinding.nl para la versión 0.9, noreply@econnect.email para la versión 1.0). Si el buzón receptor responde automáticamente — por ejemplo mediante un mensaje de ausencia — esa respuesta suele rebotar como Undeliverable o NDR (non-delivery report), normalmente con el código de error 550 5.1.10 Recipient not found.

Si recibe un Undeliverable/NDR de este tipo con un asunto que hace referencia a una notificación PSB como InvoiceSent, eso no significa que la factura no haya sido entregada a través de Peppol. El topic InvoiceSent indica que la factura saliente fue entregada con éxito a la parte receptora (consulte configurar webhooks: topics de uso frecuente). El rebote se produce porque el buzón del cliente respondió automáticamente a una dirección no-reply — no debido a un error de entrega Peppol.

Verificación:

1. Lea el adjunto del NDR: ¿el asunto original o el remitente del sobre hacen referencia a una dirección no-reply (noreply@everbinding.nl o noreply@econnect.email)?
2. Si se trata de una notificación como InvoiceSent, la factura ya ha sido entregada correctamente. El rebote es una reacción al propio correo de notificación, no un error de entrega.
3. Solicite al cliente que desactive la respuesta automática o el mensaje de ausencia para correos de everbinding.nl y econnect.eu, o que excluya las direcciones no-reply de las respuestas automáticas.

Un error real de entrega en la plataforma aparece como estado Delivery Failed en la bandeja de salida — no como un NDR en una dirección no-reply.

Consulte la especificación API completa en psb.econnect.eu para todas las configuraciones y ejemplos posibles.