๑๒๐ หม ๓ ชน ๒-๔ อาคารรวมหนวยงานราชการ “ ศนยราชการเฉลมพระเกยรต ๘๐ พรรษา ๕ ธนวาคม ๒๕๕๐ ”

ถนนแจงวฒนะ แขวงทงสองหอง เขตหลกส กรงเทพฯ ๑๐๒๑๐ โทรศพท ๐๒ ๑๔๑ ๔๐๐๐ โทรสาร ๐๒ ๑๔๓ ๙๗๓๐

คมอการพฒนาโปรแกรมเพอใชบรการระบบ 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 เวลำทบนทกขอมลกำรขนทะเบยนใหม