영수증, 세금계산서, Void 처리

/pos/receipt은 이미 결제가 끝난 Bill의 이력을 조회하는 화면입니다. 검색, 날짜 범위, 정렬, 영수증 재확인, Tax Invoice 출력, Medical Bill 출력, Void를 처리합니다.

이 화면에 보이는 Bill 범위

현재 구현 기준으로 Receipt 화면은 아래 상태만 조회합니다.

• PAID
• VOID

즉, 아직 결제되지 않은 ISSUED Bill이나 순수 미수금 목록을 여기서 직접 관리하는 구조는 아닙니다.

화면 구성

• 상단 검색 바
  • 검색어
  • 날짜 범위
  • Reset
• 영수증 테이블
• Bill 상세 모달
• Tax Invoice 모달
• Void 확인 모달

영수증 테이블 읽는 법

기본 테이블에서 주로 보는 컬럼은 아래입니다.

• 생성일
• 결제일
• Bill ID
• 보호자명
• 상태
• 총액
• 결제수단
• 메모

정렬 가능한 주요 컬럼도 함께 제공합니다.

• createdAt
• lastPaymentDate
• billDisplayId
• customerName
• netAmount

검색과 필터링

검색

검색창으로 Bill이나 보호자 관련 이력을 좁힙니다.

날짜 범위

기간 기반으로 영수증을 확인할 수 있습니다. 일마감이나 특정 분쟁 대응 시 유용합니다.

Reset

검색과 기간 필터를 초기화합니다.

Bill 상세 보기

테이블의 Bill을 열면 세부 내역을 다시 확인할 수 있습니다. 이 단계는 결제 수단, 메모, 청구 항목을 재검토할 때 유용합니다.

Tax Invoice 출력

Tax Invoice 출력은 일반 영수증 재인쇄보다 더 엄격한 전제가 있습니다.

처리 흐름

1. 필요 시 Bill을 Full Tax로 변환합니다.
2. 고객 정보를 다시 불러옵니다.
3. 고객 주소가 충분한지 검증합니다.
4. Tax Invoice 모달을 열어 출력합니다.

주소 누락 시

고객 주소 정보가 충분하지 않으면 Tax Invoice 출력이 중단됩니다.

⚠️ Warning: 고객 주소가 비어 있으면 세금계산서를 강행할 수 없습니다. 출력 실패를 프린터 문제로 보기 전에 고객 주소 등록 상태를 먼저 확인해야 합니다.

Medical Bill 출력

Receipt 화면에서는 Medical Bill PDF도 출력할 수 있습니다. 현재 구현은 의료비 명세를 날짜 단위 그룹 기준으로 불러와 출력하는 흐름을 사용합니다.

Void 처리

Void는 단순 삭제가 아니라 사유를 남기는 취소 작업입니다.

Step 1. Void 대상 확인

이미 PAID 상태인 Bill을 다시 확인합니다.

Step 2. 사유 입력

Void 모달은 비어 있지 않은 사유를 반드시 요구합니다.

Step 3. Void 실행

성공하면 목록이 갱신되고 Bill 상태는 VOID로 반영됩니다.

⚠️ Warning: 사유 없는 Void는 허용되지 않습니다. 짧더라도 운영상 추적 가능한 수준으로 남겨야 이후 감사 로그, 정산 검토, 분쟁 대응이 가능합니다.

운영 팁

• Receipt 화면에서 안 보이는 Bill은 먼저 상태가 PAID 또는 VOID인지 확인합니다.
• Tax Invoice 실패는 주소 누락, 고객 정보 미완성, Full Tax 전환 이슈를 순서대로 점검하는 편이 빠릅니다.
• Void 후에는 상태만 바뀌는 것이 아니라 정산 리포트 해석에도 영향이 있으므로, 일마감 전에 반드시 재확인해야 합니다.

관련 문서