Nie každý systém dokáže doručovať dokumenty cez API pripojenie. Pomocou mailfrom hook umožníte odosielanie dokumentov ako e-mailových príloh do PSB. PSB vygeneruje unikátnu e-mailovú adresu s tokenom (napríklad dj8fwhrqxjhw@econnect.email). Akýkoľvek dokument odoslaný ako príloha na túto adresu je automaticky spracovaný ako faktúra, objednávka alebo iný typ dokumentu.

E-mailový prijímací prvok PSB je zámerne jednoduchý ("hlúpy"): všetky súbory z e-mailovej prílohy sú spracované ako nový dokument bez ďalšej interpretácie. Technicky PSB na to používa SendGrid Inbound Parse.

Pri vytváraní mailfrom hook PSB vygeneruje unikátnu tokenovú adresu. Pomocou publishTopic nakonfigurujete, čo sa má stať s prichádzajúcimi dokumentmi, napríklad odoslanie cez Peppol (SendInvoice) alebo spracovanie ako prijatý dokument (ReceiveInvoice).

Priebeh je nasledovný:

1. Zaregistrujete mailfrom hook s publishTopic
2. PSB vygeneruje unikátnu e-mailovú adresu s tokenom
3. Používateľ alebo systém odošle e-mail s dokumentom v prílohe na túto adresu
4. PSB spracuje prílohy ako dokumenty a publikuje ich na určenej téme
5. Prípadné nadväzujúce akcie (odoslanie, transformácia) sa vykonajú automaticky

Zaregistrujte hook cez API s akciou mailfrom://. Použite $token$ ako placeholder; PSB ho nahradí vygenerovaným tokenom v odpovedi. Pozrite si tiež dokumentáciu PSB: Mail from.

{
  "id": "1",
  "name": "mail from trigger",
  "action": "mailfrom://*&to=$token$@econnect.email",
  "publishTopics": [
    "SendInvoice"
  ],
  "isActive": true
}

Po registrácii odpoveď obsahuje skutočnú tokenovú adresu:

mailfrom://*&to=dj8fwhrqxjhw@econnect.email

Od tohto okamihu sú všetky prílohy odoslané na dj8fwhrqxjhw@econnect.email spracované ako faktúry a publikované na téme SendInvoice.

Akcia sa skladá z časti from a to:

mailfrom://{from}&to={to}

Tokenová adresa môže byť umiestnená buď v časti from, alebo to. Aspoň jedna z nich musí obsahovať token, aby PSB mohol prepojiť e-mail so správnym hookom.

Zástupný znak * v časti from znamená, že sú akceptované e-maily od akejkoľvek adresy odosielateľa. Ak chcete obmedziť, ktorí odosielatelia môžu dokumenty odosielať, zadajte konkrétnu e-mailovú adresu.

Poznámka: vždy používajte správnu doménu pre dané prostredie. E-maily odoslané na produkčnú doménu sú spracované ako skutočné dokumenty a nie je možné to vrátiť späť.

Voliteľne môžete zadať sourceDocumentTypeId a targetDocumentTypeId ako query parametre. PSB potom automaticky transformuje prílohu do určeného cieľového formátu, ak je k dispozícii vhodná transformácia. Špeciálne znaky v documentTypeId musia byť URL-kódované.

{
  "id": "1",
  "name": "mail from met transformatie",
  "action": "mailfrom://*&to=$token$@econnect.email?sourceDocumentTypeId=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Anen.nl%3Anlcius%3Av1.0%3A%3A2.1&targetDocumentTypeId=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Anen.nl%3Anlcius%3Av1.0%3A%3A2.1",
  "publishTopics": [
    "SendInvoice"
  ],
  "isActive": true
}

Mailfrom hook podporuje práve jeden publishTopic. Táto téma určuje, ako PSB spracuje prichádzajúce dokumenty.

Tip: použitím RecognizeSalesInvoice ako publish topic môžete odosielať PDF faktúry e-mailom a nechať ich automaticky rozpoznať IDR. Tým kombinujete mailfrom s inteligentným rozpoznávaním dokumentov.

V predvolenom nastavení PSB používa doménu econnect.email (alebo accp.econnect.email pre akceptáciu). Je tiež možné použiť vlastnú doménu, aby e-mailová adresa zodpovedala vašej organizácii. Kontaktujte eConnect pre nastavenie.

• Mailfrom hooks spracovávajú iba prílohy. Textové telo e-mailu samotného nie je spracované ako dokument.
• Každý hook podporuje maximálne jeden publishTopic. Pre rôzne typy spracovania (odosielanie, prijímanie, rozpoznávanie) vytvorte samostatné hooky.
• Uistite sa, že prílohy sú v podporovanom formáte (XML, PDF). Iné typy súborov nie sú spracované.

Kompletná API špecifikácia je k dispozícii na psb.econnect.eu so všetkými konfiguračnými možnosťami a príkladmi.