Producten

De productenmodule is de centrale plek waar je alles beheert dat op een factuur kan verschijnen: verblijfstarieven, diensten, energiekosten en andere artikelen. Elk product heeft een prijs inclusief BTW, en je kunt extra opties instellen zoals automatisch printen of een periodebinding.

Productenoverzicht

Je vindt alle producten via Administratie > Producten.

De tabel toont per product:

• Naam en Beschrijving
• Info - het klanttype en metertype waaraan het product gekoppeld is (alleen zichtbaar als beide zijn ingesteld)
• Prijs (incl. BTW)
• BTW %
• Grootboek - het grootboeknummer voor de boekhouding (optioneel)

Zoeken en filteren

Bovenaan de tabel vind je een zoekbalk en een aantal filteropties:

• Typ in de zoekbalk om producten direct te filteren
• Filter op BTW, Klanttype, Metertype, Actietype of Rekeningen
• Gebruik de knop Filters wissen om alle actieve filters in één keer te wissen

Een product aanmaken

1. Ga naar Administratie > Producten
2. Klik op Nieuw Product rechtsboven in de werkbalk
3. Vul in het dialoogvenster de basisgegevens in:
   • Naam (verplicht) - de naam zoals die op facturen verschijnt
   • Beschrijving - een korte toelichting (optioneel)
   • Prijs (incl. BTW) - het bedrag per eenheid, inclusief BTW
   • BTW % - kies het toepasselijke BTW-tarief (0%, 6%, 9%, 12% of 21%)
   • Grootboek - het grootboeknummer voor je boekhouding (optioneel)
   • Klanttype - beperk het product tot een specifiek klanttype (optioneel)
   • Metertype - koppel het product aan een metertype (optioneel)
4. Klik op Aanmaken

Tillor opent daarna de productdetailpagina. Daar stel je factuurregelacties, automatisch printen en gebeurtenissen in (zie Een product bewerken).

Het product verschijnt in de lijst en is beschikbaar voor gebruik op facturen zodra je het hebt aangemaakt.

Een product bewerken

1. Ga naar Administratie > Producten
2. Klik op de productnaam of op het potloodpictogram in de rij
3. Op de productdetailpagina pas je links Algemeen en Extra factuurregels aan, en rechts Acties op factuurregel
4. Klik onderaan de kaart Extra factuurregels op Opslaan om alle wijzigingen op de pagina op te slaan

Rechts onder Gebeurtenissen zie je een tijdlijn van wijzigingen (prijs, BTW, grootboek, klanttype, geconfigureerde acties, enz.) met tijdstip, gebruiker en waar van toepassing een voor/na-overzicht van gewijzigde velden.

Een product verwijderen

1. Ga naar Administratie > Producten
2. Klik op het prullenbakpictogram naast het product
3. Bevestig de verwijdering door op "Verwijderen" te klikken in het dialoogvenster

Acties op factuurregel

Op de productdetailpagina kies je onder Acties op factuurregel een of meer acties die Tillor uitvoert wanneer een factuur met dit product wordt betaald. Zet een vinkje aan om een actie in te schakelen; extra velden verschijnen alleen bij de acties die dat nodig hebben.

In de productlijst toont de kolom Actie welke acties op het product staan (meerdere acties worden samengevat).

Geen extra actie

Laat alle vakjes uitgeschakeld voor gewone tarieven en diensten zonder automatische opvolging bij betaling.

NFC Tag Opladen

Wanneer een factuur met dit product wordt betaald, wordt er automatisch een NFC-tag opgeladen. Dit is bedoeld voor producten die klanten toegang geven via een NFC-tag.

Periode

Het product vertegenwoordigt een dienst over een bepaalde tijdsperiode. Als je Periode aanvinkt, verschijnen er twee extra velden:

• Per eenheid - het aantal eenheden per periode (minimaal 1)
• Periode-eenheid - kies Dag, Week of Maand

Gebruik dit actietype voor dagprijzen, weekabonnementen of maandelijkse tarieven.

Bezetting verlengen

