E-mailsjabloon
Een Email Template is herbruikbare e-mailinhoud — onderwerp en body met Jinja-placeholders die bij gebruik worden ingevuld. Bespaart u dezelfde mail vijf keer per dag te typen.
Aanmaken
Email Template → New:
| Veld | Opmerking |
|---|---|
| Name | Leesbare identifier |
| Subject | Het onderwerp — ondersteunt Jinja: Herinnering: factuur {{ doc.name }} is verlopen |
| Response | De body in HTML of platte tekst |
| Reference DocType | Optioneel — koppel sjabloon aan specifiek DocType zodat editor weet welke doc.*-velden er zijn |
| Use HTML | Toggle voor HTML vs platte tekst |
Jinja in sjablonen
Zowel Subject als Response ondersteunen Jinja-interpolatie:
<p>Beste {{ doc.customer_name }},</p>
<p>Uw factuur <strong>{{ doc.name }}</strong> ter waarde van
{{ frappe.format_value(doc.grand_total, "Currency") }}
was vervallen op {{ frappe.format_value(doc.due_date, "Date") }}.</p>
<p>Wij verzoeken u de betaling spoedig te voldoen.</p>
Beschikbare context:
doc— het document (bij verzending vanuit een document)frappe— utility module (formatters, get_value, enz.)- Standaard Jinja-filters:
upper,lower,replace,default, enz.
Waar sjablonen worden gebruikt
| Plek | Hoe |
|---|---|
| Document → Email-knop | Bij opstellen van mail vanuit een formulier: klik "Template" om in te voegen |
| Notificaties | Een Notificatie kan een Email Template referencen |
| Bulk e-mail | Bij mailen aan meerdere records (bv. herinneringsbatch) één sjabloon kiezen voor allen |
| API | Programmatisch via frappe.sendmail(template="Mijn Sjabloon", args={...}) |
Email Template vs Print Format
Email Templates zijn voor e-mail-bodies — tekst in het bericht. Print Formats zijn voor bijlagen — PDF-rendering van het document. Vaak samen: een factuurmail gebruikt "Factuurherinnering" als Email Template voor de body en "Standaardfactuur" als Print Format voor de bijgevoegde PDF.
Talen
U kunt één Email Template per taal hebben. De Notification of verzender kiest de versie die past bij het language-veld van de ontvanger. Handig voor meertalige klantenbasis — zie Vertalingen & i18n.
Tips
- Houd sjablonen kort; lange e-mails worden eerder spam
- HTML voor klantmails met huisstijl, platte tekst voor interne meldingen
- Test door eerst naar uzelf te sturen (
frappe.sendmail(recipients="me@x.com", template="X", args=test_doc)) - Versioneer in uw hoofd — als u tekst wijzigt, blijven al verzonden mails de oude versie houden