Skip to content
Markdownllms.txt

Global Tariffs, Ft Rates, Bank Accounts & Holidays ​

Who is this for: Platform Administrator (Platform ADMIN)


1. Tariffs & Billing Precision Rules (Settings > Billing & tariffs) ​

Only Platform administrators can publish or edit system-wide billing reference data (ftrate.write, bank.write, holiday.write).

Tab 1: Tariffs (Tariff structures) ​

  1. Review the Current billing rules strip at the top (billing cut-off day, decimal places for energy/rate/amount, and power factor penalty threshold/rate).
  2. Click Add tariff or Edit on an existing schedule (such as PEA TOU).
  3. Configure Tariff category, Start date / End date, Peak / Off-peak / Holiday rates, Service charge, and Bill calculation type (With Ft or Without Ft).
  4. Expand Advanced billing rules to set contract defaults:
    • Billing cut-off day (1–28) (e.g. 25 covers the 25th to the 24th of the following month)
    • Payment due (0–120 days after cut-off)
    • Decimal places: energy (0–4), rate (2–6), amount (0–4)
    • Power factor penalty (PEA): enable/disable, Minimum PF threshold (0.85), and Penalty rate (56.07 THB/kVAR)
  5. Click Save changes, or click CSV to export the tariff schedule table.

Billing Cut-Off Day Locks After First Invoice (409)

Once a site has any non-rejected invoice, its Billing cut-off day locks (409) so historical billing periods never overlap or leave gaps. Non-cut-off fields still update, and the portal reports which sites kept their original cut-off day.

Tab 2: Monthly Ft Rates (ftrate.write) ​

  1. Switch to Monthly Ft rates (or click Verify Ft rate directly from the /billing warning banner or Dashboard Action Queue).
  2. Click Publish Ft rate (or Edit an unlocked month row).
  3. Enter Billing month in YYYY-MM format (e.g., 2026-10).
  4. Enter the official ERC Ft rate (THB/kWh) between -2.0000 and 10.0000 (e.g., 0.3972).
  5. Click Save Ft rate.

Tariffs and Monthly Ft Rates ScreenFigure 1: Billing & tariffs screen showing Tariffs and Monthly Ft rates management tabs.

Mandatory Ft Enforcement (422) & Month Lock

  • Real invoice previews and generation strictly refuse (422) any billing month without a saved Ft rate. (Only the exploratory Compare PPA rate with utility modal /api/billing/rate-comparison falls back to 0.3972 THB/kWh with a visible yellow fallback warning banner.)
  • Once at least one invoice for YYYY-MM enters CHECKED or APPROVED, that month's Ft rate is locked against modification.

2. Payment Bank Accounts (Settings > Bank accounts) ​

  1. Open Bank accounts under Settings.
  2. Click Add bank account (or Edit an existing account).
  3. Enter Bank name, Branch, and select Seller (company receiving payments):
    • Platform (shared by all sellers): Default bank account printed on invoices when no seller-specific account is configured.
    • Specific Solar developer: Prints that developer's dedicated collection bank account on their invoices and PDF exports.
  4. Fill in Account name, Account number, and PromptPay / QR number, then click Add account / Save changes.

3. Public Holiday Calendar (Settings > Holidays) ​

Generation recorded on weekends and dates listed in this calendar (evaluated on Asia/Bangkok calendar dates) automatically classifies as Rate C (Holiday Off-Peak) for all 24 hours.

  1. Open Holidays under Settings.
  2. Annual preset load: Select 2025, 2026, or 2027 under Load annual public holidays (PEA / MEA calendar) and click Load annual holidays.
  3. Single holiday entry: Select Holiday date (YYYY-MM-DD), enter an optional Holiday name, and click Add holiday.

Bank Accounts, Holidays, Database Health, and Audit LogFigure 2: Shared reference and governance workspace (Bank accounts, Holidays, Database health, and Audit log).


Next Steps ​

WattDee Platform Admin & Central Operations Manual