เกี่ยวกับระบบ AMED API

   กลุ่มนวัตกรรมแพลตฟอร์มดิจิทัลสุขภาพการแพทย์ (DHCB) สำนักงานพัฒนาวิทยาศาสตร์และเทคโนโลยีแห่งชาติ (สวทช.) ได้ร่วมกับ สำนักงานหลักประกันสุขภาพแห่งชาติ (สปสช.) ในการพัฒนาการเบิกจ่าย e-Claim ผ่านระบบ AMED CARE อย่างมีประสิทธิภาพและเป็นที่ยอมรับในระดับประเทศ สร้างความเชื่อมั่นทั้งภาครัฐและเอกชนในการเบิกจ่ายดังกล่าวโดยตลอดมาผ่านการใช้งานระบบ API ของ สำนักงานหลักประกันสุขภาพแห่งชาติและการบริหารจัดการ Platform ของ AMED CARE และเพื่อเป็นการเสริมสร้างประสิทธิภาพและช่องทางในการใช้งานระบบ AMED CARE จึงได้เกิดการพัฒนาระบบเพิ่มเติมให้สามารถเชื่อมโยงการใช้งานผ่าน API จากฝั่งผู้ประกอบการ / ผู้พัฒนา โดยเรียกว่า 3rd Party ที่จะเข้ามาใช้งานระบบได้อย่างมีประสิทธิภาพ โดยจำเป็นต้องศึกษาและทำความเข้าใจระบบ AMED API ที่พัฒนาขึ้นผ่านเว็บไซต์ของ AMED API และข้อมูลอื่น ๆ ที่เกี่ยวข้องผ่านระบบ AMED API ที่ระบุไว้เท่านั้น

เข้าร่วมกับ AMED API ดีอย่างไร

  • ระบบ AMED API สามารถส่งผ่านข้อมูลการเบิกจ่ายจากโปรแกรมต้นทางของผู้พัฒนาเข้าสู่การเบิกจ่าย e-claim ของ สปสช. ได้ทันทีแบบไร้รอยต่อ
  • AMED มีความเชี่ยวชาญและองค์ความรู้ในการตรวจสอบชุดข้อมูลที่ส่งเบิกจ่าย และมีการแจ้งเพื่อให้ปรับปรุงข้อมูลให้สมบูรณ์หากข้อมูลไม่ผ่านการตรวจสอบก่อนส่งผ่านไปยัง สปสช. ส่งผลให้อัตราการเบิกจ่ายมีความสำเร็จสูงและลดอัตราการปฏิเสธหรือการเบิกจ่ายที่ใช้เวลาดำเนินที่ล่าช้า
  • มาตรฐานโครงสร้างชุดข้อมูลที่เกิดขึ้น อ้างอิงกับ สปสช. ทำให้การเปลี่ยนแปลงข้อมูลและกระบวนการที่เกี่ยวข้องสามารถปรับปรุงเปลี่ยนแปลงได้อย่างทันท่วงทีจากส่วนของ AMED API พร้อมการแจ้งกระบวนการต่าง ๆ ผ่านเว็บไซต์หรือช่องทางที่เกี่ยวข้องของโครงการ
  • มีส่วนของการชี้แจงการใช้งาน API และส่วนสนับสนุนต่าง ๆ ผ่านเว็บไซต์ของ AMED API พร้อมแนวทางการอบรมหรือส่วนที่เกี่ยวข้อง พร้อมระบบสนับสนุนผ่าน Chat Message ของระบบ

เข้าร่วมกับ AMED API เสียค่าใช้จ่ายหรือไม่

   ปัจจุบัน AMED API ยังไม่มีแผนในการจัดเก็บค่าใช้จ่าย เนื่องจากยังอยู่ในช่วงทดสอบและเปิดรับผู้สนใจในการทดสอบใช้งาน API โดยมี API ให้เรียกใช้ในรูปแบบจำกัดจำนวนครั้ง ซึ่งมีค่าเริ่มต้นให้ใช้งานเป็นเป็นจำนวน 500 ครั้ง และสามารถติดต่อประสานกับทีม AMED เพื่อขอเพิ่มได้หากหมดจำนวนที่กำหนด โดยกระบวนการและข้อมูลต่าง ๆ อาจมีการเปลี่ยนแปลงได้ในอนาคต

เข้าร่วมกับ AMED API มีหลักการอย่างไร

