Variabelen gebruiken in templates

Variabelen zijn dynamische velden die het systeem automatisch invult met gegevens uit het dossier. In plaats van handmatig "Meneer Jansen" te typen, gebruik je een variabele die automatisch de juiste naam invult bij elke offerte of factuur.

Dit maakt je templates herbruikbaar: een template werkt voor alle klanten, alle dossiers en alle documenten.

---

Hoe voeg je een variabele toe?

1. Klik in een tekstblok waar de variabele moet komen
2. Klik in de toolbar op de knop Variabelen (dropdown met pijltje naar beneden)
3. Kies een categorie: Identiteit, Klant, Offerte, of Verhuizing
4. Selecteer de gewenste variabele uit de lijst
5. De variabele wordt ingevoegd op de plek van je cursor

Je hoeft geen codes uit je hoofd te kennen. De lijst toont alle beschikbare variabelen per categorie.

---

Beschikbare variabelen

Identiteit (jouw bedrijfsgegevens)

Deze variabelen tonen informatie over jouw bedrijf:

Klant (klantgegevens)

Deze variabelen tonen informatie over de klant:

Sub-variabelen voor adressen: Factuur adres en Hoofd contactpersoon hebben sub-variabelen zoals straat, huisnummer, postcode, plaats, etc.

Offerte

Deze variabelen tonen informatie over de offerte:

Verhuizing

Deze variabelen tonen informatie over het verhuisdossier:

Sub-variabelen voor adressen: Laad adres en Los adres hebben sub-variabelen voor straatnaam, huisnummer, postcode, plaats, land, etc.

---

Vrije tekstvelden

Naast de standaard variabelen kun je ook vrije tekstvelden maken. Dit zijn custom velden die je per dossier anders invult.

Wanneer gebruik je vrije tekstvelden?

• Voor informatie die niet in een standaard veld past
• Voor optionele extra informatie die niet altijd relevant is
• Voor per-dossier aangepaste teksten (bijv. "Afvoer oud meubilair: 3 banken")

Vrij tekstveld aanmaken

1. Open je template in de editor
2. Klik in een tekstblok
3. Typ de volgende code:

######{{quote.freeText['jouw titel hier']|nl2br}}

Voorbeelden:

######{{quote.freeText['Afvoer']|nl2br}}######{{quote.freeText['Extra diensten']|nl2br}}######{{quote.freeText['Opmerkingen']|nl2br}}

De tekst tussen de quotes ('Afvoer') is de naam van het veld. Deze naam zie je later in het dossier als label, maar verschijnt NIET in de uiteindelijke PDF.

Vrij tekstveld invullen

Wanneer je een offerte of factuur genereert op een dossier:

1. Klik op het potlood-icoon rechts in het document
2. Je ziet alle vrije tekstvelden die in de template staan
3. Vul de gewenste tekst in
4. Klik op Opslaan

De ingevulde tekst verschijnt automatisch op de juiste plek in de PDF.

Belangrijk over vrije tekstvelden

Let op: Wijzig alleen de tekst tussen de quotes. Als je iets anders in de code aanpast (de accolades, |nl2br, etc.), werkt de variabele niet meer.

Dit mag:

######{{quote.freeText['Mijn eigen veldnaam']|nl2br}}

Dit breekt de template:

######{{quote.freeText[Mijn veld]|nl2br}}        # Quotes vergeten######{{quote.freeText['Test'}}                   # |nl2br vergetenquote.freeText['Test']|nl2br                # ######{{ }} vergeten

---

Variabelen syntax

Variabelen gebruiken dubbele accolades als syntax: ######{{ variabele }}.

Spaties zijn verplicht

Er moet een spatie staan tussen de dubbele accolades en de variabelnaam:

Dit werkt:

######{{ quote.loadAddresses|trans }}

Dit werkt NIET:

######{{quote.loadAddresses|trans}}

Als je variabelen invoegt via de knop Variabelen, wordt de juiste syntax automatisch toegepast. Maar als je handmatig variabelen typt of kopieert, let dan op de spaties.

---

Voorbeeld: offertetekst met variabelen

Zo ziet een typische offertetekst eruit in de editor:

Geachte ######{{ contact.salutation }} ######{{ contact.last_name }},Naar aanleiding van onze afspraak doen wij u hierbij eenofferte toekomen voor uw verhuizing van######{{ quote.loadAddresses|trans }} naar ######{{ quote.unloadingAddresses|trans }}.Hartelijk dank voor het mogen uitbrengen hiervan.

Bij een echt dossier wordt dit automatisch:

Geachte Dhr. Jansen,Naar aanleiding van onze afspraak doen wij u hierbij eenofferte toekomen voor uw verhuizing vanVoorbeeldstraat 10, 1234 AB Amsterdam naarNieuwe Straat 5, 5678 CD Utrecht.Hartelijk dank voor het mogen uitbrengen hiervan.

Tip: Zet variabelen altijd op dezelfde regel als de tekst eromheen. Als je variabelen op aparte regels zet, krijg je ongewenste witruimte in de PDF.

---

Meertalige templates

Als je internationale klanten hebt, maak je aparte templates per taal.

Beschikbare talen

Standaard beschikbaar: Nederlands en Engels. Extra talen (Duits, Frans) zijn ook mogelijk.

Werkwijze

1. Maak je Nederlandse template perfect
2. Klik op Nieuwe template en kies "Gebaseerd op"
3. Selecteer je Nederlandse template als basis
4. Vertaal alle teksten naar de gewenste taal
5. De variabelen blijven hetzelfde - die trekken automatisch de juiste data
6. Geef de template een duidelijke naam: "Offerte Engels" of "Invoice English"

Wat vertaal je?

---

Tips

• Gebruik de Variabelen knop in plaats van handmatig typen. Zo weet je zeker dat de syntax klopt.
• Zet variabelen op dezelfde regel als de omliggende tekst. Voorkomt witruimte in de PDF.
• Test met een echt dossier. Maak een testdossier aan en genereer een offerte. Worden alle variabelen correct ingevuld?
• Vrije tekstvelden voor custom info. Als er geen standaard variabele bestaat, maak je een vrij tekstveld.
• Labels van vrije velden verschijnen niet in de PDF. Alleen de ingevulde tekst.
• Variabelen werken in alle talen. Je vertaalt alleen de lopende tekst, niet de variabelen.

---

Let op

• Variabelen zonder spatie werken niet. Let op de spatie tussen ######{{ en de variabelnaam.
• Lege variabelen betekenen dat het veld niet is ingevuld in het dossier. Controleer of alle verplichte velden zijn ingevuld.
• Variabelen op aparte regels veroorzaken extra witruimte. Houd ze op dezelfde regel.
• Vrije tekstvelden code niet aanpassen behalve de tekst tussen de quotes. Anders breekt de variabele.
• Templates dupliceren met "Gebaseerd op" voor meertalige versies. Scheelt veel opmaakwerk.

---

Volgende stap: Factuur en werkbon template