Wanneer een factuur met dit product wordt betaald, verlengt Tillor Betaald tot van de bezetting op het gekozen terrein op basis van de periode op de factuurregel. Met Afronden op volgende periodegrens (op de factuur) lijnen klanten op termijn uit op dezelfde cyclus volgens de Huurfrequentie van die bezetting.

Bij het toevoegen van zo'n factuurregel kies je op de factuur een terrein. Tillor koppelt bij boeken en betalen de actieve bezetting van die klant op dat terrein. Tillor bewaart ook een snapshot van die bezetting in de factuurregel, zodat je achteraf nog kunt zien welke bezetting bedoeld was, ook als die bezetting later verwijderd is. In offerte-modus kun je een terrein kiezen waar de klant (nog) geen bezetting op heeft; zo'n regel is dan niet te boeken tot er een bezetting is.

In het productformulier kun je optioneel Vervaldatum op start bezetting aanvinken (alleen bij Bezetting verlengen). Staat die optie aan, dan zet Tillor bij het boeken van de factuur de vervaldatum op de startdatum van de bezettingsperiode op de Staangeld-regel (de van-datum), in plaats van de standaard betaaltermijn van je organisatie of de gekozen termijn in het boekdialoog. Bij herboeken blijft de oorspronkelijke vervaldatum behouden.

Heeft het product extra factuurregels (bundel onder Extra factuurregels), dan voegt Tillor automatisch kindregels toe onder de hoofdregel. De hoofdregel blijft Bezetting verlengen. NFC-kindregels met verlenging krijgen bij betaling Toegangsmethode verlengen; overige kindregels zijn gewone factuurregels zonder boekingsactie.

Toegangsmethode verlengen

Vink Toegangsmethode verlengen aan op producten waar betaling de geldigheid van toegangsmethoden moet verlengen. Dit werkt op twee manieren:

• Samen met Periode op dezelfde regel (bijv. maandhuur): bij betaling verlengt Tillor de gekozen methoden tot de einddatum van de periode op die regel.
• Via een Staangeld-bundel (hoofdregel Bezetting verlengen met NFC-expand en extendAccessMethod): bij betaling van een NFC-kindregel geldt de einddatum op de Staangeld-hoofdregel; de instellingen hieronder komen van het hoofdproduct (niet van het toeslag-NFC-product).

Na het aanvinken verschijnen extra velden:

• Extra dagen na einddatum - kalenderdagen bovenop de periode- of Staangeld-einddatum (0 = tot en met die einddatum). Bij bundels stel je het aantal dagen in per NFC-stap onder Extra factuurregels; types en statussen komen van dit product.
• Toegangsmethodetypes - kies NFC, QR en/of LPR (meervoudige selectie met vinkjes).
• Statussen - standaard alleen Actief; optioneel ook Zacht geblokkeerd.
• Niet verkorten bij verlengen - staat dit aan, dan worden methoden waarvan Geldig tot al op of na de nieuwe datum ligt overgeslagen bij verlengen. Bij terugdraaien via creditnota wordt de berekende datum altijd gezet.

Dit is los van Toegangsmethoden automatisch verlengen onder Periode (die schakelaar verlengt bij betaling van een puur periode-product zonder aparte actie Toegangsmethode verlengen).

Boeken blokkeren

Gebruik dit actietype op producten die enkel op conceptfacturen horen. Staat zo'n regel op een conceptfactuur, dan kun je die factuur niet definitief maken (boeken). Definitieve facturen zijn niet bewerkbaar; dit actietype hoort daar dus niet op.

Er is geen extra veld op de factuurregel - Tillor blokkeert enkel het boeken zolang de regel aanwezig is.

Extra factuurregels

Sommige producten zijn meer dan één regel op een factuur: Staangeld met toeslagen, toelichtingstekst, meterhuur of NFC-tags. Daarvoor configureer je op het hoofdproduct een bundel van extra regels. Kiest iemand dat product als hoofdregel op een conceptfactuur, dan voegt Tillor automatisch kindregels toe onder die hoofdregel, in de volgorde die je hier instelt.

