> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://www.praktijkonline.support/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Snippets automatische e-mails

## Overzicht Mustache-variabelen voor (nieuwe) automatische mail-sjablonen
Op dit moment worden Mustache-variabelen opgebouwd rond twee hoofdtypen automatische sjablonen:
1. **Afspraak-sjablonen**
2. **Factuur-sjablonen**
Daarnaast zijn er enkele algemene variabelen die aanvullend beschikbaar kunnen zijn.
Mustache-variabelen gebruik je met dubbele accolades, bijvoorbeeld:
```
{{client.firstname}}
```
Voor lijsten gebruik je Mustache-secties:
```
{{#appointments}}
- {{date}} om {{time}}
{{/appointments}}
```
## 1. Algemene variabelen
| Variabele | Uitleg |
| ---- |
| `{{videolink}}` | Link voor beeldbellen bij een afspraak. Wordt gevuld als er een videolink voor de afspraak bestaat. |
| `{{unsub}}` | Afmeldlink / unsubscribe-link. In de voorbeeldweergave wordt hiervoor een demo-link gebruikt. |
| `{{account.*}}` | Praktijk-/accountgegevens. Wordt alleen geladen wanneer `account` in de template voorkomt. |
| `{{user.*}}` | Gegevens van de gebruiker/behandelaar/medewerker die bij het sjabloon hoort. |
## 2. Cliënt/contact-variabelen
Deze variabelen zijn beschikbaar via:
```
{{client.veldnaam}}
```
Bij factuursjablonen kan de ontvanger ook via `contact` of `receiver` beschikbaar zijn, afhankelijk van de factuurontvanger. 
### `client`
| Variabele | Uitleg |
| ---- |
| `{{client.id}}` | ID van de cliënt/contactpersoon. |
| `{{client.coursememberid}}` | Interne contact-ID. |
| `{{client.userid}}` | Gebruiker/behandelaar die aan de cliënt gekoppeld is. |
| `{{client.firstname}}` | Voornaam. |
| `{{client.voornaam}}` | Voornaam, Nederlandse alias. |
| `{{client.insertion}}` | Tussenvoegsel. |
| `{{client.tussenvoegsel}}` | Tussenvoegsel, Nederlandse alias. |
| `{{client.lastname}}` | Achternaam. |
| `{{client.achternaam}}` | Achternaam, Nederlandse alias. |
| `{{client.initials}}` | Initialen. |
| `{{client.initialen}}` | Initialen, Nederlandse alias. |
| `{{client.ascription}}` | Aanschrijfwijze / tenaamstelling. |
| `{{client.birthdate}}` | Geboortedatum. |
| `{{client.email}}` | Primair e-mailadres. |
| `{{client.email2}}` | Tweede e-mailadres. |
| `{{client.email3}}` | Derde e-mailadres. |
| `{{client.second_name}}` | Tweede naam / aanvullende naam. |
| `{{client.address}}` | Straatnaam. |
| `{{client.house_number}}` | Huisnummer. |
| `{{client.postal_code}}` | Postcode. |
| `{{client.city}}` | Plaats. |
| `{{client.country}}` | Land. |
| `{{client.phone1}}` | Primair telefoonnummer. |
| `{{client.phone2}}` | Tweede telefoonnummer. |
| `{{client.phone3}}` | Derde telefoonnummer. |
| `{{client.BSN}}` | BSN. |
| `{{client.extra_field1}}` | Extra veld 1. |
| `{{client.extra_field2}}` | Extra veld 2. |
| `{{client.extra_field3}}` | Extra veld 3. |
| `{{client.extra_field4}}` | Extra veld 4. |
| `{{client.extra_field5}}` | Extra veld 5. |
| `{{client.extra_field6}}` | Extra veld 6. |
## 3. Gebruiker-/medewerker-variabelen
Beschikbaar via:
```
{{user.veldnaam}}
```
| Variabele | Uitleg |
| ---- |
| `{{user.initials}}` | Initialen van de medewerker. |
| `{{user.firstname}}` | Voornaam van de medewerker. |
| `{{user.insertion}}` | Tussenvoegsel van de medewerker. |
| `{{user.lastname}}` | Achternaam van de medewerker. |
| `{{user.name}}` | Volledige naam van de medewerker. |
| `{{user.birth_date}}` | Geboortedatum van de medewerker. |
| `{{user.email}}` | E-mailadres van de medewerker. |
| `{{user.agb}}` | AGB-code van de medewerker. |
| `{{user.big}}` | BIG-registratie van de medewerker. |
| `{{user.signature}}` | E-mailhandtekening van de medewerker. |
## 4. Account-/praktijkvariabelen
Beschikbaar via:
```
{{account.veldnaam}}
```
Let op: deze gegevens worden alleen opgehaald als het woord `account` in de template voorkomt.
| Variabele | Uitleg |
| ---- |
| `{{account.firstname}}` | Voornaam van account-/praktijkhouder. |
| `{{account.insertion}}` | Tussenvoegsel van account-/praktijkhouder. |
| `{{account.lastname}}` | Achternaam van account-/praktijkhouder. |
| `{{account.email}}` | Algemeen e-mailadres van de praktijk/account. |
| `{{account.website}}` | Website van de praktijk. |
| `{{account.company_name}}` | Bedrijfsnaam/praktijknaam. |
| `{{account.companyname}}` | Bedrijfsnaam/praktijknaam, alias van `company_name`. |
| `{{account.phone}}` | Telefoonnummer. |
| `{{account.address}}` | Straatnaam. |
| `{{account.house_number}}` | Huisnummer. |
| `{{account.postcode}}` | Postcode. |
| `{{account.city}}` | Plaats. |
| `{{account.kvk}}` | KvK-nummer. |
| `{{account.btw}}` | BTW-nummer. |
## 5. Afspraakvariabelen
Beschikbaar via:
```
{{appointment.veldnaam}}
```
| Variabele | Uitleg |
| ---- |
| `{{appointment.client}}` | ID van de cliënt/contactpersoon bij de afspraak. |
| `{{appointment.locationid}}` | ID van de locatie. |
| `{{appointment.case_id}}` | ID van het gekoppelde zorgtraject/dossiertraject. |
| `{{appointment.room}}` | ID van de behandelkamer/ruimte. |
| `{{appointment.time}}` | Starttijd van de afspraak. |
| `{{appointment.endtime}}` | Eindtijd van de afspraak. |
| `{{appointment.notes}}` | Notities/omschrijving van de afspraak. |
| `{{appointment.name}}` | Naam van de cliënt zoals opgebouwd voor de afspraak. |
| `{{appointment.date}}` | Afspraakdatum in formaat `dd-mm-jjjj`. |
| `{{appointment.weekday}}` | Weekdag van de afspraak. |
| `{{appointment.datelong}}` | Lange datumweergave, bijvoorbeeld `maandag 20 juli 2026`. |
| `{{appointment.employee.*}}` | Gegevens van de medewerker/behandelaar van de afspraak. Zelfde structuur als `user`. |
| `{{appointment.servicedata.*}}` | Gegevens van de behandeling/dienst. |
### Dienst/behandeling bij afspraak
Beschikbaar via:
```
{{appointment.servicedata.veldnaam}}
```
| Variabele | Uitleg |
| ---- |
| `{{appointment.servicedata.name}}` | Naam van de dienst/behandeling. |
| `{{appointment.servicedata.duration}}` | Duur van de dienst/behandeling in minuten. |
| `{{appointment.servicedata.price}}` | Tarief van de dienst/behandeling. |
| `{{appointment.servicedata.description}}` | Omschrijving van de dienst/behandeling. |
## 6. Locatievariabelen
Beschikbaar via:
```
{{location.veldnaam}}
```
De locatie wordt alleen geladen als het woord `location` in de template voorkomt.
| Variabele | Uitleg |
| ---- |
| `{{location.name}}` | Naam van de locatie. |
| `{{location.address}}` | Adres van de locatie. |
| `{{location.postcode}}` | Postcode van de locatie. |
| `{{location.city}}` | Plaats van de locatie. |
| `{{location.phone}}` | Telefoonnummer van de locatie. |
| `{{location.fax}}` | Faxnummer van de locatie. |
| `{{location.website}}` | Website van de locatie. |
| `{{location.email}}` | E-mailadres van de locatie. |
| `{{location.agb}}` | AGB-code van de locatie/praktijk. |
| `{{location.kvk}}` | KvK-nummer van de locatie. |
| `{{location.btw}}` | BTW-nummer van de locatie. |
| `{{location.iban}}` | IBAN/bankrekeningnummer van de locatie. |
| `{{location.directions}}` | Routebeschrijving. |
| `{{location.explanation}}` | Toelichting bij de locatie. |
| `{{location.room.*}}` | Kamer-/ruimtegegevens, wanneer een ruimte aan de afspraak gekoppeld is. |
## 7. Toekomstige afspraken
Beschikbaar via:
```
{{#appointments}}
    {{date}} {{time}}
{{/appointments}}
```
Deze lijst wordt alleen geladen wanneer `appointments` in de template voorkomt.
| Variabele | Uitleg |
| ---- |
| `{{appointments}}` | Lijst met toekomstige afspraken van de cliënt. |
| `{{has_more_appointments}}` | Boolean die aangeeft of er toekomstige afspraken zijn. |
Voorbeeld:
```
{{#has_more_appointments}}
Uw volgende afspraken:
{{#appointments}}
- {{date}} om {{time}}
{{/appointments}}
{{/has_more_appointments}}
```
## 8. Eerdere afspraken
Beschikbaar via:
```
{{#previous_appointments}}
    {{date}} {{time}}
{{/previous_appointments}}
```
Deze lijst wordt alleen geladen wanneer `previous_appointments` in de template voorkomt.
| Variabele | Uitleg |
| ---- |
| `{{previous_appointments}}` | Lijst met eerdere afspraken van de cliënt. |
| `{{has_previous_appointments}}` | Boolean die aangeeft of er eerdere afspraken zijn. |
Voorbeeld:
```
{{#has_previous_appointments}}
Eerdere afspraken:
{{#previous_appointments}}
- {{date}} om {{time}}
{{/previous_appointments}}
{{/has_previous_appointments}}
```
## 9. Factuurvariabelen
Beschikbaar via:
```
{{invoice.veldnaam}}
```
| Variabele | Uitleg |
| ---- |
| `{{invoice.prefix}}` | Prefix van het factuurnummer. |
| `{{invoice.invoiceid}}` | Factuurnummer. |
| `{{invoice.currency_code}}` | Valutacode. |
| `{{invoice.account_id}}` | Account-ID. |
| `{{invoice.invoice_date}}` | Factuurdatum. |
| `{{invoice.invoice_status}}` | Status van de factuur. |
| `{{invoice.insurance_company}}` | ID van de verzekeraar, indien van toepassing. |
| `{{invoice.contact}}` | ID van het contact/de cliënt op de factuur. |
| `{{invoice.term}}` | Betalingstermijn. |
| `{{invoice.location}}` | ID van de factuurlocatie. |
| `{{invoice.discount_amount}}` | Kortingbedrag, indien aanwezig. |
Daarnaast worden bij factuursjablonen ook deze objecten gevuld:
| Variabele | Uitleg |
| ---- |
| `{{contact.*}}` | Gegevens van het contact/de cliënt op de factuur. Zelfde structuur als `client`. |
| `{{receiver.*}}` | Ontvanger van de factuur. Dit is de verzekeraar als er een verzekeraar gekoppeld is, anders de cliënt/contactpersoon. |
| `{{user.*}}` | Gebruiker/medewerker die bij de factuur hoort. |
| `{{location.*}}` | Locatiegegevens van de factuur, wanneer `location` in de template voorkomt. |
| `{{account.*}}` | Praktijk-/accountgegevens, wanneer `account` in de template voorkomt. |
## 10. Portal-only oude placeholders
Voor enkele portal-gerelateerde sjablonen worden nog oude `%...%` placeholders vervangen in de voorbeeldweergave:
| Placeholder | Uitleg |
| ---- |
| `%CLIENT.FIRSTNAME%` | Voornaam van de cliënt. |
| `%PORTAL.URL%` | URL van het cliëntportaal. |
| `%PORTAL.COMPANYNAME%` | Bedrijfs-/praktijknaam van het portaal. |
Dit zijn **geen Mustache-variabelen**, maar ze worden op dit moment nog wel specifiek afgehandeld voor portal-sjablonen zoals portaluitnodigingen en notificaties.


## 11. Voorbeelden
### Afspraakbevestiging
```
Beste {{client.firstname}},

Uw afspraak staat gepland op {{appointment.datelong}} om {{appointment.time}}.

Behandeling: {{appointment.servicedata.name}}
Locatie: {{location.name}}, {{location.address}} {{location.postcode}} {{location.city}}

Met vriendelijke groet,

{{user.name}}
{{user.signature}}
```
### Factuurmail
```
Beste {{receiver.firstname}},

Hierbij ontvangt u factuur {{invoice.prefix}}{{invoice.invoiceid}} van {{account.company_name}}.

Factuurdatum: {{invoice.invoice_date}}

Met vriendelijke groet,

{{user.name}}
```
### Beeldbellen
```
Beste {{client.firstname}},

U kunt deelnemen aan de beeldbelafspraak via onderstaande link:

{{videolink}}
```
## Belangrijke kanttekening
Niet alle variabelen worden altijd gevuld. Sommige onderdelen worden alleen geladen als de naam in het sjabloon voorkomt, zoals:
* `account`
* `location`
* `appointments`
* `previous_appointments`
* `videolink`
Daarnaast hangt de beschikbaarheid van `appointment.*` of `invoice.*` af van het type automatisch sjabloon.