# 약국 POS DB 구조 - 제품/입고/판매/마진 > **분석일**: 2026-03-13 > **DB**: PM_DRUG, PM_PRES (MSSQL, 192.168.0.4\PM2014) > **목적**: 입고 기록 없이 판매 시 마진이 0으로 나오는 문제 원인 파악 --- ## 1. 개요 약국 POS 시스템(PharmIT3000)은 크게 3개의 DB를 사용합니다: | DB명 | 용도 | 주요 테이블 | |------|------|------------| | **PM_DRUG** | 약품 마스터, 재고, 입고 | CD_GOODS, IM_total, WH_main/sub | | **PM_PRES** | 판매, 처방 | SALE_MAIN/SUB, PS_main/sub_pharm | | **PM_BASE** | 고객, 도매상 정보 | CD_PERSON, CD_custom | --- ## 2. 핵심 테이블 ### 2.1 제품 마스터 - PM_DRUG.CD_GOODS ```sql -- 핵심 컬럼 DrugCode NVARCHAR(20) -- 제품코드 (PK) GoodsName NVARCHAR(80) -- 제품명 BARCODE NVARCHAR(20) -- 대표 바코드 Price DECIMAL -- 입고가 (매입가) ⭐ 마진 계산의 핵심 Saleprice DECIMAL -- 판매가 SUNG_CODE NVARCHAR(9) -- 성분코드 POS_BOON NVARCHAR(6) -- 분류 (010103=동물약) GoodsSelCode NVARCHAR(2) -- 사용여부 (B=사용, !=미사용) ``` ### 2.2 바코드 매핑 #### CD_BARCODE - 표준코드 ↔ 바코드 매핑 ```sql BARCODE NVARCHAR(20) -- 바코드 BASECODE NVARCHAR(10) -- 표준코드 (EDI 코드) DRUGCODE NVARCHAR(10) -- 제품코드 TITLECODE NVARCHAR(20) -- 대표코드 ``` #### CD_ITEM_UNIT_MEMBER - 단위별 바코드 (낱개/박스) ```sql DRUGCODE NVARCHAR(20) -- 제품코드 CD_CD_UNIT NVARCHAR(3) -- 단위코드 CD_NM_UNIT REAL -- 단위수량 CD_CD_BARCODE NVARCHAR(20) -- 단위 바코드 ⭐ APC 코드 (02로 시작) CD_MY_UNIT DECIMAL -- 단위가격 ``` > **APC 코드**: `02`로 시작하는 13자리 바코드 = 동물약 식별 코드 > 예: CD_ITEM_UNIT_MEMBER에서 `CD_CD_BARCODE LIKE '02%'` ### 2.3 재고 테이블 #### IM_total - 현재 재고 ```sql DrugCode NVARCHAR(12) -- 제품코드 IM_QT_sale_debit FLOAT -- 현재 재고 수량 ``` #### IM_date_total - 일별 재고 변동 ```sql IM_DT_appl NVARCHAR(8) -- 날짜 (YYYYMMDD) DrugCode NVARCHAR(12) -- 제품코드 IM_QT_sale_credit DECIMAL -- 입고량 im_qt_sale_debit DECIMAL -- 출고량 ``` ### 2.4 입고 테이블 (PM_DRUG) #### WH_main - 입고 마스터 ```sql WH_NO_stock NVARCHAR(14) -- 입고번호 (PK) WH_DT_appl NVARCHAR(8) -- 입고일 (YYYYMMDD) WH_CD_cust_sale NVARCHAR(10) -- 도매상코드 (→ PM_BASE.CD_custom) WH_BUSINAME NVARCHAR(200) -- 도매상명 WH_MY_amount_t DECIMAL -- 입고 총액 ``` #### WH_sub - 입고 상세 ```sql WH_SR_stock NVARCHAR(14) -- 입고번호 (FK → WH_main) DrugCode NVARCHAR(20) -- 제품코드 WH_DT_appl NVARCHAR(8) -- 입고일 WH_NM_item_a DECIMAL -- 입고 수량 ⭐ WH_MY_unit_a DECIMAL -- 입고 단가 ⭐ WH_MY_amount_a DECIMAL -- 입고 금액 (수량 × 단가) WH_END_validity NVARCHAR(8) -- 유효기한 WH_LOT_NO NVARCHAR(20) -- LOT 번호 ``` ### 2.5 판매 테이블 (PM_PRES) #### SALE_MAIN - 판매 마스터 ```sql SL_NO_order NVARCHAR(14) -- 거래번호 (PK) SL_DT_appl NVARCHAR(8) -- 판매일 SL_CD_custom NVARCHAR(10) -- 고객코드 InsertTime DATETIME -- 등록시간 SL_MY_total DECIMAL -- 총액 SL_MY_sale DECIMAL -- 판매액 ⭐ SL_MY_sale_cost DECIMAL -- 원가 합계 ⭐ (마진 계산용) SL_MY_discount DECIMAL -- 할인액 ``` #### SALE_SUB - 판매 상세 ```sql SL_NO_order NVARCHAR(14) -- 거래번호 (FK) DrugCode NVARCHAR(20) -- 제품코드 SL_NM_item DECIMAL -- 판매 수량 SL_NM_cost_a DECIMAL -- 판매 단가 SL_TOTAL_PRICE DECIMAL -- 판매 금액 (수량 × 단가) INPRICE DECIMAL -- 입고가 ⭐⭐⭐ 마진 계산의 핵심! SL_MY_in_cost DECIMAL -- 입고 원가 (= INPRICE) SL_INPUT_PRICE DECIMAL -- 입력가격 BARCODE NVARCHAR(20) -- 판매 시 사용된 바코드 ``` --- ## 3. 제품/바코드 구조 ### 3.1 코드 체계 ``` 제품코드 (DrugCode) ├── 전문의약품: 9자리 숫자 (예: 652606580) ├── 일반의약품: 9자리 숫자 └── 자체등록: LB로 시작 (예: LB000003778) 바코드 종류 ├── 대표바코드: CD_GOODS.BARCODE ├── 단위바코드: CD_ITEM_UNIT_MEMBER.CD_CD_BARCODE ├── APC 코드: 02/92로 시작하는 13자리 (동물약) └── 표준코드: CD_BARCODE.BASECODE (EDI 연동용) ``` ### 3.2 바코드 조회 순서 ```sql -- 제품의 바코드 찾기 (우선순위) 1. CD_GOODS.BARCODE -- 대표 바코드 2. CD_ITEM_UNIT_MEMBER.CD_CD_BARCODE -- 단위 바코드 (낱개/박스) 3. CD_BARCODE.BARCODE -- 표준코드 매핑 ``` --- ## 4. 입고 흐름 ### 4.1 입고 기록 생성 ``` 도매상 발주 → 입고 등록 ↓ ┌─────────────┐ │ WH_main │ 입고 마스터 생성 │ (입고번호) │ - 도매상코드 └─────┬───────┘ - 입고일 │ ↓ ┌─────────────┐ │ WH_sub │ 입고 상세 생성 │ (품목별) │ - 제품코드 └─────┬───────┘ - 수량, 단가 ⭐ │ ↓ ┌─────────────┐ │ IM_total │ 재고 증가 └─────────────┘ ``` ### 4.2 입고 시 가격 업데이트 입고 처리 시 **CD_GOODS.Price** (입고가)가 업데이트될 수 있음: ```sql -- 최근 입고 단가로 CD_GOODS.Price 업데이트 (POS 설정에 따름) UPDATE CD_GOODS SET Price = (최근 입고 단가) WHERE DrugCode = ? ``` > **중요**: POS 설정에 따라 입고 시 자동 업데이트 여부가 결정됨 --- ## 5. 판매 흐름 ### 5.1 판매 기록 생성 ``` 바코드 스캔 → 판매 등록 ↓ ┌─────────────┐ │ SALE_MAIN │ 판매 마스터 생성 │ (거래번호) │ - 고객코드, 날짜 └─────┬───────┘ - 총액, 원가합계 (SL_MY_sale_cost) │ ↓ ┌─────────────┐ │ SALE_SUB │ 판매 상세 생성 (품목별) │ │ - 제품코드 │ │ - 판매가 (SL_NM_cost_a) │ │ - 입고가 (INPRICE) ⭐ └─────┬───────┘ │ ↓ ┌─────────────┐ │ IM_total │ 재고 감소 └─────────────┘ ``` ### 5.2 판매 시 INPRICE 설정 (핵심!) **판매 시 SALE_SUB.INPRICE는 CD_GOODS.Price에서 가져옴** ```sql -- 판매 등록 시 (POS 시스템 내부 로직 추정) INSERT INTO SALE_SUB ( SL_NO_order, DrugCode, SL_NM_item, SL_NM_cost_a, INPRICE, -- CD_GOODS.Price 값 사용 ... ) VALUES ( @거래번호, @제품코드, @수량, @판매단가, (SELECT Price FROM CD_GOODS WHERE DrugCode = @제품코드), ... ) ``` > **실제 확인 결과**: SALE_SUB.INPRICE ≈ CD_GOODS.Price (99% 일치) --- ## 6. 마진 계산 로직 ### 6.1 거래별 마진 계산 ```sql -- SALE_MAIN에서 마진 계산 마진액 = SL_MY_sale (판매액) - SL_MY_sale_cost (원가합계) 마진율 = (판매액 - 원가합계) / 판매액 × 100 -- SL_MY_sale_cost 계산 (내부 로직) SL_MY_sale_cost = SUM(SALE_SUB.INPRICE × SALE_SUB.SL_NM_item) -- 입고가 × 판매수량의 합계 ``` ### 6.2 품목별 마진 계산 ```sql -- SALE_SUB에서 품목별 마진 품목_마진 = SL_TOTAL_PRICE - (INPRICE × SL_NM_item) = 판매금액 - (입고가 × 수량) ``` ### 6.3 마진 계산 예시 ``` 거래 20260313000076: ├── 판매액: 64,500원 ├── 원가: 31,650원 ← SALE_SUB.INPRICE 합계 ├── 마진: 32,850원 └── 마진율: 50.9% ``` --- ## 7. 문제점: 입고 없이 판매 시 마진 0 ### 7.1 문제 원인 **INPRICE = 0이 되는 경우:** 1. **CD_GOODS.Price가 0 또는 NULL인 경우** - 제품 등록 시 입고가를 설정하지 않음 - 입고 기록 없이 제품만 등록 2. **POS 시스템 특수 케이스** - 일부 상황에서 INPRICE가 0으로 설정됨 - (정확한 조건은 POS 내부 로직에 따름) ### 7.2 실제 데이터 분석 (2026-03-13 기준) ``` 최근 1개월 판매 건수: 1,767건 ├── INPRICE > 0: 1,749건 (98.98%) └── INPRICE = 0: 18건 (1.02%) ← 마진 0 문제 발생! ``` ### 7.3 INPRICE=0 사례 분석 | 제품코드 | 제품명 | CD_GOODS.Price | SALE_SUB.INPRICE | 입고기록 | |----------|--------|----------------|------------------|----------| | LB000003658 | 수리팍(제로슈거) | 1,450 | **0** | 있음 | | LB000003575 | 알파플러스정 | 1 | **0** | 있음 | | LB000001822 | 헤파토스시럽 | 1,613 | **0** | 있음 | > **특이사항**: 입고 기록이 있고 CD_GOODS.Price도 있는데 INPRICE=0인 경우 존재 > → POS 특수 상황에서 발생 (추가 조사 필요) ### 7.4 해결 방안 #### 방안 1: 제품 등록 시 입고가 필수 입력 ```sql -- 제품 등록 시 Price 필수 체크 IF Price IS NULL OR Price = 0 THEN ERROR '입고가를 입력하세요' ``` #### 방안 2: 판매 전 입고 기록 확인 ```sql -- 판매 시 입고 기록 확인 IF NOT EXISTS (SELECT 1 FROM WH_sub WHERE DrugCode = @코드) THEN WARNING '입고 기록 없음. 마진 계산 불가' ``` #### 방안 3: INPRICE 자동 채우기 ```sql -- INPRICE=0인 경우 CD_GOODS.Price로 업데이트 UPDATE SALE_SUB SET INPRICE = (SELECT Price FROM CD_GOODS WHERE DrugCode = SALE_SUB.DrugCode) WHERE INPRICE = 0 ``` --- ## 8. 관련 API 목록 (app.py) | 엔드포인트 | 기능 | 사용 테이블 | |------------|------|-------------| | `/api/products` | 제품 검색 | CD_GOODS, IM_total, CD_ITEM_UNIT_MEMBER | | `/api/drugs//purchase-history` | 입고 이력 | WH_main, WH_sub | | `/api/sales-detail` | 판매 상세 | SALE_SUB, CD_GOODS | | `/api/usage` | 기간별 사용량 | SALE_SUB, CD_GOODS | | `/api/rx-usage` | 처방 사용량 | PS_sub_pharm, PS_main | | `/admin/transaction/` | 거래 상세 | SALE_MAIN, SALE_SUB | --- ## 9. 테이블 관계도 ``` PM_DRUG PM_PRES ======== ======== CD_GOODS ────────────────────────┐ │ DrugCode (PK) │ │ │ ├── CD_ITEM_UNIT_MEMBER │ │ (단위바코드) │ │ │ ├── CD_BARCODE │ │ (표준코드 매핑) │ │ │ ├── IM_total │ │ (현재 재고) │ │ │ ├── WH_sub ◄─── WH_main │ │ (입고 상세) (입고 마스터)│ │ │ └──────────────────────────────┼──► SALE_SUB ◄─── SALE_MAIN │ (판매 상세) (판매 마스터) │ │ │ │ INPRICE = CD_GOODS.Price │ │ └─────────┘ 마진 계산: SALE_MAIN.SL_MY_sale_cost = Σ(SALE_SUB.INPRICE × 수량) 마진 = SL_MY_sale - SL_MY_sale_cost ``` --- ## 10. 핵심 요약 ### 10.1 마진 계산 흐름 ``` 입고 등록 (WH_sub) ↓ CD_GOODS.Price 업데이트 (입고가) ↓ 판매 등록 (SALE_SUB) ↓ SALE_SUB.INPRICE ← CD_GOODS.Price ⭐ ↓ SALE_MAIN.SL_MY_sale_cost = Σ(INPRICE × 수량) ↓ 마진 = 판매액 - 원가 ``` ### 10.2 문제 원인 - **INPRICE = 0**이면 마진 = 판매액 (100% 마진처럼 보이지만 실제로는 잘못된 데이터) - **CD_GOODS.Price = 0**이면 판매 시 INPRICE도 0 ### 10.3 권장 조치 1. 제품 등록 시 입고가(Price) 필수 입력 강제 2. 입고 처리 후 판매 권장 (입고 기록 없으면 경고) 3. 마진 리포트에서 INPRICE=0인 건 별도 표시/경고 --- *분석: 용림 (Yongrim) | 2026-03-13*