๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
คมอการพฒนาโปรแกรมเพอใชบรการระบบ Web Services
ของส านกงานหลกประกนสขภาพแหงชาต
โดย Authentication ดวยบตรประจ าตวประชาชน รน Smart Card
บญฤทธ ผเรยนศลป
Version 1.0
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
1. ค ำน ำ
2. ทรพยำกรทตองใชในกำรพฒนำระบบ
3. ขนตอนกำรด ำเนนกำร
4. รำยละเอยดของระบบ Web Services
5. ตวอยำง
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
ค าน า
เอกสำรฉบบนจดท ำเพอใชเปนคมอส ำหรบพฒนำระบบโปรแกรมเพอใชบรกำรระบบ Web
Services ของส ำนกงำนหลกประกนสขภำพแหงชำต โดย Authentication ดวยบตรประจ ำตว
ประชำชน รน Smart Card โดยเนอหำจะแสดงถงขนตอนกำรด ำเนนกำรตลอดจนสงทจ ำเปนตองใช
ประกอบกำรพฒนำระบบ พรอมทงตวอยำงกำรใชงำนระบบดงกลำว สวนกำรพฒนำโปรแกรมแตละภำษำ
โปรแกรม ผพฒนำสำมำรถทจะพฒนำโปรแกรมไดโดยผำนกลไกลของแตละภำษำหรอเทคโนโลยททำนใช
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
ทรพยากรทตองใชในการพฒนาระบบ
- สทธในการเขางานระบบ
o ผใชงำนระบทมสทธเขำใชงำนระบบ Web ตรวจสอบสทธของส ำนกงำนหลกประกน
สขภำพแหงชำต สำมำรถทจะใชงำนระบบดงกลำวไดทนท
o ผใชงำนรำยใหมใหด ำเนนกำรสมครเขำสระบบนำยทะเบยน ตำมรำยละเอยดทไดแจงไว
กอนหนำ
- บตรประจ าตวประชาชน รน Smart Card พรอมด าเนนการขอ PIN Code
- เครองอานบตรประจ าตวประชาชนรน Smart Card (Smart Card Reader)
o คณสมบตของเครองอำนบตร
กำรตดตอใชงำนเปนไปตำมมำตรฐำน Microsoft PC/SC
สำมำรถอำน/เขยน บตร Smart Card ตำมมำตรฐำน ISO 7816
ไดมำตรฐำน FCC หรอ UL เปนอยำงนอย
มควำมสำมำรถในกำรเขยน/อำน บตรประจ ำตวประชำชนแบบ Smart Card
ของกรมกำรปกครอง ไดอยำงมประสทธภำพ
o Driver ส ำหรบเครองอำน
o ผใชงำนระบบจะตองท ำกำรตดตงเครองอำนบตรพรอมทงลง Driver ใหอยในสภำพ
พรอมใชงำนโดยรำยละเอยดกำรตดตงเครองอำนรนตำงๆ สำมำรถสอบถำมจำกตวแทน
จ ำหนำยหรอคมอกำรใชงำนในแตละรนได
- ระบบเชอมตอ Internet
- โปรแกรม UCAuthentication 4.x หรอสงกวา
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
ขนตอนการด าเนนใชงานระบบ Web Services ของส านกงาน
หลกประกนสขภาพแหงชาต โดย Authentication ดวยบตรประจ าตว
ประชาชน รน Smart Card
1. เปดโปรแกรม UCAuthentication 4.x
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
2. ใสรหส PIN Code ทหนำจอโปรแกรม
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
3. เมอด ำเนนกำรเรยบรอยแลว จะมรหสส ำหรบเขำใชงำนระบบ Web Services ตำมรป
ดำนลำง
4. รหสส ำหรบเขำใชงำนระบบ Web Services นอกจำกจะแสดงผำนบนหนำจอโปรแกรมแลว
โปรแกรมจะสรำงรหสส ำหรบเขำใชงำนระบบ Web Services ทอยในรปของ Text File
ซงจะเกบไวทเดยวกบโปรแกรม UCAuthentication 4.x โดยไฟลดงกลำวจะชอวำ
nhso_token.txt โดยผพฒนำโปรแกรมสำมำรถจะเขยนโปรแกรมเพอดงรหสส ำหรบเขำใช
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
งำนระบบ Web Services จำก Text File ดงกลำวได โดยไมตอง Copy ผำนหนำ
โปรแกรม โดยรหสดงกลำวจะมอำยกำรใชงำนประมำณ 1 วน คอทกเทยงคนแตละวน ระบบ
Server จะท ำกำร Clear รหส Token ใหมทกๆวน ซงทำงผใชงำนระบบจะตองท ำกำร
Authentication ทกวนเพอตองกำรใชงำนระบบ Web Services แตถำมกำร
Authentication ใหมผำนหนำโปรแกรม UCAuthentication ระบบจะด ำเนนกำร
สรำงรหส Token ส ำหรบใชงำนระบบ Web Services ใหมทกครง นนหมำยควำมวำรหส
เดมจะใชงำนไมได
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
5. จำกนนน ำรหสทไดเขำไปใชในระบบ Web Services ซงทำงผ ใชงำนจะตองพฒนำ
ระบบโปรแกรมตำมรำยละเอยดเอกสำรดำนลำง โดยตวอยำงในรปดำนลำงจะเปนกำร
แสดงตวอยำงกำรเชอมตอกำรใชงำนระบบ Web Services ผำนโปรแกรม
SOAP UI ซงเปนโปรแกรมส ำหรบทดสอบระบบกำรใชงำนระบบ Web
Services
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
รายละเอยดของระบบ Web Services
URL WSDL
http://ucws.nhso.go.th /ucwstokenp1/UCWSTokenP1?WSDL
Method Name
- searchCurrentByPID
Method Description
- ส ำหรบตรวจสอบขอมลบคคลและสทธ ณ ปจจบน
Method parameter(s)
Name Data Type
user_person_id Text เลขประจ ำตวประชำชนผใชงำนระบบ
smctoken Text รหส Token ทไดจำกกำร Authentication ดวยบตรประจ ำตวประชำชน
person_id Text เลขประจ ำตวประชำชนทตองกำรคนหำ
SOAP Request
<?xml version="1.0" encoding="UTF-8"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <S:Body> <ns2:searchCurrentByPID xmlns:ns2="http://tokenws.ucws.nhso.go.th/">
<user_person_id>เลขประจ าตวประชาชนผใชงานระบบ</user_person_id>
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
<smctoken>รหส Token ทไดจากการ Authentication ดวยบตรประจ าตวประชาชน</smctoken>
<person_id>เลขประจ าตวประชาชนทตองการคนหา</person_id>
</ns2:searchCurrentByPID> </S:Body> </S:Envelope>
Example
SOAP Request <?xml version="1.0" encoding="UTF-8"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <S:Body> <ns2:searchCurrentByPID xmlns:ns2="http://tokenws.ucws.nhso.go.th/"> <user_person_id>1111111111user_person_id> <smctoken>รหส Token ทไดจากการ Authentication ดวยบตรประจ าตวประชาชน</smctoken>
<person_id>2222222222222 </person_id> </ns2:searchCurrentByPID> </S:Body> </S:Envelope>
SOAP Response <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:searchCurrentByPIDResponse xmlns:ns2="http://tokenws.ucws.nhso.go.th/"> <return> <birthdate>25231029</birthdate> <cardid>R897xxxxxxx</cardid> <count_select>0</count_select> <expdate>25831028</expdate> <fname>xxxxxxx</fname> <hmain>10677</hmain> <hmain_name>รพ.รำชบร</hmain_name>
<hmain_op>10677</hmain_op> <hmain_op_name>รพ.รำชบร</hmain_op_name>
<hsub>07862</hsub> <hsub_name>รพ.สต.อำงทอง หมท 06 ต ำบลอำงทอง</hsub_name>
<lname>xxxxxxx</lname> <maininscl>UCS</maininscl> <maininscl_main>U</maininscl_main> <maininscl_name>สทธประกนสขภำพถวนหนำ</maininscl_name>
<mastercup_id>70010801001</mastercup_id> <nation>099</nation>
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
<paid_model>1</paid_model> <person_id>2222222222222</person_id> <primary_amphur_name>เขตบำงซอ</primary_amphur_name>
<primary_moo>-</primary_moo> <primary_mooban_name>-</primary_mooban_name> <primary_province_name>กรงเทพมหำนคร</primary_province_name>
<primary_tumbon_name>วงศสวำง</primary_tumbon_name>
<primaryprovince>1000</primaryprovince> <purchaseprovince>7000</purchaseprovince> <purchaseprovince_name>รำชบร</purchaseprovince_name>
<sex>1</sex> <startdate>25571128</startdate> <status>004</status> <subinscl>89</subinscl> <subinscl_name>ชวงอำย 12-59 ป</subinscl_name>
<title>003</title> <title_name>นำย</title_name>
<ws_data_source>NHSO</ws_data_source> <ws_date_request>1472-01-16T00:00:00+07:00</ws_date_request> <ws_status>WS001</ws_status> <wsid>WS000000000002786</wsid> <wsid_batch>WSB00000000000586</wsid_batch> </return> </ns2:searchCurrentByPIDResponse> </S:Body> </S:Envelope>
data dictionary
COLUMN_NAME COLUMN_DESC
PERSON_ID เลขประจ ำตวประชำชน
TITLE ค ำน ำหนำนำม
FNAME ชอ
LNAME นำมสกล
SEX เพศ
BIRTHDATE วนเดอนปเกด
NATION รหสสญชำต
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
ADDRESS บำนเลขท
CHAT รหสพนทตำมทะเบยนบำน(ภมล ำเนำ)
PRIMARYPROVINCE รหสจงหวดตำมทะเบยนบำน(ภมล ำเนำ)
P_PROVINCE_NAME ชอจงหวดตำมทะเบยนบำน
P_AMPHUR_NAME ชออ ำเภอตำมทะเบยนบำน
P_TUMBON_NAME ชอต ำบลตำมทะเบยนบำน
P_MOOBAN_NAME ชอหมบำนตำมทะเบยนบำน
P_MOO หมท
STATUS สถำนะบคคล
MAININSCL รหสสทธหลกในกำรรบบรกำร
MAININSCL_NAME ชอสทธหลกในกำรรบบรกำร
SUBINSCL รหสประเภทสทธยอย
SUBINSCL_NAME ชอประเภทสทธยอย
CARDID รหสประบตรประกนสขภำพ
STARTDATE วนเรมใชสทธ
EXPDATE วนหมดสทธ
PURCHASEPROVINCE รหสจงหวดทลงทะเบยน
PURCHASEPROVINCE_NAME ชอจงหวดทลงทะเบยน
HMAIN รหสหนวยบรกำรทรบกำรสงตอ
HMAIN_NAME ชอหนวยบรกำรทรบกำรสงตอ
HSUB รหสหนวยบรกำรปฐมภม
HSUB_NAME ชอหนวยบรกำรปฐมภม
HMAIN_OP รหสหนวยบรกำรประจ ำ
HMAIN_OP_NAME ชอหนวยบรกำรประจ ำ
MASTERCUP_ID รหสเครอขำยหนวยบรกำรทลงทะเบยน
PAID_MODEL รปแบบกำรใหบรกำรเพอรบกำรจดสรรเงน
๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”
ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐
NEW_TYPE_REGISTER ประเภทกำรลงทะเบยนใหม
NEW_TYPE_REGISTER_DESC รำยละอยดของประเภทกำรลงทะเบยนใหม
NEW_PURCHASEPROVINCE รหสจงหวดทขอเปลยนหนวยบรกำรใหม
NEW_PURCHASEPROVINCE_NAME ชอจงหวดทขอเปลยนหนวยบรกำรใหม
NEW_HMAIN รหสหนวยบรกำรทรบกำรสงตอใหม
NEW_HMAIN_NAME ชอหนวยบรกำรทรบกำรสงตอใหม
NEW_HSUB รหสหนวยบรกำรปฐมภมใหม
NEW_HSUB_NAME ชอหนวยบรกำรปฐมภมใหม
NEW_HMAIN_OP รหสหนวยบรกำรประจ ำใหม
NEW_HMAIN_OP_NAME ชอหนวยบรกำรประจ ำใหม
NEW_PAID_MODEL รปแบบกำรใหบรกำรเพอรบกำรจดสรรเงนใหม
NEW_MASTERCUP_ID รหสเครอขำยหนวยบรกำรทลงทะเบยนใหม
NEW_MAININSCL รหสสทธหลกในกำรรบบรกำรใหม
NEW_MAININSCL_NAME ชอสทธหลกในกำรรบบรกำรใหม
NEW_SUBINSCL รหสประเภทสทธยอยใหม
NEW_SUBINSCL_NAME ชอประเภทสทธยอยใหม
NEW_STARTDATE วนเรมใชสทธใหม
NEW_EXPDATE วนหมดสทธใหม
NEW_STAFFNAME ชอเจำหนำทประจ ำหนวยทะเบยนใหม
NEW_DATE_REGISTER วนทบนทกขอมลกำรลงทะเบยนใหม
NEW_TIME_REGISTER เวลำทบนทกขอมลกำรขนทะเบยนใหม