Kromě webhooků nabízí PSB možnost odesílat notifikace e-mailem. E-mail hook (také mailhook nebo mailto hook) odešle e-mail při každé události na zvoleném topiku. Je to praktické pro organizace, které nemají vlastní webhook endpoint, nebo jako doplněk k existujícím webhookům.

Zaregistrujte hook přes API s akcí mailto::

{
  "action": "mailto:finance@vase-firma.cz",
  "topics": ["InvoiceReceived"]
}

Při každé přijaté faktuře PSB nyní odešle notifikační e-mail na zadanou adresu. E-mailová adresa v akci může obsahovat i placeholder: [senderEmailAddress] nebo [receiverEmailAddress] pro dynamické odesílání na e-mailovou adresu odesílatele nebo příjemce.

Pozor: Při placeholderech vždy použijte parametr fallbackEmail. Pokud e-mailová adresa není v dokumentu k dispozici, PSB odešle notifikaci na fallback adresu.

E-mail hooky podporují rozšířenou konfiguraci přes parametry dotazu v action URL. URL sestavíte jako mailto:adresa@domena.cz?param1=hodnota&param2=hodnota.

PSB podporuje dvě verze e-mailové šablony:

Tip: Pro nové konfigurace používejte vždy verzi 1.0. Verze 0.9 odesílá ze staré domény eVerbinding, která se již aktivně neudržuje.

E-mail hook, který při každé přijaté faktuře odešle e-mail s fakturou jako PDF přílohou, bez XML:

mailto:finance@vase-firma.cz?includeAttachment=true&excludePrimaryAttachment=true&version=1.0

Hook, který dynamicky odesílá odesílateli, s fallbackem:

mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@vase-firma.cz

Chcete plnou kontrolu nad formátováním e-mailu? Nechte si od eConnectu nakonfigurovat vlastní SendGrid šablonu a použijte parametr templateId. Můžete také propojit vlastní SendGrid účet přidáním objektu init s Vaším API klíčem do konfigurace hooku.

Pokud zákazník zjistí, že přeposílané příchozí faktury obsahují pouze XML a nikoliv PDF, příčinou je excludeAdditionalAttachments=true. Při vytvoření e-mailového konektoru/mailhooku je tento parametr ve výchozím nastavení true, což znamená, že přílohy PDF nejsou odesílány.

Řešení: nastavte excludeAdditionalAttachments=false na mailhooku. Dodatečné přílohy (PDF/PNG z XML) budou poté v e-mailu přiloženy.

Provedení: pokud se týká automaticky vytvořeného e-mailového konektoru (platforma Collabrr), tuto změnu může provést pouze TechSupport. Nekonfigurujte konektor ručně po provedení opravy — ruční úprava přepíše opravu a opět potlačí přílohu PDF. Pokud zákazník spravuje vlastní PSB mailhook, může parametr nastavit na false sám.

Můžete zadat více e-mailových adres vytvořením samostatných hooků, nebo použitím parametru bcc pro další příjemce.

E-mail hook odesílá notifikace z no-reply adresy (noreply@everbinding.nl pro verzi 0.9, noreply@econnect.email pro verzi 1.0). Pokud přijímající poštovní schránka odpoví automaticky — například prostřednictvím zprávy o nepřítomnosti — tato odpověď se často vrátí jako Undeliverable nebo NDR (non-delivery report), typicky s kódem chyby 550 5.1.10 Recipient not found.

Obdržíte-li takový Undeliverable/NDR s předmětem odkazujícím na PSB notifikaci, jako je InvoiceSent, neznamená to, že faktura nebyla doručena přes Peppol. Topik InvoiceSent znamená, že odchozí faktura byla úspěšně doručena přijímající straně (viz nastavení webhooků: často používané topiky). Bounce vzniká proto, že poštovní schránka zákazníka automaticky odpověděla na no-reply adresu — nikoliv z důvodu chyby doručení přes Peppol.

Ověření:

1. Přečtěte přílohu NDR: odkazuje původní předmět nebo odesílatel obálky na no-reply adresu (noreply@everbinding.nl nebo noreply@econnect.email)?
2. Jedná-li se o notifikaci jako InvoiceSent, faktura již byla úspěšně doručena. Bounce je reakcí na samotný notifikační e-mail, nikoli chybou doručení.
3. Požádejte zákazníka, aby deaktivoval automatické odpovědi nebo zprávu o nepřítomnosti pro e-maily z everbinding.nl a econnect.eu, nebo aby no-reply adresy vyloučil z automatických odpovědí.

Skutečná chyba doručení platformy se projeví stavem Delivery Failed v odchozí poště — nikoliv jako NDR na no-reply adresu.

Kompletní API specifikaci naleznete na psb.econnect.eu se všemi možnostmi konfigurace a příklady.