In een scriptlog kun je gegevens van de offerte automatisch laten invullen door middel van variabelen. Tijdens het gesprek vervangt Salesdock de variabelen door de werkelijke waarden uit de sale, zodat de medewerker klantcontact altijd de juiste tarieven, verbruiken en klantgegevens voorleest.

Dit artikel beschrijft hoe je een scriptlog inschakelt voor een flow, welke variabelen beschikbaar zijn in een energie-scriptlog en hoe je met conditionele blokken delen van het script alleen toont wanneer ze van toepassing zijn (bijvoorbeeld alleen bij stroom, alleen bij gas, of alleen bij klanten met zonnepanelen).

Scriptlog inschakelen

Een scriptlog wordt per flow ingeschakeld. Volg deze stappen:

  1. Ga naar Beheer → Flows en open de flow waarvoor je een scriptlog wilt instellen.
  2. Scroll in de flow-instellingen naar het onderdeel Scriptlog.
  3. Zet de schakelaar Scriptlog inschakelen aan.
  4. Schrijf de scripttekst in de editor daaronder. Je kunt hier vrij tekst invoeren en op de juiste plekken variabelen invoegen.
  5. Klik op Opslaan.

Waar vind ik dit? Het Scriptlog-onderdeel staat onderaan de flow-instellingen, vlak onder de PDF-instellingen en boven het onderdeel Handtekening agent op offerte-PDF.

Variabelen-knop in de editor

Naast de teksteditor van het scriptlog vind je een +-knop met de tekst Variables. Daarin staat de complete, voor jouw flow geldende variabelenboom: standaardvelden (sale, product, energie, organisatie, agent), maar ook alles wat specifiek voor jouw account is opgezet:

  • Productvragen die in de flow worden gesteld — bijvoorbeeld een vraag over de gekozen betaalmethode komt terug als {{productquestions.<identifier>}}.
  • Extra velden op het product — bijvoorbeeld als de looptijd niet via het systeemveld maar via een eigen extra veld is vastgelegd, vind je die terug als {{product.extrafield.<identifier>}}.
  • Extra velden op de sale, organisatie, leverancier of flow — respectievelijk {{sale.extrafield.…}}, {{organisation.extrafield.…}}, {{supplier.extrafield.…}}, {{flow.extrafield.…}}.

Gebruik deze knop als je twijfelt over een variabele-naam, of om eigen velden te vinden die hieronder niet staan.

Klantgegevens

OmschrijvingVariabele
Voornaam{{sale.firstname}}
Achternaam{{sale.lastname}}
Volledige naam{{sale.fullName}}
Geslacht (waarde){{sale.gender}}
Geboortedatum{{sale.birthdate}}
E-mailadres{{sale.email}}
Telefoonnummer{{sale.phone}}
Bedrijfsnaam (zakelijk){{sale.companyName}}
KvK-nummer (zakelijk){{sale.kvk}}
IBAN{{sale.iban}}
IBAN-tenaamstelling{{sale.ibanHolder}}

Adresgegevens

OmschrijvingVariabele
Volledig adres (regel){{sale.address}}
Straatnaam{{sale.streetname}}
Huisnummer{{sale.housenumber}}
Toevoeging{{sale.suffix}}
Postcode{{sale.postcode}}
Woonplaats{{sale.city}}
Aansluitadres — straat{{sale.connectionStreetname}}
Aansluitadres — huisnummer{{sale.connectionHousenumber}}
Aansluitadres — toevoeging{{sale.connectionSuffix}}
Aansluitadres — postcode{{sale.connectionPostcode}}
Aansluitadres — woonplaats{{sale.connectionCity}}

Verbruik — elektriciteit

OmschrijvingVariabele
Verbruik enkeltarief (kWh){{energie.electricity.usage-single}}
Verbruik normaal/hoog (kWh){{energie.electricity.usage-high}}
Verbruik dal/laag (kWh){{energie.electricity.usage-low}}
Totaal verbruik (kWh){{energie.electricity.usage-combined}}
Teruglevering enkeltarief (kWh){{energie.electricity.return-single}}
Teruglevering normaal/hoog (kWh){{energie.electricity.return-high}}
Teruglevering dal/laag (kWh){{energie.electricity.return-low}}
Totale teruglevering (kWh){{energie.electricity.return-total}}
EAN-code elektra{{energie.electricity.ean-code}}
Aansluitwaarde{{energie.electricity.connection-type}}
Netbeheerder{{energie.electricity.grid-operator}}

