# Template editor voor werkbon PDF's

Met de template editor kun je de PDF-layout van werkbonnen volledig naar wens aanpassen. Je bepaalt zelf welke informatie er op de werkbon staat, in welke volgorde en met welke opmaak.

## Navigatie naar de template editor

1. Ga naar **Instellingen** in het menu
2. Selecteer **Werkbonnen**
3. Klik bij "PDF Templates" op **Openen**
4. Je ziet nu een overzicht van alle templates

## Templates overzicht

In het templates overzicht zie je:

* Alle bestaande templates met hun naam
* Welke template standaard is
* Het gebruikte lettertype per template

### Acties in het overzicht

| Actie                   | Beschrijving                                               |
| ----------------------- | ---------------------------------------------------------- |
| **Nieuwe template**     | Maak een nieuw template aan                                |
| **Bewerken**            | Klik op een template om deze te bewerken                   |
| **Dupliceren**          | Maak een kopie van een bestaand template                   |
| **Standaard instellen** | Stel dit template in als standaard                         |
| **Verwijderen**         | Verwijder een template (niet mogelijk als dit de enige is) |

## Een nieuw template aanmaken

1. Klik op **Nieuwe template** in het templates overzicht
2. Vul een naam in voor het template
3. Configureer de blokken en instellingen
4. Klik op **Aanmaken** om het template op te slaan

## Template bewerken

De editor bestaat uit twee delen:

* **Links:** Alle instellingen en configuratieopties
* **Rechts:** Live preview van hoe de PDF eruit zal zien

### Template naam

Bovenaan kun je de naam van het template aanpassen. Kies een duidelijke naam zodat je later makkelijk het juiste template kunt selecteren.

### Lettertype kiezen

Selecteer een lettertype voor je werkbon PDF:

* Figtree (Standaard)
* Arial
* Helvetica
* Times New Roman
* Georgia
* Verdana
* Courier New

## Blokken beheren

De PDF is opgebouwd uit blokken die je kunt aan- of uitzetten, verslepen en configureren.

### Beschikbare blokken

| Blok                   | Beschrijving                                 |
| ---------------------- | -------------------------------------------- |
| **Bedrijfslogo**       | Toont het logo van je bedrijf                |
| **Bedrijfsinformatie** | Bedrijfsnaam, adres en contactgegevens       |
| **Klantgegevens**      | Naam en adresgegevens van de klant           |
| **Werkbon informatie** | Werkbonnummer, datum en extra velden         |
| **Uren tabel**         | Overzicht van geregistreerde uren            |
| **Materialen tabel**   | Overzicht van gebruikte materialen           |
| **Handtekeningen**     | Ruimte voor handtekening klant en medewerker |

### Blok aan- of uitzetten

Gebruik de schakelaar (toggle) rechts van elk blok om deze zichtbaar of onzichtbaar te maken op de PDF.

### Volgorde wijzigen

Sleep blokken naar boven of beneden door het grijze handvat links van het blok vast te pakken. De volgorde in de editor bepaalt de volgorde op de PDF.

### Blok positie (links/rechts)

Voor de volgende blokken kun je de positie instellen:

* **Bedrijfslogo:** Links of rechts uitlijnen
* **Bedrijfsinformatie:** Links of rechts uitlijnen
* **Klantgegevens:** Links of rechts uitlijnen

> **Tip:** Als je bedrijfsinformatie links plaatst en klantgegevens rechts, worden deze naast elkaar weergegeven.

Klik op het pijltje rechts van het blok om de positie-instellingen te openen.

### Labels aanpassen

Voor sommige blokken kun je de labels/titels aanpassen:

#### Werkbon informatie

* **Werkbon prefix:** Tekst voor het werkbonnummer (standaard: "Werkbon")
* **Datum label:** Label bij de datum (standaard: "Werkbon datum")
* **Totaal label:** Label voor totaalrij (standaard: "Totaal")

#### Uren tabel

* **Titel:** De titel boven de urentabel (standaard: "Uren")
* **Details label:** Label voor de detailrij (standaard: "Details")

#### Materialen tabel

* **Titel:** De titel boven de materialentabel (standaard: "Materialen")

#### Handtekeningen

* **Klant handtekening label:** Label boven handtekening klant (standaard: "Handtekening klant")
* **Medewerker handtekening label:** Label boven handtekening medewerker (standaard: "Handtekening medewerker")

## Uren tabel configureren

Klik op het tandwiel-icoon bij het blok "Uren tabel" om de kolommen te configureren.

### Standaard kolommen

| Kolom        | Beschrijving                      |
| ------------ | --------------------------------- |
| Dag          | De datum van de urenregistratie   |
| Naam         | Naam van de medewerker            |
| Omschrijving | Beschrijving van de werkzaamheden |
| Tijden       | Start- en eindtijd                |
| Netto uren   | Gewerkte uren exclusief pauze     |
| Pauze        | Pauzetijd                         |
| Totaal       | Totaal aantal uren                |

