/tax-invoice-hometax

name: "tax-invoice-hometax"
description: "개인사업자의 홈택스 전자세금계산서 발급·수정·조회·미수금 점검. 청구/영수·금액·거래처·중복 발급 QA, 청구 건과 입금 대조, 판매채널별 매출·카드/현금영수증·플랫폼 정산·수수료·환불·입금의 수동 검토를 돕는다. 세금계산서 발행, 미수금, 정산금이 매출과 달라, 매출 누락 점검 요청에 사용. Pro 대량 월마감은 설치 시 연결하며 자동 발급 금지."

전자세금계산서 홈택스 발급 (tax-invoice-hometax)

홈택스에서 **전자세금계산서를 발급 직전까지** 작성·점검하고, 사용자 확인 후 발급을 보조하는 범용 스킬. 특정 회사 전용이 아니다. 동료·일반 개인사업자 기준으로 동작한다.

연관 스킬:

• 허브: `hometax-tax-hub`
• 부가세 신고 대조: `vat-hometax`
• 신고 준비: `tax-prep-kr`

상세:

• `references/pre-issue-checklist.md`
• `references/amend-types.md`
• `references/receivables-check.md` (미수금 점검)
• `references/receivables-engine.md` (Pro 엔진 파일이 설치된 경우만 읽기: 실행·입력 스키마·합성 예제)

절대 규칙

1. **자동 발급 금지.** 매번 확인: `이 내용으로 세금계산서 발급 진행해도 될까요?` 2. 비밀번호·인증서 비밀번호·OTP·간편인증 **직접 입력 금지** 3. 거래처·금액·일자를 추측하거나 창작하지 않는다. 누락은 질문 목록으로 보고 4. 현재 홈택스 화면 필드·안내문 = 최종 근거 5. 주민번호·계좌 등은 마스킹 6. 보고 말미 표준 면책(아래 「보고 포맷」 하단 문구)을 반드시 삽입.

사업 정보 재사용

허브 또는 사용자 지정 로컬 가명 프로필이 있으면 사업 가명·기간·과세유형·확인일을 먼저 대조하고 변경점·누락만 묻는다. 직원 없음과 외주 지급 없음은 별개이며, 미확인·미수집을 false·0원으로 채우지 않는다. 프로필이 없거나 이 스킬만 설치되어 있어도 필요한 항목만 직접 확인해 진행한다. 원본 식별정보·인증정보를 공통 프로필에 저장하지 않는다.

시작 인터뷰

- 작업: 신규 발급 / 수정세금계산서 / 조회만 / 미수금 점검
- (신규 발급이면) 거래처: 기존 / 신규 → 아래 두 레인으로 질문 수가 달라짐

필수 값이 없으면 **입력하지 말고** 먼저 질문한다. 사업자 미등록 거래처·주민번호 발급이 필요하면 별도 확인.

기존·신규 거래처 구분 (발급 초반 첫 질문)

세금계산서 발급 요청을 받으면 **거래처 정보를 묻기 전에 먼저** 질문한다. 기존 업체는 홈택스에 거래처로 저장돼 있어 불러오면 되고, 신규는 사업자번호부터 새로 조회해야 하므로 흐름이 갈린다.

> **이 거래처는 전에도 세금계산서를 발행하신 곳인가요, 아니면 이번이 처음인 신규 거래처인가요?**

사용자가 기존/신규를 모르면 사업자번호(또는 거래처명)로 홈택스 저장 여부를 조회해 확인한 뒤 아래 레인으로 진행.

기존 거래처 — 패스트트랙 (질문 5개로 끝)

저장된 정보(사업자번호·상호·주소·이메일)는 **다시 묻지 않는다.** 홈택스 저장 거래처에서 불러오고, 화면에 채워진 상호가 사용자가 말한 곳과 맞는지 확인만 한다. 물을 것은 이 5개뿐:

1. **금액** — "공급가액인가요, 부가세 포함 합계인가요?" (자릿수까지 복창 확인) 2. **품목** — 직전 발행 이력이 보이면 "지난번과 같은 품목([품목명])인가요?"로 단축 3. **작성일자·공급일자** — **매번 새로 받는다** (일자는 절대 추측·재사용 금지 — 공급시기가 어긋나면 지연발급 가산세 위험) 4. **영수/청구** — "이 건은 대금을 이미 받으셨나요?" 5. **과세구분** — 직전 발행과 동일(과세/영세율/면세)한지 확인. 직전 이력이 영세율·면세이거나 이력을 알 수 없으면 **반드시 질문** (영세율 수출 건에 10% 세액을 붙이는 사고 방지. 면세 거래는 세금계산서가 아니라 '계산서' 대상이므로 발급 문서 종류부터 재확인)

