---
title: "Documentsjablonen: wat, waarom en hoe."
description: "Dit artikel is een gids over documentsjablonen: wat ze zijn en hoe ze worden ingesteld en gebruikt."
url: https://help.qargo.com/nl/articles/246339-documentsjablonen-wat-waarom-en-hoe
locale: nl
updated: 2026-08-21
---

# Documentsjablonen: wat, waarom en hoe.

## Samenvatting {#h_8bf77434b0}

-   **_Wat is een Qargo-sjabloon?_**

    -   Een personaliseerbaar, herbruikbaar ontwerp om bedrijfsdocumenten aan te maken, zoals facturen, afleveringsbewijzen, laadbonnen, offertes enz.
    -   Kan in taken worden gebruikt om automatisch documenten aan te maken en/of te versturen.
-   **_Waarom sjablonen gebruiken?_**

    -   Met sjablonen bepalen gebruikers hoe documenten eruitzien en welke gegevens erin staan.
    -   Elk bedrijf kan documenten aanmaken in een gewenst formaat, afgestemd op het werkproces, de taal en de huisstijl van het bedrijf.
    -   Alle vereiste gegevens worden dynamisch vanuit het TMS ingevuld.
-   **_Hoe worden sjablonen gebruikt?_**

    -   Om documenten aan te maken die aan orders en trips gekoppeld zijn.
    -   In combinatie met werkprocestaken worden documenten vlot en op het juiste moment aangemaakt.
    -   Documenten worden automatisch aangemaakt, wat invoerfouten vermindert. In combinatie met contacttaken wordt het werkproces efficiënter, bv. een POD of factuur per e-mail versturen enz.

**Voorbeeld:** taken **_'Document genereren'_**

