What is the difference between 'Separate Line' and 'Distributed' surcharge mode?

When you add a surcharge (admin fee or markup) during bill creation, you choose how it appears on the tenant's invoice. There are two modes:

Separate Line (surcharge_mode = "separate_line")

The surcharge is added as its own line item at the bottom of the invoice. The tenant sees each energy cost at its base rate, plus a clearly labeled fee line (e.g., "Admin Fee — 15%"). This is the default and the most transparent option.

Example invoice with 15% surcharge:

• Electricity: 2,500 kWh × 0.85 NOK/kWh = 2,125.00 NOK
• Heating: 1,200 kWh × 0.65 NOK/kWh = 780.00 NOK
• Admin Fee (15%): 435.75 NOK
• Total: 3,340.75 NOK

Distributed (surcharge_mode = "distributed")

The surcharge is blended into each existing line item's amount. No separate fee line appears — instead, each unit price is multiplied by (1 + surchargePercent / 100). The tenant sees a higher per-kWh rate but no visible fee line.

Example invoice with 15% surcharge distributed:

• Electricity: 2,500 kWh × 0.9775 NOK/kWh = 2,443.75 NOK (inkl. admin fee)
• Heating: 1,200 kWh × 0.7475 NOK/kWh = 897.00 NOK (inkl. admin fee)
• Total: 3,340.75 NOK

Both modes produce the same total amount. The difference is presentation only.

Where to configure: Tenant Billing → Create Bill → Step 3 (Settings) → toggle "Add surcharge" → choose "Separate Line" or "Distributed" under "How to apply the fee".