Verbruik — gas

OmschrijvingVariabele
Gasverbruik (m³){{energie.gas.usage}}
EAN-code gas{{energie.gas.ean-code}}
Aansluitwaarde{{energie.gas.connection-type}}
Netbeheerder{{energie.gas.grid-operator}}

Tarieven elektriciteit

Elk tarief heeft twee varianten: zonder en met btw. Voor consumentenscripts gebruik je de variant met -inc-tax achter de naam.

OmschrijvingExcl. btwIncl. btw
Tarief enkeltarief (per kWh){{energie.electricity.tariff-single}}{{energie.electricity.tariff-single-inc-tax}}
Tarief normaal/hoog (per kWh){{energie.electricity.tariff-high}}{{energie.electricity.tariff-high-inc-tax}}
Tarief dal/laag (per kWh){{energie.electricity.tariff-low}}{{energie.electricity.tariff-low-inc-tax}}
All-in tarief enkel (per kWh){{energie.electricity.all-in-tariff-single}}{{energie.electricity.all-in-tariff-single-inc-tax}}
All-in tarief normaal (per kWh){{energie.electricity.all-in-tariff-high}}{{energie.electricity.all-in-tariff-high-inc-tax}}
All-in tarief dal (per kWh){{energie.electricity.all-in-tariff-low}}{{energie.electricity.all-in-tariff-low-inc-tax}}
Vaste leveringskosten per maand{{energie.electricity.fixed-fee-month}}{{energie.electricity.fixed-fee-month-inc-tax}}
Vaste leveringskosten per jaar{{energie.electricity.fixed-fee-year}}{{energie.electricity.fixed-fee-year-inc-tax}}
Cashback / korting{{energie.electricity.cashback}}{{energie.electricity.cashback-inc-tax}}
Vermindering energiebelasting (per jaar){{energie.electricity.tax-reduction}}{{energie.electricity.tax-reduction-inc-tax}}
Netbeheerkosten per maand{{energie.electricity.tariff-grid-operator-monthly}}{{energie.electricity.tariff-grid-operator-monthly-inc-tax}}
Netbeheerkosten per jaar{{energie.electricity.tariff-grid-operator-year}}{{energie.electricity.tariff-grid-operator-year-inc-tax}}
Tarief groene stroom (per kWh){{energie.electricity.tariff-green-electricity}}{{energie.electricity.tariff-green-electricity-inc-tax}}
Inkoopopslag elektra (verbruik){{energie.electricity.purchase-surcharge}}{{energie.electricity.purchase-surcharge-inc-tax}}
Inkoopopslag elektra (teruglevering){{energie.electricity.purchase-surcharge-return}}{{energie.electricity.purchase-surcharge-return-inc-tax}}
Inkoopopslag teruglevering (boven saldering){{energie.electricity.purchase-surcharge-return-after-offset}}{{energie.electricity.purchase-surcharge-return-after-offset-inc-tax}}

Dynamische prijzen elektra

Voor producten met dynamische tarieven zijn de gemiddelde prijzen beschikbaar via aparte variabelen. Deze worden gebruikt wanneer het tarief afhankelijk is van het EPEX-/dynamische markt:

OmschrijvingExcl. btwIncl. btw
Gemiddelde dynamische prijs verbruik{{energie.electricity.average-dynamic-price-usage}}{{energie.electricity.average-dynamic-price-usage-inc-tax}}
Gemiddelde dynamische prijs teruglevering{{energie.electricity.average-dynamic-price-return}}{{energie.electricity.average-dynamic-price-return-inc-tax}}

Tarieven gas

OmschrijvingExcl. btwIncl. btw
Tarief gas (per m³){{energie.gas.tariff}}{{energie.gas.tariff-inc-tax}}
Tarief incl. regiotoeslag (per m³){{energie.gas.tariff-with-gas-region-tax}}{{energie.gas.tariff-with-gas-region-tax-inc-tax}}
All-in tarief (per m³){{energie.gas.all-in-tariff}}{{energie.gas.all-in-tariff-inc-tax}}
Vaste leveringskosten per maand{{energie.gas.fixed-fee-month}}{{energie.gas.fixed-fee-month-inc-tax}}
Vaste leveringskosten per jaar{{energie.gas.fixed-fee-year}}{{energie.gas.fixed-fee-year-inc-tax}}
Cashback / korting{{energie.gas.cashback}}{{energie.gas.cashback-inc-tax}}
Netbeheerkosten per maand{{energie.gas.tariff-grid-operator-monthly}}{{energie.gas.tariff-grid-operator-monthly-inc-tax}}
Netbeheerkosten per jaar{{energie.gas.tariff-grid-operator-year}}{{energie.gas.tariff-grid-operator-year-inc-tax}}
Inkoopopslag gas{{energie.gas.purchase-surcharge}}{{energie.gas.purchase-surcharge-inc-tax}}
Gemiddelde dynamische prijs gas{{energie.gas.average-dynamic-price}}{{energie.gas.average-dynamic-price-inc-tax}}

