마약류 의료쇼핑 방지 정보망 연계 개발가이드 모듈 (v1.3)

[붙임1] 환자 마약류 투약내역 확인 의무화 제도 시행 안내 포스터(제도안내)

[붙임2] 환자 마약류 투약내역 확인 의무화 제도 시행 안내 포스터(사용방법)

마약류 의료쇼핑 방지 정보망
연계 개발가이드 v1.3

(연계 모듈)

마약류 의료쇼핑 방지 정보망 연계개발가이드

제도안내 및 시스템 소개
1-1. 제도안내
1-2. 마약류 의료쇼핑 방지 정보망 소개
1-3. 마약류 의료쇼핑 방지 정보망 팝업창 조회 흐름도
1-4. 마약류 의료쇼핑 방지 정보망 API 흐름도
개발자 가이드
2-1. 개발업체 기능구현 사항
2-2. 마약류 의료쇼핑 방지 정보망 연계 상세 정의
2-3. 환자 투약 내역 조회 연계 상세 정의
2-4. 마약류 조회 연계 상세 정의
2-5. 마약류 조회 여부 확인 연계 상세 정의
2-6. 환자 투약 내역 조회 예외 사항 연계 상세 정의
2-7. 처방 의사 개인 및 병원의 인증키 조회 상세 정의
2-8. 서버 상태 체크 조회 상세 정의
2-9. 주의사항 및 지원사항
참고

참고1. 의사 개별 및 대표자 회원가입

참고2. 병원/의원 SW 의사 인증키 등록 관리

참고3. 인증키 발급 및 연계 테스트 방법

1. 제도안내 및 시스템 소개

개요

마약류 의료쇼핑 방지 정보망에 대해 소개합니다.

대상
병·의원 처방S/W(EMR, OCS)에서 환자의 마약류 투약이력 조회

제도안내
마약류 의료쇼핑 방지 정보망(정보연계) 소개
마약류 의료쇼핑 방지 정보망 팝업창 조회 흐름도
마약류 의료쇼핑 방지 정보망 API 흐름도

- 3 -

1.1. 제도 소개 및 마약류 취급의 보고 근거

제도안내 및 시스템 소개

제도안내

「마약류 관리에 관한 법률」(이하「마약류관리법」이라 한다) 제30조(마약류 투약 등) ② 마약류취
급의료업자는 대통령령으로 정하는 마약 또는 향정신성의약품을 기재한 처방전을 발급하는 경우에는
제11조의4제2항제3호에 따라 식품의약품안전처장 및 통합정보센터의 장에게 투약내역의 제공을 요
청하여 확인하여야 한다. 다만, 긴급한 사유가 있거나 오남용 우려가 없는 경우 등 대통령령으로 정하
는 경우에는 그러하지 아니하다. <신설 2023. 6. 13.>
③ 마약류취급의료업자는 제11조의4제2항제3호에 따라 투약내역을 확인한 결과 마약 또는 향정신성
의약품의 과다ㆍ중복 처방 등 오남용이 우려되는 경우에는 처방 또는 투약을 하지 아니할 수 있
다. <신설 2019. 12. 3., 2023. 6. 13.>
「마약류 관리에 관한 법률」(이하「마약류관리법」이라 한다) 제11조의4(마약류 통합정보의 제공 등)
제2항 제3호에 따라 “마약류취급의료업자가 마약 또는 향정신성의약품의 과다 · 중복 처방 등 오남용
을 방지하기 위하여 투약내역(일자, 약품정보, 수량을 말한다. 이하 같다)을 요청(전자적 방법을 통한
요청을 포함한다)하는 경우. 이 경우 마약류 취급의료업자는 환자에게 열람요청 사실을 사전에 알려
야한다.”

조직		역할

	식품의약품안전처

		※ 문의 : 02-2172-6705
	한국의약품안전관리원 마약류통합정보관리센터


	병·의원 S/W업체

		( 환자 고지확인 및 투약내역 조회 등 )
	병·의원 마약류 처방의사

법 · 제도 · 정책 수립 및 개선
운영관리 및 대외홍보 총괄
부처 협력·조정

마약류 의료쇼핑 방지 정보망 구축 및 운영
보안체계 구축 · 유지 · 관리
외부 프로그램 연계

마약류 의료쇼핑 방지 정보망 연계 기능 제공
의사 개인 인증키 관리, 환자식별번호 암호화

병·의원 처방 S/W에서 환자 선택 후 버튼 클릭으로
마약류 의료쇼핑 방지 정보망 팝업창 조회
환자 투약내역을 조회하기 위해서 의사는 열람사실을
사전에 환자에게 고지하여야함.

- 4 -

1. 제도안내 및 시스템 소개

마약류 의료쇼핑 방지 정보망(정보연계) 소개
마약류 의료쇼핑 방지 정보망은 병·의원 S/W(EMR, OCS)의 환자 처방화면에서 한번 클릭으로 환자의
마약류 의료쇼핑 방지 정보를 바로 조회할 수 있도록 팝업으로 제공하는 서비스입니다.

사용자

병·의원 마약류 처방의사(치과의사)
병·의원 처방 S/W에서 팝업 조회
환자 투약내역(효능/성분별 조회), 나의 조회이력 조회 등

마약류 의료쇼핑 방지 정보망

마약류 취급보고
검증 조회업무 지원
- 환자 투약내역 조회
공통기반 기능
- 회원가입
  처방정보
  투약정보
  - 효능/성분별 조회
  - 나의 조회이력
    - 개인인증키 관리
    - 사용자 인증
    내부사용자
    
    [마약류 의료쇼핑 방지 정보망 구조도]
    - 5 -
    
    1. 제도안내 및 시스템 소개
마약류 의료쇼핑 방지 정보망 팝업창 조회 흐름도
병·의원 처방S/W의 환자 처방화면에서 의사 개인 인증키와 암호화된 환자식별번호만으로 마약류 의
료쇼핑 방지 정보망을 호출하여 팝업 형태로 환자 투약내역을 조회하는 체계입니다.
* 개발 및 테스트는 테스트서버(testdata.nims.or.kr)에서 수행하여 주시기 바랍니다.

병·의원 처방S/W에서 data.nims.or.kr로 팝업창 Link 호출
①
병원/의원 SW