![](https://help.qargo.com/media/d7eb5cf0d4f9-image.png)

-   **3 kerncomponenten:**

    -   _Handlebars-sjabloon:_ dynamische placeholders om gegevens in te voegen
    -   _Sjabloonschema:_ gestructureerde definitie van alle dynamische velden die in het sjabloon beschikbaar zijn; kan lijsten, tabellen, tekst enz. bevatten
    -   _Datamodel:_ de werkelijke gegevens die bij het aanmaken aan het sjabloon worden doorgegeven (bv. orderwaarde)
-   De velden in het sjabloonschema bepalen welke dynamische gegevenselementen kunnen worden opgehaald en getoond, of herhaald.

    -   Dat kunnen eenvoudige velden zijn, bv. 'titel', of complexere velden voor lijsten en tabellen waarvoor parameters nodig zijn.
-   Sjablonen kunnen worden geconfigureerd door schema's en visuele lay-outs te bewerken

    -   Selecteren welke velden worden getoond en logica bepalen (bv. if/else, voorwaarden enz.)
-   Documenten aanmaken: het sjabloon haalt de meest recente gegevens op en vult de dynamische velden in volgens het sjabloonschema en het datamodel.

    -   Het resultaat is een gebruiksklaar document in het gewenste formaat (bv. PDF, CSV)
-   Sjablonen kunnen globaal of tenantspecifiek zijn

    -   Globaal sjabloon = basislay-out die kan worden overschreven of met eigen variabelen kan worden uitgebreid
    -   Tenantsjabloon = afgestemd op speciale vereisten, bv. om aan wettelijke of reglementaire eisen te voldoen.
-   Ondersteunde functies in sjablonen:

    -   Meertalige ondersteuning (lokalisatie), indien ingeschakeld
    -   Tabellen en contextspecifieke lussen
    -   Aangepaste helpers (zoals datums opmaken, barcodes enz.)
    -   Verwerking van speciale gevallen en voorwaarden, bv. een veld niet tonen als het leeg is
    -   Bijlagen of afbeeldingen, bv. handtekeningen
-   Met Handlebars-expressies is geavanceerde logica mogelijk

![](https://help.qargo.com/media/da46670d86d2-image.png)

* * *

## Terminologie {#h_575846571e}

| **Term** | **Definitie** |
| --- | --- |
| **Qargo-sjabloon:** | Standaard, globale sjabloonversies die Qargo aanbiedt en onderhoudt; dienen als referentiebibliotheek; eenvoudig aan te passen voor huisstijl, taal, speciale gegevensvereisten enz. |
| **Tenantsjabloon** | Gepersonaliseerd sjabloon dat specifiek is voor de tenant (account) |
| **Extern sjabloon** | Documentsjablonen uit een externe bron die kunnen worden gebruikt of waarnaar kan worden verwezen; dit kunnen sjablonen zijn die door meerdere organisaties of locaties worden gedeeld, standaardformaten uit de sector of sjablonen die uit externe systemen zijn geïmporteerd, bv. creditnota's, self-bills, tripbladen, CMR's. |
| **Basissjabloon** | Algemeen sjabloon waarmee een nieuw documentsjabloon wordt aangemaakt; wordt geselecteerd in een keuzelijst met vooraf bepaalde opties, op basis van de categorie van het document dat wordt aangemaakt, bv. 'factuur'. |
| **Gearchiveerd sjabloon** | Sjablonen die niet meer in het platform worden ondersteund; meestal vervangen door een bijgewerkte versie. |
| **Handlebars-expressie** | Handlebars-expressies zijn speciale placeholders en logische blokken in sjablonen waarmee gegevens worden ingevoegd en voorwaardelijke of herhalende logica wordt toegevoegd bij het aanmaken van documenten of e-mails. |
| **Contextlabel (blauw)** | Wordt bij bepaalde velden of rijen in de sjablooneditor getoond; geeft aan dat een veld gekoppeld is aan een specifiek deel van de onderliggende gegevens, bv. stops, die dan als één rij per stop worden getoond. |

![](https://help.qargo.com/media/09784e228563-image.png)

![](https://help.qargo.com/media/c0e762505678-image.png)

* * *

## De sjabloonindeling begrijpen {#h_5436d95364}

Bij het toevoegen van een nieuw sjabloon moet eerst een basissjabloon worden geselecteerd. Daarna worden de gegevensrijen en het previewvenster (nr. 3 Visualiseren) getoond. Het sjabloon wordt met algemene gegevens getoond.

![](https://help.qargo.com/media/963f989321d9-image.png)

1.  Op de pagina **Nieuw sjabloon** het gepaste **_'Basissjabloon'_** in de keuzelijst selecteren.
2.  Het nieuwe sjabloon **configureren**. Het nieuwe sjabloon een naam geven waaraan het gebruik makkelijk te herkennen is. Velden aanpassen om het sjabloon te personaliseren, of het basissjabloon ongewijzigd gebruiken.
3.  Het sjabloonformaat in het previewvenster **visualiseren**. Door op een element in het previewvenster te klikken, wordt de bijbehorende gegevensrij gemarkeerd. In de rij klikken als de getoonde gegevens moeten worden gewijzigd.

::video{src="/media/video/34bcde4b39bd-2025-06-20_12-45-45-1-.mp4"}

-   De sjabloongegevens bewerken door in de gepaste rij te klikken en de inhoud te bewerken.

    -   In de rij klikken of het 'oog'-pictogram gebruiken markeert de gegevens van deze rij in het previewvenster.
    -   Op informatie in het previewvenster klikken markeert de gepaste rij waarin de gegevens kunnen worden bewerkt.
    -   Het veld **_'Data-eigenaar'_** gebruiken om live gegevens te bekijken; de getoonde opties hebben specifiek betrekking op het document. In het voorbeeld hieronder gaat het bijvoorbeeld om een facturatievoorstel, dus de opties in het veld Data-eigenaar zijn aankoopfacturen.

::video{src="/media/video/4f38b0dc3c27-2025-06-20_15-21-09-1-.mp4"}

* * *

## De bewerkingspictogrammen begrijpen {#h_aa3898f3c5}

-   Door in een rij te klikken om details te bewerken, wordt een reeks bewerkingsopties getoond.

![](https://help.qargo.com/media/81731f89eab0-image.png)

1.  Opties voor tekstbewerking, waaronder vet, cursief en onderstrepen; lettergrootte en kleur; met H en h worden de gegevens als kop 1 (H) of kop 2 (h) opgemaakt.
2.  Een URL-link naar een website toevoegen. Er verschijnt een pop-upvenster waarin de link kan worden toegevoegd.
3.  Gegevens als opsommingstekens of genummerde lijst toevoegen.
4.  Syntaxisblokken om geavanceerdere voorwaarden aan te maken met expressies die meerdere variabelen of voorwaarden combineren.
5.  Opmaakopties om een pagina-einde of HTML-blok toe te voegen

### Syntaxisblokken gebruiken  {#h_5ef90025ec}

![](https://help.qargo.com/media/f6ec65742470-image.png)

-   Bij het bewerken van een sjabloon zijn er syntaxisopties beschikbaar om sjablonen aan te maken die specifieke voorwaarden weergeven.

![](https://help.qargo.com/media/caf25e5a326a-image.png) **Handlebars-expressies**

-   **_Handlebars-expressies_** worden gebruikt om **variabelen** te selecteren die aan het document gekoppeld zijn. De variabelen in de keuzelijst zijn specifiek voor het document en de bijbehorende rij.

    ![](https://help.qargo.com/media/5c29b33d2e38-image.png)


![](https://help.qargo.com/media/20bc909793cf-image.png) **'IF'-blok**

-   Het **IF**-blok in een documentsjabloon gebruiken om bepaalde inhoud of opmaak alleen onder specifieke voorwaarden te tonen, op basis van de gegevens. Bijvoorbeeld om een veld alleen te tonen als het niet leeg is, of om een rij alleen te markeren als een waarde een drempel overschrijdt.
-   **Veelvoorkomende scenario's:**

    -   Kosten met bedrag 0 verbergen: met een IF-blok een kost alleen tonen als de waarde groter is dan nul.
    -   Inhoud voorwaardelijk tonen: bijvoorbeeld een opmerking of sectie alleen tonen als een veld bepaalde tekst bevat (zoals de naam van een specifieke onderaannemer of een ingevulde opmerking).
    -   Voorwaardelijke opmaak: tekst vet maken of speciale stijlen toepassen als een waarde aan een voorwaarde voldoet (bv. een locatie vet maken als er een bijbehorende opmerking bestaat).

    ![](https://help.qargo.com/media/6ae9979e73f3-image.png)


:::callout{tone="info"}
📚 IF-blokken kunnen met ELSE worden gecombineerd voor complexere logica.
:::

![](https://help.qargo.com/media/f8d63d1309c3-image.png) **FOR-blok**

-   Het **FOR**-blok is een krachtige functie in de documentsjablooneditor van Qargo, waarmee documenten dynamisch en op basis van gegevens worden aangemaakt.
-   Om alle producten van een order op te sommen, met elk product en de beschrijving ervan op een nieuwe regel, een FOR-blok voor de goederenarray toevoegen en de productdetails in het blok plaatsen. Het FOR-blok zorgt ervoor dat elk product een eigen regel krijgt in het uiteindelijke document.

    ![](https://help.qargo.com/media/b4385abb177d-image.png)


![](https://help.qargo.com/media/3122906af688-image.png)**COMBINE-instructie**

-   Het **COMBINE**-blok gebruiken om in het sjabloon een samengevoegde of geaggregeerde lijst uit een array te tonen, bijvoorbeeld om een lijst met waarden samen te voegen tot een door komma's gescheiden tekenreeks.
-   Een FOR-blok doorloopt elk item en geeft de inhoud telkens opnieuw weer. Het Combine-blok verwerkt de array daarentegen tot één resultaat, meestal door de elementen aan elkaar te koppelen of op een andere manier te aggregeren.
-   Een belangrijke beperking is dat IF-instructies (voorwaardelijke logica) niet in een Combine-blok kunnen worden gebruikt. Het Combine-blok is dus het meest geschikt voor eenvoudige aggregatie zonder voorwaarden per item.

    ![](https://help.qargo.com/media/eb18f78683f8-image.png)


* * *

:::callout{tone="info"}
📚 Specifieke documenten kunnen niet worden gedupliceerd. Contact opnemen met Qargo Support om een bestaand sjabloon te kopiëren, bijvoorbeeld een klantspecifiek factuursjabloon.
:::

## Nieuw sjabloon toevoegen {#h_a554b7a8de}

-   Naar **Configuratie > Sjablonen** gaan
-   Klikken op **_'Sjabloon toevoegen'_**
-   Het documenttype in de keuzelijst selecteren.

    -   **Opmerking**: er kunnen extra opties beschikbaar zijn, bv. "Factuur" biedt de keuze tussen factuur of creditnota, en "Laadbon" biedt de keuze tussen trip of resource

::video{src="/media/video/6c54a27f6b6d-2025-06-30_13-57-15-1-.mp4"}

-   Een basissjabloon in de keuzelijst selecteren.

    ![](https://help.qargo.com/media/05abd201da3a-image.png)


-   In het venster **'Visualiseren'** in het veld **_'Data-eigenaar'_** klikken om de overeenkomende records voor dit soort document te tonen. Door een ervan te selecteren, wordt de preview van het sjabloon met klantgegevens getoond.

    ::video{src="/media/video/f466209ed045-2025-06-30_14-07-03-1-.mp4"}

    -   Als het basissjabloon alle gegevens in de vereiste lay-out bevat, het sjabloon een naam geven en op **Opslaan** klikken.
-   Als de lay-out van het sjabloon moet worden aangepast, de rijen in **'Configureren'** gebruiken om de gegevens bij te werken.

### Een sjabloon aanpassen {#h_c32012d005}

:::callout{tone="info"}
📚 Om een bestaand sjabloon aan te passen, de **visualisatietool** gebruiken om de juiste velden te vinden die moeten worden bijgewerkt. Om bijvoorbeeld een referentienummer op een factuur bij te werken, volstaan de onderstaande stappen.

-   Het sjabloon openen (bv. factuur)
-   In het previewvenster op het gegevenselement klikken dat moet worden bijgewerkt
-   Het bijbehorende configuratieveld wordt links gemarkeerd
-   De keuzelijst openen om de gegevens te tonen
-   De gegevens in het configuratieveld bijwerken en in de preview controleren of de wijziging naar verwachting wordt getoond
-   Op **Opslaan** klikken
:::

-   Het sjabloonformaat is beschikbaar in HTML of PDF.
-   Bij PDF zijn extra opmaakopties beschikbaar. De rij 'PDF-configuratie' uitvouwen.

    -   Wijzigingen in het configuratievenster worden in het rechtervenster als preview getoond.

    ![](https://help.qargo.com/media/9375fb4afa1f-image.png)

-   Om afzonderlijke elementen aan te passen, op het element klikken; de rij die moet worden bijgewerkt, wordt dan gemarkeerd.

    -   In de rij klikken; de bewerkingsopties worden getoond.
    -   De gepaste actie uit de opties selecteren.
    -   Na de selectie worden de gewijzigde gegevens bijgewerkt in het preview- of visualisatievenster, zodat ze kunnen worden bevestigd.
-   De **optie 'Achtergrond'** gebruiken om een bestaand briefhoofd te uploaden als achtergrondlay-out voor een factuur.

    ![](https://help.qargo.com/media/5e7c17fc33a3-image.png)

-   Zodra het sjabloon overeenkomt met de vereiste lay-out en inhoud, op **Opslaan** klikken.

::video{src="/media/video/dfe1379400f1-2025-06-30_15-58-25-1-.mp4"}

:::callout{tone="info"}
📚 Als een klantspecifiek sjabloon moet worden gedupliceerd, contact opnemen met Qargo Support om de wijziging aan te vragen.
:::

* * *

### De sorteervolgorde van de rijen configureren {#h_6963ba72da}

In de documentsjablooneditor kunnen regels nu op een gekozen veld worden gesorteerd. Elke PDF die op basis van dat sjabloon wordt aangemaakt, volgt die volgorde: verkoopfacturen, creditnota's, self-bills van onderaannemers, facturatievoorstellen en tripexports. De instelling wordt één keer in het sjabloon bepaald en geldt telkens.

Tot nu toe verschenen regels altijd in dezelfde vaste volgorde (op het geplande starttijdstip van de eerste stop, daarna op de naam van de kost), zonder mogelijkheid om dat te wijzigen. Die volgorde is nu configureerbaar.

### Een sorteersleutel instellen {#h_59b4663596}

1.  Naar **Configuratie > Sjablonen** **navigeren** en het te bewerken sjabloon openen, of een nieuw sjabloon toevoegen.
2.  Het blok met rij-iteratie dat de order- of kostenrijen weergeeft, **selecteren**.
3.  In de sectie **Sorteren** bij **Sorteren op** het veld instellen dat het document moet volgen, en daarna bij **Richting** kiezen voor **Oplopend** of **Aflopend**.
4.  Optioneel een tweede **Sorteren op** **toevoegen** om gelijke waarden te ordenen, bijvoorbeeld eerst op naam van de chauffeur en daarna op geschat starttijdstip.
5.  Het sjabloon **opslaan**. Elke PDF die op basis van dat sjabloon wordt aangemaakt, volgt dan de geconfigureerde sortering.

![](https://help.qargo.com/media/be5296e1baeb-image.png)

### Beschikbare sorteersleutels {#h_87c269fddf}

De beschikbare sleutels hangen af van het soort rijen dat het geselecteerde blok weergeeft.\
Voor orderrijen (sjablonen voor verkoopfacturen en creditnota's):

-   **Ordernummer**
-   **Klantreferentie**
-   **Leveringsdatum (gevraagd)**
-   **Leveringsdatum (werkelijk)**
-   **Ophaaldatum (gevraagd)**
-   **Ophaaldatum (werkelijk)**
-   **Tijdstip laatste zendingsstop** (de bestaande standaard)

Voor kostenrijen (sjablonen voor aankoopfacturen en facturatievoorstellen of self-bills):

-   **Naam chauffeur**
-   **Naam resource (voertuig)**
-   **Tripnummer**
-   **Geschat starttijdstip** (de bestaande standaard)
-   **Naam kost**

Sjablonen voor tripexports bieden daarnaast **Voertuig** en **Chauffeur** als sorteersleutels.

### Veelvoorkomend gebruik {#h_fe2b5a9a42}

-   Een verkoopfactuur gesorteerd op **Klantreferentie** of **Leveringsdatum**, zodat de klant ze met de eigen administratie kan afstemmen.
-   Een self-bill of facturatievoorstel voor een onderaannemer, gegroepeerd op **Naam chauffeur** (primair) en daarna chronologisch op **Geschat starttijdstip** (secundair), zodat de trips van elke chauffeur bij elkaar staan.
-   Een tripexport gegroepeerd per voertuig door **Naam resource (voertuig)** als sorteersleutel te gebruiken.

:::callout{tone="note"}
De standaardsortering komt overeen met het vroegere gedrag. Bestaande sjablonen veranderen dus pas als een nieuwe sorteersleutel wordt gekozen. Er is geen automatische migratie.
:::

:::callout{tone="info"}
📚 De sortering in de lijstweergaven **Facturen**, **Creditnota's** of **Te factureren trips** staat los van het sjabloon. De volgorde van de rijen in een aangemaakte PDF wordt alleen bepaald door de sortering die in het sjabloon is geconfigureerd.
:::

:::callout{tone="note"}
In deze release bepaalt de configureerbare sortering de volgorde van orderrijen of triprijen. Kostenregels binnen een tripblok behouden hun bestaande volgorde. Handmatig rijen ordenen met slepen en neerzetten en de volgorde van documenten in een samengevoegde PDF met meerdere documenten vallen er niet onder. Voor blokken met een subtotaal per chauffeur, voertuig, order of trip, zie [Regels groeperen en subtotalen](#h_0233169384).
:::

* * *

## Regels groeperen en subtotalen {#h_0233169384}

Factuursjablonen kunnen kostenregels in blokken afdrukken, met onder elk blok een subtotaal. Dat helpt klanten en onderaannemers die een totaal per vrachtwagen, per chauffeur, per order of per trip nodig hebben, zonder dat handmatig te moeten uitrekenen. Het eindtotaal blijft altijd onderaan het document staan.

Er zijn twee opties:

-   Twee basissjablonen met gegroepeerde regels, die regels groeperen op een gekozen sleutel.
-   Een optionele subtotaalrij na elke order of trip op de bestaande factuursjablonen.

### Regels groeperen op order, trip, voertuig of chauffeur {#h_fdd064632a}

:::callout{tone="info"}
🧰 Voor het instellen van een sjabloon is een super admin nodig. Voor hulp bij een klantspecifiek sjabloon contact opnemen met Qargo Support of het onboardingteam.
:::

1.  Naar **Configuratie > Sjablonen** **navigeren** en op **Sjabloon toevoegen** klikken.

    ![De pagina Sjablonen met de knop Sjabloon toevoegen](https://help.qargo.com/media/90db2ec05846-templates-add-template.png)

2.  Het documenttype **selecteren** en daarna het basissjabloon kiezen: **Factuursjabloon - gegroepeerde regels** voor verkoopfacturen en creditnota's, of **Aankoopfactuursjabloon - gegroepeerde regels** voor facturatievoorstellen en self-bills.

    ![Het documenttype kiezen](https://help.qargo.com/media/e6d6256bfbb3-templates-document-type.png)

    ![De lijst met basissjablonen met Factuursjabloon - gegroepeerde regels](https://help.qargo.com/media/cdbf3045f255-templates-base-grouped-lines.png)

3.  **Sjabloonopties** **uitklappen** en **Instellingen regelgroepering** openen.
4.  **Regels groeperen op** **instellen** op de sleutel die het document moet volgen.

    ![Het veld Regels groeperen op in Instellingen regelgroepering](https://help.qargo.com/media/c5e07e56d1ee-templates-group-lines-by.png)

5.  Het sjabloon **opslaan**. Elk document dat op basis van het sjabloon wordt aangemaakt, drukt één blok per groep af.

    ![Preview van een verkoopfactuur gegroepeerd per order, met onder elke order een subtotaal](https://help.qargo.com/media/0e5a49719885-templates-grouped-preview.png)

De beschikbare sleutels hangen af van het document:

-   Verkoopfacturen en creditnota's: **Order**, **Voertuig** en **Chauffeur**.
-   Facturatievoorstellen en self-bills: **Trip**, **Order** (de kostorder van de regel), **Voertuig** en **Chauffeur**.

![De opties voor Regels groeperen op bij een aankoopfactuursjabloon: Chauffeur, Order, Trip en Voertuig](https://help.qargo.com/media/35193e9056f2-templates-group-keys-purchase.png)

Elk blok heeft een koptekst (bijvoorbeeld het ordernummer, de nummerplaat of de naam van de chauffeur), de bijbehorende kostenregels en een subtotaal. Subtotalen worden standaard afgedrukt. Om ze te verbergen, het veld **group_subtotal_label** op het sjabloon leegmaken. Koptekst en regels van de groepen blijven staan.

![Het veld group_subtotal_label en de subtotaalrij in de preview](https://help.qargo.com/media/2c1ad77a6b83-templates-group-subtotal-label.png)

Regels zonder waarde voor de gekozen sleutel worden in één blok aan het einde van het document verzameld, met een eigen subtotaal. Het blok draagt de naam van de sleutel: "Geen voertuig toegewezen" of "Geen chauffeur toegewezen".

:::callout{tone="note"}
📚 Kosten die rechtstreeks aan een factuur zijn toegevoegd zonder order, worden in een eigen blok na de groepen afgedrukt. Ze blijven buiten elk groepssubtotaal en tellen wel mee in het eindtotaal. Een subtotaal omvat altijd een volledige groep: een subtotaal over een handmatig gekozen set kosten is niet mogelijk.

![Een verkoopfactuur gegroepeerd per chauffeur, met een kost zonder order die na de groepen wordt afgedrukt](https://help.qargo.com/media/aa096cb75773-templates-charge-without-order.png)
:::

:::callout{tone="info"}
🧰 Goed om te weten:

-   Groeperen vereist een sjabloon dat op een van de twee basissjablonen met gegroepeerde regels is gebouwd. Een bestaand sjabloon kan niet naar groeperen worden omgezet.
-   Per sjabloon geldt maar één groeperingssleutel. Een document kan niet eerst op voertuig en daarna op order worden gegroepeerd.
-   Groeperen op product bestaat niet. Voor een totaal per kost het basissjabloon **Totaalfactuursjabloon - kosten gegroepeerd op naam** gebruiken.
:::

Hoe regels aan een voertuig of chauffeur worden toegewezen:

-   Op verkoopdocumenten wordt een order nooit over twee groepen verdeeld. Alle kostenregels ervan worden afgedrukt onder het voertuig of de chauffeur van de leveringsstop.
-   Voertuig betekent de primaire tractor, de vrachtwagen of de bestelwagen. Een trailer wordt nooit als groep gebruikt.
-   Een trip met twee primaire tractors toont beide nummerplaten in één koptekst. Hetzelfde geldt voor twee primaire chauffeurs.

:::callout{tone="info"}
📚 De volgorde van de blokken volgt de sorteerinstellingen van het sjabloon (zie [De sorteervolgorde van de rijen configureren](#h_6963ba72da)). Eerst op **Naam chauffeur** en daarna op datum sorteren om de trips van elke chauffeur in chronologische volgorde te tonen.
:::

### Een subtotaalrij toevoegen aan bestaande factuursjablonen {#h_f208069a26}

De bestaande verkoopfactuursjablonen (1, 2 en 3 kolommen, totaal met details, en totaal met gegroepeerde kosten en details) en de bijbehorende aankoopfactuursjablonen kunnen na elke order (verkoop) of elke trip (aankoop) een subtotaalrij afdrukken.

1.  Naar **Configuratie > Sjablonen** **navigeren** en het te wijzigen sjabloon openen.
2.  **order_subtotal_label** **invullen** op verkoopsjablonen, of **shipment_subtotal_label** op aankoopsjablonen, bijvoorbeeld met "Subtotaal".

    ![Het veld order_subtotal_label op een verkoopfactuursjabloon](https://help.qargo.com/media/1bd4eb75b78f-templates-order-subtotal-label.png)

3.  De preview in het paneel **Visualiseren** **controleren**. De rij verschijnt onder de laatste kostenregel van elke order of trip, in dezelfde kolomindeling als de kostenrijen.
4.  Het sjabloon **opslaan**.

Beide velden zijn standaard leeg, dus bestaande documenten veranderen pas wanneer een label is ingevuld. Om de rij weer te verwijderen, het veld volledig leegmaken.

:::callout{tone="note"}
📚 Een sjabloon dat via de eigen configuratie al een tripsubtotaal boven de kostenregels afdrukt, toont twee subtotalen per trip zodra een label is ingevuld. Eerst de oudere instelling wissen.
:::

### Goed om te weten {#h_6b1e0c4d92}

-   Er is geen paginatotaal en geen instelling voor het aantal rijen per pagina. Een factuur van meerdere pagina's toont het totaal alleen op de laatste pagina.
-   Er is geen overzichtsblok dat het totaal van elke groep toont vóór de detailregels.

* * *

## Praktische probleemoplossing: voorbeelden voor factuursjablonen {#h_df85dd75fd}

-   **Achtergrond wordt niet getoond**: controleren of het bestandsformaat een ondersteund type is en of de optie "Tonen in PDF" tijdens het bewerken is ingeschakeld.
-   **Fout** `Preview could not be rendered or updated. Please verify that all open '#{{' tags have a corresponding '}}' tag.`: kan erop wijzen dat het weergeven van de preview mislukt door de grote omvang van het document. Testen met een kleiner document (slechts enkele orders) om na te gaan of de preview werkt. Het aanmaken van documenten wordt hierdoor niet beïnvloed.
-   **Moeilijkheden bij het verwijderen van elementen**: als ongewenste elementen, zoals een e-mailadres, deel uitmaken van een achtergrondbestand, dat bestand extern bewerken met bijvoorbeeld een PDF-editor en het daarna opnieuw uploaden in de configuratie-instellingen van het sjabloon.
-   **Terugkerende problemen met de achtergrond**: wijzigingen in het achtergrondbestand altijd opslaan voordat het opnieuw wordt geüpload, en de wijzigingen via de preview controleren.
-   **Verkeerde referentienummers:** om het referentienummer op facturen bij te werken:

    1.  Naar de sectie **Sjablonen** in Qargo gaan.
    2.  Het sjabloon openen dat voor de facturen van de betreffende klant wordt gebruikt.
    3.  In het adresveld klikken. Het veld waarin de referentie is opgeslagen, wordt dan in het linkervenster gemarkeerd.
    4.  Het referentienummer naar de gewenste waarde bijwerken.
    5.  Het sjabloon opslaan. De bijgewerkte referentie geldt voor alle nieuw aangemaakte facturen. Als een factuur al de status "Gefactureerd" heeft, kan de PDF worden bijgewerkt door de factuur-PDF opnieuw te genereren, zodat de nieuwe referentie verschijnt.
-   **Klantreferenties in Peppol XML controleren**: om na te gaan of een klantreferentie in de Peppol XML van een factuur staat:

    1.  De factuur in Qargo openen.
    2.  De preview van de Peppol XML openen.
    3.  Met de zoekfunctie de referentiewaarde opzoeken door het verwachte referentienummer te plakken.
    4.  Controleren of de referentie in de XML in het previewvenster rechts verschijnt.


## Gerelateerde artikelen

- [Video: hoe regels groeperen en subtotalen toevoegen op verkoop- en aankoopfacturen?](https://help.qargo.com/nl/articles/894190-video-hoe-regels-groeperen-en-subtotalen-toevoegen-op-verkoop-en-aankoopfacturen.md)
- [Aangepaste exports: de Expression Builder gebruiken](https://help.qargo.com/nl/articles/467741-aangepaste-exports-de-expression-builder-gebruiken.md)
- [Sjablonen: groupage-CMR's instellen](https://help.qargo.com/nl/articles/425074-sjablonen-groupage-cmrs-instellen.md)
- [Facturen: self-bill voor onderaannemer aanmaken vanuit trips](https://help.qargo.com/nl/articles/133825-facturen-self-bill-voor-onderaannemer-aanmaken-vanuit-trips.md)
- [Orders - functies van de lijstweergave van orders](https://help.qargo.com/nl/articles/133839-orders-functies-van-de-lijstweergave-van-orders.md)