Terugleverkosten en terugleververgoeding

Voor klanten met zonnepanelen zijn er aparte variabelen voor terugleverkosten (vaste of variabele kosten die de leverancier in rekening brengt) en terugleververgoeding (de vergoeding die de klant ontvangt voor stroom die hij teruglevert boven het saldeerbare deel).

Huidige terugleververgoeding (vóór 1 januari 2027)

OmschrijvingExcl. btwIncl. btw
Terugleververgoeding enkel (per kWh){{energie.electricity.tariff-return-single}}{{energie.electricity.tariff-return-single-inc-tax}}
Terugleververgoeding normaal (per kWh){{energie.electricity.tariff-return-high}}{{energie.electricity.tariff-return-high-inc-tax}}
Terugleververgoeding dal (per kWh){{energie.electricity.tariff-return-low}}{{energie.electricity.tariff-return-low-inc-tax}}

Terugleverkosten

OmschrijvingExcl. btwIncl. btw
Vaste terugleverkosten per maand{{energie.electricity.fixed-fee-return-month}}{{energie.electricity.fixed-fee-return-month-inc-tax}}
Vaste terugleverkosten per jaar{{energie.electricity.fixed-fee-return-year}}{{energie.electricity.fixed-fee-return-year-inc-tax}}
Schaal-aanduiding terugleverkosten{{energie.electricity.fixed-fee-return-scale}}
Variabele terugleverkosten per kWh{{energie.electricity.tariff-variable-fee-return}}{{energie.electricity.tariff-variable-fee-return-inc-tax}}
Variabele terugleverkosten per maand{{energie.electricity.variable-fee-return-month}}{{energie.electricity.variable-fee-return-month-inc-tax}}
Variabele terugleverkosten per jaar{{energie.electricity.variable-fee-return-year}}{{energie.electricity.variable-fee-return-year-inc-tax}}

Vanaf 1 januari 2027 (na afloop salderingsregeling)

OmschrijvingExcl. btwIncl. btw
Terugleververgoeding enkel (per kWh, 2027){{energie.electricity.tariff-return-single-2027}}{{energie.electricity.tariff-return-single-2027-inc-tax}}
Terugleververgoeding normaal (per kWh, 2027){{energie.electricity.tariff-return-high-2027}}{{energie.electricity.tariff-return-high-2027-inc-tax}}
Terugleververgoeding dal (per kWh, 2027){{energie.electricity.tariff-return-low-2027}}{{energie.electricity.tariff-return-low-2027-inc-tax}}
Variabele terugleverkosten per kWh (2027){{energie.electricity.tariff-variable-fee-return-2027}}{{energie.electricity.tariff-variable-fee-return-2027-inc-tax}}
Terugleververgoeding offset (saldering, enkel){{energie.electricity.tariff-return-single-offset-2027}}{{energie.electricity.tariff-return-single-offset-2027-inc-tax}}
Variabele terugleverkosten offset{{energie.electricity.tariff-variable-fee-return-offset-2027}}{{energie.electricity.tariff-variable-fee-return-offset-2027-one-cent-inc-tax}}

Totaalbedragen

OmschrijvingExcl. btwIncl. btw
Indicatief jaarbedrag totaal{{energie.totals.total}}{{energie.totals.total-inc-tax}}
Indicatief maandbedrag totaal{{energie.totals.total-per-month}}{{energie.totals.total-per-month-inc-tax}}
Totaal cashback / korting{{energie.totals.total-cashback}}{{energie.totals.total-cashback-inc-tax}}
Indicatief jaarbedrag (situatie 2027){{energie.totals.total-2027}}{{energie.totals.total-inc-tax-2027}}
Indicatief maandbedrag (situatie 2027){{energie.totals.total-per-month-2027}}{{energie.totals.total-per-month-inc-tax-2027}}

Multi-site (meerdere locaties)