• 이메일 전송은 저장된 주소 확인만: "저장된 ○○@…로 전송할까요?"
• **월 정기·반복 거래면 더 단축:** "지난달과 동일 조건([품목] [금액])이면 '같아요'라고만 답하셔도 됩니다" → 다르면 달라진 항목만 받는다. **단, 작성일자·공급일자만은 예외 — 매번 새로 확인한다.**

신규 거래처 — 필수 질문 세트 (이것만 있으면 발행 가능)

조각조각 여러 번 묻지 말고 **한 번에 묶어서** 질문한다:

처음 발행하는 거래처네요. 다음 7가지만 알려주시면 됩니다:
1. 사업자등록번호 (10자리) — 상호·주소는 홈택스가 자동으로 찾아줍니다
2. 세금계산서 받을 이메일 (모르면 비워두세요 — 발급 후 전송도 가능합니다)
3. 금액 (공급가액인지, 부가세 포함인지 함께)
4. 품목 (무엇에 대한 대금인지)
5. 작성일자·공급일자
6. 대금을 이미 받으셨나요, 아직인가요? (영수/청구)
7. 일반 국내 과세 거래인가요? — 수출(영세율)·면세 품목이면 알려주세요

7번이 영세율이면 세액 0 + 영세율 사유·서류 확인으로, 면세면 세금계산서가 아니라 **계산서** 발급 대상이므로 문서 종류부터 바로잡는다.

• 사업자번호 입력 → **상호·주소 자동조회** 결과가 사용자가 말한 상호와 **다르면 진행 중단**하고 확인 (엉뚱한 회사로 발행 방지).
• 사업자 없는 개인(주민번호 발급 건)이면 별도 확인 후 진행.

공통 안전장치

기존이든 신규든 발급 직전 **사업자번호 유효성(휴·폐업 여부)**을 한 번 확인한다. 기존 거래처라도 그 사이 폐업했을 수 있음 — 폐업 확인 시 발급 권유 금지, 사용자에게 알림.

청구·영수 구분 (필수 질문)

홈택스 발급 화면에는 **`영수` / `청구`** 선택이 있고 기본값이 **`청구`**로 되어 있다. 세액·합계에는 영향이 없지만 거래 성격 표시라 실제 상황에 맞춰야 한다. 발급 정보를 모을 때 **반드시** 다음을 질문한다:

> **이 건은 대금을 이미 받으셨나요, 아니면 아직 안 받고 청구하는 건가요?**

• **이미 받았음 → `영수`** 선택 (기본값 `청구`에서 **바꿔야 함**)
• **아직 안 받음(청구 목적) → `청구`** 유지
• 애매하면(계약금 일부만 받음 등) 사용자에게 되물어 확정. 임의 판단 금지.

정의: **영수** = 대금 수령 완료 후 발행(영수증 성격) · **청구** = 대금 미수령, 청구 목적 발행. 세액은 동일.

모드

| 모드 | 산출 | | --- | --- | | A. 신규 발급 보조 | 입력값 초안 + 발급 직전 QA | | B. 수정세금계산서 | 원본 조회 + 수정사유 확인 + QA | | C. 조회·다운로드 | 발급/수신 목록 정리 | | D. 대량 보조 | 건별 체크리스트 (한 건씩 확인) | | E. 미수금 점검 | 청구 발행 건 ↔ 입금내역 대조 + 미수금 리스트 + 경과일수 경고 |

기본: 인터뷰 → A 또는 B → 발급 직전 QA → 사용자 확인 → 발급 클릭(사용자 본인) → C로 검증

---

홈택스 절차 (신규 발급)

1. 로그인 세션 확인 (없으면 사용자 로그인) 2. **조회/발급 → 전자세금계산서 → 발급** (메뉴명은 현재 화면 우선) 3. 발급 유형: 일반 / 위수탁 등 해당 메뉴 선택 4. 공급자(본인 사업장) 확인 5. 공급받는자 입력 — **기존 거래처면** 저장된 거래처에서 불러오기, **신규면** 사업자번호 입력 → 상호·주소 자동조회 확인. 어느 경우든 **휴·폐업 여부 확인**(폐업이면 발급 중단·보고) 6. 작성일자·공급일자 입력 7. 품목, 규격, 수량, 단가, **공급가액**, **세액** 입력 8. 합계 검산: 공급가액 × 10% ≈ 세액 (과세 기준, 원 단위 반올림 차이 허용 범위는 화면 검증 따름) 8-1. **`영수`/`청구` 선택** — 화면 기본값은 **`청구`**. 인터뷰에서 "대금 이미 받음"으로 확인됐으면 **`영수`**, "아직 안 받음"이면 `청구`가 맞다. **AI는 어떤 값을 눌러야 하는지 안내만 하고, 라디오/버튼 클릭·선택은 사용자 본인**이 한다. 현재 라디오/버튼 상태를 함께 확인해 알려주고, "대금 받으셨다고 하셨으니 기본값 `청구`에서 **영수**로 바꿔 선택하시면 됩니다"처럼 안내한다. 9. 이메일 등 전송 옵션 확인 10. **발급 직전 QA** (`references/pre-issue-checklist.md`) 11. 사용자 확인 문구 후 발급 12. 발급완료·승인번호·조회 화면 캡처/기록

