관리자 기능

관리자 역할이 부여된 계정에서만 접근할 수 있는 기능입니다. API 설정, 마스터 DB 관리, 사용자 관리, 데이터 관리, 휴일 관리, 활동 로그를 포함합니다.

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

API 설정

사이드바 도구 그룹의 API 설정을 클릭하면 API 설정 다이얼로그가 열립니다. KPIS API 연동에 필요한 인증 정보를 등록하고 관리합니다.

공동인증서 탭

KPIS API 등록(MA111~MA114) 시 전자서명에 사용되는 공동인증서를 관리합니다.

인증서는 서버에 AES-256으로 암호화하여 보관됩니다.

주의: 공동인증서가 만료되면 KPIS API 자동 제출이 불가능합니다. 만료 전에 반드시 새 인증서를 등록하세요. KPIS 전용 공동인증서(용도제한)를 사용해야 하며, 범용 공동인증서는 사용할 수 없습니다.

DEV API 탭

개발/테스트 환경용 KPIS API 설정입니다.

연결 테스트 성공 시 초록색 점이 표시됩니다.

LIVE API 탭

운영 환경용 KPIS API 설정입니다. DEV API 탭과 동일한 구조이며, 운영용 사업자등록번호와 API KEY를 등록합니다.

주의: LIVE 환경의 API KEY로 제출하면 실제 KPIS에 보고됩니다. 테스트 데이터를 LIVE 환경에 제출하지 않도록 주의하세요.

DEV/LIVE 환경 전환

사이드바 하단의 DEV/LIVE 배지를 클릭하여 환경을 전환할 수 있습니다.

LIVE 모드로 전환 시 경고 다이얼로그가 표시되며, 사이드바 상단에 빨간색 “LIVE 운영 서버” 경고 스트라이프가 표시됩니다.

주의: DEV 키로 LIVE 서버를 호출하거나 그 반대는 인증 오류가 발생합니다. 환경 전환 시 반드시 해당 환경의 API KEY가 등록되어 있는지 확인하세요.

마스터 DB 관리

사이드바 도구 그룹의 마스터 DB를 클릭하면 마스터 데이터 관리 다이얼로그가 열립니다. 표준코드 매칭, 규격 검증, 코드검색에 사용되는 기준 데이터를 관리합니다.

표준코드 마스터

KPIS 13자리 의약품 식별코드 데이터입니다. 두 가지 방법으로 등록할 수 있습니다.

방법 1: KPIS API 조회 (MA101)

1. 마스터 DB 패널에서 API 조회 버튼을 클릭합니다.
2. KPIS MA101 API를 호출하여 최신 표준코드 데이터를 가져옵니다.
3. 기존 데이터와 병합됩니다.

방법 2: 엑셀 업로드

1. 마스터 DB 패널에서 엑셀 업로드 버튼을 클릭합니다.
2. 표준코드마스터 엑셀 파일을 선택합니다.
3. 파일의 데이터가 마스터 DB에 등록됩니다.

바코드 데이터

BarCodeData 엑셀을 업로드하여 규격, 업체명, 제형 등 추가 정보를 등록합니다. 바코드 데이터는 자동 코드매핑의 필터 체인에서 제형구분, 포장수량 등의 비교에 활용됩니다.

검색

등록된 마스터 데이터를 제품명 또는 표준코드로 검색할 수 있습니다. 검색 결과에서 각 제품의 포장수량, 상한가, 규격, 제형 등의 상세 정보를 확인할 수 있습니다.

주의: 마스터 DB가 비어있거나 오래된 데이터만 있으면 자동 코드매핑의 매칭률이 크게 떨어집니다. 분기 보고 시작 전에 최신 데이터로 업데이트하는 것을 권장합니다.

사용자 관리

사이드바 도구 그룹의 사용자관리를 클릭하면 사용자 관리 다이얼로그가 열립니다. Google OAuth 인증이 활성화된 환경에서만 표시됩니다.

사용자 목록

등록된 모든 사용자가 목록으로 표시됩니다. 각 사용자의 이메일, 역할, 승인 상태를 확인할 수 있습니다.

관리 기능

주의: 최초 가입자는 자동으로 관리자 역할이 부여됩니다. 관리자가 최소 1명은 유지되어야 합니다.

데이터 관리

사이드바 도구 그룹의 데이터 관리를 클릭하면 관리 화면(AdminView)으로 이동합니다.

날짜별 데이터 집계

날짜별로 업로드된 데이터의 요약 정보가 테이블로 표시됩니다.

관리 기능

주의: 삭제는 복구할 수 없습니다. 이미 KPIS에 제출한 건이 포함된 날짜를 삭제하더라도 KPIS 서버의 보고 내역은 유지됩니다. KPIS 보고를 취소하려면 삭제가 아닌 취소(코드 5) 제출이 필요합니다.

휴일 관리

사이드바 도구 그룹의 휴일 관리를 클릭하면 휴일 관리 다이얼로그가 열립니다.

기능

활용

• 달력의 날짜 색상 점에 영업일/휴일 구분이 반영됩니다.
• 미보고 날짜 배너에서 휴일은 자동으로 제외됩니다.
• 보고율 계산에서 휴일은 제외됩니다.

활동 로그

상단 헤더의 활동 로그 버튼(벨 아이콘)을 클릭하면 활동 로그 다이얼로그가 열립니다.

기록되는 활동

시스템의 주요 활동이 자동으로 기록됩니다.

활동 로그는 시간순으로 정렬되며, 각 항목에 발생 시각과 상세 내용이 표시됩니다.

다음 단계

• 시작하기 — 시스템 개요 및 화면 구성
• 내보내기 및 제출 — API 설정 후 제출 절차
• 반송 관리 — 반송 건 처리