미수내역¶
이 페이지에서 찾을 수 있는 것
미수 / 미수내역 / 분납 / 잔금 / 외상 / 미회수 / 일자별 미수 / 환자별 미수
청구는 했지만 아직 회수되지 않은 미수액을 환자별·일자별로 조회하는 페이지입니다. 분납 환자 잔금 회수, 외상 잔액 추적의 핵심 화면.
주소:
/sales/unpaid
화면 구성¶
| 영역 | 위치 | 내용 |
|---|---|---|
| 상단 필터 | 화면 위 | 기간(차트 일자) / 담당의 / 실장 / 환자명·차트번호 |
| 메인 표 | 가운데 | 환자명·차트번호·차트일자·청구액·수납액·미수액·담당의·실장 |
| 합계 박스 | 우측 상단 | 미수 총액 + 환자 수 |
| 액션 | 표 우측 | 차트 진입 / 수납 팝업 / SMS 안내 |
미수 계산 공식¶
total_amount(청구액): 차트의 오더 합계 + 비급여paid_amount(수납액):SUM(payments WHERE status='completed' AND is_refund=0)- 단 환불(refund_amount)이 발생한 경우 paid_amount는 차감 반영됨
정합성 가드¶
- status='deleted' 차트는 미수 합산에서 자동 제외 (WI#65 후속, 2026-05-13 적용)
- 전액 환불된 차트는 자동 매출 0 처리 (WI#66 Phase D, 2026-05-13 적용 — 환불 후 미수 잘못 표시 방지)
- 옛 데이터(2026-05-13 이전 환불) 중 차트 미정리 케이스는 정합성 봇 #22가 매일 06:00 알람
자주 쓰는 동작¶
시나리오 1 — 분납 환자 잔금 회수¶
- 미수내역 → 환자 검색 (예: 박새별)
- 미수액 확인 (예: 50만원)
- 환자 행 → 수납 팝업 또는 차트 진입
- 잔금 결제 입력 →
paid_amount자동 갱신 → 미수 0 처리
시나리오 2 — 미수 환자 일괄 SMS 안내¶
- 기간 필터로 미수 누적된 환자 추출
- 다건 선택 → 일괄 SMS (안내 템플릿)
- 결제 유도
시나리오 3 — 담당 실장별 미수 관리¶
- 실장 필터에 본인 이름
- 본인 담당 환자의 미수만 추출
- 환자별 미수 정렬 → 우선순위 결정 후 콜
시나리오 4 — 월별 미수 추세 분석¶
- 기간을 월 단위로 변경
- 월별 미수 합계 비교
- 미수 증가/감소 추이 파악
권한별 차이¶
| Level | 사용 가능 |
|---|---|
| 1~2 (관리자) | ✅ 전체 환자 + 모든 필터 |
| 3 (의료진) | 본인 진료 환자 미수 |
| 4 (실장) | 본인 담당 환자 미수만 |
자주 발생하는 문제 / FAQ¶
Q1. 결제 끝났는데 미수내역에 그대로 남아 있어요. A. 화면 새로고침(F5)으로 확인. 만약 그대로면 결제 등록 시 차트 연결이 안 됐을 수도 — 운영팀 문의.
Q2. 환불 처리했는데 미수가 발생하고 있어요. A. 2026-05-13 핫픽스 — 환불 처리 시 차트 매출도 자동 0 처리. 옛 데이터는 차트 화면에서 청구액을 0으로 정정 또는 운영팀에 정합성 봇 #22 알람 후 처리.
Q3. 협찬 환자가 미수로 잡혀요. A. visit_type='협찬' 차트는 매출/미수에서 제외(WI#17d). 만약 잡힌다면 visit_type 확인 또는 운영팀 문의.
Q4. 미수 총액이 일일결산과 달라요. A. 일일결산은 결제 일자 기준, 미수내역은 차트 일자 기준 — 시점 차이로 다를 수 있음 (정상).
Q5. 분납 환자 잔금을 결제했는데 patient_reservations 상태가 안 바뀌어요. A. 잔금 결제 후 자동으로 '수납완료'로 변경됨 (WI#28 가드). 만약 안 바뀌면 미수 = 0인지 확인 + 운영팀.