====== offer-cube / Dokument und Vorlagen für Emails ======

Zurück zur [[offer-cube:howto|Anleitungen / HowTos]]

Siehe auch [[offer-cube:howto:offer|Angebote]] \\
Siehe auch [[offer-cube:howto:order|Auftrag und Lieferschein]] \\
Siehe auch [[offer-cube:howto:pdf-special-font|PDF Power User Funktionen Schriftstile]] \\
Siehe auch [[offer-cube:howto:pdf-special-img|PDF Power User Funktion Bild einfügen]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

Siehe auch [[offer-cube:faq:faq_ooi-grussformel_signatur_emails_aendern|Grußformel/Signatur in Emails]] \\

Siehe auch [[offer-cube:howto:docmeta|Dokument Vorlagen für Textblöcke]] \\
Siehe auch [[offer-cube:howto:ooi-textblocks|Überschrift, Texte und Textblöcke in Angebot, Auftrag, Rechnung bearbeiten]]

===== Allgemeines / Zusammenfassung =====

Im Modul "//Dokument Vorlagen//" (//docmeta//) finden sich Vorlagen für Form-App (digitale Formulare), Textbausteine für [[offer-cube:howto:offer|Angebote]]/[[offer-cube:howto:order|Auftrag]]/Rechnungen sowie Vorlagen für Emails.

Die Dokument Vorlagen finden sich unter //**Einstellungen**// --> //**Dokument Vorlagen**//

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-01-settings-dokumente.png|Einstellungen -> Dokument Vorlagen}}

Die Vorlagen werden in unterschiedliche Typen eingeteilt:

	* //**Formular Vorlagen**// sind die Vorlagen für die FormCube digitalen Formulare der Formular-App (kostenpflichtiges Addon)
	* //**PDF Vorlage**// sind Vorlagen für PDF / Dokument Generierung z.B. für die PDFs der automatischen Mahnungen
	* //**Mail-Vorlage**// sind Vorlagen für versendete Emails z.B. bei Versendung automatischer Emails durch "//Hooks//" oder zur manuellen Auswahl bei Versand eines Angebots/Auftrags oder Rechnung
	* //**[[offer-cube:howto:docmeta|Textblöcke]]**// sind einzelne Textblock Vorlagen, die direkt in die Texte eines Angebots, Auftrags oder einer Rechnung als Beschreibung oder Appendix übernommen werden können
	* //**Email-Textblöcke**// sind einzelne Textblock Vorlagen, die direkt in die Texte zum Versand einer Email für Angebote/Aufträge oder Rechnung verwendet werden können

**ACHTUNG:** Soll nur die Grußformel ("//mit freundlichen Grüßen Ihr XY-Firma Team//") oder die Signatur der Email geändert werden --> siehe [[offer-cube:faq:faq_ooi-grussformel_signatur_emails_aendern.txt|Grußformel/Signatur in Emails ändern]]

===== Email Vorlagen anlegen =====

Beim Erstellen der Dokumenten Vorlage für eine neue Email kann auch das //Dokument Ziel// angegeben werden, für das diese Vorlage gültig ist:

	* |invoice| = Rechnung
	* |offer| = Angebot
	* |order| = Auftrag
	* |supplierorder| = Lieferantenbestellung

Soll die Email Vorlage für mehrere Objekte gültig sein bzw. zur Auswahl stehen, so können diese auch in Kombination angegeben werden:

	* |invoice|offer|order| = Rechnung und Angebot und Auftrag

**WICHTIG:** Die senkrechten Striche (Pipes) MÜSSEN auch vorne und hinten angegeben werden.

Im Betreff können natürlich [[offer-cube:howto:pdf-special-variables|Variablen]] verwendet werden:
<code>
[[$CONFIGURATION.ownCompany]]: [[if $it.summary]][[$it.summary]] ([[/if]]Angebot [[$it._objref]][[if $it.summary]])[[/if]] [[$it.id]]
</code>

{{offer-cube:howto:docmeta-email:offer-cube_howto-docmeta-email-01-new.png|Neue Mail Vorlage anlegen}}

Nun können die Textblöcke angelegt werden, aus denen die Email besteht.

Auch hier können wieder [[offer-cube:howto:pdf-special-variables|Variablen]] verwendet werden (siehe Beispiele unten).

Bilder werden als base64 kodierte Inhalte eingefügt. \\
Hierzu einfach das gewünschte Bild (z.B. Logo) in base64 umwandeln und dann folgendermaßen einbinden:
<code>
<img src="data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAACYCAIAAACd9YxIAAAABnRSTlMAAAAAAABupgeRAAAACXBIWXMAAAsTAAALEw....">
</code>

