--- title: Customer Portal Guide description: Guide for Off-Taker (Customer Tier) users covering role boundaries, real-time solar dashboard, 15-minute charts, verified invoice review, and countersigning. --- ::: warning UAT release This guide describes the upcoming portal update. Some screens or actions may differ in the current UAT portal. ::: # Customer Portal Guide (Off-Taker Experience) The WattDee Customer Portal provides electricity off-takers (**Customer / Off-Taker Tier**) with a focused workspace to track real-time solar energy generation, verify PPA contract savings against PEA utility rates, inspect issued statements, and countersign approved invoices. --- ## 1. Customer Tier Roles & Access Boundaries Access within the Customer Portal depends on your assigned role inside your organization (see [Roles and Permissions](./01-roles-and-permissions) for the complete capability matrix): | Role | Dashboard & 15-Min Charts | Meter Status | View Issued Invoices (`APPROVED`) | Countersign Invoices | Manage Company Users & Profile | | :--- | :---: | :---: | :---: | :---: | :---: | | **Customer Administrator (`ADMIN`)** | Allowed | Allowed (IPs hidden) | Allowed | Allowed | Allowed (manage staff & company signature) | | **Customer Representative (`CUSTOMER`)** | Allowed | Allowed (IPs hidden) | Allowed | Allowed | Restricted | | **Read Only (`READER`)** | Allowed | Allowed (IPs hidden) | Restricted (`/billing` shows `AccessDenied`) | Restricted | Restricted | ::: info Privacy & Working-Paper Isolation - **Approved Invoices Only**: Customers only see **`APPROVED`** (officially issued) invoices. Internal developer `DRAFT`, `CHECKED`, and `REJECTED` records, along with internal Stage 2 verification reports, are never exposed to the customer tier. - **Hidden Network & HES Internals**: For infrastructure security, customer accounts (including Customer `ADMIN`) never receive meter IP addresses, TCP ports, SIM card IDs, DLMS credential status, or backfill triggers. ::: --- ## 2. Customer Dashboard & Meter Monitoring Signing in as a customer user lands on the **Solar Energy & Savings Overview** (`/`): 1. **Header & Date Picker**: - Displays your company name, active **PPA Discount (%)** tag, and site meter health status (`Normal operation` or `X/Y sites online`). - Use the top-right **DatePicker** to inspect any historical date. - Quick shortcuts open **Company overview** or **View all invoices** (`/billing`, visible to `ADMIN` and `CUSTOMER` only). 2. **Latest Statement Quick-Access Banner**: - Highlights the newest `APPROVED` invoice with its `#invoiceNumber`, net payable (incl. 7% VAT), total energy (kWh), and countersignature badge (`Countersigned` or `Pending customer signature`). - Click **Review & Sign Invoice** to jump directly to `/billing`. 3. **4 Customer-Centric KPI Cards**: - **Month-to-Date Solar Energy (`kWh`)**: Cumulative energy with a stacked On-Peak / Off-Peak / Holiday breakdown bar. - **Month-to-Date PPA Net Cost (`THB`)**: Pre-VAT PPA energy cost compared against the crossed-out PEA standard tariff equivalent. - **Month-to-Date Contract Savings (`THB`)**: Net savings versus PEA TOU plus savings earned on the selected day. - **Today's Solar Generation (`kWh`)**: Selected day energy, PPA cost, and today's Peak Power (`kW`). 4. **Daily 15-Minute Solar Generation Curve**: - Color-coded by TOU band (`On-Peak` Mon–Fri `09:00–22:00`, `Off-Peak`, and `Holiday`). - Telemetry outages appear as true **broken gaps (`null`)**, never fabricated as zero. - Click **In-depth Data Analysis** (`/view-data`) for multi-day or multi-month drilldowns. 5. **PPA Contract & Installed Sites Cards**: - Shows installed capacity (`kWp`), meter serial numbers, connection status badge (`Online`, `Communication lost`, `Waiting first connection`, or `Disabled`), **Effective Discounted PPA Rates** vs. PEA base rates (`On-Peak`, `Off-Peak`, `Holiday`), and monthly totals per site. - Click **View meter status** or **Daily/Monthly charts** for per-site details (see [Meter & Telemetry Guide](./05-meter-and-telemetry-guide)). ![Customer dashboard showing monthly savings KPIs, 15-minute TOU load curve, and site PPA cards](/screenshots/en/31-customer-dashboard-and-meter.png) --- ## 3. Viewing Approved Statements & Downloading Documents (`/billing`) Users with **`ADMIN`** or **`CUSTOMER`** roles can open **Electricity Statements & Billing History** (`/billing`): ### 3.1 Filtering & Summary Cards 1. Filter statements using **Billing Year**, **Site** (if your organization has multiple sites), or **Search** (by invoice number, site name, or billing month). 2. Review the 3 top summary tiles: - **Total Issued Invoices** (`approvedCount`) - **Countersigned** (`signedCount`) - **Pending Customer Signature** (`pendingSignCount`) ### 3.2 Inspecting the Spotlight Statement Card Click any row in the **Statement History** table below to load its full breakdown into the Spotlight Card: - **Left Panel (TOU Energy Summary)**: `On-Peak`, `Off-Peak`, `Holiday / Weekend` kWh, `Peak Demand (kW)`, and `Total Energy (kWh)`. - **Right Panel (Financial Breakdown, THB)**: Base energy charge, `Ft` surcharge (with rate per kWh), PPA contract discount deduction (applied to `energy + Ft` per the [Billing & Approval Guide](./06-billing-and-approval-guide)), `VAT 7%`, and `Total Payable`. - **Footer Strip**: Displays countersignature status and the **`Invoice Reference Code`** (`รหัสอ้างอิงใบแจ้งหนี้`, `SIG_AVG_...`) matching the official PDF audit strip. ### 3.3 Previewing & Exporting Documents From the Spotlight Card footer or table action buttons: 1. **Preview Invoice (PDF)**: Opens the A4 viewer where you can toggle between **System PDF** and **Signed PDF** (once uploaded). 2. **Download Invoice (PDF)**: Official bilingual A4 Tax Invoice (includes Page 2 Annex if meters were swapped mid-cycle). 3. **Download Billing Notice (PDF)**: Official `Billing Notice / ใบวางบิล` summary document. 4. **Calculation Sheet (Excel)**: Multi-sheet `.xlsx` workbook containing the full 15-minute interval dataset for independent accounting verification. 5. **Document (Word)**: `.docx` executive summary report. 6. **View Signed PDF**: Downloads the countersigned PDF attached to the invoice. ![Customer billing portal showing spotlight statement breakdown, Invoice Reference Code, and countersign actions](/screenshots/en/32-customer-billing-and-countersign.png) --- ## 4. Countersigning Approved Invoices For any `APPROVED` invoice marked **Pending customer signature**, users holding `invoice.countersign` (`Customer ADMIN` or `CUSTOMER`) can countersign using **either of two methods**: ### Option A: Upload a Countersigned PDF (`อัปโหลด PDF ที่ลงนามแล้ว`) Best when your organization prints/stamps/signs hard copies or applies an external corporate digital signature: 1. Click **Download Invoice (PDF)** and have your authorized signatory sign/stamp the document. 2. Return to `/billing` and click **Upload Signed PDF** (or **Sign** in the history table). 3. Enter the **Authorized Signatory Name**. 4. Select the signed **`.pdf`** file (maximum **15 MB**; validated by `%PDF` magic bytes). 5. Click **Save & Upload**. The statement immediately updates to **Countersigned**. ### Option B: Attach a Customer Signature Image (`แนบลายเซ็นผู้รับซื้อ`) Best for embedding your authorized signature directly into the WattDee-generated invoice PDF: 1. Click **Attach Customer Signature** on the Spotlight Card. 2. Enter the **Authorized Signatory Name**. 3. Upload a signature image (**transparent PNG recommended**; supports `PNG`, `JPEG`, and `WebP` up to **2 MB**). 4. Review the preview (fetched securely over the private authenticated endpoint `/api/invoices/:id/customer-signature`, never via public URLs). 5. Click **Save Signature**. Your signature and signatory name are embedded directly into the **"For / Customer Signature"** box on the PDF invoice. ::: warning Countersignature Immutability (`409 Conflict`) Once a countersigned PDF or customer signature image is saved to an invoice, **customer and developer users cannot overwrite or replace it** (the API returns `409 Conflict`). If an incorrect file was uploaded by mistake, contact a **Platform Super Administrator** to replace it. ::: --- ## 5. Managing Customer Accounts & Changing Your Password - **Customer Administrator (`ADMIN`)**: Open **Settings** to add, edit, or suspend `CUSTOMER` and `READER` users in your company, maintain your legal Tax ID (13 digits) and VAT address, or upload an organization-wide signature image. - **Any User**: Click your profile card at the bottom-left of the sidebar and select **Change password** (`เปลี่ยนรหัสผ่าน`) to update your own password anytime (automatically signs out all other active devices). Need help with access restrictions, login errors, or billing rules? See the [Troubleshooting, FAQ & AI Integration Guide](./08-troubleshooting-faq).