--- title: Global Tariffs, Ft & Reference Data description: Managing shared PEA TOU tariff structures, billing cut-off locks, publishing monthly Ft rates (ftrate.write), seller bank accounts (bank.write), and public holiday calendars (holiday.write). --- # 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. ::: warning 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 Screen](/screenshots/en/29-settings-tariff-ft-rates.png) *Figure 1: Billing & tariffs screen showing Tariffs and Monthly Ft rates management tabs.* ::: danger 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 Log](/screenshots/en/30-settings-bank-holiday-system-audit.png) *Figure 2: Shared reference and governance workspace (Bank accounts, Holidays, Database health, and Audit log).* --- ## Next Steps - [Chapter 04: VPN Profiles, HES & Meter Identity](./04-vpn-hes-and-meter-identity) - [Chapter 05: Database Health, Audit Log & Support Ops](./05-database-audit-and-platform-ops)