De bundel staat op de productdetailpagina in de kaart Extra factuurregels, direct onder Algemeen. Rechts blijven Acties op factuurregel (betalingsacties) en Gebeurtenissen staan.

Bundel aanmaken of bewerken

1. Ga naar Administratie > Producten en open het hoofdproduct (bijv. Staangeld)
2. Scroll naar de kaart Extra factuurregels onder Algemeen
3. Nog geen bundel? Klik Bundel configureren
4. Voeg stappen toe met Productstap of Inforestap
5. Pas velden per stap aan (zie hieronder)
6. Gebruik de pijltjes omhoog/omlaag om de volgorde te wijzigen; het prullenbakpictogram verwijdert één stap
7. Klik Opslaan onderaan die kaart

Je kunt de bundel weer uitzetten met Hele bundel verwijderen. Er passen maximaal 40 stappen in één bundel.

Productstap

Een productstap is één configuratieregel die Tillor omzet naar één of meer factuurregels (afhankelijk van het hoeveelheidstype).

Inforestap

Een inforestap is pure tekst zonder product en zonder bedrag. Tillor toont die als toelichtingsregel (standaard stijl INFO).

Dynamische sleutels

De namen in de app komen overeen met de technische sleutels in metadata.invoiceBundle.

Dynamisch (één regel) (resolver):

Dynamisch (één regel per item) (expand):

Placeholders in omschrijvingen

In Omschrijving (optioneel) (en bij legacy Omschrijving inbegrepen NFC) kun je deze placeholders tussen accolades zetten:

NFC-verlenging via de bundel

Voor Staangeld met NFC-tags horen meestal drie dingen samen:

1. Op het hoofdproduct: actie Bezetting verlengen (en een gekozen terrein op de factuurregel)
2. In de bundel: expand-stappen Eerste NFC (inbegrepen) en/of Extra NFC-tags, eventueel met Extra dagen na Staangeld-einddatum (NFC)
3. Op het hoofdproduct: actie Toegangsmethode verlengen met gewenste types (NFC, QR, LPR), statussen en Niet verkorten bij verlengen

Bij betaling van een NFC-kindregel zet Tillor Geldig tot op de einddatum van de Staangeld-hoofdregel plus de ingestelde extra dagen (tot het einde van die lokale dag). Zonder geldige einddatum op de hoofdregel gebeurt er geen automatische verlenging. Het aantal extra dagen komt uit de bundelstap; welke methoden meegenomen worden, uit Toegangsmethode verlengen op het hoofdproduct.

Voorbeeld: typische Staangeld-bundel

1. Inforestap - "Inclusief toeristen-, gemeente- en provincietaksen"
2. Productstap - product NFC-toeslag, Dynamisch (één regel per item) > Eerste NFC (inbegrepen), Vermenigvuldig met hoeveelheid hoofdregel aan, Regelstijl INFO, Eén keer per factuur aan, Extra dagen bijv. 20
3. Productstap - zelfde toeslagproduct, Extra NFC-tags, dezelfde schaal- en verlengingsopties, Eén keer per factuur aan
4. Productstap - product meterhuur, Regel per ICY elektriciteitsmeter, omschrijving met {meterName} en {meterCount}, eventueel ICY elektriciteitsmeters met supply-regels

Op de conceptfactuur verschijnen kindregels pas onder de hoofdregel zodra je bij Bezetting verlengen een terrein hebt gekozen (en voor NFC-verlenging bij betaling een einddatum op die hoofdregel).

Gedrag op conceptfacturen

Wanneer een conceptfactuur wordt opgeslagen, bouwt Tillor bundel-kindregels onder een hoofdregel met een bundel opnieuw op als op die hoofdregel het product, de hoeveelheid of (bij Bezetting verlengen) het terrein is gewijzigd. Anders blijven handmatig aangepaste kindregels grotendeels staan. In de factuureditor gebruikt Tillor een preview zodat je hetzelfde ziet als na opslaan, inclusief Eén keer per factuur waar dat van toepassing is.