หากคุณมีความสนใจในการเข้าร่วมใช้งานระบบกับ AMED API คุณสามารถตรวจสอบเงื่อนไขเบื้องต้นและความพร้อมในการเข้าร่วมโครงการได้ ดังนี้

  • เป็นผู้สนใจในมุมนักพัฒนาโปรแกรม , บริษัท , ผู้ประกอบการ หรือส่วนเกี่ยวข้องกับกระบวนการเบิกจ่ายกับสำนักงานหลักประกันสุขภาพแห่งชาติ (สปสช.) ซึ่งมีความสามารถในการใช้งานระบบหรือการพัฒนาระบบที่เกี่ยวข้องได้อย่างดี
  • เป็นผู้ที่มีโปรแกรมใช้งานเกี่ยวกับการเบิกจ่ายตามสิทธิ์หลักประกันสุขภาพแห่งชาติแล้วต้องมีการนำข้อมูลการเบิกจ่ายดังกล่าวไปบันทึกข้อมูลซ้ำซ้อนกับโปรแกรมเบิกจ่ายอื่น ๆ ที่ทำให้เกิดความล่าช้าและทำงานซ้ำซ้อน ซึ่งสามารถใช้ AMED API เชื่อมโยงส่งข้อมูลได้ทันที
  • เข้าใจพันธกิจและการดำเนินงานของ AMED CARE ที่ดำเนินการโดยสำนักงานพัฒนาวิทยาศาสตร์และเทคโนโลยีแห่งชาติ (สวทช.) ร่วมกับการดำเนินการกับสำนักงานหลักประกันสุขภาพแห่งชาติ (สปสช.) ในด้านการเบิกจ่ายของโครงการ
  • โครงสร้างมาตรฐานชุดข้อมูลการเบิกจ่ายของ AMED API อ้างอิงตามมาตรฐานระดับประเทศของ สำนักงานหลักประกันสุขภาพแห่งชาติ (สปสช.) โดยทางระบบ AMED API มีการพัฒนาโปรแกรมและกระบวนการตรวจสอบข้อมูลที่เป็นองค์ความรู้ของทาง AMED ที่เกี่ยวข้องกับการเบิกจ่าย
  • ผู้สนใจควรติดตามข่าวประชาสัมพันธ์ทางเว็บไซต์ AMED API เพื่อการลงทะเบียนทดสอบการใช้งาน API และกระบวนการต่าง ๆ ที่เกี่ยวข้อง

ผู้ใช้งาน AMED API เตรียมข้อมูลอะไรบ้างเพื่อเริ่มใช้งาน

  • ผู้ใช้งานระบบ AMED API ต้องมี TOKEN KEY สำหรับหน่วยบริการซึ่งลงทะเบียนกับ สปสช. เรียบร้อยแล้ว เพื่อใช้ในงาน AMED API
  • ผู้ใช้งาน AMED API ต้องได้รับ amed-token-key จาก AMED เท่านั้นเพื่อการใช้งานระบบ โดยได้รับจากการลงทะเบียนหรือกระบวนการอื่น ๆ ที่ทาง AMED กำหนดขึ้น
  • ผู้ใช้งาน AMED API ต้องศึกษากระบวนการใช้งานและการจัดการระบบเพื่อความเข้าใจในภาพรวม
  • ผู้ใช้งาน AMED API จะต้องเข้าใจกระบวนการส่งผ่านข้อมูลจาก API และการอ่านค่า DASHBOARD

กลุ่มผู้รับบริการที่เกี่ยวข้องกับโครงการ

ปัจจุบันระบบ AMED API รองรับกลุ่มผู้รับบริการที่เกี่ยวข้องกับโครงการโดยมีรายละเอียดดังภาพ และมีแผนในการเพิ่มเติมกลุ่มผู้เกี่ยวข้องตามลำดับ

การเริ่มใช้งาน AMED API

   เมื่อมีข้อมูลผู้รับบริการที่ดำเนินการ MAPPING ข้อมูลจากโปรแกรมและมาตรฐานชุดข้อมูลของ สปสช. เรียบร้อยแล้ว ลำดับต่อไปจึงเป็นการเชื่อมโยงระบบ AMED API จากโปรแกรมและชุดข้อมูลดังกล่าวเข้าสู่ระบบ โดยมีขั้นตอนการส่ง API จำนวน 3 ขั้นตอน ได้แก่

  • API 1 : การปิดสิทธิ์ ผ่าน URL Endpoint คือ https://amed-uat.hii.app.meca.in.th/amedapi/api/authencode2
  • API 2 : การส่ง CLAIM และตรวจสอบข้อมูลผ่าน AMED สู่ สปสช. URL Endpoint คือ https://amed-uat.hii.app.meca.in.th/amedapi/api/check2eclaim
  • API 3 : การส่งข้อมูลติดตามอาการภายใน 72 ชั่วโมง URL Endpoint คือ https://amed-uat.hii.app.meca.in.th/amedapi/api/service72h

ผู้ใช้งานระบบจำเป็นต้องศึกษาและทำความเข้าใจระบบรวมทั้งได้รับ API TOKEN จาก AMED API จึงจะสามารถส่งผ่านข้อมูลดังกล่าวได้