Wanneer een sale meerdere leveradressen bevat (bijvoorbeeld bij zakelijke klanten met meerdere panden), zijn de gegevens per locatie beschikbaar via een loop. Het volgende blok wordt voor iedere locatie herhaald:

{{#energie.multi-sites}}
Locatie: {{connection-address}}
Verbruik elektra: {{electricity.usage-combined}} kWh
Verbruik gas: {{gas.usage}} m³
{{/energie.multi-sites}}

Binnen het blok zijn dezelfde elektra- en gas-variabelen beschikbaar als hierboven beschreven, maar dan zonder het energie.-prefix. Beschikbare velden per locatie:

OmschrijvingVariabele (binnen loop)
Volledig leveradres{{connection-address}}
Postcode leveradres{{connection-postcode}}
Huisnummer leveradres{{connection-housenumber}}
Toevoeging leveradres{{connection-suffix}}
Bevat elektra (boolean){{has-stroom}}
Bevat gas (boolean){{has-gas}}
Jaartotaal locatie{{total}} / {{total-inc-tax}}
Maandbedrag locatie{{total-per-month}} / {{total-per-month-inc-tax}}
Klantclassificatie locatie{{customer-classification}}
Elektra-blok{{electricity.…}}
Gas-blok{{gas.…}}

Wil je het multi-site-blok alleen tonen wanneer er daadwerkelijk meerdere locaties zijn, gebruik dan de boolean energie.has-multisite.

Klantclassificatie en sale-meta

OmschrijvingVariabele
Klantclassificatie (label){{energie.customer-classification}}
Klant is micro-business (boolean){{energie.is-micro-business}}
Acquisitie of retentie{{energie.retention}}
Bron van verbruik (klant / schatting / cercar){{energie.usage-source}}
Toelichting bij verbruiksbron{{energie.usage-source-text}}
Levering hoofdzakelijk privé{{energie.delivery-mainly-private}}
Woon-, werk- of verblijfsfunctie{{energie.woon-werk-verblijfsfunctie}}

Product en organisatie

OmschrijvingVariabele
Productnaam{{product.name}}
Looptijd in maanden (systeemveld){{product.duration}}
Looptijd via product extra-veld{{product.extrafield.<identifier>}}
Leverancier{{supplier.name}}
Organisatie{{organisation.name}}
Naam medewerker{{agent.fullName}}
Datum vandaag{{general.currentDate}}
Antwoord op een productvraag{{productquestions.<identifier>}}

Let op — Looptijd: de variabele {{product.duration}} geeft de looptijd in maanden terug (12, 24, 36 enzovoort). Er is geen ingebouwde "looptijd in jaren"-variabele. Wil je in het script "1 jaar" of "3 jaar" laten oplezen, dan kun je dit het beste hardcoderen in de tekst per propositie, of een eigen extra-veld op het product definiëren met de tekstuele variant en die uitvragen via {{product.extrafield.<identifier>}}.

Conditionele blokken: alleen tonen als…

Met conditionele blokken (zogeheten sections) toon je een stuk tekst alleen wanneer aan een voorwaarde wordt voldaan. Salesdock gebruikt hiervoor de Mustache-syntax:

  • {{#voorwaarde}}…tekst…{{/voorwaarde}} — tekst tonen als de voorwaarde waar is.
  • {{^voorwaarde}}…tekst…{{/voorwaarde}} — tekst tonen als de voorwaarde niet waar is.

Single fuel of dual fuel (alleen elektra, alleen gas, of beide)

In een energieflow kan een sale zowel een dual-fuel (elektra & gas), elektra-only of gas-only product bevatten. De volgende voorwaarden zijn beschikbaar om delen van het script gericht te tonen:

VoorwaardeVariabele
Sale bevat elektraenergie.has-stroom
Sale bevat gasenergie.has-gas
Sale bevat zowel elektra als gas (dual fuel)energie.has-stroom-and-gas

Voorbeeld — alleen tonen als er elektra in de sale zit:

{{#energie.has-stroom}}
Het stroomtarief bedraagt {{energie.electricity.tariff-single-inc-tax}} per kWh.
{{/energie.has-stroom}}

Voorbeeld — alleen tonen als er gas in de sale zit:

{{#energie.has-gas}}
Het gastarief bedraagt {{energie.gas.tariff-inc-tax}} per kubieke meter.
{{/energie.has-gas}}

Voorbeeld — alleen tonen als zowel elektra als gas in de sale zit (dual fuel):

{{#energie.has-stroom-and-gas}}
Daarnaast rekenen we vaste leveringskosten per product per maand.
{{/energie.has-stroom-and-gas}}

Voorbeeld — alleen tonen wanneer er alleen elektra is, geen gas (single fuel elektra):

{{#energie.has-stroom}}
{{^energie.has-gas}}
U sluit een contract af voor alleen elektriciteit.
{{/energie.has-gas}}
{{/energie.has-stroom}}

Enkeltarief of dubbeltarief (een meter met of zonder dal/normaal)

Voor elektra is er één voorwaarde die aangeeft of de klant een dubbele meter heeft (dal- en normaaltarief) of een enkele meter (één tarief). Daarmee kun je de tarieven correct uitspreken in het script:

VoorwaardeVariabele
Klant heeft dubbele meterenergie.electricity.double-meter
{{#energie.electricity.double-meter}}
Het normaaltarief bedraagt {{energie.electricity.tariff-high-inc-tax}} per kWh
en het daltarief {{energie.electricity.tariff-low-inc-tax}} per kWh.
{{/energie.electricity.double-meter}}
{{^energie.electricity.double-meter}}
Het tarief bedraagt {{energie.electricity.tariff-single-inc-tax}} per kWh (enkeltarief).
{{/energie.electricity.double-meter}}

Klant heeft zonnepanelen / teruglevert

VoorwaardeVariabele
Klant levert terug (zonnepanelen)energie.electricity.has-return
{{#energie.electricity.has-return}}
Wanneer u zonnepanelen heeft, brengen wij u terugleverkosten in rekening.
De terugleververgoeding bedraagt {{energie.electricity.tariff-return-single-inc-tax}} per kWh.
{{/energie.electricity.has-return}}

Andere veelgebruikte conditionals

VoorwaardeVariabele
Sale heeft meerdere locaties (multi-site)energie.has-multisite
Klant is micro-businessenergie.is-micro-business
Berekening met saldering 2027 actiefenergie.electricity.has-2027-calculation
Inkoopopslag boven saldering aanwezigenergie.electricity.has-purchase-surcharge-return-after-offset
Sale is een mansale.ismale
Sale is een vrouwsale.isfemale

Aandachtspunten

Tip: open- en sluittag van een conditioneel blok moeten exact dezelfde naam hebben. {{#energie.has-stroom}} sluit altijd af met {{/energie.has-stroom}}. Een typefout zorgt ervoor dat het blok niet wordt herkend en als platte tekst in het script blijft staan.

Let op — btw-variant: kies bewust voor de -inc-tax-variant of de variant zonder btw. Voor consumentenscripts gebruik je altijd inclusief btw, voor zakelijke scripts vaak exclusief. Een verkeerde keuze betekent dat je de klant met het verkeerde bedrag voorleest.

Test je script: als je een nieuw scriptlog opzet, doorloop dan altijd een testverkoop in de salesflow met realistische verbruiksgegevens. Je ziet daarmee meteen of alle variabelen correct worden ingevuld en of je conditionele blokken juist werken bij verschillende klantsituaties (single fuel, dual fuel, met of zonder zonnepanelen, enkele/dubbele meter).

Begrippenlijst

Scriptlog — gespreksleidraad die de medewerker klantcontact gebruikt tijdens het verkoopgesprek. Variabelen worden tijdens het gesprek vervangen door de actuele waarden uit de sale.

Mustache — de syntax die Salesdock gebruikt om variabelen in te voegen, herkenbaar aan de dubbele accolades {{ … }}.

Section — conditioneel blok in mustache-syntax, geopend met {{#…}} en gesloten met {{/…}}.

Inverted section — omgekeerd conditioneel blok, geopend met {{^…}}. De inhoud wordt getoond als de voorwaarde niet waar is.

Single fuel — een sale met alleen elektriciteit of alleen gas, in plaats van beide.

Dual fuel — een sale waarbij zowel elektriciteit als gas worden afgesloten.

Multi-site — een sale waarbij meerdere leveradressen onder hetzelfde contract vallen, doorgaans bij zakelijke klanten met meerdere panden.

Productvraag — een vraag die in de salesflow aan de klant wordt gesteld en wordt opgeslagen op de sale; bijvoorbeeld de gekozen betaalmethode.

Extra veld — een extra eigenschap die zelf is gedefinieerd op een product, sale, organisatie, leverancier of flow, naast de standaard systeemvelden.