Kindregels horen bij de hoofdregel (parentItemListIndex). Je verplaatst een hoofdregel met pijltjes alleen als heel blok; kindregels schuif je alleen binnen die bundel. Verwijder je de hoofdregel, dan verdwijnen de kindregels mee. Op de PDF krijgen gewone kindregels vaak ↳ voor de omschrijving; inforestappen zijn grijze regels zonder bedragen.

Ontbrekende of ongeldige productstappen (geen product gekozen) worden overgeslagen bij het genereren. Onbekende dynamische sleutels leveren geen extra regels op.

Voor integrators: JSON (version 1)

De UI schrijft hetzelfde schema weg als handmatige metadata.invoiceBundle-JSON. Integrators en imports gebruiken dezelfde structuur; zie OpenAPI voor preview-endpoints.

Vorm

• invoiceBundle.version - vast 1
• invoiceBundle.steps - lijst van stappen. Elke stap is óf een productstap óf een inforestap:
  • Productstap - productId (bestaand product in je organisatie), quantity, optioneel quantityScale, optioneel style (DEFAULT of INFO, zie hieronder) en optioneel description (inclusief onderstaande placeholders). Alleen nog bij de samengevoegde legacy-expand CUSTOMER_NFC_ACCESS_SURCHARGE_LINES: optioneel descriptionIncluded voor alleen de eerste NFC-regel; bij CUSTOMER_NFC_ACCESS_INCLUDED_LINE gebruik je description. NFC-extendAccessMethod (zie hieronder): alleen bij een CUSTOMER_NFC_ACCESS_*-expand onder een hoofdproduct Bezetting verlengen: bij betaling van zo'n NFC-kindregel verlengt Tillor periodTo van die NFC-toegangsmethode tot de einddatum die op de hoofdregel Staangeld staat (actionDetails.endDate van Bezetting verlengen op die bundel), plus daysAfterPeriodEnd kalenderdagen (tot het einde van die lokale dag). Die einddatum moet dus op de Staangeld-hoofdregel gekozen zijn vóór betaling. Optioneel billOncePerInvoice: true - zie hieronder.
  • Inforestap - { "stepKind": "info", "description": "<tekst>" } - geen productId en geen bedrag; standaard slaat Tillor de regel op als inforegel. Optioneel style (standaard INFO als je het weglaat). Staat de stap onder een bundelhoofdregel, dan zet de PDF ↳ automatisch vooraan als description nog niet met ↳ begint (je mag ↳ ook gewoon in de JSON zetten). De volgorde van het kindblok volgt de volgorde van steps in je JSON.
• style (optioneel, productstappen en inforestappen) - DEFAULT of INFO. Gebruik bijvoorbeeld "style": "INFO" op een productstap als je die kindregel als grijze toelichting op de PDF wilt (zelfde idee als een inforestap). Tillor zet geen stijl automatisch op basis van een expand-key - je configureert dit zelf in de JSON.
• Voor een productstap is quantity altijd één van:
  • { "kind": "fixed", "value": <positief getal> } - één kindregel met die hoeveelheid en het producttarief
  • { "kind": "resolver", "key": "<string>" } - één kindregel; de hoeveelheid wordt server-side bepaald bij het opslaan van de factuur (zie keys hieronder)
  • { "kind": "expand", "key": "<string>" } - nul of meer kindregels afhankelijk van de klant (zie keys hieronder)