### Kolommen beheren

In het configuratiescherm kun je:

* **Kolommen aan- of uitzetten:** Gebruik de schakelaar om kolommen te verbergen
* **Volgorde wijzigen:** Sleep kolommen naar de gewenste positie
* **Labels aanpassen:** Wijzig de kolomnamen naar wens

## Uren extra velden

Als je extra velden hebt aangemaakt voor uren, kun je deze configureren in de sectie "Uren extra velden".

### Tabelkolommen voor numerieke velden

Numerieke extra velden kunnen als aparte kolom in de urentabel worden getoond:

1. Vouw het blok "Uren extra velden" open
2. Zet **Tonen als tabelkolom** aan bij het gewenste veld
3. Configureer:
   * **Kolom naam:** De naam die in de tabelkop verschijnt
   * **Formaat:** Kies het getalformaat (geheel getal, 1 decimaal, 2 decimalen)
   * **Optellen in footer:** Vink aan om het totaal onderaan de tabel te tonen

> **Let op:** Je kunt maximaal 4 extra tabelkolommen toevoegen om lay-outproblemen te voorkomen.

### Detail rij weergave

Extra velden die niet als tabelkolom zijn ingesteld, worden getoond in een detailrij onder elke urenregistratie. Dit geldt voor:

* Alle tekstvelden
* Numerieke velden zonder de optie "Tonen als tabelkolom"

## Materialen tabel configureren

Klik op het tandwiel-icoon bij het blok "Materialen tabel" om de kolommen te configureren.

### Beschikbare kolommen

| Kolom       | Beschrijving                   |
| ----------- | ------------------------------ |
| Artikelcode | De code van het materiaal      |
| Datum       | Datum van materiaalgebruik     |
| Naam        | Naam van het materiaal         |
| Eenheid     | De eenheid (stuk, meter, etc.) |
| Aantal      | Het gebruikte aantal           |
| Prijs       | De prijs van het materiaal     |

> **Let op:** De datum-kolom wordt automatisch verborgen als je materialen direct aan werkbonnen toevoegt in plaats van via uren.

## Werkbon extra velden

Als je extra velden hebt aangemaakt voor werkbonnen, kun je per template instellen welke velden zichtbaar zijn.

1. Vouw het blok "Werkbon extra velden" open
2. Zet velden aan of uit met de schakelaar
3. Zichtbare velden worden getoond bij "Werkbon informatie" in de PDF

## Live preview

Aan de rechterkant van de editor zie je een live preview van je template. De preview toont:

* De huidige blokvolgorde
* Alle zichtbare blokken
* Voorbeelddata voor uren en materialen
* Het gekozen lettertype
* De configureerde labels en kolommen

> **Let op:** De preview is een schaalmodel. De werkelijke PDF kan er iets anders uitzien qua proporties.

### Oriëntatie

De PDF schakelt automatisch naar liggend formaat (landscape) wanneer je meer dan 8 kolommen in de urentabel hebt.

## Template opslaan

Klik op **Opslaan** (bij bestaand template) of **Aanmaken** (bij nieuw template) om je wijzigingen op te slaan. Je wordt teruggeleid naar het templates overzicht.

## Template dupliceren

Om een bestaand template te kopiëren:

1. Ga naar het templates overzicht
2. Klik op het menu-icoon (⋮) naast het template
3. Selecteer **Dupliceren**
4. Een kopie wordt aangemaakt die je kunt bewerken

## Standaard template instellen

Het standaard template wordt automatisch gebruikt bij het genereren van werkbon PDF's.

1. Ga naar het templates overzicht
2. Klik op het menu-icoon (⋮) naast het gewenste template
3. Selecteer **Instellen als standaard**

Het standaard template wordt aangegeven met "Standaard template" in het overzicht.

## Template verwijderen

1. Ga naar het templates overzicht
2. Klik op het menu-icoon (⋮) naast het template
3. Selecteer **Verwijderen**
4. Bevestig de verwijdering

> **Let op:** Je kunt het laatste template niet verwijderen. Er moet altijd minimaal één template zijn.

## Template selecteren bij PDF export

Wanneer je een werkbon exporteert als PDF, kun je kiezen welk template je wilt gebruiken (als je meerdere templates hebt). Anders wordt automatisch het standaard template gebruikt.

## Tips

* Begin met het dupliceren van het standaard template als je kleine aanpassingen wilt maken
* Gebruik de preview om je wijzigingen direct te controleren
* Kies duidelijke labels die voor je klanten begrijpelijk zijn
* Test je template door een werkbon te exporteren en de PDF te bekijken
* Maak aparte templates voor verschillende klanten of projecttypes

## Benodigde rechten

Om PDF templates te beheren heb je de permissie **Instellingen beheren** nodig.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.timemate.nl/werkbonnen-en-projecten/template-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
