미수 처리¶

이 페이지에서 찾을 수 있는 것

미수 처리 / 잔금 결제 / 분납 / 미수내역 / 미수 환자 / 미수액 / 일괄 SMS 안내 / 가족 대납 / 친구 대납

청구액보다 결제액이 부족한 환자(미수금 보유 환자)를 추적하고 잔금을 결제 받는 흐름입니다. 분납 환자, 결제 일부만 받은 환자 등 미수가 발생하는 모든 케이스를 한 곳에서 관리합니다.

미수 처리 진입 경로 — 3가지¶

경로	사용 시점
매출/결산 > 미수내역 (`UnpaidListPage`)	전체 미수 환자 목록 조회 + 엑셀 추출
수납 팝업 > 미수처리 탭 (개별 환자)	환자가 잔금 결제하러 왔을 때
현황판 > 환자 카드 우클릭 > 수납/미수	일반 진입 (자동으로 미수처리 탭 진입)

💡 자동 탭 전환 (work-item 28 Phase 6-A): 환자에게 미수가 있으면 수납 팝업 열릴 때 자동으로 "미수처리" 탭이 활성화됩니다.

미수내역 페이지 (UnpaidListPage)¶

기간 필터 + 미수 환자 표.

기간 필터¶

시작일/종료일 (기본: 5년 전 ~ 오늘)
빠른 선택: 오늘 / 이번주 / 이번달 / 올해

컬럼 구성¶

컬럼	의미
이름	환자명
주민번호	마스킹 표시
주소	환자 주소 (회수 안내용)
전화번호	연락처 (미수 안내 SMS용)
미수액	청구액 - 수납액
마지막 진료일	최근 차트 일자

기능¶

엑셀 다운로드: 미수 환자 목록 (이름/주민/주소/전화/미수액)
SMS 발송: 선택 환자에게 미수 안내 일괄 발송
환자 클릭: 차트 페이지 또는 수납 팝업 진입

자주 쓰는 동작¶

시나리오 1 — 분납 환자 잔금 결제 (박새별 케이스)¶

5/1 박새별 1,000,000원 중 50만원 결제, 잔금 50만원 다음달 결제

5/1 (1차 결제):

차트 입력 + 청구액 1,000,000원 + 저장
수납 팝업 → 미수처리 탭
카드 행에 500,000원 입력 → 결제 처리
차트로 돌아가 "수납대기" 버튼 클릭 (수납완료 X)
(시스템: 미수 50만원 표시 + reservation status='수납대기')

잔금 결제일 (다음달 또는 환자 재내원 시):

박새별 환자 검색 → 우클릭 → "수납/미수"
수납 팝업 자동 열림 → 자동으로 "미수처리" 탭 진입 (Phase 6-A)
상단 미수 차트 목록에서 5/1 차트 미수 50만원 항목 더블클릭 → 결제 영역에 자동 입력
결제 수단 선택 (카드/현금) → 결제 처리
자동 처리:
- payments INSERT (50만원, completed)
- progress_notes.paid_amount: 500,000 → 1,000,000
- reservation status 자동: "수납대기" → "수납완료"
정합성 봇 알림 자동 사라짐

시나리오 2 — 미수내역 페이지에서 일괄 안내 SMS¶

한 달간 미수 환자에게 잔금 안내 SMS 발송

매출/결산 > 미수내역 페이지 진입
기간 필터 = "이번달"
결과 표 확인 → SMS 발송할 환자 체크박스 선택
하단 "SMS 발송" 버튼
안내 메시지 작성 (예: "안녕하세요. 짱한의원입니다. 미결제 ○○원 안내 드립니다.")
발송 완료
발송 이력은 메시지 > SMS 발송 이력에서 확인

시나리오 3 — 미수내역 엑셀 추출 (회수 작업용)¶

월말 미수 환자 회수용 엑셀

미수내역 페이지 → 기간 = 5년 전 ~ 오늘 (장기 미수 모두)
엑셀 다운로드 버튼
파일에 이름/주민/주소/전화/미수액 포함
회수 부서/실장에게 전달

시나리오 4 — 환자가 잔금 안 가져오고 그냥 갔을 때¶

진료 끝났는데 결제 안 하고 환자 귀가

차트 + 결제 0건 상태
"수납대기" 버튼 클릭 → reservation status='수납대기'
환자 메모에 "○○월 ○○일 잔금 회수 예정" 등 기록
다음 내원 시 미수처리 탭에서 결제 받음

→ 정합성 봇 11번 "접수/진료 방치" 알림이 며칠 후 발동될 수 있음. 메모 잘 적어두면 봇 메시지에서 식별 쉬움.

시나리오 5 — 가족/친구 대납¶

친구가 환자 미수 대신 결제

환자 검색 → 우클릭 → 수납/미수
수납 팝업 → 미수처리 탭
결제 수단 행 (카드/현금) 입력
메모에 "친구 대납" 또는 대납자 이름 기록
결제 처리 (환자 본인이 안 내도 OK)