การใช้งาน API 1 การปิดสิทธิ์

   เป็นกระบวนการแจ้งข้อมูลผู้เบิกจ่ายไปยัง สปสช. เพื่อการขอรับ Authencode จาก สปสช. โดยมีรูปแบบกระบวนการใช้งานดังนี้
การใช้งานระบบสามารถเรียกใช้งานได้ตามพารามิเตอร์ที่เกี่ยวข้องในภาพรวมดังนี้

ผู้สนใจในการทดสอบใช้งานระบบ API สามารถศึกษาข้อมูลเพิ่มเติมได้ผ่าน SWAGGER Document

ผลลัพธ์ของการส่ง API จากระบบ AMED API

   ในการเรียกใช้ API ดังกล่าว หากการส่งผ่านข้อมูลสำเร็จจะได้มาซึ่ง authencode และ seq จากการตอบกลับของ API หลักจาก สปสช. โดยทางผู้พัฒนาจำเป็นต้องนำไปใช้ประกอบกับการใช้งานใน API เส้นที่ 2 คือการส่ง CLAIM และตรวจสอบข้อมูลผ่าน AMED สู่ สปสช. ในลำดับต่อไป สำหรับกรณีที่ไม่สามารถส่งผ่านได้ จะมีกระบวนการแจ้ง Error ที่เกิดจากการประมวลผลและตรวจสอบข้อมูลจาก AMED รวมทั้งการตอบกลับจาก สปสช. ซึ่งผู้ใช้งานจำเป็นต้องดำเนินการแก้ไขให้ถูกต้องตามมาตรฐานและข้อกำหนดของ สปสช. จึงจะได้รับ authencode ดังกล่าวสู่ระบบต่อไป

การใช้งาน API 2 การส่ง CLAIM และตรวจสอบข้อมูลผ่าน AMED สู่ สปสช.

    เป็นกระบวนการส่งข้อมูลการ CLAIM มายัง AMED เพื่อการตรวจสอบชุดข้อมูลด้วยกระบวนการของ AMED อ้างอิงมาตรฐานการเบิกจ่ายของ สปสช. โดยนำ authencode ที่ได้จาก API 1 มาใช้งานในส่วนของพารามิเตอร์ permitno และข้อมูลอื่น ๆ ที่เป็นข้อมูลการเบิกจ่ายของผู้รับบริการที่เกี่ยวข้องของระบบต้นทาง
การใช้งานระบบสามารถเรียกใช้งานได้ตามพารามิเตอร์ที่เกี่ยวข้องในภาพรวมดังนี้

การใช้งานระบบสามารถเรียกใช้งานได้ตามพารามิเตอร์ที่เกี่ยวข้องในภาพรวมดังนี้

ผู้สนใจในการทดสอบใช้งานระบบ API สามารถศึกษาข้อมูลเพิ่มเติมได้ผ่าน SWAGGER Document
การตรวจสอบความถูกต้องของข้อมูลในการเบิกจ่ายของ AMED จะมีการชี้แจงแยกเป็นรายตารางและรายข้อมูลเพื่อให้แน่ใจว่าข้อมูลดังกล่าวจะสามารถนำส่งไปเบิกจ่ายยัง สปสช. ได้อย่างมีคุณภาพ
การตอบกลับข้อมูลจาก สปสช. และ AMED จะแสดงผลให้ทราบอย่างชัดเจน

การใช้งาน API 3 การส่งข้อมูลติดตามอาการภายใน 72 ชั่วโมง

    เป็นกระบวนการแจ้งข้อมูลผู้เบิกจ่ายหลังจากเข้ารับการบริการไปยัง สปสช. ภายใน 72 ชั่วโมง เพื่อให้เสร็จสิ้นกระบวนการในเชิงคุณภาพ โดยกระบวนการอาจมีการเปลี่ยนแปลงในอนาคต

ส่ง API ทั้ง 3 เสร็จแล้วทำอย่างไรต่อไป

   เมื่อส่ง API สำเร็จทั้ง 3 เสร็จแล้ว ในกระบวนการต่อไปจะเป็นการรอการประเมินการเบิกจ่ายจากทาง สปสช. และการติดตามข้อมูลการเบิกจ่ายจากระบบต่อไป โดยผู้ใช้งานที่เกี่ยวข้อง สามารถดูผลการส่งหรือสถานะต่างๆ ได้ผ่าน API DASHBOARD ของ USER ที่จะได้รับจาก AMED API

