Skip to content
Markdownllms.txt

การอัปเดต UAT

คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน

การแก้ไขปัญหา คำถามที่พบบ่อย และการเชื่อมต่อ AI ​

คู่มือนี้รวบรวมปัญหาที่พบบ่อยในการออกบิล การควบคุมสิทธิ์ การเข้าสู่ระบบ การเชื่อมต่อมิเตอร์ วิธีแก้ไขทีละขั้นตอน รวมถึงวิธีใช้งานคู่มือ WattDee ร่วมกับ AI Assistants และ Agents


1. Error 422: ไม่มีอัตราค่า Ft สำหรับรอบบิลเมื่อกดสร้างใบแจ้งหนี้ ​

อาการที่พบ ​

  • ระบบปฏิเสธการคำนวณหรือสร้างใบแจ้งหนี้ด้วยข้อความ: No Ft (Fuel Adjustment Tariff) rate is on record for YYYY-MM. Refusing to generate: billing would require inventing a rate. (HTTP 422)
  • ด้านบนของหน้า /billing หรือส่วนงานที่ต้องทำบน Dashboard แสดงแถบแจ้งเตือน "ต้องยืนยันอัตรา Ft (Ft verification required)"

สาเหตุ ​

  1. ระบบไม่อนุญาตให้สมมติอัตรา Ft สำหรับการออกใบแจ้งหนี้ทางการเงินจริง หากยังไม่มีบันทึกอัตรา Ft ตามประกาศ กกพ. ประจำเดือน YYYY-MM ในฐานข้อมูล การออกบิลจะถูกระงับทันที
  2. มีเพียง Platform Administrator (สิทธิ์ ftrate.write) เท่านั้นที่กำหนดหรือแก้ไขอัตรา Ft ได้ บัญชีฝั่งผู้พัฒนา (Developer ADMIN / ACCOUNTING) ไม่สามารถตั้งค่า Ft เองได้

วิธีแก้ไขทีละขั้นตอน ​

  1. ให้ Platform Administrator ลงชื่อเข้าใช้และไปที่หน้า /billing แล้วคลิก ยืนยันอัตรา Ft ในแถบเตือนสีเหลือง (หรือไปที่ การตั้งค่า → การคิดบิล/อัตรา)
  2. ตรวจสอบเดือนรอบบิล (YYYY-MM) และกรอก อัตรา Ft (บาท/หน่วย) ตามประกาศ กกพ. (ในช่วง -2.0000 ถึง 10.0000)
  3. กด ยืนยันอัตรา Ft ประจำรอบบิล จากนั้นกลับมาที่ /billing เพื่อสร้างใบแจ้งหนี้ตามปกติ (รายละเอียดเพิ่มเติมดูที่ คู่มือการออกบิล TOU)

เหตุใดหน้า "เทียบค่าไฟ PPA กับ กฟภ." จึงยังคำนวณได้แม้ยังไม่ตั้งค่า Ft?

หน้าต่าง เทียบค่าไฟ PPA กับ กฟภ. (/api/billing/rate-comparison) เป็นเพียงการประมาณการเปรียบเทียบเบื้องต้น หากเดือนนั้นยังไม่มีอัตรา Ft ระบบจะใช้ค่าเริ่มต้น 0.3972 บาท/หน่วย ชั่วคราวพร้อมแสดง แถบแจ้งเตือนสีเหลือง ด้านบนเพื่อเตือนให้ผู้ใช้งานทราบว่าตัวเลขดังกล่าวยังไม่ใช่ค่า Ft ที่ยืนยันแล้ว

แถบแจ้งเตือนค่าเริ่มต้น Ft 0.3972 บาท/หน่วย ในหน้าต่างเปรียบเทียบค่าไฟฟ้า


2. Error 422: รอบบิลยังไม่สิ้นสุด (Open Billing Period กับสิทธิ์ invoice.issueEarly) ​

