E-Mail-Versand

Dieses Dokument soll dazu dienen die Zusammenhänge der plus.e-Invoicing-Konfiguration und dem von der Lösung erzeugten elektronischen Rechnungsdokuments nachvollziehen zu können. Der Fokus soll dabei darauf liegen, wie erzeugte elektronische Rechnungsdokumente als E-Mail versandt werden können.

Die Funktionalität zum E-Mail wurde mit der Version 1.1.3.0 eingeführt.

Motivation/Problembeschreibung

Nach der Erstellung eines elektronischen Rechnungsdokuments soll es möglich sein, das erzeugte Dokument als Anhang in einer E-Mail an den in der Geb. Verkaufsrechnung angegebenen Debitor zu senden. Dazu soll der in Business Central integrierte E-Mail-Editor verwendet werden können. Alternativ soll es möglich sein die E-Mail direkt zu versenden, ohne zusätzliche Nutzerinteraktion.

Spezifikation

Für die Umsetzung des E-Mail-Versandes wird keine Information aus der ZUGFeRD-Spezifikation benötigt.

Notwendige Konfiguration

E-Mail Konten/SMTP-Konfiguration

Je nach verwendeter Business Central Version ist es notwendig ein E-Mail Konto in der Verwaltungsübersicht E-Mail-Konten oder SMTP-Mail-Einrichtung einzurichten. Zur Unterscheidung, für welche Version, welche Verwaltungsseite notwendig ist, kann die folgenden Abbildung herangezogen werden:

E-Mail-Extension Einführung

Die Verwaltungsseite E-Mail-Konten wird mit der neuen Enhanced email capabilities-Funktion eingeführt und ist ab Version 17.0 installierbar. Ab Version 17.0 kann entsprechend die plus.e-Invoicing-Version basierend auf dem Branch releases/1.1.3.0 ausgeliefert werden. Für die Business Central Versionen 15 und 16 sind die entsprechendenen Release Branches BC15/releases/1.1.3.0 und BC16/releases/1.1.3.0 zu verwenden. Der Unterschied besteht in der Verwendung der zur Verfügung stehenden Schnittstellen in AL. Entsprechend steht für Version 17 die Codeunit kmitsZF_MailHandler und für die Versionen 15 und 16 die Codeunit kmmitsZF_LegacyMailHandler zur Verfügung.

Profile

Zur Unterstützung des E-Mail-Versandes, wurde der Aktionstyp in plus.e-Invoicing Profile um die Option Sende Email ergänzt. Die folgende Abbildung zeigt die notwendigen Änderungen in den Profileinstellungen:

Profileinstellungen zum E-Mail-Versand

Über das Feld Email Silent Mode kann eingestellt werden, ob das Öffnen des E-Mail Editors vor dem Versand der E-Mail geöffnet werden soll. Silent Mode bedeutet hierbei, dass das Öffnen des Editors nicht erwünscht ist.

Beispiel

Die folgenden Abbildungen zeigen den E-Mail Editor für die Business Central Versionen 16 und 17.

Business Central 16

E-Mail Editor BC16

Beschreibung der Felder:

  1. Die im Debitor hinterlegte E-Mail-Adresse wird automatisch übernommen
  2. Der Betreff wird entsprechend der Dokumentnummer und des Dokumenttyps angepasst
  3. Das erzeugte elektronische Rechnungsdokument ist als Anhang an die E-Mail angefügt
  4. Über die Verwaltungsseite Berichtsauswahl - Verkauf kann wie gewohnt der für den E-Mail-Body zu verwendende Report ausgewählt werden. Alternativ kann auch ein eigener Text verfasst werden.

Business Central 17

E-Mail Editor BC17

Beschreibung der Felder:

  1. Die im Debitor hinterlegte E-Mail-Adresse wird automatisch übernommen
  2. Der Betreff wird entsprechend der Dokumentnummer und des Dokumenttyps angepasst
  3. Über die Verwaltungsseite Berichtsauswahl - Verkauf kann wie gewohnt der für den E-Mail-Body zu verwendende Report ausgewählt werden. Alternativ kann auch ein eigener Text verfasst werden.
  4. Das erzeugte elektronische Rechnungsdokument ist als Anhang an die E-Mail angefügt