Terrains
Create the terrains of your park, set their tariff and attach meters, so that you can put customers on them.
Last updated on
A terrain is a place in your park: a plot, chalet, motorhome pitch or permanent pitch. Here you create your terrains, give them a type and a tariff and attach meters to them. Then you put customers on them with an occupation or a reservation. You find them under ParkTerrains.
How does this fit together?
Everything that belongs to that place is attached to a terrain. The tariff follows from the surface area and the custom fields of the terrain. The meters on the terrain provide the consumption, and that consumption goes to the customer with an active occupation. See also Meter management.
Good to know
- The name is required and may have at most 255 characters.
- Bookable is off by default for a new terrain.
- Tillor calculates the surface area as soon as you draw the terrain on the map. You do not type it in yourself.
- Recent Terrains counts the terrains from the past 7 days.
- A terrain has at most one active occupation at a time.
- The calculated tariff is recalculated as soon as you save a terrain, and for all terrains as soon as you save the tariff formula.
- If you delete a terrain type, the terrains remain, but they then have no type any more.
Creating a new terrain
Before you start: if you need terrain types (such as Pitch or Chalet) or custom fields, create those first. See Terrain types and Custom fields.
Fill in the details
Only the Name is required. You can also fill in:
- Description, an explanation.
- Terrain type, or leave No type.
- Custom fields that your organisation has added itself, such as a surcharge or a gas meter number.
- Bookable, if customers may reserve the terrain online.
- Location, to point out the terrain on the map straight away.
Click Create terrain
The terrain is in the list. If you did not draw the location, you do that later on the map, see Map.
What happens next?
- The terrain appears in the list and in the statistics at the top: Total Terrains, Recent Terrains, Bookable Terrains, Non-Bookable Terrains and Total Surface Area (only of terrains with a drawn location).
- Tillor calculates the Calculated tariff from your organisation's tariff formula.
- On the detail page you can link meters, add comments and see the history.
Viewing and editing a terrain
Click a terrain in the list. At the top are the name, description, surface area, the number of meters, whether it is bookable, the Customer with an active occupation and the creation and modification date. In the Update terrain form you change:
- Name, Terrain type, Description, Bookable and the Custom fields.
- Surface area and Calculated tariff are read-only.
Save with Update terrain. Next to the form are Location, Meters and Occupation history. Below that are Comments (only visible to your colleagues), Events with a before/after overview per changed field, and Reservations.
Attaching meters to a terrain
In the Meters card you choose Add meter and then Assign meter. Only meters without a terrain are in the list. For each meter you see the type, a status indicator and the latest reading. With the menu (...) you choose Unlink from terrain; that choice is only here. The whole route to the customer is described under Linking a meter to a customer.
Terrain types
With terrain types you classify terrains, for example Pitch, Chalet or Motorhome pitch. You see the type in the terrain list (column Type, with a filter), you can colour the map by it and it is in the export. You manage them under SupportSettingsTerrain types.
The All terrain types table shows for each type the Name, Map color, Description and the number of Terrains. Search with Search terrain types.... With the pencil you edit a type, with the bin you delete it.
Fill in the details
Give a Name, optionally a Description, and choose a Map color. Blue is preselected.
You link a type to a terrain via the Terrain type field. You see the map colour on the map when you set the colours to Terrain type under Layers, see Map.
Exporting terrains
Click Export all terrains (top right) to download an Excel file. For each terrain it contains the basic details, the terrain type, the custom fields and the tariff calculation (subtotal, surcharges and total). Use it, for example, for the annual tariff check.
How the tariff is determined
The Calculated tariff follows from your organisation's tariff formula. The formula works with the surface area and with the custom fields of the terrain. Which custom fields those are, you decide yourself. The default formula uses the fields with the keys locationSurcharge, gasMeterNumber, electricityMeterSurcharge and staticPrice. If you have created those under SupportSettingsCustom fields, they work like this:
- Surface area: the drawn surface area, in bands per m².
- Gas meter surcharge: is added if the field with the gas meter number is filled in.
- Location surcharge: the amount you enter.
- Electricity surcharge: the amount you enter.
- Static price: if this field is filled in, that amount replaces the calculated tariff and Tillor skips the formula.
If you want to change a year's tariff, adjust the custom fields, check under Calculated tariff whether it is right and save with Update terrain.
Tariff formula
Under SettingsTerrain tariff you decide yourself how the tariff is calculated. Whoever was already allowed to edit the settings has been given the Edit terrain tariff formula permission. The formula is a piece of TypeScript (a programming language) that returns the annual tariff in euros, or named parts that together make up the tariff, such as Subtotaal and Toeslag gasmeter. Each part gets its own column in the export.
- You read fields of the terrain with
{terrain.veld}, such as{terrain.surfaceArea}or{terrain.customFields.locationSurcharge}. Via the Variable button or by typing{you choose from all fields, including your own. - To the right of the formula you try them out straight away on one of your terrains. An error is shown there with the line number. A formula that does not work cannot be saved.
- With Reset to default you go back to the formula every organisation started with.
- In automations you read the tariff as
{terrain.calculatedTariff.total}.
Note
The formula runs in isolation: it can only calculate with the fields of the terrain, without other data or internet. A formula that takes too long to calculate is aborted and then produces no tariff.
Problems?
Concepts
- Terrain: a place in your park. See Concepts.
- Terrain type: a classification such as Pitch or Chalet, with a map colour.
- Bookable: customers may reserve the terrain online.
- Calculated tariff: the tariff that Tillor calculates from the formula.
- Custom field: a field that your organisation adds itself. See Concepts.
- Occupation: a customer on a terrain for a period. See Concepts.