อาการที่พบ ​

  • เมื่อกด สร้างบิล ก่อนวันสิ้นสุดรอบบิล (โดยเฉพาะผู้ใช้บทบาท ACCOUNTING) ระบบแจ้งเตือน: Billing period YYYY-MM has not ended (X/Y days elapsed)... (HTTP 422) หรือ "รอบบิล ... ยังไม่สิ้นสุด - ออกใบแจ้งหนี้ได้หลังสิ้นรอบ หรือให้ผู้ดูแลระบบของบริษัทออกก่อนสิ้นรอบ"

สาเหตุ ​

  • ตามกติกาธุรกิจ (BL-1) ใบแจ้งหนี้รายเดือนต้องคำนวณหลังจากรอบบิลปิดสมบูรณ์แล้ว (ตาม billingCycleDay ในเวลา Asia/Bangkok UTC+7) เพื่อป้องกันการออกบิลที่ขาดข้อมูลช่วงปลายเดือน
  • เฉพาะผู้ที่มีสิทธิ์ invoice.issueEarly (Developer ADMIN และ Platform ADMIN) เท่านั้นที่ยืนยันการออกบิลก่อนสิ้นรอบได้ ส่วน Developer ACCOUNTING ต้องรอให้พ้นวันตัดรอบก่อน (และไม่อนุญาตให้ออกบิลสำหรับเดือนในอนาคตที่ยังไม่เริ่มโดยเด็ดขาด)

วิธีแก้ไขทีละขั้นตอน ​

  1. หากเป็นรอบบิลปัจจุบันที่ยังไม่ครบกำหนดตัดรอบ ให้รอจนพ้นเวลา 00:00 น. ของวันตัดรอบถัดไปแล้วจึงกด สร้างบิล
  2. หากจำเป็นต้องออกบิลปิดยอดกลางเดือน (เช่น ปิดสัญญาหรือทดสอบระบบ) ให้ Developer ADMIN หรือ Platform ADMIN กด สร้างบิล และยืนยันในหน้าต่าง "รอบบิลยังไม่สิ้นสุด" โดยกด ออกก่อนสิ้นรอบ

3. เหตุใดผู้ตรวจบิล (CHECKED) และผู้อนุมัติ (APPROVED) ต้องเป็นคนละคนกัน ​

อาการที่พบ ​

  • บนการ์ด Kanban หรือตารางรวม ปุ่มอนุมัติเปลี่ยนเป็นป้าย ติดเงื่อนไข SoD (ไอคอนโล่ล็อก) หรือพบข้อความแจ้งเตือน: Segregation of duties violation: The accounting approver cannot be the same user who performed the technical service check.

สาเหตุ ​

ระบบบังคับใช้หลักการควบคุมภายในแบบ Dual Control / Segregation of Duties (checker ≠ approver):

  1. บัญชีผู้ใช้ที่กดตรวจรับรองทางเทคนิค Stage 2 (checkedByServiceUserId) ไม่สามารถ กดอนุมัติขั้นสุดท้าย Stage 3 (APPROVED) บนใบแจ้งหนี้ฉบับเดียวกันได้ แม้ว่าผู้ใช้นั้นจะเป็น ADMIN ที่มีสิทธิ์ทั้งสองขั้นก็ตาม
  2. ใบแจ้งหนี้ไม่สามารถข้ามจาก DRAFT เป็น APPROVED โดยไม่ผ่าน CHECKED ได้

วิธีแก้ไขทีละขั้นตอน ​

  1. ให้วิศวกรปฏิบัติการ (SERVICE) หรือผู้ดูแลระบบคนที่ 1 ตรวจรับรองขั้นที่ 2 (DRAFT → CHECKED)
  2. ให้เจ้าหน้าที่ฝ่ายบัญชี (ACCOUNTING) หรือผู้ดูแลระบบ อีกคนหนึ่ง ลงชื่อเข้าใช้ด้วยบัญชีของตนเองเพื่อกด ลงนามอนุมัติ (CHECKED → APPROVED)

4. รอบบิลถูกล็อกและมีข้อมูลพลังงานเข้ามาหลังปิดรอบ (Locked Period และ late_intervals) ​

