시작하기

KPIS DSR API는 의약품 도매상의 공급내역 보고 업무를 자동화하는 시스템입니다. 엑셀 파일을 업로드하면 자동으로 표준코드를 매핑하고, 데이터를 검증한 뒤, KPIS (의약품관리종합정보센터) OpenAPI를 통해 공급내역을 보고할 수 있습니다.

시스템 개요

의약품 도매상은 분기마다 KPIS 포털에 공급내역(갑지/을지)을 보고해야 합니다. 기존에는 수천 건의 데이터를 수작업으로 입력하거나 엑셀 파일을 직접 업로드해야 했으며, 오류 발생 시 반송과 재작업이 빈번했습니다.

이 시스템은 다음 과정을 자동화합니다.

1. 엑셀 파일 업로드 및 날짜 자동 추출
2. 제품명 기반 표준코드 자동 매핑 (5단계 필터 체인)
3. 사용자 정의 규칙에 따른 일괄 데이터 수정
4. 3단계 유효성 검증 (필수값 → 형식 → 비즈니스 규칙)
5. KPIS API를 통한 자동 제출 및 결과 확인
6. 반송 건 자동 감지 및 재제출 지원

사용자 역할

시스템에는 두 가지 역할이 있습니다.

주의: 최초 로그인 시 관리자 승인이 필요합니다. 첫 번째 가입자는 자동으로 관리자 역할이 부여됩니다.

로그인

1. 웹 브라우저에서 시스템 주소에 접속합니다.
2. Google 계정으로 로그인 버튼을 클릭합니다.
3. Google 계정으로 인증을 완료합니다.
4. 최초 로그인 시 승인 대기 화면이 표시됩니다. 관리자가 사용자관리에서 승인하면 서비스를 이용할 수 있습니다.

주의: 인증이 비활성화된 환경에서는 로그인 없이 바로 접속됩니다. 이 경우 모든 사용자가 관리자 권한을 갖습니다.

지원 브라우저

Chrome 또는 Edge를 사용하면 바탕화면의 지정 폴더에 엑셀 파일을 직접 저장할 수 있어 업무 효율이 높아집니다.

화면 구성

사이드바 메뉴

사이드바는 5개 그룹으로 구성되어 있습니다. 좌측 상단 햄버거 버튼으로 아이콘 모드로 축소할 수 있습니다.

공급구분 탭과 현황 카드는 해당 날짜에 데이터가 있을 때만 표시됩니다. 각 탭 우측의 배지 숫자는 해당 공급구분의 행 수를 나타냅니다.

주의: LIVE 모드일 때 사이드바 상단에 빨간색 “LIVE 운영 서버” 경고 스트라이프가 표시됩니다. LIVE 모드에서는 실제 KPIS 운영 서버에 데이터가 전송되므로 주의가 필요합니다.

상단 헤더 (PageHeader)

데이터 편집 화면의 상단 헤더에는 다음 요소가 표시됩니다.

배지 카운터

사이드바와 헤더에 표시되는 배지 카운터의 의미는 다음과 같습니다.

미보고 날짜 배너

앱 상단에 미보고 또는 부분보고 날짜 목록이 표시됩니다. 날짜를 클릭하면 해당 날짜로 이동합니다. 보고가 불필요한 날짜는 무시 버튼으로 배너에서 제외할 수 있습니다.

핵심 용어

기본 워크플로우

전체 업무 흐름은 다음과 같습니다.

1. 로그인 (Google OAuth, 관리자 승인)
     ↓
2. 대시보드에서 보고 현황 확인
     ↓
3. 상단 달력에서 날짜 선택
     ↓
4. 파일 업로드 (갑지 + 을지 엑셀)
     ↓  자동: 코드매핑 + 마스터매칭 + 규격보정 + 규칙 적용
5. DataGrid에서 데이터 확인 및 편집
     ↓  규칙관리, 코드검색, 규격검증
6. 검증 오류 해결 (하단 검증 바 확인)
     ↓
7. 내보내기 (수동보고) 또는 API 제출 (자동보고)
     ↓
8. 결과 확인 (MA112)
     ├→ 등록 완료 → 대시보드 보고율 반영
     └→ 반송 발생 → 반송 관리에서 수정 후 재제출

다음 단계

• 대시보드 — 월간 보고 현황 및 통계 확인
• 파일 업로드 — 갑지/을지 엑셀 업로드 및 자동 처리
• 데이터 편집 — DataGrid에서 데이터 편집