선납권 가족 대납과는 별도 흐름 (선납권은 선납권 충전/사용 참조).

자동 처리 로직¶

미수 결제 시 자동:

payments INSERT (결제 완료)
progress_notes.paid_amount 자동 +=
payments.unpaid_amount 재계산 (남은 미수 갱신)
reservation status 자동 재평가:
total - paid <= 0 → "수납완료" 자동 전환
total - paid > 0 → "수납대기" 유지
정합성 봇 다음날 06:00 점검 시 자동 통과

→ 직원은 결제 입력만, 나머지는 자동.

권한별 차이¶

기능	권한
미수내역 조회 (UnpaidListPage)	🟢 모든 직원
미수처리 탭 결제 입력	🟢 모든 직원
SMS 일괄 발송	🟢 모든 직원
엑셀 다운로드 (개인정보 포함)	🟢 모든 직원
수납완료 강제 변경 (잔액 있는데 완료)	🔴 Level 1~2 관리자 (work-item 28 Phase 6-C)

→ 일반 미수 결제는 모든 직원 가능. 잔액 있는데 수납완료로 잘못 변경하는 건 백엔드에서 차단 (재발 방지 fix).

자동 검증 (정합성)¶

미수 관련 정합성 봇 알림:

검사 번호	내용	처리
2	수납완료인데 미수 (잘못된 status)	차트의 "수납대기" 버튼으로 되돌림
3	수납대기인데 완납	환자 카드 우클릭 → 수납완료로 변경
11	접수/진료 방치 (금액 있음, 과거 날짜)	차트에서 status 정리

→ 정합성 점검 처리 참조.

자주 발생하는 문제 / FAQ¶

Q1. 분납 환자에게 "수납완료" 누르면 차단되나요? A. 네. work-item 28 Phase 6-C 적용 후 잔액 있는데 "수납완료" 변경 시도 시:

미수 ○○원이 있어 수납완료로 변경할 수 없습니다.
잔금 결제 후 자동으로 수납완료 처리됩니다.

→ 정상 분납 흐름 강제. 수납대기 상태 유지하시고 잔금 결제 시 자동 전환.

Q2. 환자 검색에서 미수 환자만 빠르게 찾고 싶어요. A. 매출/결산 > 미수내역 페이지 사용. 기간 필터로 미수 발생 시점 좁혀서 검색.

Q3. 미수 환자에게 SMS 안내했는데 안 갔어요. A. 환자 휴대폰 번호 비어있거나 잘못 등록되어 있을 수 있음. 메시지 > SMS 발송 이력에서 실패 사유 확인.

Q4. 잔금 결제했는데 status가 자동 갱신 안 됐어요. A. 다음 항목 확인: 1. 결제 등록이 정확히 됐는지 (payments INSERT 확인) 2. 결제가 해당 차트(progress_note_id)에 연결됐는지 3. 새로고침 후 status 재확인 → 안 되면 #dev 문의.

Q5. 가족 대납 시 누구 결제로 잡히나요? A. 결제 받은 환자 본인의 차트에 결제 등록. 메모에 "○○○ 대납" 기록 권장. 매출 통계는 환자 본인 기준으로 잡힘.

Q6. 미수내역 엑셀에 진료 기록도 포함하고 싶어요. A. 현재는 미수내역만 (이름/주민/주소/전화/미수액). 진료 상세가 필요하면 환자 상세 검색 페이지 사용.

Q7. 미수가 너무 오래된 환자는 어떻게 처리하나요? A. 회수 불가 미수는 다음 옵션: - 부분 환불 처리로 청구액 정리 - 차트의 청구액(total_amount) 정정 (오더 정정) - 무상 처리 시 협찬 visit_type으로 변경 (선택) → 운영 정책에 따라 처리 후 미수 0으로 만듦.

Q8. 미수처리 탭과 일반 수납 탭 차이가 뭐예요? A. 둘 다 결제 입력 가능하지만: - 미수처리 탭: 미수 차트 목록 표시 + 더블클릭으로 자동 입력 - 수납목록 탭: 결제 이력만 표시 (입력 칸 없음) → 잔금 결제는 미수처리 탭이 정확합니다 (자동으로 progress_note_id 연결).

Q9. 환자가 미수를 부정하면 어떻게 하나요? A. 차트 이력 + 결제 내역 확인: - 차트 청구액 (시술 항목) - payments 결제 이력 - 메모/사유 확인 → 데이터로 입증 후 환자에게 안내. 정정 필요하면 차트/결제 정정.

Q10. 미수 안내 발송 후 자동 추적되나요? A. SMS 발송 이력은 메시지 발송 이력에 기록되지만, "이 환자가 안내 받았는지" 자동 추적은 별도 기능 없음. 운영상 환자별 메모 활용 권장.