수정세금계산서

1. 원본 전자세금계산서 조회 2. 수정 사유 선택 (기재사항 착오정정, 공급가액 변동, 환입, 계약해제 등 — **현재 화면 선택지** 따름) 3. 사유별 필수 필드 확인 (`references/amend-types.md`) 4. 변경 전·후 금액 대조표 작성 5. 사용자 확인 후 발급

조회

• 기간·거래처·승인번호로 발급/수신 목록 조회
• 합계가 부가세 신고와 연결되면 `vat-hometax`로 넘김

미수금 점검 (모드 E)

상세 절차·경고 문구·보고 포맷: `references/receivables-check.md` — **반드시 읽고 그대로 따른다.**

`청구`로 발행한 건 중 입금 안 된 건을 찾아 미수금 리스트를 만드는 모드. 요약:

1. **시작 전 3고지** (생략 금지): ① 부가세는 발생주의 — 미입금이어도 전액 신고 대상, 빼면 매출 누락 ② 대손세액공제는 법적 대손 확정 시에만(단순 미입금 해당 없음) ③ 이 점검은 수금 관리용이며 신고 내용을 바꾸지 않음 2. 기간 확정(+약정 결제기일) → 발급 목록 엑셀 다운로드 (기간이 조회 단위를 넘으면 분할 다운로드·병합, 다운로드는 사용자 본인) 3. **정합성 게이트 ①**: 총 건수 = 영수 + 청구, 수정·취소 건 짝 처리(감액은 순액 대조·취소는 환불 필요 역확인), 분할 조회 시 기간 공백 없음 — 어긋나면 진행 중단 4. 청구 건 대조: **Pro 엔진 `assets/receivables-engine.mjs`가 설치되어 있으면 실행해** 순액·입금 연결·경과일수·분류 합계를 계산한다. 무료처럼 엔진이 없으면 원자료·스프레드시트 합계와 건별 질문을 이용하는 수동 점검표로 진행한다. 통장내역이 있으면 정확 일치만 후보로 대조하고 **입금 1건=계산서 1건 소진**을 적용한다. 부분·합산·선금·PG정산·상계·명의불일치는 판단불가, 통장이 없으면 건별 질문. **임의 확정 금지, 미입금은 최후의 분류** 5. **정합성 게이트 ②**: 입금완료 + 미입금 + 판단불가 = 청구 건수 — 불일치 시 보고 금지, 재점검 6. `영수` 건 역점검: 영수인데 입금 흔적 없으면 ⚠️ 민사 리스크 경고 + 착오정정(→청구) 안내 7. 미수금 리포트 (경과일수별 정상/⚠️주의/🔶경고/🔴위험 단계 표시)

**금지:** 미입금을 이유로 신고 매출 제외 제안, 입금 여부 임의 확정, 판단불가 건 조용한 누락, 통장 원본 저장·외부 전송, 독촉·소송 문서 발송 대행.

**실행 방식 구분:** Pro 엔진 파일이 있으면 Node.js 18 이상(외부 패키지 불필요)으로 실행한다. 이때만 `references/receivables-engine.md`를 읽고 마스킹 자료를 지정 JSON으로 전달한다. 입력 검증이 실패하면 엔진 결과 보고를 중단하고 오류를 해소하며 암산·추정으로 우회하지 않는다. 정확 일치도 사용자 확인 전에는 `판단불가`이고 실제 응답만 `confirmations`에 반영해 재실행한다. **무료 수동 점검:** 엔진이 없으면 `references/receivables-check.md`의 자료 범위·건별 질문·원본/수정 순액·입금 소진·3분류 합계 대조를 그대로 수행한다. 원자료/스프레드시트에 확인된 합계와 사용자 응답을 표에 남기고 미수집을 0원으로 채우지 않는다. 수동 점검을 엔진 검증 완료로 소개하거나 별도 세액 계산기로 확장하지 않는다.