อาการที่พบ ​

  • ในส่วน ต้องดำเนินการ (Action Queue) บนหน้า Dashboard แสดงรายการ: พลังงานเข้ามาหลังปิดรอบบิล X ไซต์ (Y kWh ยังไม่อยู่ในใบแจ้งหนี้)
  • หรือไม่สามารถสับเปลี่ยนมิเตอร์/รันประมวลผลข้อมูลย้อนหลังทับเดือนที่ออกบิลไปแล้วได้

สาเหตุ ​

  1. ทันทีที่ใบแจ้งหนี้เข้าสู่สถานะ CHECKED หรือ APPROVED ช่วงเวลาของใบแจ้งหนี้นั้น ([billingPeriodStart, billingPeriodEnd)) จะ ถูกล็อก (Period Lock) เพื่อรับประกันว่าข้อมูลโหลดโปรไฟล์ 15 นาที (load_profile_15min) ในฐานข้อมูลจะตรงกับตัวเลขที่พิมพ์บนใบแจ้งหนี้เสมอ
  2. หากมิเตอร์เพิ่งส่งข้อมูลย้อนหลังเข้ามาหลังสัญญาณขาดหาย (Backfill) หรือมีการแก้ไขค่าอ่านในช่วงเวลาที่ล็อกไว้ ระบบประมวลผลจะ ไม่เขียนทับ load_profile_15min แต่จะแยกข้อมูลใหม่/ที่เปลี่ยนแปลงไปเก็บในตาราง late_intervals และรายงานผลรวมแยกตามช่วง TOU และ Peak Demand ให้เห็นทันที

วิธีแก้ไขทีละขั้นตอน ​

  1. ตรวจสอบปริมาณหน่วยไฟที่เข้ามาทีหลังบน Dashboard (Action Queue) หรือเรียกดูรายละเอียดผ่าน API GET /api/billing/late-intervals
  2. ตัดสินใจตามสถานะของใบแจ้งหนี้:
    • กรณีบิลยังอยู่ในสถานะ CHECKED (ยังไม่ได้อนุมัติส่งลูกค้า): ให้สั่งคำนวณบิลใหม่ (หรือเปลี่ยนสถานะกลับเป็น DRAFT) ระบบจะนำข้อมูลจาก late_intervals มาเขียนลง load_profile_15min ให้อัตโนมัติใน Transaction เดียวกัน จากนั้นให้ตรวจรับรอง Stage 2 และอนุมัติ Stage 3 ใหม่อีกครั้ง
    • กรณีบิลอยู่ในสถานะ APPROVED แล้ว: หากยอดพลังงานที่ตกหล่นมีนัยสำคัญและต้องออกบิลใหม่ ให้กด ยกเลิกบิล (Void) พร้อมระบุเหตุผล (ระบบจะนำ late_intervals กลับมาอัปเดตให้ทันที) แล้วกด ออกบิลใหม่ (Reissue) เพื่อสร้างใบแจ้งหนี้ฉบับใหม่ที่รวมหน่วยครบถ้วน

5. เหตุใด READER และ OPERATOR เข้า /billing ไม่ได้ และทำไม READER ไม่เห็น IP มิเตอร์ ​

สาเหตุที่เข้าหน้า /billing ไม่ได้ (AccessDenied) ​

สิทธิ์ใน WattDee ถูกกำหนดจาก ประเภทองค์กร × บทบาท (Tier × Role) ไม่ได้ดูจากชื่อบทบาทเพียงอย่างเดียว (ดูตารางเต็มที่ บทบาทและสิทธิ์การใช้งาน):

  • การเปิดหน้า /billing ต้องมีสิทธิ์ invoice.view
  • Customer READER (ดูอย่างเดียว): มีไว้ดูกราฟการผลิตและสถานะมิเตอร์เท่านั้น ไม่มีสิทธิ์ด้านเอกสารการเงินหรือการตั้งค่าใดๆ
  • Developer OPERATOR (ผู้ควบคุมระบบ): มีไว้เฝ้าระวังมิเตอร์ ทดสอบการเชื่อมต่อ และจัดการการแจ้งเตือน ไม่เกี่ยวข้องกับการออกบิล
  • หากบัญชีทั้งสองพยายามเข้า /billing โดยตรง หน้าเว็บจะแสดงหน้า ไม่มีสิทธิ์เข้าถึงข้อมูลการเรียกเก็บเงิน (Billing) (AccessDenied)

สาเหตุที่ READER (และผู้ใช้ฝั่งลูกค้า) ไม่เห็น IP Address ของมิเตอร์ ​

  • การดู IP Address, พอร์ต, หมายเลข SIM และรายละเอียดเครือข่ายเกตเวย์ของมิเตอร์ต้องมีสิทธิ์ meter.network.read
  • บทบาทฝั่งลูกค้าทั้งหมด (Customer ADMIN, CUSTOMER, READER) รวมถึง Developer ACCOUNTING ไม่ได้รับสิทธิ์ meter.network.read เพื่อป้องกันการเปิดเผยโครงสร้าง VPN/SIM ภายใน
  • ทั้ง Backend API (stripMeterNetworkFields) และหน้า UI จะตัดข้อมูล ipAddress, port, simCardId และ lastError ของเกตเวย์ออกโดยอัตโนมัติ

วิธีแก้ไข ​

หากผู้ใช้งานจำเป็นต้องตรวจดูใบแจ้งหนี้หรือข้อมูลเครือข่าย ให้ติดต่อ ผู้ดูแลองค์กร (Organization Admin) เพื่อปรับบทบาทให้เหมาะสม (เช่น เปลี่ยนจาก READER เป็น CUSTOMER เพื่อดูและลงนามใบแจ้งหนี้ หรือเปลี่ยนเป็น SERVICE/OPERATOR สำหรับทีมเทคนิคฝั่งผู้พัฒนา)


6. ติดจำกัดความถี่การเข้าสู่ระบบ (429) และวิธีรีเซ็ตรหัสผ่านเมื่อลืมรหัสผ่าน ​

หน้าเข้าสู่ระบบ WattDee พร้อมการแจ้งเตือนเมื่อรหัสผ่านผิดหรือเข้าสู่ระบบถี่เกินกำหนด

กรณีขึ้นข้อความ "มีการเข้าสู่ระบบหลายครั้งเกินไป" (429 Too Many Requests) ​

  • สาเหตุ: ในโหมดใช้งานจริง (Production) ระบบยืนยันตัวตน (BetterAuth) จำกัดความถี่ในการพยายามลงชื่อเข้าใช้ไม่เกิน ประมาณ 3 ครั้งภายใน 10 วินาทีต่อ IP Address เพื่อป้องกันการเดารหัสผ่าน
  • วิธีแก้ไข:
    1. หยุดกดปุ่มเข้าสู่ระบบและรออย่างน้อย 10–15 วินาที ก่อนลองใหม่อีกครั้ง
    2. ตรวจสอบภาษาของแป้นพิมพ์ ปุ่ม Caps Lock และตัวสะกดของอีเมลให้ถูกต้อง