{{offer-cube:howto:docmeta-email:offer-cube_howto-docmeta-email-02-docparts.png|Textblöcke anlegen aus denen eine Email besteht}}


===== Email Vorlagen verwenden =====

Die angelegten Email Vorlagen stehen je nach eingestelltem Dokumenten Ziel dann in [[offer-cube:howto:offer|Angebote]], [[offer-cube:howto:order|Auftrag]] oder [[offer-cube:howto:invoice|Rechnung]] im Senden Dialog zur Verfügung.

{{offer-cube:howto:docmeta-email:offer-cube_howto-docmeta-email-11-offer-select-send.png|Vorlage beim Versenden auswählen}}


{{offer-cube:howto:docmeta-email:offer-cube_howto-docmeta-email-12-email-result.png|Email Resultat}}

===== Email Vorlagen als Standard hinterlegen =====

Eine Vorlage lässt sich als Standard für Angebot, Auftrag und Rechnung in den Einstellungen voreinstellen.

Diese Vorlage wird dann automatisch beim Versand vorausgewählt.

Siehe //Einstellungen// --> //Systemeinstellungen// --> //Rechnungs/Auftrags/Artikel-Einstellungen// --> Email Vorlage

{{offer-cube:howto:docmeta-email:offer-cube_howto-docmeta-email-31-settings.png|Systemeinstellungen - Standard Email Vorlage}}

===== Beispiel Vorlagentexte =====

==== Anrede Email Vorlage ====

Automatische Anrede in Deutsch: 

<code>
<p>[[$ANREDE]],</p>
</code>

Automatische Anrede in Englisch: 

<code>
<p>[[$SALUTATION]],</p>
</code>


==== Angebot Email Vorlage (HTML) ====

Dokumenten-Ziel:
<code>|offer|</code>

Betreff:
<code>[[$CONFIGURATION.ownCompany]]: [[if $it.summary]][[$it.summary]] ([[/if]]Angebot [[$it._objref]][[if $it.summary]])[[/if]]</code>

<code>
<p>wir freuen uns Ihnen folgendes Angebot[[if $it.summary]] "[[$it.summary|escape]]"[[/if]] zu unterbreiten.</p>
<p>[[if $sendAttachmentNotLink]] Im Anhang finden Sie Ihr Angebot.<br />[[else]] Hier finden Sie den Link zu Ihrem Angebot:<br />[[if $CONFIGURATION.acceptOfferOnline == 2]] <a href="[[myurl script='enduser.php' module='offerpdf' action=$attachment.id id=$attachment.token|escape absolute=true noGetParams=true]]/[[$attachment.filename|escape]]" target="_blank" rel="noopener">Angebot [[$it._objref]]</a> [[else]] <a href="[[myurl module='offer' action=$it.id id=$sid absolute=true noGetParams=true]]" target="_blank" rel="noopener">Angebot [[$it._objref]]</a> [[/if]] [[/if]]</p>
<p>[[if $useOwnEmailText AND strlen($useOwnEmailText) GT 0]]</p>
<p>[[$useOwnEmailText|nl2brdep]]</p>
<p>[[/if]]</p>
</code>


==== Auftragsbestätigung Email Vorlage (HTML) ====

Dokumenten-Ziel:
<code>|order|</code>

Betreff:
<code>[[$CONFIGURATION.ownCompany]]: [[if $it.summary]][[$it.summary]] ([[/if]]Auftrag [[$it._objref]][[if $it.summary]])[[/if]]</code>

<code>
<p>vielen Dank f&uuml;r Ihren Auftrag[[if $it.summary]] "[[$it.summary|escape]]"[[/if]].</p>
<p>[[if $sendAttachmentNotLink]] Im Anhang finden Sie Ihren Auftrag.<br />[[else]]</p>
<p>Hier finden Sie den Link zum Download Ihrer Auftragsbest&auml;tigung:</p>
<p><a href="[[$PDF_LINK]]" target="_blank" rel="noopener">Auftrag [[$it._objref]]</a></p>
<p>[[/if]]</p>
<p>[[if $useOwnEmailText AND strlen($useOwnEmailText) GT 0]]</p>
<p>[[$useOwnEmailText|nl2brdep]]</p>
<p>[[/if]]</p>
</code>


==== Auftrag Lieferschein Email Vorlage (HTML) ====

