lbiz-partners/hometax-doum / skills/tax-invoice-hometax
tax-invoice-hometax
Verified개인사업자의 전자세금계산서·계산서·현금영수증 발급·수정·취소·조회 준비, 현금영수증 가맹점 가입 판정·신청과 미수금·정산 대조에 사용한다. 부가세 신고서 작성은 vat-hometax가 맡는다. 최종 발급은 본인이 진행하며 Pro 대조 엔진이 없으면 수동 확인으로 진행한다.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.8 KB |
| references/amend-types.md | markdown | 1.2 KB |
| references/cash-receipts.md | markdown | 8.5 KB |
| references/issuance-workflow.md | markdown | 6.6 KB |
| references/pre-issue-checklist.md | markdown | 2.0 KB |
| references/receivables-check.md | markdown | 16.2 KB |
| references/receivables-engine.md | markdown | 8.8 KB |
| references/sales-settlement-review.md | markdown | 3.1 KB |
references/receivables-check.md
View on GitHub# 미수금 점검 모드 (청구 발행 건 입금 대조)
**목적:** `청구`로 발행한 전자세금계산서 중 **입금이 안 된 건을 빠짐없이** 찾아 미수금 리스트로 정리한다.
**아닌 것:** 부가세 신고 금액을 바꾸는 기능이 아니다. 수금 관리 도구다.
---
## ⚠️ 시작 전 필수 고지 (사용자에게 그대로 안내)
점검을 시작하기 전에 아래 3가지를 사용자에게 먼저 보여준다. 생략 금지.
> 1. **부가세는 발생주의입니다.** 입금을 못 받았어도 청구 발행분 매출세액은 해당 과세기간에 **전액 신고 대상**입니다. "입금 안 받았으니 매출에서 빼자"는 처리는 **매출 누락(가산세 대상)**이 되므로 이 도구는 그런 제안을 하지 않습니다.
> 2. **대손세액공제는 별개 제도입니다.** 단순 미입금이 아니라 파산·강제집행 불능·소멸시효 완성 등 **법적으로 대손이 확정**된 경우에만 검토 가능합니다(기한: 공급일부터 10년이 지난 날이 속하는 과세기간에 대한 확정신고 기한까지 대손이 확정된 분 — 부가가치세법 §45). 해당 가능성이 보이면 세무사 상담을 권합니다.
> 3. 이 점검은 **수금 관리용 리스트**를 만드는 것이며, 세무 처리·신고 내용을 변경하지 않습니다.
## 입력 자료
| 자료 | 필수 여부 | 비고 |
| --- | --- | --- |
| 홈택스 매출 전자세금계산서 **발급 목록** (기간 지정, 엑셀) | 필수 | 다운로드 파일(실측 2026-08): 파일명 `매출전자세금계산서목록(1~N).xls`(구형 xls), **상단 5행은 사업자정보·총계 메타이고 6행째가 헤더**, 33컬럼, 구분 컬럼명은 정확히 **`영수/청구 구분`**(22번째, '비고' 다음). 대표 품목 컬럼 포함. 구조가 다르면 화면 목록 기준으로 대조 |
| 통장 **입금내역** (엑셀/CSV) | 선택 | 있으면 자동 대조, 없으면 건별 질문 방식 |
**PII 규칙:** 통장 파일을 받기 **전에** 먼저 안내한다: "계좌번호 등 민감정보는 지우거나 가린 뒤 첨부해 주세요. 대조에는 일자·입금액·의뢰인명만 있으면 됩니다." 받은 파일에 계좌번호·주민번호가 섞여 있으면 마스킹하고, 원본 데이터를 저장하거나 외부로 보내지 않는다.
**Pro 엔진 설치 시:** `assets/receivables-engine.mjs`가 있으면 [`receivables-engine.md`](receivables-engine.md)를 읽고 사용한다. Node.js 18 이상, 외부 패키지 불필요. 판정·합계를 임의로 고치거나 입력 오류를 0원으로 바꾸지 않는다.
**무료 수동 점검:** 엔진이 없으면 아래 같은 절차를 원자료·스프레드시트 합계와 사용자 건별 응답으로 수행한다. 자동 검증을 주장하지 않는다. 원본/수정 순액과 입금 ID를 표에 연결하고 입금 소진·선금·통장 범위·판단불가 유지 및 두 합계 게이트를 동일 적용한다. 엔진 JSON·Node 설치는 무료 점검의 필수 조건이 아니다.
## 절차
### 1. 기간 확정
- 사용자에게 점검 기간을 확인한다. 기본 제안: **직전 과세기간 시작일 ~ 오늘** (예: 1기분이면 1/1~오늘).
- 기간 경계는 **작성일자(발행일) 기준**임을 고지한다. 기간 직전에 발행되고 입금은 기간 안에 된 건이 빠질 수 있으므로, 미수금이 의심되는 오래된 건이 있으면 기간을 넓혀 다시 조회하도록 권한다.
- **약정 결제기일도 함께 확인한다** (예: "월말 마감, 익월 말 지급"). 아래 경과일수 경고 단계는 **결제기일 기준**으로 계산하고, 결제 조건이 없거나 모르면 발행일 기준 **참고치**로 안내한다 — 지급기일이 아직 안 지난 정상 거래처에 독촉을 권하지 않기 위함.
### 2. 발급 목록 다운로드
- 홈택스 **조회/발급 → 전자세금계산서 → 목록조회** (메뉴명은 현재 화면 우선) → 기간 입력 → **매출분**만 → 엑셀 다운로드.
- **조회 기간 상한은 3개월** (실측 2026-08, 화면 안내: "조회기간은 3개월 범위 내로 제한. 단, 공급받는자 등록번호를 입력하면 1년까지 조회가능. [월/분기별 목록조회]에서는 반기별 조회까지 가능"). 점검 기간이 3개월을 넘으면 **기간을 나눠 여러 번 다운로드해 병합**한다 (예: 1기분 1/1~8월 점검이면 3회 분할). 몇 개 구간으로 나눴는지 기록해 둔다. 상한이 바뀌면 현재 화면 우선.
- 조회 기간 기준은 **작성일자**로 선택한다 (화면에서 작성일자/발급일자/전송일자 선택 가능 — §1의 기간 경계 판정과 일치시키기 위함).
- 내려받기 순서(실측): `내려받기` → 품목정보 추가 여부 팝업(기본 미체크로 확인) → 파일 종류 선택(엑셀) → **마지막 "파일을 받으시겠습니까?" 창은 브라우저 시스템 대화상자라 반드시 사용자 본인이 클릭** (AI·확장이 누를 수 없음).
- 다운로드·클릭은 사용자 본인. AI는 화면 순서 안내만.
### 3. 정합성 검증 — 놓침 방지 게이트 ①
대조를 시작하기 **전에** 목록 자체가 온전한지 검증한다. 하나라도 어긋나면 대조를 진행하지 말고 목록을 재확인한다.
- [ ] **총 건수 = 영수 건수 + 청구 건수** — 구분값이 비었거나 제3의 값인 건이 0건인지 (수정 건도 자체 영수/청구 값으로 이 집계에 포함)
- [ ] **수정세금계산서(음수·수정 건)는 원본과 짝지어 순액 처리** — ① 전부 취소(원본+수정 합계 0)는 대조 대상에서 **제외하되 "취소됨"으로 별도 표기**하고, 취소인데 통장에 이미 입금이 있으면 **"환불 필요" 경고**를 붙인다 ② 감액 수정(합계 ≠ 0)은 제외하지 말고 **원본+수정 합산 순액을 그 건의 대조 금액**으로 쓴다 (원본액으로 대조하면 완납 건이 부분입금으로 오분류됨)
- [ ] **분할 조회했다면 구간이 빈틈없이 이어지는지** — 기간 공백·중복이 없는지, 구간별 건수 합 = 병합 후 총 건수인지 (한 구간 파일이 통째로 빠지는 것이 가장 흔한 누락 경로)
- [ ] 같은 거래처·같은 금액·비슷한 일자의 **중복 발행 의심 건**이 있으면 표시하고 사용자에게 확인
- [ ] 조회 기간과 사용자가 말한 기간이 일치하는지
### 4. 청구 건 추출 → 입금 대조
`청구` 건만 추려 대조한다. **모든 매칭은 "후보"이며, 확정은 사용자가 한다. 임의 확정 금지.** 후보는 3분류에서 **판단불가**다. 사용자의 건별 확인 응답을 받기 전의 보고에서는 입금완료 건수가 항상 0이다.
**통장내역이 있는 경우 (Pro 엔진 또는 무료 수동 대조):**
- **합계금액(감액 수정이 있으면 순액) 정확 일치 + 발행일 이후 입금**인 건만 "입금 후보(판단불가·확인 대기)"로 제시 — 후보의 상태는 **판단불가**이고, 사용자가 "맞다"고 답한 뒤에만 입금완료로 바꾼다. "입금완료 (추정 후보)"처럼 입금완료 표에 후보를 넣지 않는다
- **입금 소진 규칙 (1:1):** 입금 1건은 세금계산서 1건에만 배정한다. 동일 금액 청구가 여러 건인데 입금 건수가 모자라면(예: 월 110만원 3건 청구에 입금 1건), 어느 것도 입금완료 후보로 만들지 말고 **전부 판단불가**로 내려 "이 입금은 몇 월분 대금인가요?"를 확인한다 — 입금 하나가 여러 건을 동시에 지우면 실미수금이 조용히 사라진다.
- 아래는 자동 확정 금지 → **판단불가**로 분류해 사용자 확인:
- 부분입금 (금액 일부만 일치)
- 합산입금 (여러 건을 한 번에 입금)
- **선금·계약금 (발행일 이전 입금)** — 금액·명의가 일치해도 "이 입금이 이 계산서의 대금인가요?"로 확인 (먼저 받고 나중에 발행하는 흔한 패턴을 미입금으로 오분류하면 이미 지불한 거래처를 독촉하게 됨)
- 카드·PG·플랫폼 정산 (수수료가 차감되어 계산서 금액과 다르게 입금)
- 상계·어음 등 통장에 안 잡히는 결제
- 의뢰인명이 거래처 상호와 다른 입금 (대표자 개인 명의 등)
- **미입금은 최후의 분류다:** 금액·명의·날짜 어느 축으로도 연결 후보가 전혀 없을 때만 미입금으로 분류한다. 하나라도 걸치면 판단불가.
Pro 엔진은 순액 일치, 명의 일치, 작성일 또는 약정 결제기일과 **같은 일자** 중 하나라도 있으면 연결 근거로 남긴다. 날짜가 단순히 작성일 이후라는 이유만으로 무관한 모든 입금을 연결하지는 않는다. 작성일 이전에 같은 금액이 들어왔지만 명의가 다른 경우도 판단불가다. 같은 금액의 다른 청구·영수·취소 건이 있거나 입금 자체가 여러 건이면 자동 배정하지 않는다. 환불·입금취소는 원 입금 ID와 연결해 기록하고, 환불 이력이 있는 입금은 완납 후보에서 제외한다.
통장 범위가 기준일까지 이어지는지, 기간 전 선수금과 현금·상계 등 통장 밖 결제를 점검했는지가 확인되지 않으면, 연결 입금이 없어도 **판단불가**다. 이 확인값을 AI가 임의로 `true`로 만들면 안 된다. 자료가 확인됐고 연결 후보도 전무할 때의 `미입금`은 **확인된 자료 범위의 분류**이며 수령 사실을 법적으로 확정한 것이 아니다.
**통장내역이 없는 경우 (건별 질문):**
- 청구 건 전체를 표(거래처·발행일·합계금액)로 한 번에 제시하고, 건별로 입금 여부(O/X/모름)를 표기받는다.
### 5. 3분류 + 합계 검증 — 놓침 방지 게이트 ②
- 모든 청구 건을 **입금완료 / 미입금 / 판단불가** 셋 중 하나로 분류한다. 네 번째 상태 없음.
- **검증식: 입금완료 + 미입금 + 판단불가 = 청구 건수.** 불일치하면 어딘가에서 건이 새고 있는 것 — 보고하지 말고 재점검한다.
- **입금완료는 사용자가 건별로 확정한 건만 센다.** 정확 일치·명의 일치 등 자동 매칭은 "입금 추정 후보"이며 사용자 확인 전에는 **판단불가**에 센다. 자료가 단순해도 자동 후보를 입금완료로 올리지 않는다(2026-09-17 행동 평가에서 정확 일치 1건을 입금완료로 센 사례 교정).
- 사용자가 "모름"이라 답한 건은 미입금으로 넘기지 말고 **판단불가로 유지**해 리스트에 남긴다.
- 판단불가가 남아 있으면 보고서에 "사용자 확인 필요" 섹션으로 반드시 노출한다.
Pro 엔진 사용 시 결과의 `status`는 위 3종만 사용한다. 자동 정확 일치는 `candidate: true`로 추가 표시하되 `status: 판단불가`를 유지한다. 사용자에게 계산서와 연결 입금 ID를 보여 주고 건별 확인을 받은 뒤, 실제 응답만 `confirmations`에 넣어 재실행한다. 은행 완납 확인은 연결 입금의 합계가 계산서 순액과 같아야 하며 이미 소진·환불된 입금은 재사용할 수 없다. 합산 입금 한 건을 여러 계산서에 쪼개 배정하는 기능은 지원하지 않으므로 그 경우 판단불가와 확인 메모를 유지한다. 사용자가 현금·상계로 완납을 확인하면 그 수단과 확인 메모를 기록할 수 있다. 어음 수령만으로 완납을 단정하지 않는다.
무료 수동 표도 정확 일치는 후보·판단불가로 남기고, 사용자의 실제 건별 확인 뒤에만 상태를 바꾼다. 같은 입금 ID 재사용, 미확인 선금·합산입금 임의 배정, 환불된 입금의 완납 사용은 금지다. 검증식은 원자료·스프레드시트의 건수·합계와 대조하며 계산 수단이 없으면 합계를 만들지 말고 확인필요로 남긴다.
### 6. 영수 건 역점검 (권장)
통장내역이 있으면 `영수` 건도 역방향으로 점검한다:
> ⚠️ **영수로 발행됐는데 입금 흔적이 없는 건**이 발견되면 경고한다. '영수' 표시는 "대금을 받았다"는 외관을 만들어, 미수금 분쟁(소송·지급명령) 시 상대방이 지급 증거로 주장할 수 있다. 실제 미입금이 맞다면 ① 통장 미입금 증거 확보, ② 수정세금계산서(기재사항 착오정정 → 청구)를 안내한다 (`amend-types.md` 참조). 정정 여부 판단은 사용자.
### 7. 미수금 리포트 작성
아래 「보고 포맷」대로 작성한다.
## 경과일수별 경고 단계
**약정 결제기일 기준** 경과일수로 단계를 표시한다 (결제 조건이 없거나 모르면 발행일 기준 **참고치**로 안내 — "결제 조건에 따라 아직 정상일 수 있습니다" 단서를 붙인다). 법적 조치·소멸시효는 **단정하지 않고** "검토·전문가 확인" 수준으로만 안내한다.
| 경과일수 | 단계 | 안내 |
| --- | --- | --- |
| 30일 미만 | 정상 | 통상 결제 주기 내. 결제 예정일 확인 |
| 30일 이상 ~ 90일 미만 | ⚠️ 주의 | 독촉 연락, 결제일 재확인 권장 |
| 90일 이상 ~ 1년 미만 | 🔶 경고 | 내용증명 발송 검토, 거래 조건(선금 등) 재협의 권장 |
| 1년 이상 | 🔴 위험 | 지급명령·소송 검토 권고. **소멸시효 주의** — 상품·용역 대금 채권은 3년 단기소멸시효에 해당할 수 있음(채권 성격에 따라 다름 → 변호사·법률 전문가 확인 필수) |
## 보고 포맷
```text
## 미수금 점검 결과 ({기간})
기준일: {YYYY-MM-DD} (출처: 시스템 시계 / 사용자 확인) · 경과일수는 이 날짜 기준
### 정합성 (게이트 통과 확인)
- 통장 자료 유무 / 기준일까지의 범위 / 기간 전 선수금·통장 외 결제 확인 여부 (미확인은 그대로 노출)
- 발급 총 {N}건 = 영수 {a}건 + 청구 {b}건 (수정 건도 자체 구분값으로 포함 집계)
- {c} = 취소 쌍에 속한 청구 건수(원본+수정 모두) → 대조 제외 (환불 필요 여부 확인 결과 병기)
- {d} = 취소되지 않은 원본에 병합한 수정분(감액·증액) 중 **청구 구분인 것만**의 건수 → 원본 행에 병합해 순액으로 대조 (별도 행으로 세지 않음. 영수 구분 수정 건은 {b}에 집계되지 않으므로 여기서도 세지 않는다)
- **대조 대상 청구 {b − c − d}건 = 입금완료 {x} + 미입금 {y} + 판단불가 {z}** ✓ (식이 안 맞으면 보고 금지, 재점검. x는 사용자 확정 건만, 자동 후보는 z에 포함)
### 미수금 리스트 ({y}건, 합계 {금액}원)
| 거래처 | 발행일 | 합계금액 | 경과일수 | 단계 | 다음 액션 |
| --- | --- | ---: | ---: | --- | --- |
### 판단불가 ({z}건) — 사용자 확인 필요 (자동 후보 포함)
| 거래처 | 발행일 | 합계금액 | 보류 사유 | 연결 입금 ID·자동 후보 여부 |
(정확 일치 자동 후보는 이 표에 "자동 후보 · 확인 질문: …"으로 넣는다. 입금완료 표는 사용자 확정 건 전용이다)
### 영수 건 경고 (해당 시에만)
| 거래처 | 발행일 | 합계금액 | 권고 |
### ⚠️ 세무 주의
- 위 미입금 건도 해당 과세기간 부가세 신고 매출에 **전액 포함**되어야 합니다 (발생주의). 미수금을 이유로 매출에서 제외하면 매출 누락입니다.
- 대손세액공제는 법적 대손 확정 시에만 검토 가능합니다 — 해당 가능성이 있으면 세무사와 상담하세요.
- 이 점검은 수금 관리용 리스트이며 세무 처리·신고 내용을 변경하지 않습니다. (시작 전 3고지를 보고에도 그대로 남긴다 — 단일 보고만 보는 사용자도 세 가지를 읽어야 한다)
```
보고 말미에 SKILL.md 「보고 포맷」의 표준 면책 문구를 동일하게 붙인다.
## 금지 사항
- 미입금을 이유로 **신고 매출에서 제외하자는 제안 금지**
- 입금 여부 **임의 확정 금지** — 자동 매칭은 항상 후보, 확정은 사용자
- 판단불가 건을 조용히 누락시키는 것 금지 — 합계 검증식이 깨지면 보고 금지
- 통장 원본 데이터 저장·외부 전송 금지
- 독촉·내용증명·소송 문서의 **발송 대행 금지** — 초안·안내까지만
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |