โปรแกรมตั้งเวลาปิดสิทธิการรักษาอัตโนมัติ (HIS HOSxP × API สปสช.)

 

🚀 แนะนำเครื่องมือ: โปรแกรมตั้งเวลาปิดสิทธิการรักษาอัตโนมัติ (HIS HOSxP × API สปสช.)

สำหรับโรงพยาบาลหรือหน่วยบริการสาธารณสุขที่ใช้งานระบบ HOSxP (หรือ HOSxP XE) การจัดการเรื่องสิทธิการรักษาและส่งข้อมูลเบิกจ่ายกับ สปสช. ถือเป็นงานที่ต้องใช้ความละเอียดและเวลา วันนี้เราจะมาแนะนำ "โปรแกรมตั้งเวลาปิดสิทธิการรักษา" ที่จะช่วยเชื่อมต่อระบบ HIS ของคุณเข้ากับ API ของ สปสช. แบบอัตโนมัติ ช่วยลดภาระงานซ้ำซ้อนและลดข้อผิดพลาดได้อย่างมีประสิทธิภาพ

📌 โปรแกรมนี้ทำงานอย่างไร?

โปรแกรมนี้เปรียบเสมือน "ตัวกลาง" ที่คอยคุยกันระหว่างฐานข้อมูลโรงพยาบาลและเซิร์ฟเวอร์ของ สปสช. โดยมีลำดับการทำงานหลักๆ ดังนี้:

1. ดึงข้อมูล: อ่านรายการ Visit ของผู้ป่วยในวันนี้ จากฐานข้อมูล HOSxP (รองรับทั้ง MySQL และ PostgreSQL)

2. ส่ง API: ส่งข้อมูลไปยัง API ของ สปสช. (nhso-claim-detail) เพื่อทำการ "ปิดสิทธิการรักษา"

3. อัปเดตสถานะ: เมื่อปิดสิทธิสำเร็จ โปรแกรมจะนำรหัส Authen (ที่ขึ้นต้นด้วย EP) กลับไปอัปเดตลงตาราง visit_pttype ใน HOSxP ให้ทันที

ฟีเจอร์เด่นที่น่าสนใจ:

• ป้องกันการปิดสิทธิซ้ำ: มีระบบ SQLite (ep_closed_local.sqlite) ช่วยจำรหัส VN ที่ปิดสิทธิไปแล้วในกรณีที่ฐานข้อมูล HIS มีปัญหาหรือ API ตอบสนองช้า

• Web Dashboard (Flask): มีหน้าเว็บสำหรับดูสถานะการอ่านบัตรและปิดสิทธิแบบ Real-time (ตั้งค่าเปิดให้เครื่องอื่นในวง LAN เข้าดูได้)

• รันอัตโนมัติ (Scheduler): ตั้งเวลาให้โปรแกรมทำงานทุกๆ N นาทีได้ โดยไม่ต้องมีคนคอยกด (แต่ต้องเปิดโปรแกรมทิ้งไว้)

---

💻 เจาะลึกการใช้งานแต่ละส่วน (Tabs)

หน้าต่างโปรแกรมถูกออกแบบมาให้เข้าใจง่าย แบ่งออกเป็นหมวดหมู่ดังนี้:

1. แท็บ "หน้าหลัก" (Main Dashboard)

• ควบคุมการ เริ่ม/หยุด ตัวจับเวลา (Scheduler) สำหรับการค้นหาและปิดสิทธิอัตโนมัติ

• มีปุ่มทดสอบการเชื่อมต่อฐานข้อมูล และสามารถกดค้นหา Visit ของ "วันนี้" (อิงตามเวลาของเซิร์ฟเวอร์ Database) ได้ทันที

2. แท็บ "บัตรประชาชน" (Smart Card)

• รองรับการใช้เครื่องอ่านบัตรสมาร์ตการ์ด เมื่อเสียบบัตร โปรแกรมจะค้นหา Visit วันนี้ของผู้ป่วยที่ยังไม่ได้รหัส EP และทำการยิง API ปิดสิทธิให้ทันที (เหมาะสำหรับจุดซักประวัติหรือห้องจ่ายยา)

3. แท็บ "ตั้งค่า" (Settings)

หัวใจสำคัญของโปรแกรมอยู่ที่หน้านี้ คุณสามารถกำหนดค่าต่างๆ ได้อย่างละเอียด:

• ฐานข้อมูล & API: กรอก Host, User, รหัสหน่วยบริการ (HCode) และ API Token

• ⚠️ โหมด "ปิดสิทธิเฉพาะ API สปสช": * จุดประสงค์: สำหรับ รพ. ที่ไม่อยากให้โปรแกรมนี้ไปเขียนหรือแก้ไขข้อมูลใน HOSxP

  • การทำงาน: โปรแกรมจะยิง API สปสช. อย่างเดียว แต่ ไม่ อัปเดตตาราง visit_pttype

  • ข้อควรระวัง: หากใช้โหมดนี้ร่วมกับการตั้งเวลา (Scheduler) อาจทำให้ยิง API ซ้ำได้ เพราะโปรแกรมไม่มีรหัส EP ใน HIS ไว้เช็กว่าเคยทำไปแล้ว ผู้ใช้ต้องระมัดระวัง

• ระบบเสียงและ TTS (Text-to-Speech): รองรับการแจ้งเตือนด้วยเสียง (Success, Error, Warning) และสามารถใช้ Google TTS เพื่ออ่านออกเสียงภาษาไทยได้ (ต้องต่อเน็ต)

4. แท็บ "ผลลัพธ์" และ "ล็อก" (Logs)

• สรุปผลหลังเรียก API (โชว์เลข EP, จำนวนเงิน, สถานะ)

• หน้า Log จะบันทึกทุกขั้นตอนการทำงาน ใช้เช็กได้เลยว่าติดปัญหาที่ Database, API หรืออินเทอร์เน็ต

---

📂 ไฟล์ระบบที่สำคัญ

หากต้องการปรับแต่งเชิงลึก สามารถเข้าไปจัดการไฟล์เหล่านี้ที่อยู่โฟลเดอร์เดียวกับโปรแกรมได้:

• config.ini: เก็บค่า Setting ทั้งหมด รวมถึง IP/Port ของหน้า Web Dashboard

• pttype_mapping.json: ไฟล์สำหรับจับคู่ (Map) รหัสสิทธิ pttype ใน HOSxP ให้ตรงกับ mainInsclCode ที่ API สปสช. ต้องการ (แก้ไขให้ตรงกับบริบทของ รพ. ได้เลย)

---

🛠 การแก้ไขปัญหาเบื้องต้น (Troubleshooting)

• เชื่อมต่อ Database ไม่ได้: เช็ก Host, Port, Username/Password และดูว่า Firewall บล็อกอยู่หรือไม่

• ยิง API ไม่ผ่าน: ตรวจสอบ API Token, รหัส HCode, และความถูกต้องของข้อมูลผู้ป่วย (PID/CID) ในหน้า Log

• อ่านบัตร ปชช. ไม่ได้: เช็ก Device Manager ว่าเจอเครื่องอ่านไหม ลองถอดเสียบใหม่ หรือปิดโปรแกรมอื่นที่อาจดึงสัญญาณเครื่องอ่านบัตรไปใช้

• ไม่มีเสียงเตือน: ตรวจสอบให้แน่ใจว่าไฟล์เสียง (.wav หรือ .mp3) อยู่ในโฟลเดอร์ sounds ที่อยู่ระดับเดียวกับไฟล์ตัวรันโปรแกรม และกดเปิดใช้งานเสียงในแท็บตั้งค่าแล้ว

     Download โปรแกรม