처방의사
③
의료 쇼핑
병∙의원 대표 회원가입 후 의사/병원 인증키 발급
( https://data.nims.or.kr )

② (연계 신청 시 모듈 키 발급)
병원/의원 SW에 병원인증키 등록
병 ∙ 의원 대표자
방지 정보망
연동 모듈
모듈 설치
(발급 받은 모듈 키 등록)
병원 인증서로 로그인 시 모듈 작동

④마약류* 처방 시
* API를 통해 제공된 조회
대상 마약류 Master로 관리
⑤
의쇼망 예외*
체크

*응급, 입원, 암 환자
예외 사항 해당

예외 사항 미 해당
⑥ ( https://data.nims.or.kr )
의쇼망 조회 예외 정보 전송
API 호출
(팝업창 OPEN 없이 종료)

( https://data.nims.or.kr )
마약류 처방 시 환자 정보조회
LINK

의심환자 정보조회 팝업 창
병원 인증키, 의사 정보, 암호화된 환자식별번호를 파라미터로 URL 호출
( post method )
SSL : 구간보안
⑦

환자식별번호, 조회기간, 효능/성분, 본인처방 조회조건 및 환자고지 확인
마약류 의료쇼핑 방지 정보망

환자 투약 내역
환자 투약 통계
마약류 처방 현황
환자의 투약내역 목록 조회
환자의 투약 통계 자료
마약류 처방 통계 자료
나의 조회 이력 나의 투약내역 조회 이력

안전 사용 기준
마약류 안전사용 안내 자료
1. 처방 SW 에서 팝업 오픈 시
  /api/apiChkLogin.do 호출
2. 모듈에서 팝업 오픈 시
/openpopup/api/apiChkLogin.do 호출
⑧ ( https://data.nims.or.kr )
의쇼망 환자 정보조회 여부 확인
API 호출

- 6 -

API를 통해 조회 여부 체크하여 조회
누락 시 재 조회
1. 제도안내 및 시스템 소개
  
  ① 회원 가입 후 병원/의사 인증키 발급
  - DATA.NIMS.OR.KR 사이트를 통해서 의사 개별 회원 가입 및 대표자 회원 가입 (참고1 확인)
  - 가입 및 로그인 후 “회원 > 연계정보: 암호화/인증 키” 메뉴에서 의사/병원 인증키 조회
- DEV.NIMS.OR.KR 사이트를 통해서 연계 신청 (연계 방식 : 연계 모듈 설치 방식 선택 > 관
리자가 승인 후 모듈 키 발급 > 신청서 상세정보에서 모듈 키 확인)

② 병원/의원 SW 병원/의사 인증키 등록 관리 (개발업체 구현 필요) (참고2 확인)
- 처방 SW 내에서 의사/병원 인증키 저장, 관리 기능 구현
- 저장된 의사/병원 인증키는 API 호출 시 파라미터로 전달
  
  ③ 모듈 설치 (개발업체 설치 필요)
- 개인 PC 나 브로커 서버에 설치 (윈도우OS)
- 설치 시 발급 받은 모듈 키 등록
- 모듈 실행 후 병원 인증서 로그인 시 작동
  
  ④ 환자 투약내역 조회(의쇼망) 대상 마약류(팬타닐 정/패취) 제품 목록 관리 (개발업체 구현
  필요)
- 처방 화면에서 의쇼망 의무 조회 대상 제품(펜타닐 정/패취) 목록 관리 기능 구현
- 의무 조회 대상 제품 목록 API(https://모듈 설치 PC의 IP:26104, 개인PC일 경우는
  localhost:26104/api/getDrugList.do) 호출하여 정보 제공
  
  ⑤ 환자 투약내역 조회(의쇼망) 예외 대상(응급환자, 입원환자, 암환자) 여부 체크 (개발업체
  구현 필요)
- 처방 SW 내에서
1. 예외 대상(응급환자, 입원환자, 암환자) 구분이 가능한 경우,
  ⑥번 API 호출 하여 별도 팝업창 Open 없이, 의쇼망으로 예외 대상 정보 전송
2. 예외 대상이 아니거나 SW에서 구분이 안 되는 경우,
⑦번 의쇼망 팝업창 Open

- 7 -

1. 제도안내 및 시스템 소개

⑥ 환자 투약내역 조회(의쇼망) 예외 정보 전송 API 호출 (개발업체 구현 필요)
- 예외 정보 전송 API(https://모듈 설치 PC의 IP:26104, 개인PC일 경우는
  https://localhost:26104 /api/setRpExcept.do) 호출 하여 조회 예외 사유
  전송
- 별도 팝업창 Open 없이 처방 진행
⑦ 환자 투약내역 조회(의쇼망) 화면 팝업창 OPEN (개발업체 구현 필요)
- 브라우저 팝업창 Open하여 의쇼망 URL(https://모듈 설치 PC의 IP:26104, 개인PC일 경우
  는 https://localhost:26104/api/apiChkLogin.do) 호출
- 모듈에서 팝업창이 Open 하는 의쇼망 URL(https://모듈 설치 PC의 IP:26104, 개인PC일 경
  우는 https://localhost:26104/openpopup/api/apiChkLogin.do) 호출
- 파라미터 : 병원/의사 인증키, 의사면허번호, 종별구분, 의사명, 환자식별번호 암호화, 질병
  명, 제품코드, 처방일자, 조회일자, SW ID
  
  ⑧ 환자 투약내역 조회(의쇼망) 성공 여부 확인 API 호출 (개발업체 구현 필요)
  - 의쇼망 조회 여부 API(https://모듈 설치 PC의 IP:26104, 개인PC일 경우는
    https://localhost:26104/api/getChkRpHist.do) 호출 하여 조회 여부 확인
  - 정상 조회인 경우 처방 진행
  - 정상 조회 처리 안된 경우, 재조회
- 8 -

1. 제도안내 및 시스템 소개
마약류 의료쇼핑 방지 정보망 API 흐름도

병·의원 처방S/W의 환자 처방화면에서 의사/병원 인증키와 암호화된 환자식별번호만으로 마약류 의
료쇼핑 방지 정보망 API를 호출하여 JSON 형태로 데이터를 조회 및 등록하는 체계입니다.

* 개발 및 테스트는 테스트서버(testdata.nims.or.kr)에서 수행하여 주시기 바랍니다.

병·의원 처방S/W에서 data.nims.or.kr로 API 호출

①

병원/의원 SW 병∙의원 대표 회원가입 후 의사/병원 인증키 발급
( https://data.nims.or.kr )

처방의사

②

병원/의원 SW에 병원인증키 등록

(연계 신청 시 모듈 키 발급)

병 ∙ 의원 대표자

의료 쇼핑
방지 정보망 연동

모듈

모듈 설치

(발급 받은 모듈 키 등록)

마약류 의료쇼핑 방지 정보망

③

병원 인증서로 로그인 시 모듈 작동 ④

⑤

환자 투약 내역 조회

필수 조회 마약류 조회
환자 투약 내역 조회 여부 확인

마약류* 처방 시

* API를 통해 제공된 조회

⑥

환자 투약 내역 조회 예외 사항 등록

⑦

처방 의사의 인증키 조회 URL

⑧

서버 유효 상태 체크

조회결과

JSON Return (예시)

조회 예시

{response::{“rtnMsg”:”조회성공“,code:”0”, body:
[{data:0,data:1}]

- 9 -

제도안내 및 시스템 소개

① 대표자 회원 가입 후 의사/병원 인증키 발급
- DATA.NIMS.OR.KR 사이트를 통해서 대표자 회원 가입 (참고1 확인)
- 가입 및 로그인 후 “회원 > 연계정보: 암호화/인증 키” 메뉴에서 의사/병원 인증키 조회

- DEV.NIMS.OR.KR 사이트를 통해서 연계 신청 (연계 방식 : 병원단위인증 선택 후 IP 입력)

② 병원/의원 SW 의사/병원 인증키 등록 관리 (개발업체 구현 필요) (참고2 확인)

처방 SW 내에서 의사/병원 인증키 저장, 관리 기능 구현
저장된 병원 인증키는 API 호출 시 파라미터로 전달
③ 환자 투약 내역 조회 전문 API 호출 (개발업체 구현 필요) (상세 정의 참고)
마약류 처방의사가 처방 S/W화면에서 환자의 투약 내역을 조회
호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/getRpHistList.do
개인PC - https://localhost:26104/api/getRpHistList.do
결과값 유형 : JSON
④ 마약류 조회 전문 API 호출 (개발업체 구현 필요) (상세 정의 참고)
필수 조회 마약류 조회
호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/getDrugList.do
개인PC - https://localhost:26104/api/getDrugList.do
결과값 유형 : JSON
⑤ 마약류 조회 여부 확인 전문 API 호출 (개발업체 구현 필요) (상세 정의 참고)
마약류 조회 여부 확인
호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/getChkRpHist.do
개인PC - https://localhost:26104/api/getChkRpHist.do
결과값 유형 : JSON
⑥ 환자 투약 내역 조회 예외 사항 전문 API 호출 (개발업체 구현 필요) (상세 정의 참고)
마약류 처방의사가 처방 S/W화면에서 환자의 투약 내역의 예외 사항 (암환자,입원환자,
응급환자)리스트를 호출하여 조회 이력 생성
호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/setRpExcept.do
개인PC - https://localhost:26104/api/setRpExcept.do
결과값 유형 : JSON

- 10 -

제도안내 및 시스템 소개

⑦ 처방 의사 및 의사/병원 인증키 조회 (개발업체 구현 필요) (상세 정의 참고)
- 마약류 처방 의사 및 병원의 처방S/W에서 의료용 마약류 빅데이터활용서비스
  (data.nims.or.kr) 가입된 ID, 비밀번호 인증 을 통해 병원/의사 인증키 및 병원 인증 키를 조회
- 호출 URL : https://data.nims.or.kr/api/getCrkey.do
- 호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/getCrkey.do
  개인PC - https://localhost:26104/api/getCrkey.do
- 결과값 유형 : JSON
  ⑧ 서버 유효 상태 체크 조회 (개발업체 구현 필요) (상세 정의 참고)
- 처방S/W에서 마약류 빅데이터활용서비스(data.nims.or.kr)서비스가 유효한지 체크
- 호출 URL : 브로커 서버 - https://모듈설치IP:26104/api/svrStatus.do
  개인PC - https://localhost:26104/api/svrStatus.do
- 결과값 유형 : JSON
  
  - 11 -
개발자 가이드

2.1. 개발업체 기능구현 사항

환자의 마약류 투약내역 조회를 위한 기능구현 사항

개인 인증키 관리 기능

- 의료용마약류 빅데이터활용서비스(data.nims.or.kr)에서 발급받은 의사의 인증키를 병원/의원
처방SW(EMR, OCS)에 저장 및 관리 기능을 구현

SWID 관리 및 보고기능
- 마약류통합정보관리센터에서 연계SW별로 부여한 SW 고유식별번호 관리 기능 및 환자의 마약류
  투약내역 조회 시 호출 파라미터로 입력되도록 구현
LINK URL호출 서비스
- 연계SW에서 팝업창으로 환자의 마약류 투약내역 조회(테스트 서버) - 의사개인
  ( https://연계모듈IP:26104/api/apiLogin.do )
  호출 기능 개발
  파라미터 : 병원/의사 인증키, 의사면허번호, 종별구분, 의사명, 환자식별번호 암호화, 질병명, 제품
  코드, 예외사항, 처방일자 이후
  
  - 연계SW에서 팝업창으로 환자의 마약류 투약내역 조회(테스트 서버) – 허용IP, 모듈사용, 의사개인
  ( https://연계모듈IP:26104/api/apiChkLogin.do )
  호출 기능 개발
  파라미터 : 병원/의사 인증키, 의사면허번호, 종별구분, 의사명, 환자식별번호 암호화, 질병명, 제품
  코드, 예외사항, 처방일자 이후
환자식별번호 암호화 기능
- 조회하고자 하는 환자의 식별번호를 암호화하는 기능 개발 필요
  * 마약류 취급내역 보고 시 사용하는 암호화 방식(RSA512)과 암호화키 적용 가능
의사의 인증키 조회 기능
- 처방SW에서 의료용 마약류 빅데이터활용서비스(data.nims.or.kr)에 가입된

의사의 ID, 비밀번호 인증으로 의사의 인증키 조회 기능 개발
( https://연계모듈IP:26104/api/getCrkey.do )

호출 기능 개발

파라미터 : 의사 ID, 비밀번호

- 12 -

개발자 가이드

개발업체 기능구현 사항

정보제공 OpenAPI 목록

API명칭

결과 유형

호출주소

환자 투약 내역 조회 팝업 VIEW (병원/개인)

VIEW

/api/apiChkLogin.do

환자 투약 내역 조회

JSON

/api/getRpHistList.do

필수 조회 마약류 조회

JSON

/api/getDrugList.do

환자 투약 내역 조회 여부 확인

JSON

/api/getChkRpHist.do

환자 투약 내역 조회 예외 사항 등록

JSON

/api/setRpExcept.do

처방 의사의 인증키 조회 URL

JSON

/api/getCrkey.do

서버 유효 상태 체크

JSON

/api/svrStatus.do

- 13 -

2. 개발자 가이드

마약류 의료쇼핑 방지 정보망 연계 상세 정의

환자 투약 내역 조회 팝업VIEW 호출 (개인/병원)

마약류 처방의사가 처방 S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약내역을 조회

호출 주소URL( 테스트 환경 )
테스트서버 호출 주소
- 처방 SW에서 팝업 오픈 시
  https://연계모듈IP:26104/api/apiLogin.do
- 모듈에서 팝업 오픈 시
  https://연계모듈IP:26104/openpopup/api/apiLogin.do
호출 파라미터

No.	호출 파라미터	필수여부	설명
1	k = 병원/의사 인증키	필수	의료용마약류 빅데이터활용서비스 사이트 https://data.nims.or.kr “의사.환자 정보활용” 메뉴 하위의 “연계정보: 암호화/인증 키“ 메뉴에서 인증키, 암호화키 확인 ※ 테스트서버는 testdata.nims.or.kr에서 로그인하여 확인
2	lcn = 의사면허번호	필수	처방 의사 면허번호
3	fg = 종별구분	필수	(01: 의사, 02: 치과의사)
4	dn = 의사명	선택	처방 의사 명
5	s = 환자식별번호	필수	환자 주민등록번호를 암호화 키로 RSA암호화
6	ilns = 주상병명	선택	환자의 주상병명
7	pc = 제품코드	선택	처방할 제품 코드
8	ymd = 처방일자	선택	처방일자 (미 입력 시 현재일자)
9	symd = 조회일자	선택	조회일자 (미 입력 시 현재일자)
10	swid = 소프트웨어ID	필수	한국의약품안전관리원에서 발급한 S/W업체 고유ID

- 14 -

개발자 가이드

2.2. 마약류 의료쇼핑 방지 정보망 연계 상세 정의

환자 투약 내역 조회 팝업VIEW 호출 (개인/병원)

마약류 처방의사가 처방 S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약내역을 조회

호출 방식
Request Method = POST 방식, Charset = UTF-8
투약내역 조회 조회절차

절차	수행내용	수행자
1	병·의원 S/W의 의사가 조회 대상 마약류 처방	마약류 처방의사
2	1) 의사 개인인증키가 없는 경우 – 인증키 등록	마약류 처방의사
3	2) 환자식별번호 암호화	S/W 기능
4	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
5	비밀번호 재입력 화면 표시 후 환자고지 여부 동의 후 비밀번호 재 입력 후 확인	마약류 처방의사
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 15 -

2. 개발자 가이드

2.2. 마약류 의료쇼핑 방지 정보망 연계 상세 정의

환자 투약 내역 조회 팝업VIEW 호출 (개인/병원)
- 마약류 처방의사가 처방 S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약내역을 조회
1. 호출 예시
  url : https://연계모듈IP:26104/api/apiLogin.do
  http method : post
  http Body : k=0e529a94ba5b035cd7846741582ab8d66d22d363f0344fae049fa6d39f5467c7&
  s=927bebb818d77f1a1e7213cc2bee4b358fae2c764395f3076e4b972572ece5d4e647c1224401752a383803
  b1b01a67141fd1c8e5e60d42a99f008c33ad5da93415c1e763b5519247ca31d79166b299ee80a8642d29de6
  0b1615c3f0f4dfead67492576999f07f2b575b7553b125a31e8d957e8b004a82ccec0a56848242bc20eb180b7
  2d2c3b8e65d9fc6bd15882780e9a5213ed714e38e9616f32172550e7f47a245adb03047936548ce3b12f4dfc4
  aa1f06901b8f5d7a8721630cf466c4b4c9767fa2043a3160272e37b339cf13f11b26e6c42f8833d7cef02731ed
  685d805bf12a41c76e119ebc6ffae6914d9a54e1a928315e1c7f20c2c9e996bb3b65f47&lcn=202001&fg=53
  &swid=20H1234
2. 연계정보: 암호화/인증 키 화면 예시
- 16 -

2. 개발자 가이드

환자 투약 내역 조회 팝업VIEW 호출 (개인/병원)

마약류 처방의사가 처방 S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약내역을 조회
모듈 사용은 사용자에게 비밀번호를 묻지 않음.

호출 주소URL( 테스트 환경 )
테스트서버 호출 주소
- 처방 SW에서 팝업 오픈 시
  https://연계모듈IP:26104/api/apiChkLogin.do
- 모듈에서 팝업 오픈 시
  https://연계모듈IP:26104/openpopup/api/apiChkLogin.do

호출 파라미터

No.	호출 파라미터	필수여부	설명
1	k = 병원/의사 인증키	필수	의료용마약류 빅데이터활용서비스 사이트 https://data.nims.or.kr “의사.환자 정보활용” 메뉴 하위의 “연계정보: 암호화/인증 키“ 메뉴에서 인증키, 암호화키 확인 ※ 테스트서버는 testdata.nims.or.kr에서 로그인하여 확인
2	lcn = 의사면허번호	필수	처방 의사 면허번호
3	fg = 종별구분	필수	(01: 의사, 02: 치과의사)
4	dn = 의사명	선택	처방 의사 명
5	s = 환자식별번호	필수	환자 주민등록번호를 암호화 키로 RSA암호화
6	ilns = 주상병명	선택	환자의 주상병명
7	pc = 제품코드	선택	처방할 제품 코드
8	ymd = 처방일자	선택	처방일자 (미 입력 시 현재일자)
9	symd = 조회일자	선택	조회일자 (미 입력 시 현재일자)
10	swid = 소프트웨어ID	필수	한국의약품안전관리원에서 발급한 S/W업체 고유ID

호출 방식

Request Method = POST 방식, Charset = UTF-8

- 17 -

2. 개발자 가이드

마약류 의료쇼핑 방지 정보망 연계 상세 정의

환자 투약 내역 조회 팝업VIEW 호출 (개인/병원)

마약류 처방의사가 처방 S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약내역을 조회
모듈 사용은 사용자에게 비밀번호를 묻지 않음.

투약내역 조회 조회 절차 ( 모듈 )

절차	수행내용	수행자
1	“마약류 의료쇼핑 방지 정보망“ 대표자 회원가입	병의원 대표자
2	“마약류 의료 쇼핑 방지 정보망“ 에서 모듈키 신청	병의원 대표자
3	모듈 설치	병의원 관리자 및 개발사
4	환자식별번호 암호화	S/W 기능
5	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 18 -

2. 개발자 가이드

마약류 의료쇼핑 방지 정보망 연계 상세 정의

환자 투약 내역 조회 팝업 VIEW 호출 (개인/병원)
- 마약류 처방의사가 처방S/W화면에서 환자식별번호, 의사 개인 인증키로 환자의 투약 내역을 조회
- 모듈 사용은 사용자에게 비밀번호를 묻지 않음.
1. 호출 예시
  url : https://연계모듈IP:26104/api/apiChkLogin.do
  http method : post
  http Body : k=0e529a94ba5b035cd7846741582ab8d66d22d363f0344fae049fa6d39f5467c7&
  s=927bebb818d77f1a1e7213cc2bee4b358fae2c764395f3076e4b972572ece5d4e647c1224401752a383803
  b1b01a67141fd1c8e5e60d42a99f008c33ad5da93415c1e763b5519247ca31d79166b299ee80a8642d29de6
  0b1615c3f0f4dfead67492576999f07f2b575b7553b125a31e8d957e8b004a82ccec0a56848242bc20eb180b7
  2d2c3b8e65d9fc6bd15882780e9a5213ed714e38e9616f32172550e7f47a245adb03047936548ce3b12f4dfc4
  aa1f06901b8f5d7a8721630cf466c4b4c9767fa2043a3160272e37b339cf13f11b26e6c42f8833d7cef02731ed
  685d805bf12a41c76e119ebc6ffae6914d9a54e1a928315e1c7f20c2c9e996bb3b65f47&lcn=202001&fg=53
  &swid=20H1234
2. 결과 예시
- 19 -

2. 개발자 가이드

환자 투약내역 조회 전문 호출 (개인/병원)

마약류 처방의사가 처방 S/W화면에서 환자의 투약 내역을 조회
모듈 사용은 사용자에게 비밀번호를 묻지 않음.

호출 주소URL( 테스트 환경 )
테스트서버 호출 주소
https://연계모듈IP:26104/api/getRpHistList.do

호출 파라미터

No.	호출 파라미터	필수여부	설명
1	k = 병원/의사 인증키	필수	의료용마약류 빅데이터활용서비스 사이트 https://data.nims.or.kr “의사.환자 정보활용” 메뉴 하위의 “연계정보: 암호화/인증 키“ 메뉴에서 인증키, 암호화키 확인 ※ 테스트서버는 testdata.nims.or.kr에서 로그인하여 확인
2	lcn = 의사면허번호	필수	처방 의사 면허번호
3	fg = 종별구분	필수	(01: 의사, 02: 치과의사)
4	dn = 의사명	선택	처방 의사 명
5	s = 환자식별번호	필수	환자 주민등록번호를 암호화 키로 RSA암호화
6	nt = 고지 여부	필수	Y / N
7	ilns = 주상병명	선택	환자의 주상병명
8	pc = 제품코드	선택	처방할 제품 코드
9	ymd = 처방일자	선택	처방일자 (미 입력 시 현재일자)
10	symd = 조회일자	선택	조회일자 (미 입력 시 현재일자)
11	swid = 소프트웨어ID	필수	한국의약품안전관리원에서 발급한 S/W업체 고유ID
12	pageNo=조회페이지번호	선택	페이징 ( 페이지 번호) 기본값 : 1
13	numOfRows=페이지 당표 현레코드수	선택	페이징 ( 한페이지에 표현될 데이터 수 ) 기본값 : 100

호출 방식

Request Method = POST 방식, Charset = UTF-8

- 20 -

2. 개발자 가이드

2.3. 환자 투약 내역 조회 연계 상세 정의

환자 투약 내역 조회 전문 호출

마약류 처방 의사가 처방 S/W화면에서 환자의 투약 내역을 조회

모듈 사용은 사용자에게 비밀번호를 묻지 않음.

4. 결과 항목

항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1...n), 0건 또는 복수건(0...n)

항목명(영문)		결과항목	NO	형식	항목구분	설명
rtnMsg		결과메세지	1	VARCHAR2(50)	1	결과 메시지
code		결과코드	2	VARCHAR2(1)	1	0:성공, 1:실패, 2: 필수값확인, 3:인증실패
totalCount		총 건수	3	Int	1	총 조회건수
pageNo		현재 페이지 번호	4	VARCHAR2	1	현재 페이지 번호
numOfRows		페이지 당 표현 건수	5	VARCHAR2	1	페이지 당 표현 건수
lastPageYn		마지막페이지 여부	6	VARCHAR2(1)	1	마지막페이지 일때 : Y 마지막페이지 아닐때 : N
body					0…n
	HDR_DE	처방일자	7	VARCHAR2(100)	1
	HDNT_NM	의료기관유형	8	VARCHAR2(100)	1
	INOUT_NM	조제	9	VARCHAR2(100)	1
	SGGU_NM	지역	10	VARCHAR2(100)	1
	PRDUCT_NM	제품명	11	VARCHAR2(100)	1
	USE_GRP	효능	12	VARCHAR2(100)	1
	INGR_GRP	성분	13	VARCHAR2(100)	1
	MDC_ONCE_QY_FORM	1회 투여량	14	VARCHAR2(100)	1
	MDC_ADE_CNT_FORM	1일 투여횟수	15	VARCHAR2(100)	1
	MDC_TOT_DCNT	총 투여일수	16	VARCHAR2(100)	1
	PRDUCT_CD	제품코드	17	VARCHAR2(100)	1

- 21 -

2. 개발자 가이드

2.3. 환자 투약 내역 조회 연계 상세 정의

환자 투약 내역 조회 전문 호출

마약류 처방 의사가 처방 S/W화면에서 환자의 투약 내역을 조회

모듈 사용은 사용자에게 비밀번호를 묻지 않음.

4-1. 투약내역 조회 조회절차(IP)

절차	수행내용	수행자
1	“마약류 의료쇼핑 방지 정보망“ 대표자 회원가입	병의원 대표자
2	“마약류 의료쇼핑 방지 정보망“ 에서 IP 허용 신청	병의원 대표자
3	환자식별번호 암호화	S/W 기능
4	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
5	환자의 투약내역 조회 화면 확인	마약류 처방의사

4-2. 투약내역 조회 조회절차 (모듈)

절차	수행내용	수행자
1	“마약류 의료쇼핑 방지 정보망“ 대표자 회원가입	병의원 대표자
2	“마약류 의료쇼핑 방지 정보망“ 에서 모듈키 신청	병의원 대표자
3	모듈 설치	병의원 관리자 및 개발사
4	환자식별번호 암호화	S/W 기능
5	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 22 -

2. 개발자 가이드

환자 투약 내역 조회 연계 상세 정의

환자 투약 내역 조회 전문 호출

마약류 처방 의사가 처방 S/W화면에서 환자의 투약 내역을 조회

모듈 사용은 사용자에게 비밀번호를 묻지 않음.

투약내역 조회 조회 절차 (개인)

절차	수행내용	수행자
1	병·의원 S/W의 의사가 조회 대상 마약류 처방	마약류 처방의사
2	1) 의사 개인인증키가 없는 경우 – 인증키 등록	마약류 처방의사
3	2) 환자식별번호 암호화	S/W 기능
4	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
5	비밀번호 재입력 화면 표시 후 환자고지 여부 동의 후 비밀번호 재 입력 후 확인	마약류 처방의사
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 23 -

2. 개발자 가이드

환자 투약 내역 조회 연계 상세 정의

환자 투약 내역 조회 전문 호출
- 마약류 처방 의사가 처방 S/W화면에서 환자의 투약 내역을 조회
- 허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.
  1. 호출 예시
    url : https://연계모듈IP:26104/api/getRpHistList.do
    http method : post
    http Body : k=0e529a94ba5b035cd7846741582ab8d66d22d363f0344fae049fa6d39f5467c7&
    s=927bebb818d77f1a1e7213cc2bee4b358fae2c764395f3076e4b972572ece5d4e647c1224401752a383803
    b1b01a67141fd1c8e5e60d42a99f008c33ad5da93415c1e763b5519247ca31d79166b299ee80a8642d29de6
    0b1615c3f0f4dfead67492576999f07f2b575b7553b125a31e8d957e8b004a82ccec0a56848242bc20eb180b7
    2d2c3b8e65d9fc6bd15882780e9a5213ed714e38e9616f32172550e7f47a245adb03047936548ce3b12f4dfc4
    aa1f06901b8f5d7a8721630cf466c4b4c9767fa2043a3160272e37b339cf13f11b26e6c42f8833d7cef02731ed
    685d805bf12a41c76e119ebc6ffae6914d9a54e1a928315e1c7f20c2c9e996bb3b65f47&lcn=202001&fg=53
    &swid=20H1234
  2. 결과 예시
  - 24 -
  
  2. 개발자 가이드

필수 조회 마약류 조회 전문 호출

허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.

호출 주소URL( 테스트 환경 )
테스트서버 호출 주소
https://연계모듈IP:26104/api/getDrugList.do

호출 파라미터

No.	호출 파라미터	필수여부	설명
1	h = 요양기관번호	필수	요양기관번호
2	pageNo=조회페이지번호	선택	페이징 ( 페이지 번호) 기본값 : 1
3	numOfRows=페이지 당표 현레코드수	선택	페이징 ( 한페이지에 표현될 데이터 수 ) 기본값 : 100
4	swid = 소프트웨어ID	필수	한국의약품안전관리원에서 발급한 S/W업체 고유ID

호출 방식
Request Method = POST 방식, Charset = UTF-8
결과 항목

항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1...n), 0건 또는 복수건(0...n)

항목명(영문)		결과항목	NO	형식	항목구분	설명
rtnMsg		결과메세지	1	VARCHAR2(50)	1	결과 메시지
code		결과코드	2	VARCHAR2(1)	1	0:성공, 1:실패, 2: 필수값확인, 3:인증실패
totalCount		총 건수	3	Int	1	총 조회건수
pageNo		현재 페이지 번호	4	VARCHAR2	1	현재 페이지 번호
numOfRows		페이지 당 표현 건수	5	VARCHAR2	1	페이지 당 표현 건수
lastPageYn		마지막페이지 여부	6	VARCHAR2(1)	1	마지막페이지 일때 : Y 마지막페이지 아닐때 : N
body					0…n
	EDI_CD	EDI청구코드	7	VARCHAR2(14)	1
	PRDUCT_CD	제품코드	8	VARCHAR2(14)	1
	PRDUCT_NM	제품명	9	VARCHAR2(300)	1

- 25 -

2. 개발자 가이드

마약류 조회 연계 상세 정의

필수 조회 마약류 조회 전문 호출

허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.

투약내역 조회 조회 절차 (모듈)

절차	수행내용	수행자
1	“마약류 의료쇼핑 방지 정보망“ 대표자 회원가입	병의원 대표자
2	“마약류 의료쇼핑 방지 정보망“ 에서 모듈키 신청	병의원 대표자
3	모듈 설치	병의원 관리자 및 개발사
4	환자식별번호 암호화	S/W 기능
5	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 26 -

2. 개발자 가이드

마약류 조회 연계 상세 정의

필수 조회 마약류 조회 전문 호출
- 허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.
  1. 호출 예시
    url : https://연계모듈IP:26104/api/getDrugList.do
    http method : post
    http Body : k=Q52N9TXSDXAVDX0XBI4SY3J2P27B77BRNXR1GI43B663N5GE8EG5YVFG89ZG08K0&
    pg=1&swid=20H1234
  2. 결과 예시
  - 27 -
  
  2. 개발자 가이드

조회 여부 확인 전문 호출

허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.

호출 주소URL( 테스트 환경 )

테스트서버 호출 주소

https://연계모듈IP:26104/api/getChkRpHist.do

No.	호출 파라미터	필수여부	설명
1	k = 병원/의사 인증키	필수	의료용마약류 빅데이터활용서비스 사이트 https://data.nims.or.kr “의사.환자 정보활용” 메뉴 하위의 “연계정보: 암호화/인증 키“ 메뉴에서 인증키, 암호화키 확인 ※ 테스트서버는 testdata.nims.or.kr에서 로그인하여 확인
2	lcn = 의사면허번호	필수	처방 의사 면허번호
3	s = 환자식별번호	필수	환자 주민등록번호를 암호화 키로 RSA암호화
4	fg = 종별구분	필수	(01: 의사, 02: 치과의사)
5	dn = 의사명	선택	처방 의사 명
6	ymd = 처방일자	선택	조회처방 (미 입력 시 현재일자)
7	symd = 조회일자	선택	조회일자 (미 입력 시 현재일자)
8	swid = 소프트웨어ID	필수	한국의약품안전관리원에서 발급한 S/W업체 고유ID
9	ex = 예외 사항 포함 여부	선택	Y : 예외 사항 포함 / N : 예외 사항 미포함
9	pageNo=조회페이지번호	선택	페이징 ( 페이지 번호) 기본값 : 1
10	numOfRows=페이지 당표 현레코드수	선택	페이징 ( 한페이지에 표현될 데이터 수 ) 기본값 : 100

호출 파라미터
호출 방식

Request Method = POST 방식, Charset = UTF-8
결과 항목

항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1...n), 0건 또는 복수건(0...n)

항목명(영문)		결과항목	NO	형식	항목구분	설명
rtnMsg		결과메세지	1	VARCHAR2(50)	1	결과 메시지
code		결과코드	2	VARCHAR2(1)	1	0:성공, 1:실패, 2: 필수값확인, 3:인증실패
totalCount		총 건수	3	Int	1	총 조회건수
pageNo		현재 페이지 번호	4	VARCHAR2	1	현재 페이지 번호
numOfRows		페이지 당 표현 건수	5	VARCHAR2	1	페이지 당 표현 건수
body					0…n
	P_JUMIN_NO	환자식별번호	6	VARCHAR2(1000)	1
	REGISTER_DT	조회일자	7	DATE	1
	FG	종별구분	8	VARCHAR2(50)	1	10001 : 의사 / 10002 : 치과의사
	DORTOR_LCN	의사면허번호	9	VARCHAR2(50)	1
	EXC	예외사항코드	10	VARCHAR2(50)	1	01: 암환자, 02:입원환자, 03:응급환자, 04: 원내처방

- 28 -

2. 개발자 가이드

마약류 조회 여부 확인 연계 상세 정의

조회 여부 확인 전문 호출

허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.

투약내역 조회 조회 절차 (모듈)

절차	수행내용	수행자
1	“마약류 의료쇼핑 방지 정보망“ 대표자 회원가입	병의원 대표자
2	“마약류 의료쇼핑 방지 정보망“ 에서 모듈키 신청	병의원 대표자
3	모듈 설치	병의원 관리자 및 개발사
4	환자식별번호 암호화	S/W 기능
5	팝업창 생성 후 연계URL 및 파라미터 호출	S/W 기능
6	환자의 투약내역 조회 화면 확인	마약류 처방의사

- 29 -

2. 개발자 가이드

마약류 조회 여부 확인 연계 상세 정의

조회 여부 확인 전문 호출
- 허용된 IP, 모듈 사용은 사용자에게 비밀번호를 묻지 않음.
  1. 호출 예시
    
    url : https://연계모듈IP:26104/api/getChkRpHist.do
    http method : post
    http Body :
    k=Q52N9TXSDXAVDX0XBI4SY3J2P27B77BRNXR1GI43B663N5GE8EG5YVFG89ZG08K0&s=44dfb8ce4b57c
    b8f8740469fb9422b22ff5ae5b5a6e66ef0750f06cc499d59f4686017f31802305f90b3652d2b8b1dec8e227ac
    cc7d0e14b3dc9871154b8164890d26ab812ac4870127aaeba76bf801ea96ababf3290dcc6023e0c507eaa125
    dfe9c8affa6fa09c06d43457789ef2ab488be34b1fc17177e5f941df46f49ab21165d49b723e312907d4bb40b8
    5d214c0323c9950de05da775a60ad7b34698ebad7ce2f70c80c8625b9d3702037c45f34781b07c56c5c68e01
    9fe2d59e50cf6e2cc65c705ccc7413d3eecfdca1091c2394308dc8a83d060b2646942176d798eadacaedc8b2f
    70cd14da25654ec2a180e5ce1a0d3b8889c51dff79193344a968ea&Lcn=202001&ymd=&swid=20H1234
  2. 결과 예시
  - 30 -
  
  2. 개발자 가이드

환자 투약내역 조회 예외 사항 전문 호출

마약류 처방의사가 처방 S/W화면에서 환자의 투약 내역의 예외 사항 (암환자,입원환자,응급환자)
리스트를 호출하여 조회 이력 생성

호출 주소URL( 테스트 환경 )

테스트서버 호출 주소
https://연계모듈IP:26104/api/setRpExcept.do

호출 파라미터

No.	호출 파라미터	필수여부	유형	설명
1	k = 병원/의사 인증 키	필수	String	의료용마약류 빅데이터활용서비스 사이트 https://data.nims.or.kr “의사.환자 정보활용” 메뉴 하위의 “연계정보: 암호화/인증 키“ 메뉴에서 인증키, 암호화키 확인 ※ 테스트서버는 testdata.nims.or.kr에서 로그인하여 확인
2	lcn = 의사면허번호	필수	Array	처방 의사 면허번호
3	fg = 종별구분	필수	Array	(01: 의사, 02: 치과의사)
4	s = 환자식별번호	필수	Array	환자 주민등록번호를 암호화 키로 RSA암호화
5	ex = 예외사항	필수	Array	01: 암환자, 02:입원환자, 03:응급환자, 04:원내처방
6	dn = 의사명	선택	Array	처방 의사 명
7	ilns = 주상병명	선택	Array	환자의 주상병명
8	pc = 제품코드	선택	Array	처방할 제품 코드
9	ymd = 처방일자	선택	Array	처방일자 (미 입력 시 현재일자)
10	symd = 조회일자	선택	Array	조회일자 (미 입력 시 현재일자)
11	swid = 소프트웨어ID	필수	String	한국의약품안전관리원에서 발급한 S/W업체 고유ID

호출 방식

Request Method = POST 방식, Charset = UTF-8

- 31 -

개발자 가이드

2.6. 환자 투약 내역 조회 예외 사항 연계 상세 정의

환자 투약내역 조회 예외 사항 전문 호출

마약류 처방의사가 처방 S/W화면에서 환자의 투약 내역의 예외 사항 (암환자,입원환자,응급환자)
리스트를 호출하여 조회 이력 생성

결과값

상태	결과
정상	{"code":"0","result":”저장되♘습니다.”}
오류	{"code":"1","result":”실패되♘습니다.”}
오류	{"code":“2","result":”필수 값이 누락되♘습니다.”}
오류	{"code":“4","result":”인증에 실패하였습니다.”}

호출 예시

url : 연계모듈IP:26104/api/setRpExcept.do
http method : post
http Body :
k=Q52N9TXSDXAVDX0XBI4SY3J2P27B77BRNXR1GI43B663N5GE8EG5YVFG89ZG08K0&s=44dfb8ce4b57c
b8f8740469fb9422b22ff5ae5b5a6e66ef0750f06cc499d59f4686017f31802305f90b3652d2b8b1dec8e227ac
cc7d0e14b3dc9871154b8164890d26ab812ac4870127aaeba76bf801ea96ababf3290dcc6023e0c507eaa125
dfe9c8affa6fa09c06d43457789ef2ab488be34b1fc17177e5f941df46f49ab21165d49b723e312907d4bb40b8
5d214c0323c9950de05da775a60ad7b34698ebad7ce2f70c80c8625b9d3702037c45f34781b07c56c5c68e01
9fe2d59e50cf6e2cc65c705ccc7413d3eecfdca1091c2394308dc8a83d060b2646942176d798eadacaedc8b2f
70cd14da25654ec2a180e5ce1a0d3b8889c51dff79193344a968ea&Lcn=202001&ymd=&swid=20H1234
결과 예시

{"code":"0","result":”저장되♘습니다.”}

- 32 -

2. 개발자 가이드

처방 의사 개인 및 병원의 인증키 조회 상세 정의

처방 의사 개인 및 병원의 인증키 조회 URL 호출

마약류 처방의사가 처방S/W에서 의료용 마약류 빅데이터활용서비스(data.nims.or.kr)에 가입된 ID,
비밀번호 인증을 통하여 의사 개인 및 병원 의 인증키를 조회

호출 주소URL( 테스트 환경 )
테스트서버 호출 주소
https://연계모듈IP:26104/api/getCrkey.do

호출 파라미터

No.	호출 파라미터	필수여부	설명
1	i = 의사ID / 병원 대표ID	필수	의료용마약류 빅데이터활용서비스(https://data.nims.or.kr)에 가입된 의사 및 대표자의 로그인 ID
2	p = 비밀번호	필수	의료용마약류 빅데이터활용서비스(https://data.nims.or.kr)에 가입된 의사 및 대표자의 로그인 비밀번호(암호화)

호출 방식

GET 방식 : https://연계모듈IP:26104/api/getCrkey.do?i=아이디&p=비밀번호
POST 방식
- 호출 URL : https://연계모듈IP:26104/api/getCrkey.do
- 파라미터 : i=아이디&p=비밀번호

결과값

상태	결과
정상	{"code":"0","result":"RQJXJXGVYETCFSA1DIMJG63PLI44A868NQ5Y61UU4B3FE3F4N2Q34"}
오류	{"code":"1","result":"사용자 ID가 일치하지 않습니다."}
오류	{"code":"2","result":"사용자 비밀번호가 일치하지 않습니다."}
오류	{"code":"3","result":"비밀번호 RSA복호화에 실패하였습니다. RSA암호화 가이드에 따라 암호화해 주세요."}
오류	{"code":"4","result":"의사 인증키가 없습니다. data.nims.or.kr 회원>연계정보 메뉴에서 등록해주세 요."}

- 33 -

2. 개발자 가이드

서버 상태 체크 조회 상세 정의

서버 유효 상태 체크
- 처방S/W에서 의료용 마약류 빅데이터활용서비스(data.nims.or.kr) 서비스가 유효한지 체크
병·의원 처방SW(EMR,OCS)에서 환자의 마약류 투약내역 조회 기능 구현 예시
- 병·의원 처방SW의 처방화면에서 ‘마약류 투약내역 조회’ 버튼 클릭으로 환자의 마약류 투약내역
  을 확인할 수 있습니다.
예시) 병원/의원 SW(EMR,OCS)의 처방화면
□ 환자 처방 마약류 투약내역 조회

https://data.nims.or.kr
비밀번호 재확인 및 환자에게 고지 확인

※ 연계인증을 통한 조회 시 비밀번호 재확인만으로 간편조회 결과를 표시합니다. ( 간편비밀번호 사용 가능 )

https://testdata.nims.or.kr
투약내역 조회 및 주의환자 제보

- 35 -

2. 개발자 가이드
WebBrowser Version 관리
- Visual Studio, C#에서 기본 제공하는 WebBrowser 컴포넌트는 구 버전인 Internet Explorer7 엔진
  을 사용 하므로, 차세대 웹 기술인 HTML5 또는 Google map v3 최신 버전 등을 지원하지 못하는
  문제가 발생할 수 있음
- 참고 사이트
- WebBrowser Vision 변경
  : https://okgood0412.tistory.com/entry/C-WebBrowser-version-%EB%B3%80%EA%B2%BD
- C# WebBrowser 설정 방법
: https://akinokaze.tistory.com/165

- Visual Basic 설정 방법
: https://zenix.tistory.com/6
- 36 -

연계 개발 가이드 참고 자료

참고1
의사 개별 및 대표자 회원가입

참고2

병원/의원 SW 의사 인증키 등록 관리

참고3

인증키 발급 및 연계 테스트 방법

- 37 -

참고1

1. 의사 개별 회원가입 방법
마약류 의료쇼핑 방지 정보망 홈페이지 접속
1. 마약류 의료쇼핑 방지 정보망 홈페이지(https://data.nims.or.kr)을 통해
대표자 회원가입을 진행합니다.

- 38 -

참고1
1. 의사 개별 회원가입 방법
회원가입 방법
- 39 -
1. 마약류 의료쇼핑 방지 정보망 홈페이지에 접속하여 ‘회원가입’을 진행합니다. ‘약관동의’를 읽어본
  후 ‘동의합니다’를 선택합니다.
참고1

1. 의사 개별 회원가입 방법
회원가입 방법(기존 NIM 대표계정이 있는 경우)
3-1-1. 사용자 구분(NIMS 기존 가입 기관)을 선택합니다.

- 40 -

참고1

1. 의사 개별 회원가입 방법
회원가입 방법(의사용, 치과의사용 휴대폰 본인인증)
3-1-2. 기존 NIMS 대표계정으로 로그인을 시도하세요.

- 41 -

참고1
참고1

1. 의사 개별 회원가입 방법
회원가입 방법(기존 NIM 대표계정이 없는 경우)
3-2.
① 사용자 구분(NIMS 미 가입 기관)을 선택합니다.
② 찾기 업체(기관) 검색’ 팝업창을 띄운 후 검색 영역에서 검색 후 나오는 목록에서 원하는 기관을
‘더블 클릭’하여 선택합니다
③ ‘휴대폰 본인인증’ 버튼을 클릭하여 본인인증을 진행 합니다

1

2

3

- 42 -

참고1

1. 의사 개별 회원가입 방법
회원가입 방법
4. 업체(기관) 정보를 확인합니다.

- 43 -

참고1

1. 의사 개별 회원가입 방법
회원가입 방법
5. 항목 입력 후 ‘가입합니다’ 버튼을 클릭합니다.

- 44 -

참고1

1. 의사 개별 회원가입 방법
회원가입 방법
6. 가입 신청이 완료되♘고 관리자 승인을 기다립니다.

- 45 -

참고2

1. 병원/의원 SW 의사 인증키 등록 관리
의료용마약류 빅데이터활용서비스 접속
1. 의료용마약류 빅데이터활용서비스 테스트 서버(testdata.nims.or.kr) 접속
2. 마약류통합정보관리센터에서 발급·제공한 테스트 계정으로 ‘아이디로그인’을 통해 접속
- 46 -

참고2

1. 병원/의원 SW 의사 인증키 등록 관리
연계 정보 인증키 발급을 위한 본인인증
1. 회원 메뉴에 연계정보 암호화/인증키 메뉴 접속
2. 해당 아이디의 비밀번호를 입력하여 인증
- 47 -

참고2

1. 병원/의원 SW 의사 인증키 등록 관리
연계 정보 인증키 발급
1. Key 재발급 및 추가 버튼을 사용하여 Key 발급

- 48 -

참고2

1. 병원/의원 SW 의사 인증키 등록 관리
[병의원 S/W] 병원 기준 연계 정보 인증키 등록
1. 발급 받은 인증키를 병의원 S/W에 등록하여 모든 API에 파라미터로 전송

- 49 -

참고3

1. 인증키 발급 및 연계 테스트 방법
의료용마약류 빅데이터활용서비스 접속
1. 의료용마약류 빅데이터활용서비스 테스트 서버(testdata.nims.or.kr) 접속
2. 마약류통합정보관리센터에서 발급·제공한 테스트 계정으로 ‘아이디로그인’을 통해 접속
- 50 -

참고3

1. 인증키 발급 및 연계 테스트 방법
연계정보 확인 및 연계 테스트
1. 회원 > ‘연계정보:암호화/인증 키’ 클릭
2. 로그인 비밀번호로 재인증 후 확인
- 51 -

참고3

1. 인증키 발급 및 연계 테스트 방법
연계정보 확인 및 연계 테스트
1. 간편 비밀번호 설정 및 연계정보(인증키, 암호화키) 확인
  1. 간편비밀번호 설정 후 저장
- 간편 비밀번호는 연계SW에서 환자의 마약류 투약내역 조회 API를 호출 시 의사 인증을 위해 사용
되며, 간편 비밀번호 미설정 시 로그인ID에 대한 패스워드로 대체됩니다.

- 52 -

참고3

1. 인증키 발급 및 연계 테스트 방법
연계정보 확인 및 연계 테스트
1. 병원/의원 처방SW 연동테스트
  1. 파라미터 및 환자식별번호 확인 후 > ‘결과보기’ > ‘화면보기’ 클릭
  2. 비밀번호(간편비밀번호) 입력 및 ‘환자에게 고지여부 확인‘ 선택 후 확인
    
    - 53 -
    
    참고3
    
    1. 인증키 발급 및 연계 테스트 방법
연계정보 확인 및 연계 테스트