• quantityScale (optioneel, alleen productstappen) - "anchor_line_quantity": Tillor vermenigvuldigt de berekende hoeveelheid van die stap met de hoeveelheid van de hoofdregel (hetzelfde jaardeel als bij Staangeld met Bezetting verlengen, bv. 0,5 bij een half jaar). Afgerond op twee decimalen; regels met hoeveelheid 0 na vermenigvuldiging worden gewoonlijk weggelaten (uitzondering: de inbegrepen NFC-regel met CUSTOMER_NFC_ACCESS_INCLUDED_LINE (hoeveelheid 0), of bij legacy CUSTOMER_NFC_ACCESS_SURCHARGE_LINES de eerste regel daarvan: die blijft bewust staan voor de zichtbare omschrijving). Voor de editor-preview hoort daarbij anchorLineQuantity op POST .../invoices/preview-bundle-lines (OpenAPI). Heeft het hoofdproduct het actietype Bezetting verlengen en bevat de bundel ICY-meterstappen, geef dan ook terrainId mee (het gekozen terrein op die hoofdregel) zodat preview hetzelfde terrein gebruikt als bij opslaan. Bevat de bundel een stap extendAccessMethod, geef bij preview-bundle-lines ook invoiceBillingAnchorEndDateIso mee (de gekozen einddatum op die hoofdregel bij Bezetting verlengen) zodat preview hetzelfde perioderesultaat gebruikt als bij opslaan voor die NFC-actie.
  • billOncePerInvoice (optioneel, alleen productstappen, boolean true) - alleen actief bij opslaan via factuur vervangen (replaceInvoice) én bij factuureditor-preview als preview-bundle-lines wordt aangeroepen met invoiceItemsForBillOnceContext en anchorItemListIndex. Bij twee of meer hoofdregels waarvan invoiceBundle minstens één stap heeft met billOncePerInvoice true, wordt elke billOnce-stap maximaal één keer op die factuur toegepast: Tillor gebruikt het hoofdproduct-id én de volgorde in steps (dus twee NFC-stappen met hetzelfde toeslag-product kunnen elk billOnce hebben). De eerste hoofdregel in items-volgorde wint voor die stap. Met precies één bundelhoofdregel heeft deze instelling geen effect. Integrators zonder preview-context zien mogelijk meer regels per hoofdregel dan na opslaan.
  • icyElectricityMeterBilling (optioneel, alleen productstappen waar quantity ICY_ELECTRICITY_METER_COUNT of ICY_ELECTRICITY_METER_LINES gebruikt) - zie ICY-meterhuur en supply aan/uit.
  • Tip bij twee NFC-expand stappen met hetzelfde productId - zet desgewenst billOncePerInvoice: true op beide stappen (inbegrepen én extra); elk telt als aparte stap door de positie in steps.
• description (alleen productstappen, optioneel) - tekst voor de factuurregel in plaats van de productnaam. Placeholders waar ze van toepassing zijn:
  • {meterName} - naam van de meter op die regel (expand ICY-meterregels)
  • {meterCount} - totaal aantal ICY-elektriciteitsmeters dat voor deze klant meetelt (resolver ICY_ELECTRICITY_METER_COUNT, en hetzelfde totaal op elke ICY-meterregel bij ICY_ELECTRICITY_METER_LINES)
  • {accessMethod} en {accessMethods} - voor NFC-regels vult Tillor dit met het bekende weergavelabel uit de interne kaartlijst (bv. V040005) als die voor de opgeslagen chip-UID bekend is; anders met de ruwe UID (hex). Je zet zelf dubbele punten of spaties in description / descriptionIncluded als je dat zo op de factuur wilt (bv. Toeslag extra toegangsmethode: {accessMethod}).
  • {dogNumber} - volgnummer van de hondregel (1 … n) bij CUSTOMER_DOG_SURCHARGE_LINES
  • {dogCount} - totaal aantal honden uit extraFields.animals.dogs (resolver CUSTOMER_DOG_COUNT, en hetzelfde totaal op elke hondregel bij CUSTOMER_DOG_SURCHARGE_LINES)

Inforestap (voorbeeld)

{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}

Server-side resolvers (bij opslaan)