กรณีลืมรหัสผ่านเข้าสู่ระบบ (ไม่มีลิงก์ "ลืมรหัสผ่าน" หรือ "สมัครสมาชิก") ​

  • สาเหตุ: WattDee ปิดการสมัครสมาชิกสาธารณะและปิดการรีเซ็ตรหัสผ่านเองโดยไม่มีการยืนยันตัวตน เพื่อความปลอดภัยของข้อมูลหลายองค์กร (Multi-Tenant Security) มีเพียงผู้ดูแลระบบขององค์กรเท่านั้นที่รีเซ็ตให้ได้
  • วิธีรีเซ็ตรหัสผ่านโดยผู้ดูแล (Admin Reset Password):
    1. ติดต่อ ผู้ดูแลบริษัท (Company ADMIN / Developer ADMIN) หรือ Platform Administrator
    2. ให้ผู้ดูแลเข้าไปที่ การตั้งค่า → บริษัท → ผู้ใช้และสิทธิ์ (People & access) แล้วกดไอคอน แก้ไข (Edit) ที่ชื่อของคุณ
    3. ในหัวข้อ ตั้งรหัสผ่านใหม่ (Reset password) ผู้ดูแลสามารถพิมพ์รหัสผ่านใหม่ที่ตรงตามเกณฑ์ความปลอดภัย (ยาวอย่างน้อย 8 ตัวอักษร มี A-Z, a-z, 0-9 และอักขระพิเศษ !@#$%&*) หรือ เว้นว่างไว้เพื่อสุ่มรหัสผ่านชั่วคราว (แสดงครั้งเดียว) แล้วกด ตั้งรหัสผ่านใหม่
    4. ระบบจะออกจากระบบบนอุปกรณ์เดิมทั้งหมดโดยอัตโนมัติ เมื่อได้รหัสผ่านใหม่และลงชื่อเข้าใช้แล้ว แนะนำให้เปลี่ยนเป็นรหัสผ่านส่วนตัวทันทีที่ เมนูบัญชีมุมซ้ายล่าง → เปลี่ยนรหัสผ่าน

7. มิเตอร์แสดงสถานะ ขาดการติดต่อ (Offline): วิธีตรวจ VPN และ ทดสอบการเชื่อมต่อ ​

มิเตอร์จะถูกจัดอยู่ในสถานะ ขาดการติดต่อ (Offline) เมื่อไม่ได้ส่งข้อมูลเข้ามามากกว่า 1 ชั่วโมง (60 นาที) หรือเมื่อ HES แจ้งสถานะขัดข้อง (commLostAt / verification_failed / inactive) ให้ตรวจสอบตามลำดับต่อไปนี้ (ต้องมีสิทธิ์ meter.command, meter.network.read หรือ vpn.manage; ดูเพิ่มเติมที่ คู่มือการติดตามมิเตอร์และข้อมูลโทรมาตร):

  1. ตรวจสถานะการเปิดใช้งานใน HES:
    • เปิดหน้า การตั้งค่า → ไซต์ → มิเตอร์ แล้วดูแท็กสถานะ หากขึ้นว่า ปิดใน HES - ไม่ถูกอ่านค่า หรือ HES รอตรวจสอบ ให้ตรวจสอบว่าตั้งค่าเรียบร้อยแล้วกดปุ่ม เปิดใช้งานใน HES (Activate in HES)
  2. ตรวจสอบการเชื่อมต่อ VPN (กรณีเชื่อมต่อแบบ VPN (Mikrotik)):
    • ให้ Platform ADMIN เข้าที่ การตั้งค่า → บริษัทผู้พัฒนา → โปรไฟล์ VPN (VPN profiles) และกด อัปเดตสถานะ (Refresh status)
    • ตรวจสอบว่าสถานะท่อ VPN เป็น เชื่อมต่อ VPN แล้ว (tunnel_up) (หากขึ้น controller_offline, runner_error, pending หรือ disabled ต้องตรวจสอบอุปกรณ์ Mikrotik / อินเทอร์เน็ตหน้างาน)
    • ตรวจสอบว่าได้ผูกมิเตอร์เข้ากับโปรไฟล์ VPN ที่ถูกต้อง และ IP ของมิเตอร์อยู่ในช่วง allowed_ips
  3. กดปุ่ม ทดสอบการเชื่อมต่อ (Test connection):
    • เปิดแผงรายละเอียดมิเตอร์ในหน้า /meter (แท็บการตรวจสอบ) หรือในหน้าตั้งค่ามิเตอร์ แล้วกด ทดสอบการเชื่อมต่อ จากนั้นอ่านคำอธิบายผลจาก HES:
      • config_error / ยังไม่มีรหัสผ่าน LLS: ต้องตั้งค่า LLS Password บนเครื่อง HES และรีสตาร์ทบริการ HES
      • auth_failed: มิเตอร์ปฏิเสธรหัสผ่าน LLS ให้ตรวจว่ารหัสผ่านบน HES ตรงกับที่ตั้งบนตัวมิเตอร์
      • operation was canceled (หมดเวลา session): เชื่อมต่อ TCP ได้แต่มิเตอร์ไม่ตอบ มักเกิดจากเลือก Interface ผิดระหว่าง HDLC (ผ่านโมเด็ม 4G/ตัวแปลงสัญญาณ) กับ WRAPPER (เสียบสาย LAN ตรงที่ตัวมิเตอร์)
      • connect_failed / poll_timeout: ติดต่อ IP/พอร์ต (ค่าเริ่มต้น 4059) ไม่ได้ ให้เช็กไฟเลี้ยงมิเตอร์ สัญญาณซิม 4G/APN ท่อ VPN และการ Forward พอร์ต
      • protocol_error: ตรวจสอบรุ่นมิเตอร์ (Saral 305, Premier 550, Prometer 100) และ Interface ให้ตรงกับอุปกรณ์จริง
  4. กู้คืนข้อมูลช่วงที่ขาดหาย:
    • เมื่อ ทดสอบการเชื่อมต่อ ผ่านแล้ว ให้กด อ่านค่าทันที (Read now) หรือสั่ง Backfill (ดึงย้อนหลังได้สูงสุด 31 วันต่อคำสั่ง) เพื่อให้ HES ดึงโหลดโปรไฟล์ที่เก็บอยู่ในหน่วยความจำมิเตอร์กลับมาคำนวณ

8. การใช้งานคู่มือ WattDee ร่วมกับ AI Assistants และ Agents ​

คู่มือผู้ใช้งาน WattDee เผยแพร่อยู่ที่ https://docs.wattdee.com พร้อมช่องทางมาตรฐานสำหรับ AI Assistants, LLM และ Coding Agents ดังนี้:

ช่องทางที่อยู่ / คำสั่งเหมาะสำหรับ
ดัชนีเอกสารสำหรับ AI (/llms.txt)https://docs.wattdee.com/llms.txtให้ AI Agent อ่านสารบัญ URL และสรุปเนื้อหาของคู่มือทุกหน้า (ทั้งไทยและอังกฤษ) เพื่อค้นหาหน้าที่เกี่ยวข้องได้อย่างรวดเร็ว
คู่มือฉบับเต็มในไฟล์เดียว (/llms-full.txt)https://docs.wattdee.com/llms-full.txtดาวน์โหลดหรือส่งให้ AI อ่านเนื้อหา Markdown ทั้งหมดของคู่มือทั้ง 2 ภาษาในครั้งเดียว (หรือเลือกเฉพาะภาษาได้ที่ /th/llms-full.txt และ /en/llms-full.txt)
MCP Server สำหรับเครื่องมือ AIbun run docs:mcpเชื่อมต่อ Model Context Protocol (MCP) เข้ากับ Claude Desktop, Cursor หรือ Antigravity พร้อมเครื่องมือ search_wattdee_manual, get_wattdee_guide และ get_role_capabilities

ตัวอย่างการตั้งค่า bun run docs:mcp ใน MCP Client ​

ในโฟลเดอร์หลักของโปรเจกต์ AMR สามารถเรียกใช้งานเซิร์ฟเวอร์ MCP ของเอกสารคู่มือผ่านคำสั่ง:

bash
bun run docs:mcp

หรือเพิ่มรายการในไฟล์ตั้งค่า MCP Client ของคุณ (ปรับพาธให้ตรงกับเครื่องที่รัน):

json
{
  "mcpServers": {
    "wattdee-docs": {
      "command": "bun",
      "args": ["run", "docs:mcp"],
      "cwd": "/path/to/AMR"
    }
  }
}

ตัวอย่างคำถามที่ถาม AI Assistant ได้ทันทีหลังเชื่อมต่อ

  • "ตรวจสอบสูตรคำนวณส่วนลด PPA และภาษีมูลค่าเพิ่ม 7% ในคู่มือ WattDee ให้หน่อย"
  • "ลูกค้าขึ้นหน้า AccessDenied ตอนเข้า /billing ต้องปรับสิทธิ์อย่างไรตามคู่มือ?"
  • "สรุปขั้นตอนแก้ปัญหาเมื่อเจอ Error 422 ไม่มีอัตรา Ft หรือรอบบิลยังไม่สิ้นสุด"

คู่มือการใช้งานระบบ WattDee AMR & Private PPA Billing