260618 메딕스 외부 약국관리 허들
2026년 6월 18일 공유
약국 관리 등록 로직 및 API 연동 회의
개요
콘텐츠 유형: 회의
약국 관리 화면의 등록 방식, 심평원/국세청 API 연동 구조, 사업자번호 기반 검증 방식, 원내약국 분류 로직, 그리고 일부 EDI/흡수율 조회 요구사항을 논의했다.
핵심 쟁점은 약국 정보를 어떤 API에서 어떤 기준값으로 조회할지, 그리고 약국/병원/도매 사업자를 어떻게 정확히 구분할지였다.
참여자 및 역할
SPEAKER_1: 회의 진행, 기능/화면 설계 설명
- SPEAKER_2: 업무 요구사항 상세 설명, 운영 관점 검토
SPEAKER_3: 추가 요구사항 및 보완 포인트 제시
- SPEAKER_4: 사업자번호 기반 조회 정확성 관련 의견 제시
SPEAKER_5: 백엔드/API 확인 사항 공유
- SPEAKER_6: UI 동작 방식 설명
결정 사항
- 약국 관리 화면은 우선 약국 기본정보 중심으로 단순 구성한다.
- 약국 조회 시 약국명 + 지역으로 검색한 뒤, 목록에서 선택하는 방식이 기본안이다.
- 검색 결과가 많을 수 있으므로, 조회 결과 내 주소 키워드 필터를 추가하는 방향으로 검토한다.
정식명칭은 필수값으로 처리한다.
- 내부명칭은 정식명칭을 자동 복사해 기본 입력되도록 한다.
원내약국 여부는 병원 등록 시 수동 지정하는 방식이 아니라, 이후 매출 데이터 처리 과정에서 병원 사업자와 동일 사업자가 확인될 때 분류하는 방향으로 이해를 정정했다.
- 약국 관리 화면에 병원별 흡수율 필드를 추가하는 것은 현재 요구사항이 아님으로 정리됐다.
- 메뉴 논의는 이번 회의에서 마무리하지 않고 추후 별도 진행하기로 했다.
액션 아이템
심평원 API 재확인
- 사업자번호로 약국/요양기관/도매 여부 확인이 가능한지 검토
- 폐업 여부 및 폐업일 제공 여부 확인
- 약국명+지역 조회와 사업자번호 조회가 각각 어떤 API로 가능한지 정리
백엔드 검토
- 심평원 API만으로 필요한 검증이 모두 가능하면 국세청 조회를 최소화할 수 있는지 검토
- 불가능할 경우 국세청 + 심평원 이중 조회 구조 유지
자료 재공유
- 기존에 공유했던 심평원 API 종류/명세를 다시 전달
후속 회의 일정
- 월요일 오후 2시 온라인 미팅 진행
- 논의 대상: 병의원, 품목, 구매업체 마스터
- EDI, 흡수율, 인센티브 관리 등은 다음 주 별도 논의 예정
논의 내용
1. 약국 관리 기본 항목
약국 관리에서 다루는 주요 정보는 다음과 같다.
대표자명
- 정식명칭
내부명칭
- 사업자번호
개업/폐업 상태
- 연락처
주소
- 좌표(XY)
원내약국 여부
추가로 폐업일자도 중요 정보이므로, API에서 제공 가능한지 확인하기로 했다.
2. 약국 검색 및 등록 방식
약국 등록 시 병원 주문과 연결되기 위해서는 약국 식별이 정확해야 하며, 현재 구상은 다음과 같다.
- 사용자가 약국명과 지역을 입력
- 해당 조건으로 심평원 데이터 조회
- 조회된 목록에서 정확한 약국을 선택
- 선택 후 다음 정보 자동 반영:
- 주소
- 연락처
- 좌표(XY)
- 기타 약국 기본정보
이 방식이 필요한 이유는 같은 이름의 약국이 여러 지역에 존재할 수 있기 때문이다.
검색 보완 요구
시/도 단위만으로는 결과가 너무 많을 수 있어, 조회된 결과 안에서 다음과 같은 추가 필터링 기능이 필요하다는 의견이 나왔다.
- 주소 내 특정 키워드 검색
- 예: 역삼, 동 이름 등
지역만으로 거르는 방식은 실효성이 낮을 수 있어, 결과 목록 내 주소 필터가 더 유용하다.
3. 심평원과 국세청 API 역할 분리
회의의 핵심 쟁점은 어떤 API에서 무엇을 검증할지였다.
현재 이해된 구조
국세청
- 사업자번호 기준 조회
- 유효한 사업자인지
- 개업/폐업 상태
- 가능하면 폐업일자
심평원
- 약국/요양기관 관련 상세 정보 조회
- 약국명, 주소, 전화번호, XY 좌표
- 사업자번호가 실제 약국 관련 사업자인지 확인 가능성 검토
논의된 핵심 포인트
- 단순히 국세청에서 정상 사업자로 확인되었다고 해도, 그 사업자가 약국 사업자라는 보장은 없다.
- 예를 들어 도매업체 사업자번호를 입력해도 국세청에서는 정상 사업자로 보일 수 있다.
- 따라서 최종적으로는 심평원에서 약국 여부를 판별하는 검증이 중요하다.
방향성
가능하다면 다음 구조가 가장 적절하다는 의견이 나왔다.
1.심평원에서 사업자번호 기준 조회*
2. 해당 번호가 실제 약국/요양기관/도매 관련 대상인지 확인
3. 약국일 경우 주소, 연락처, 좌표 등 상세정보 반영
4. 폐업 여부까지 심평원에서 제공되면 국세청 조회를 생략하거나 축소
반대로 심평원 API가 이를 충분히 지원하지 않으면:
- 국세청에서 사업자 유효성 및 폐업 여부 확인
- 심평원에서 약국 상세정보 별도 조회
즉, 최종 구조는 심평원 API의 실제 제공 범위 확인 결과에 따라 결정된다.
4. 사업자번호 기반 조회 필요성
사업자번호 기반 조회가 중요한 이유는 다음과 같다.
- 잘못된 사업자번호 입력 방지
- 도매업체 번호, 타 기관 번호 입력 방지
- 중복 등록 방지
- 특정 약국과 사업자번호의 정확한 매칭 보장
일부 운영 방식에서는 현재도 사업자번호 기준 조회가 더 정확하다고 보고 있으며, API에서도 가능하다면 사업자번호 기준 조회가 우선이라는 의견이 제시됐다.
또한 심평원 API가 실제로는 하나가 아니라, 목적에 따라 다음처럼 복수 API로 구성되어 있을 가능성이 언급됐다.
- 상세 정보 조회용 API
- 사업자번호로 기관 성격을 확인하는 API
이 부분은 다시 명세를 받아 확인하기로 했다.
5. 정식명칭과 내부명칭 처리 방식
업체 마스터와 유사하게 약국도 다음 원칙으로 처리한다.
- 정식명칭: 필수 입력
- 내부명칭: 기본적으로 정식명칭을 자동 반영
UI 동작 방식
- 사용자가 정식명칭 입력
- 입력 포커스가 벗어나는 시점에
- 내부명칭 칸에 동일한 값 자동 입력
이후 필요하면 사용자가 내부명칭을 직접 수정할 수 있다.
즉, 내부명칭을 반드시 따로 입력하지 않아도 등록은 가능하되, 등록 전 원하는 값으로 수정할 수 있는 구조다.
6. 대표자명 입력 방식
대표자명은 API에서 불러올 수 있으면 자동 반영하고,
불러올 수 없는 경우에만 수기 입력하는 방향으로 논의됐다.
이 로직은 병원 등록 시에도 유사하게 적용할 수 있다.
7. 원내약국 분류 로직 정정
초기에는 병원 등록 시 사용자가 원내약국 여부를 선택하고, 그에 따라 약국을 자동 생성하는 방식으로 이해하고 있었다.
그러나 실제 업무 프로세스는 다르다는 점이 확인됐다.
실제 업무 로직
- 병원 등록 시점에는 해당 병원이 원내약국 납품 구조인지 알 수 없음
- 이후 도매 매출자료 처리 과정에서
- 병원 사업자와 동일한 사업자 정보가 확인되면
- 그때 원내약국으로 분류
즉, 원내약국은 사전 수동 설정값이 아니라,
매출 데이터와 사업자 일치 여부를 기반으로 후행 판단되는 개념이다.
8. EDI / 흡수율 관련 요구사항 정리
약국 관리 화면 자체에 병원별 흡수율을 넣는 요구는 아닌 것으로 정리됐다.
혼선이 있었던 실제 요구사항은 EDI 조회 / 도매 매출 조회 / 흡수율 조회 화면에서의 연결 조회 기능에 가깝다.
논의된 요구 방향
- 흡수율 조회
- 병원을 기준으로 조회하면 제품별로
- 처방액
- 출고액
- 흡수율 이 보이는 구조
- 도매 매출 조회
- 병원을 넣었을 때 특정 제품의 출고액이
- 어떤 거래/내역으로 구성되는지 세부 조회 필요
- EDI 조회
- 기존에는 병원 기준 조회
- 향후에는 특정 약국 기준으로, 그 약국에 연결된 여러 병원의 처방 내역을 묶어서 조회하는 기능 필요 가능성 제기
즉, 핵심은 약국 기준으로 연결 병원 데이터를 집계하거나 세부 내역을 조회하는 기능이며, 이는 약국 마스터 필드 추가 문제가 아니라 리포트/조회 화면 설계 이슈에 해당한다.
이 부분은 이번 회의에서 결론 내지 않고, 다음 주 EDI/흡수율 관리 논의 때 다시 상세 검토하기로 했다.
9. 후속 일정
다음 회의는 월요일 오후 2시에 온라인으로 진행한다.
다음 회의 예정 주제
- 병의원 마스터
- 품목 마스터
- 구매업체 마스터
추가로 다음 주에는 아래 주제들도 별도로 논의할 예정이다.
- EDI
- 흡수율 관리
- 인센티브 관리