Wanneer een conceptfactuur wordt opgeslagen via factuur vervangen (replaceInvoice), bouwt Tillor bundel-kindregels onder een hoofdregel met invoiceBundle alleen opnieuw als op die hoofdregel het product, de hoeveelheid of (bij actietype Bezetting verlengen) het gekozen terrein is gewijzigd ten opzichte van de laatst opgeslagen staat. Optioneel billOncePerInvoice op een productstap wordt tijdens die rebuild alleen toegepast als er minstens twee bundel-hoofdregels met zo'n stap op de factuur staan (zie billOncePerInvoice hierboven). Anders blijven de door jou ingevoerde of verwijderde kindregels staan (bijv. een meterregel weglaten blijft weg), behalve dat Tillor onder latere hoofdregels (waar de bundel dus niet opnieuw wordt opgebouwd) kindregels voor een billOncePerInvoice-product weghaalt als dat product al onder een eerdere hoofdregel op dezelfde factuur staat - zo voorkom je dubbel tellen na autosave of preview. Voordat je opslaat gebruikt de factuureditor preview-bundle-lines wanneer je die hoofdregel aanpast op hoeveelheid of terrein (of bij het kiezen van een ander bundel-product), met draftcontext zodat billOncePerInvoice overeenkomt met opslaan. Uitzondering: heeft het hoofdproduct het actietype Bezetting verlengen, dan verschijnen bundel-kindregels pas nadat je een terrein hebt gekozen (idem bij opslaan zonder regeneratie zolang product/hoeveelheid/terrein ongewijzigd zijn).

Ondersteunde resolver-keys (één regel, hoeveelheid = afgeleide waarde):

Ondersteunde expand-keys (per match gewoonlijk hoeveelheid 1, behalve waar anders beschreven):

NFC-toeslag: periodTo na betaling (extendAccessMethod)

Alleen zinvol als het hoofdproduct Bezetting verlengen is en je een expand gebruikt CUSTOMER_NFC_ACCESS_INCLUDED_LINE, CUSTOMER_NFC_ACCESS_EXTRA_SURCHARGE_LINES óf CUSTOMER_NFC_ACCESS_SURCHARGE_LINES. Voeg optioneel toe:

"extendAccessMethod": { "daysAfterPeriodEnd": 20 }

daysAfterPeriodEnd is een niet-negatief geheel getal (maximum volgens het Tillor bundels-schema). Na betaling van zo'n NFC-kindregel zet Tillor periodTo op de einddatum van de gekoppelde Staangeld-hoofdregel (Bezetting verlengen, veld endDate op die hoofdregel), plus daysAfterPeriodEnd kalenderdagen (aan het einde van die lokale dag). Welke types en statussen meegenomen worden, stel je in op het hoofdproduct onder Toegangsmethode verlengen (standaard bij bundels: alleen actieve NFC, tenzij je breder configureert). Zonder geldige endDate op die hoofdregel gebeurt er bij betaling geen automatische verlenging voor die NFC-regel. Met Niet verkorten bij verlengen aan (productinstelling) worden methoden overgeslagen waar periodTo al op of na de nieuwe datum ligt. Op de gebeurtenissen-tijdlijn verschijnt na een geslaagde verlenging een regel die verwijst naar deze betaling.

Zonder gekozen terrein op Bezetting verlengen worden er geen kindregels met deze automatische actie gegenereerd. terrainId op preview-bundle-lines blijft nodig waar meter-stappen het terrein nodig hebben. Optioneel invoiceBillingAnchorEndDateIso helpt de editor bij een consistente preview-context voor de hoofdregel; bij betaling gebruikt Tillor voor de verlenging uitsluitend de endDate op de Staangeld-hoofdregel in de parent-keten (die waarde wordt niet meer op de NFC-kindregel opgeslagen).

Honden: één regel vs. regel per hond

{
  "productId": "prd_hond",
  "quantity": { "kind": "resolver", "key": "CUSTOMER_DOG_COUNT" },
  "description": "Honden ({dogCount})"
}

Onbekende resolver- en expand-keys op een productstap worden genegeerd (geen extra regels). Ontbrekende productId op een productstap wordt overgeslagen. Een inforestap heeft geen productId.

ICY-meterhuur en supply aan/uit

Alleen voor stappen met resolver ICY_ELECTRICITY_METER_COUNT of expand ICY_ELECTRICITY_METER_LINES kun je optioneel icyElectricityMeterBilling op dezelfde productstap zetten.

