내보내기 및 제출

검증을 마친 공급내역 데이터를 KPIS에 제출하는 두 가지 방법(수동보고/자동보고)을 안내합니다.

수동보고: 엑셀 내보내기

KPIS 포털에 직접 업로드하려는 경우, 가공된 데이터를 엑셀 파일로 내보냅니다.

내보내기 절차

1. 데이터 편집 화면에서 상단 헤더의 내보내기 버튼을 클릭합니다.
2. 활성화된 배치 규칙이 최종 1회 적용됩니다.
3. 갑지 파일이 생성됩니다.
4. 을지 데이터가 있으면 을지 파일도 함께 생성됩니다.
5. 브라우저의 다운로드 폴더(또는 지정 폴더)에 파일이 저장됩니다.

내보내기 파일 형식

생성되는 파일명과 구성은 다음과 같습니다.

내보내기는 순수 읽기 작업입니다. DB에 저장된 데이터에 영향을 주지 않습니다.

텍스트 형식 보존

엑셀로 내보낼 때 다음 열은 텍스트 형식으로 저장됩니다. 이는 엑셀이 숫자로 자동 변환하여 선행 0이 사라지거나, 지수 표기(8.80666E+12)로 바뀌는 문제를 방지합니다.

공급규격, 수량, 단가는 소수점 첫째 자리에서 반올림하여 저장됩니다.

내보내기 폴더 설정 (Chrome/Edge)

Chrome 또는 Edge에서는 바탕화면에 지정 폴더를 설정하여 파일을 직접 저장할 수 있습니다.

최초 설정 절차

1. 사이드바 도구 그룹에서 내보내기 폴더를 클릭합니다.
2. 폴더 선택 다이얼로그에서 바탕화면을 선택합니다.
3. KPIS의약품공급내역보고 폴더가 자동으로 생성됩니다.
4. 이후 내보내기 시 해당 폴더에 파일이 직접 저장됩니다.

폴더 변경 또는 해제

1. 사이드바에서 내보내기 폴더를 다시 클릭합니다.
2. 확인을 누르면 새 폴더를 선택할 수 있습니다.
3. 취소를 누르면 설정이 해제되고 기본 다운로드 폴더로 돌아갑니다.

주의: 브라우저를 재시작한 후 첫 내보내기 시 폴더 접근 권한 확인 팝업이 표시될 수 있습니다. Chrome 122 이상에서는 매번 허용을 선택하면 이후 팝업이 표시되지 않습니다. Firefox와 Safari에서는 이 기능이 지원되지 않습니다.

KPIS 포털 업로드 (수동보고)

내보낸 엑셀 파일을 KPIS 포털에 직접 업로드하는 절차입니다.

1. KPIS 포털(https://www.kpis.or.kr)에  공동인증서로 로그인합니다.
2. 공급내역 보고 메뉴에서 엑셀 업로드를 선택합니다.
3. 갑지 파일과 을지 파일을 각각 업로드합니다.
4. 제출 후 결과를 확인합니다.

자동보고: KPIS API 제출

시스템에서 KPIS OpenAPI를 통해 직접 제출하는 방식입니다. 수동 업로드 없이 버튼 클릭으로 완료됩니다.

사전 조건

자동보고를 사용하려면 다음 조건이 모두 충족되어야 합니다.

주의: 공동인증서가 만료되었거나 미등록이면 제출 버튼이 비활성화됩니다. 인증서 만료 30일 전부터 대시보드에 경고 배너가 표시됩니다.

API 제출 4단계

상단 헤더의 API제출 버튼(종이비행기 아이콘)을 클릭하면 제출 다이얼로그가 열립니다.

1단계: 준비 (MA111)

1. 제출 범위를 선택합니다 (전체 탭 또는 특정 공급구분).
2. 제출 건수 및 요약 정보를 확인합니다.
3. 현재 DEV/LIVE 서버 환경을 확인합니다.
4. 제출(N건) 버튼을 클릭합니다.
5. 확인 다이얼로그에서 서버 환경을 한 번 더 확인하고 승인합니다.

2단계: 제출 (MA111 일괄 등록)

1. 시스템이 MA111 (공급내역 정보 직접 등록) API를 호출합니다.
2. 서버가 공동인증서를 로드하고 JWT 토큰을 발급받습니다.
3. 각 행이 100ms 간격으로 KPIS 서버에 전송됩니다 (Rate Limiting).
4. 우측 하단 플로팅 카드에 진행 상황이 실시간으로 표시됩니다.
5. 각 행 제출 성공 시 접수번호(Q열)가 즉시 반영됩니다.

진행 중에 제출 중단 버튼을 클릭하면 남은 건의 전송을 즉시 중단할 수 있습니다. 이미 접수된 건은 유지됩니다.

3단계: 결과 확인 (MA112)

1. 제출 완료 5초 후 시스템이 자동으로 MA112 (결과 조회) API를 호출합니다.
2. 결과확인(N건) 버튼으로 수동 조회도 가능합니다.
3. 각 건별로 처리 상태가 업데이트됩니다.

KPIS 서버의 처리 시간에 따라 결과 조회까지 시간이 소요될 수 있습니다. 접수 직후에는 submitted 상태이며, 일정 시간 후 registered 또는 returned로 변경됩니다.

4단계: 반송 처리 (MA113 / MA114)

반송(returned) 건이 발생한 경우 두 가지 처리 방법이 있습니다.

방법 1: 데이터 수정 후 재제출

1. 반송 관리에서 반송 코드를 확인합니다.
2. 해당 필드를 수정합니다.
3. 접수번호를 초기화하고 다시 MA111로 제출합니다.

방법 2: 반송신청 (MA113)

1. 결과확인 화면에서 반송 건을 선택합니다 (체크박스).
2. 반송신청(N건) 버튼을 클릭합니다.
3. 시스템이 MA113 (반송신청 직접 등록) API를 호출합니다.
4. 반송접수번호가 발급됩니다.
5. 상태갱신(MA114) 버튼으로 처리 상태를 확인합니다.

DEV/LIVE 서버 주의사항

주의: DEV 서버에서 제출한 데이터는 실제 KPIS에 반영되지 않습니다. 업무용 제출은 반드시 LIVE 모드로 전환한 후 진행해야 합니다. 반대로, 테스트 목적의 제출은 반드시 DEV 모드에서 진행해야 합니다. DEV 키로 LIVE 서버를 호출하거나 그 반대는 인증 오류가 발생합니다.

제출 상태 요약

전체 데이터의 제출 현황은 사이드바의 달력과 대시보드에서 날짜별로 확인할 수 있습니다.

다음 단계

• 반송 관리 — 반송 건 확인 및 재제출
• 관리자 기능 — API 설정, 공동인증서 등록
• 파일 업로드 — 엑셀 업로드 및 자동 처리