Nicht jedes System kann Dokumente über eine API-Verbindung liefern. Mit einem Mailfrom-Hook ermöglichen Sie die Einreichung von Dokumenten als E-Mail-Anhänge an die PSB. Die PSB generiert eine eindeutige E-Mail-Adresse mit einem Token (zum Beispiel dj8fwhrqxjhw@econnect.email). Jedes Dokument, das als Anhang an diese Adresse gesendet wird, wird automatisch als Rechnung, Bestellung oder anderer Dokumenttyp verarbeitet.

Der PSB-E-Mail-Empfänger ist bewusst einfach gehalten ("dumm"): Alle Dateien aus dem E-Mail-Anhang werden ohne weitere Interpretation als neues Dokument verarbeitet. Technisch nutzt die PSB hierfür SendGrid Inbound Parse.

Wenn Sie einen Mailfrom-Hook erstellen, generiert die PSB eine eindeutige Token-Adresse. Über ein publishTopic konfigurieren Sie, was mit den eingehenden Dokumenten passieren soll, zum Beispiel der Versand über Peppol (SendInvoice) oder die Verarbeitung als empfangenes Dokument (ReceiveInvoice).

Der Ablauf ist wie folgt:

1. Sie registrieren einen Mailfrom-Hook mit einem publishTopic
2. Die PSB generiert eine eindeutige E-Mail-Adresse mit einem Token
3. Ein Benutzer oder System sendet eine E-Mail mit Dokumentanhang/-anhängen an diese Adresse
4. Die PSB verarbeitet die Anhänge als Dokumente und veröffentlicht sie auf dem angegebenen Topic
5. Etwaige Folgeaktionen (Versand, Transformation) werden automatisch ausgeführt

Registrieren Sie einen Hook über die API mit einer mailfrom://-Action. Verwenden Sie $token$ als Platzhalter; die PSB ersetzt diesen in der Antwort durch das generierte Token. Siehe auch die PSB-Dokumentation: Mail from.

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

Nach der Registrierung enthält die Antwort die tatsächliche Token-Adresse:

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

Ab diesem Moment werden alle Anhänge, die an dj8fwhrqxjhw@econnect.email gesendet werden, als Rechnungen verarbeitet und auf dem Topic SendInvoice veröffentlicht.

Die Action besteht aus einem from- und einem to-Teil:

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

Die Token-Adresse kann entweder im from- oder im to-Teil platziert werden. Mindestens einer der beiden muss das Token enthalten, damit die PSB die E-Mail dem richtigen Hook zuordnen kann.

Der Platzhalter * im from-Teil bedeutet, dass E-Mails von beliebiger Absenderadresse akzeptiert werden. Wenn Sie einschränken möchten, welche Absender Dokumente einreichen dürfen, geben Sie eine spezifische E-Mail-Adresse ein.

Hinweis: Verwenden Sie immer die richtige Domain pro Umgebung. E-Mails, die an die Produktionsdomain gesendet werden, werden als echte Dokumente verarbeitet und können nicht rückgängig gemacht werden.

Optional können Sie sourceDocumentTypeId und targetDocumentTypeId als Query-Parameter angeben. Die PSB transformiert den Anhang dann automatisch in das angegebene Zielformat, sofern eine geeignete Transformation verfügbar ist. Sonderzeichen in der documentTypeId müssen URL-kodiert sein.

{
  "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
}

Ein Mailfrom-Hook unterstützt genau ein publishTopic. Dieses Topic bestimmt, wie die PSB die eingehenden Dokumente verarbeitet.

Tipp: Indem Sie RecognizeSalesInvoice als Publish-Topic verwenden, können Sie PDF-Rechnungen per E-Mail einreichen und automatisch von der IDR erkennen lassen. So kombinieren Sie Mailfrom mit intelligenter Dokumentenerkennung.

Standardmäßig verwendet die PSB die Domain econnect.email (bzw. accp.econnect.email für die Akzeptanzumgebung). Es ist auch möglich, eine benutzerdefinierte Domain zu verwenden, sodass die E-Mail-Adresse zu Ihrer eigenen Organisation passt. Kontaktieren Sie eConnect, um dies einzurichten.

• Mailfrom-Hooks verarbeiten ausschließlich Anhänge. Der Textkörper der E-Mail selbst wird nicht als Dokument verarbeitet.
• Jeder Hook unterstützt maximal ein publishTopic. Für verschiedene Verarbeitungstypen (Versand, Empfang, Erkennung) erstellen Sie separate Hooks.
• Stellen Sie sicher, dass die Anhänge in einem unterstützten Format vorliegen (XML, PDF). Andere Dateitypen werden nicht verarbeitet.

Die vollständige API-Spezifikation finden Sie unter psb.econnect.eu mit allen Konfigurationsoptionen und Beispielen.