• icyElectricityMeterBilling weglaten - Bestaand gedrag: elke ICY-elektriciteitsmeter in scope telt mee (supply aan of uit), onafhankelijk van de klant.
• restrictBillingToSupplyOnMeters: false - hetzelfde als weglaten (alle meters in scope tellen mee).
• restrictBillingToSupplyOnMeters: true - standaard tellen alleen meters met supply aan (icyMetadata.switchState === true). Optioneel billSupplyOffMetersForCustomersCreatedOnOrAfter - ISO-8601 datum/tijd (bijv. "2026-01-01T00:00:00.000Z"): klanten wiens createdAt ≥ dit tijdstip worden ook gefactureerd voor meters met supply uit. Laat dat veld weg als niemand voor supply-uit moet betalen.

Voorbeeld (supply-aan voor bestaande klanten, supply-uit ook voor klanten vanaf 2026):

"icyElectricityMeterBilling": {
  "restrictBillingToSupplyOnMeters": true,
  "billSupplyOffMetersForCustomersCreatedOnOrAfter": "2026-01-01T00:00:00.000Z"
}

Childregels worden gekoppeld aan de hoofdregel (parentItemListIndex). Op een conceptfactuur verplaats je een hoofdregel met de pijltjes alleen als heel blok ten opzichte van andere hoofdregels; je kunt hem niet tussen de kindregels van een andere bundel zetten. Kindregels herschik je alleen binnen die bundel (niet boven de hoofdregel). Verwijder je de hoofdregel, dan verdwijnen de gekoppelde kindregels mee.

Voorbeeld JSON (toelichting + NFC-toeslag + meterhuur)

{
  "invoiceBundle": {
    "version": 1,
    "steps": [
      {
        "stepKind": "info",
        "description": "Inclusief toeristen-, gemeente- en provincietaksen"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": { "kind": "expand", "key": "CUSTOMER_NFC_ACCESS_INCLUDED_LINE" },
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "description": "Toegangsmethode inclusief: {accessMethod}",
        "style": "INFO",
        "billOncePerInvoice": true
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": { "kind": "expand", "key": "CUSTOMER_NFC_ACCESS_EXTRA_SURCHARGE_LINES" },
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "description": "Toeslag extra toegangsmethode: {accessMethod}",
        "billOncePerInvoice": true
      },
      {
        "productId": "prd_meterhuur",
        "quantity": { "kind": "expand", "key": "ICY_ELECTRICITY_METER_LINES" },
        "description": "Huur digitale elektriciteitsmeter {meterName} ({meterCount} totaal)",
        "icyElectricityMeterBilling": {
          "restrictBillingToSupplyOnMeters": true,
          "billSupplyOffMetersForCustomersCreatedOnOrAfter": "2026-01-01T00:00:00.000Z"
        }
      }
    ]
  }
}

Klanttype en metertype

Je kunt een product optioneel koppelen aan een Klanttype en een Metertype. Dit maakt het makkelijker om producten te filteren en automatisch toe te wijzen.

De beschikbare klanttypes zijn:

• Standaard - reguliere klanten
• Arbeider Huurcaravan - arbeidersklanten met een huurcaravan
• Arbeider Trekcaravan - arbeidersklanten met een trekcaravan

De beschikbare metertypes zijn:

• Elektriciteit
• Water
• Gas

Automatisch printen

Onder Acties op factuurregel kun je Thermisch printen en A4 printen apart inschakelen. Zodra je minstens één printactie aanvinkt, verschijnt het blok Automatisch printen met het aantal kopieën per printer.

• Thermische printkopieën - exemplaren op de thermische (kassa)printer bij betaling. Stel in op 0 om die printer uit te laten.
• A4-printkopieën - exemplaren op de A4-printer bij betaling. Stel in op 0 om A4 uit te laten.

Het maximum is 10 kopieën per printer per product.

Grootboeknummer

Elk product kan een grootboeknummer krijgen. Dit nummer wordt gebruikt bij het exporteren naar boekhoudsoftware. Als je een product niet aan een specifieke grootboekrekening wilt koppelen, laat je dit veld leeg.

Een wijziging van het grootboeknummer geldt voor nieuwe factuurregels. Bestaande factuurregels behouden het grootboeknummer van toen ze werden toegevoegd.