Dokumenten-Ziel:
<code>|order|</code>

Betreff:
<code>[[$CONFIGURATION.ownCompany]]: Lieferschein zu [[if $it.summary]][[$it.summary]] ([[/if]]Auftrag [[$it._objref]][[if $it.summary]])[[/if]]</code>

<code>
<p>vielen Dank f&uuml;r Ihren Auftrag[[if $it.summary]] "[[$it.summary|escape]]"[[/if]].</p>
<p>[[if $sendAttachmentNotLink]] Im Anhang finden Sie Ihren Lieferschein.<br />[[else]]</p>
<p>Hier finden Sie den Link zum Download Ihres Lieferscheins:</p>
<p><a href="[[$PDF_LINK]]" target="_blank" rel="noopener">Lieferschein zu Auftrag [[$it._objref]]</a></p>
<p>[[/if]]</p>
<p>[[if $useOwnEmailText AND strlen($useOwnEmailText) GT 0]]</p>
<p>[[$useOwnEmailText|nl2brdep]]</p>
<p>[[/if]]</p>
</code>


==== Rechnung Email Vorlage (HTML) ====

Dokumenten-Ziel:
<code>|invoice|</code>

Betreff:
<code>[[$CONFIGURATION.ownCompany]]: [[if $it.summary]][[$it.summary]] ([[/if]]Rechnung [[$it._objref]][[if $it.summary]])[[/if]]</code>

<code>
<p>vielen Dank f&uuml;r Ihren Auftrag[[if $it.summary]] "[[$it.summary|escape]]"[[/if]].</p>
<p>[[if $sendAttachmentNotLink]] Im Anhang finden Sie Ihre Rechnung.<br />[[else]]</p>
<p>Hier finden Sie den Link zum Download Ihrer Rechnung:</p>
<p><a href="[[$PDF_LINK]]" target="_blank" rel="noopener">Rechnung [[$it._objref]]</a></p>
<p>[[/if]]</p>
<p>[[if $useOwnEmailText AND strlen($useOwnEmailText) GT 0]]</p>
<p>[[$useOwnEmailText|nl2brdep]]</p>
<p>[[/if]]</p>
</code>

==== Lieferantenbestellung Email Vorlage (HTML) ====

Dokumenten-Ziel:
<code>|supplierorder|</code>

Betreff:
<code>[[$CONFIGURATION.ownCompany]]: [[if $it.summary]][[$it.summary]] ([[/if]]Lieferantenbestellung [[$it._objref]][[if $it.summary]])[[/if]]</code>

Text:
<code>
<p>wir senden Ihnen folgende Bestellung[[if $it.summary]] "[[$it.summary|escape]]"[[/if]].</p>
<p>[[if $sendAttachmentNotLink]] Im Anhang finden Sie Ihre Bestellung.<br />[[else]]</p>
<p>Hier finden Sie den Link zum Download unserer Bestellung:</p>
<p><a href="[[$PDF_LINK]]" target="_blank" rel="noopener">Bestellung [[$it._objref]]</a></p>
<p>[[/if]]</p>
<p>[[if $useOwnEmailText AND strlen($useOwnEmailText) GT 0]]</p>
<p>[[$useOwnEmailText|nl2brdep]]</p>
<p>[[/if]]</p>
</code>

==== Grußformel Email Vorlage (HTML) ====

Text:
<code>
<p>Mit freundlichen Gr&uuml;&szlig;en<br />Ihr [[$CONFIGURATION.ownCompany|escape]] Team</p>
<div class="footer" style="color: #8c8c8c; font-size: 0.8em;">
<img src="data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAAAP8AAACqCAIAAADtKQ7ZAAAABmJLR0QA/wD/AP+gvaeTAAAB+0lEQVR4nO3WMRECQRREQZai8HISLiXBDjmaL0LAIuMHr1vBBC+YdR3nDZLu0wNgjPrpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny710/V4vl/TG2DG2ntPb4AZng9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRPl/rpUj9d6qdL/XSpny7106V+utRP1/p9vtMbYMa6jnN6A8zwfOhSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX661E+X+ulSP13qp0v9dKmfLvXTpX66/q0uCVsVTgVTAAAAAElFTkSuQmCC" alt="Logo" /> <br />
[[$CONFIGURATION.ownCompany|escape|nl2br]] <br />
[[$CONFIGURATION.ownOfferContact|escape|nl2br]]</div>
</code>

Hinweis: Das Logo muss vorher base64 kodiert werden.