การใช้งาน API DASHBOARD

   AMED API ได้จัดทำ API DASHBOARD สำหรับผู้ที่ได้สิทธิ์ในการใช้งานระบบ โดยจัดทำในรูปแบบ USER DASHBOARD ที่มีหน้าแสดงสถิติการใช้งาน API ของผู้ใช้งานผ่าน AMED API ที่มีสิทธิ์เข้าถึงและได้รับ AMED TOKEN KEY เรียบร้อยแล้ว โดยมีรายละเอียดในการนำเสนอข้อมูลภาพรวมของผู้ใช้ รายละเอียดของระบบในภาพรวม สามารถนำเสนอข้อมูลได้ดังนี้

  1. แสดงข้อมูลวันที่และเวลาของระบบอิงกับ SERVER TIME แบบ REALTIME
  2. แสดงจำนวนข้อมูลที่ส่งภายในเดือนปัจจุบันและจำนวนภาพรวมของการส่ง API พร้อม Limit Token
  3. แสดงจำนวนการใช้งาน API โดยแบ่งเป็น จำนวนใช้งานรวม จำนวนส่งผ่านถึง สปสช. และ จำนวนส่งไม่ผ่าน โดยแสดงเป็นจำนวนภาพรวมทั้งหมดของระบบ
  4. แสดงจำนวนการใช้งาน API ในภาพรวมของผู้ใช้งานในรูปแบบตัวเลขของเดือนปัจจุบัน
  5. แสดงการ Response จากระบบ API ที่ผู้ใช้งานส่งไปยังระบบ AMED ซึ่งผู้ใช้งานสามารถเลือกดูข้อมูลทีเกิดขึ้นและดำเนินการแก้ไขกระบวนการต่าง ๆ ได้ตามคำแนะนำที่เกิดขึ้นจากระบบ

การคำนวณครั้งของการใช้ API ในระบบคิดอย่างไร

   การคำนวณจำนวณครั้งของการใช้ API ในระบบ นับจากการใช้งาน API เส้นที่ 2 ที่ผ่านการตรวจสอบข้อมูลจาก AMED แล้วได้ผลลัพธ์ตอบกลับมาหรือการส่งไปถึง สปสช. แล้วได้ผลลัพธ์ตอบกลับมา โดยจะนับเป็น 1 ครั้ง แล้วนำไปลดจากจำนวนที่ได้รับที่มีทั้งหมด โดยแสดงเป็นจำนวนครั้งที่ใช้ / จำนวนที่ได้รับทั้งหมด โดยเมื่อ API เต็มจำนวนที่กำหนดแล้ว ผู้ใช้งานสามารถติดต่อกับทางทีม AMED API เพื่อการปรับปรุงจำนวนการใช้งาน API ให้ใช้งานได้ตามปกติในกระบวนการต่อไป *กระบวนการนี้สามารถเปลียนแปลงได้ในอนาคต

สถานะของ API ในส่วนของ NHSO Message คืออะไร

    คือส่วนของการแจ้งสถานะการตอบกลับข้อมูลเบิกจ่ายที่ดำเนินการโดย สปสช. ซึ่งจะแสดงผลของข้อมูลการไม่ผ่านหรือไม่ผ่านในกระบวนการนี้ โดยกระบวนการนี้ ผู้ใช้งานสามารถเลือกพิจารณาข้อมูลที่ผิดแล้วนำกลับไปแก้ไขพร้อมส่งมาพิจารณาใหม่ได้ เมื่อระบบส่งผ่านเสร็จสมบูรณ์แล้ว สปสช. จะดำเนินการพิจารณาเบิกจ่ายตามเงื่อนไขได้ต่อไป
สถานะการแจ้ง NHSO Message ที่สามารถเลือกข้อมูลที่เกิดขึ้นในระบบเพื่อพิจารณาได้

ติดต่อสอบถามกับ AMED API อย่างไร

    คุณสามารถสอบถามข้อสงสัยหรือสอบถามคำถามต่าง ๆ ได้ผ่านส่วน CHAT MESSENGER ที่ปรากฏอยู่ภายในเว็บไซต์ของ AMED โดยระบบจะดำเนินการค้นหาข้อมูลคำตอบที่ใกล้เคียงกับคำถามของคุณผ่านระบบคลังความรู้ FAQ ที่มีในระบบ หรือหากไม่พบข้อมูลดังกล่าว ระบบจะเปิดโอกาสให้คุณสนทนาหรือฝากข้อมูลให้กับเจ้าหน้าที่ของ AMED โดยจะนำคำตอบมาให้กับคุณโดยเร็วที่สุดในมุมที่เกี่ยวข้องกับโครงการ หรือนำไปจัดทำเป็น FAQ เพิ่มเติมต่อไปในอนาคต

ทำอย่างไรหากต้องการส่งออกข้อมูลจาก DASHBOARD

    สามารถทำได้โดยการ Click ขวาบนตารางหรือข้อมูลที่ต้องการ export ข้อมูล จากนั้นเลือก explore > Inspect > Data จะปรากฏปุ่ม Download ซึ่งผู้ใช้งานสามารถเลือก Download ได้ในรูปแบบของ CSV หรือ Excel ได้ทันที