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-engine.md
View on GitHub# 미수금 엔진 실행과 입력
**Pro 실행 파일 `assets/receivables-engine.mjs`가 실제 설치되어 있을 때만 이 문서를 읽고 실행한다.** 무료 수동 점검은 `receivables-check.md`를 따르며 엔진 설치를 요구하지 않는다.
`assets/receivables-engine.mjs`는 스킬에 포함된 실제 계산기다. Node.js 18 이상이면 별도 패키지 설치 없이 실행한다. 파일·네트워크 저장 없이 표준입력 JSON을 받아 표준출력 JSON을 반환한다. 원본 통장 파일을 엔진에 전달하지 않는다. AI가 사용자에게 JSON 작성을 요구하는 대신, 민감정보를 제거한 표를 아래 스키마로 옮기고 누락·확인 사항만 질문한다.
```bash
node assets/receivables-engine.mjs --help
node assets/receivables-engine.mjs < 비식별입력.json
```
위 상대경로는 설치된 `tax-invoice-hometax` 폴더를 기준으로 한다. 실제 사용에서는 준비된 비식별 JSON을 표준입력으로 직접 전달해도 된다. 원본을 새 파일에 복사하거나 외부 서비스에 업로드하지 않는다. 오류 시 종료코드 2와 `stderr` 오류 JSON을 반환하고 `stdout` 보고 결과는 내보내지 않는다. 자동 복구라는 명목으로 누락값·오류를 0·빈 배열·확인 완료로 채우지 않는다.
## 입력 스키마
표에 있는 필수값은 생략할 수 없다. 알 수 없는 필드, 금액 문자열·소수, 잘못된 날짜, 중복 ID, 잘못된 수정·환불 연결은 오류다. 금액은 원 단위 JSON 정수로 넣는다(`"1,000,000"`이 아니라 `1000000`). 날짜는 `YYYY-MM-DD`다. 명의는 원문이 같을 때만 일치로 취급하며 법인표기 제거·유사어·대표자명 추정을 하지 않는다.
| 필드 | 내용 |
| --- | --- |
| `asOf` | 사용자와 확인한 점검 기준일 |
| `period` | `{from, to}`: 계산서 작성일 기준 조회 기간. 종료일은 기준일 이하 |
| `segments` | 다운로드 구간별 `{from, to, count}` 배열. 단일 조회도 1개 구간을 넣고 실제 원본의 건수를 기재. 구간은 전체 기간을 공백·중복 없이 덮어야 함 |
| `reportedCounts` | 홈택스 목록 총계의 `{total, 청구, 영수}`. 원본·수정분을 모두 원래 구분으로 세고, 입력 행과 대조. 이 값을 입력 행 수에서 임의로 만들어 내면 목록 누락을 검출할 수 없음 |
| `bankCoverage` | 통장이 없으면 `null`. 있으면 아래 범위·확인값 객체 |
| `invoices` | 계산서 원본·수정분 배열. 목록이 실제 0건인 경우에만 빈 배열 |
| `deposits` | 통장이 없으면 `null`. 자료를 확인했고 입금이 실제 없을 때만 빈 배열. 입금·연결 환불 배열 |
| `confirmations` | 사용자의 건별 응답 배열. 아직 응답을 받지 않았으면 빈 배열 |
`bankCoverage`는 `{from, to, complete, priorPaymentsReviewed, nonBankPaymentsReviewed}`다. `complete`는 해당 구간의 대상 계좌 입금·관련 취소가 빠짐없이 제공됐는지, `priorPaymentsReviewed`는 기간 전 선수금·이월 수령액을 확인했는지, `nonBankPaymentsReviewed`는 현금·상계·어음 등 통장 밖 결제를 확인했는지다. 세 확인값은 `true`/`false`만 허용하며 사용자가 확인하지 않았으면 `false`다. 통장 시작일이 계산서 조회 시작일 이후이거나, 통장 종료일이 기준일과 다르거나, 확인값 하나라도 `false`면 연결 흔적이 없어도 미입금으로 분류하지 않는다. 정확 일치 흔적은 후보로 보여 줄 수 있다.
계산서 행:
| 필드 | 내용 |
| --- | --- |
| `no`, `partner`, `date`, `amount`, `kind` | 필수: 계산서 고유 ID·거래처명·작성일·부가세 포함 합계·`청구` 또는 `영수` |
| `amendOf` | 수정분에만 원본 ID. 음수는 필수이며, 양수 증액 수정에도 사용 가능. 수정분끼리 연쇄 연결하지 말고 같은 거래처의 선행 원본에 직접 연결 |
| `dueDate` | 선택: 사용자와 확인한 약정 결제기일. 없으면 작성일 경과일수를 참고치로 표시 |
| `settlement` | 선택: `bank`/`cash`/`offset`/`note`/`pg`/`unknown`. 통장 밖 결제·어음·PG 정산 또는 미확인은 자동 완납 후보 제외 |
원본은 양수, 수정 후 순액은 0 이상이어야 한다. 순액 0은 `cancellations`로 별도 보고하고, 그 외에는 원본 구분을 기준으로 순액 1건을 만든다. 기재사항 착오 등으로 거래처가 바뀌거나 원본이 조회 범위 밖이면 임의로 이어 붙이지 말고 원본 관계를 먼저 확인하고 조회 범위를 넓힌다.
입금 행은 `{id, date, amount, name}`이다. 환불·입금취소를 확인한 경우 음수 금액과 `reverses: 원입금ID`를 함께 넣는다. 음수 거래는 같은 명의의 선행 양수 입금과 연결되어야 하며 누적 환불액이 입금액을 넘으면 오류다. 일반 출금을 마구 포함하지 않는다. 다른 명의로 환불한 건처럼 연결이 확인되지 않은 사례는 금액을 바꾸거나 가짜 연결을 만들지 말고 미확인 사유로 남긴다. 원입금에 환불 이력이 있으면 자동 완납 후보·은행 완납 확인에 사용하지 않는다.
사용자 확인 행은 `{no, status, note}`가 기본이다. `status`는 `입금완료`/`미입금`/`판단불가` 중 하나이며, `note`에 실제 응답의 요지를 적는다. `입금완료`는 `method`도 필요하다.
- `method: bank`: `depositIds` 배열 필수. 연결 입금 합계가 순액과 정확히 같아야 하며, 같은 입금은 다른 확인에 재사용할 수 없다. 명의 차이·선금·분할입금은 사용자가 귀속·완납을 확인한 경우에만 이 방식으로 확정한다.
- `method: cash` 또는 `offset`: 사용자가 현금·상계로 완납을 확인한 메모가 필요하며 `depositIds`는 넣지 않는다.
- 부분입금, 합산 입금 1건의 다건 분배, 수수료 차감·어음·환불 관계가 남아 있는 건은 `판단불가`와 확인 메모로 유지한다. 정확한 배정이 이 스키마로 표현되지 않으면 금액을 조작하지 않는다.
## 합성 예제
아래는 실행 확인용 가상자료다. 실제 확인값을 대신하는 기본값으로 사용하지 않는다.
```json
{
"asOf": "2026-09-12",
"period": {"from": "2026-07-01", "to": "2026-09-12"},
"segments": [{"from": "2026-07-01", "to": "2026-09-12", "count": 1}],
"reportedCounts": {"total": 1, "청구": 1, "영수": 0},
"bankCoverage": {
"from": "2026-07-01", "to": "2026-09-12", "complete": true,
"priorPaymentsReviewed": true, "nonBankPaymentsReviewed": true
},
"invoices": [{
"no": "가상-I1", "partner": "가상거래처", "date": "2026-07-10",
"amount": 1100000, "kind": "청구", "dueDate": "2026-08-10"
}],
"deposits": [{
"id": "가상-D1", "name": "가상거래처", "date": "2026-07-20", "amount": 1100000
}],
"confirmations": []
}
```
예상 결과는 `status: 판단불가`, `candidate: true`, 연결 후보 `가상-D1`이다. 자동으로 입금완료가 되지 않는다. 사용자가 해당 건 완납을 확인한 뒤에만 `confirmations`를 다음으로 바꾸어 재실행한다.
```json
[{"no": "가상-I1", "status": "입금완료", "method": "bank",
"depositIds": ["가상-D1"], "note": "사용자가 이 입금이 해당 계산서의 완납 대금임을 확인"}]
```
## 결과를 보고서에 옮기는 순서
1. 종료코드 0, `gate.status: 통과`와 실제 구간·목록 총계를 확인한다. `dataCompleteness`에 통장·결제 확인이 미완료로 나오면 보고서에도 노출한다. 게이트 통과는 원본 자체의 진실성이나 세무 처리를 보증하지 않는다.
2. `rows`를 `status` 3종으로 빠짐없이 나누고, `candidate`는 판단불가 표의 추가 정보로만 표시한다. `confirmation`이 없으면 사용자가 수령 여부를 확정했다는 문구를 쓰지 않는다.
3. `gate.classification`과 `summary`를 그대로 사용한다. 수정·취소 집계는 `cancelledClaimRows`, `mergedClaimRows`, `targetCount`로 대조한다.
4. `cancellations`의 환불 필요 여부와 `receiptChecks`를 별도 노출한다. 환불 경고는 관련 흔적을 찾았다는 의미이며 환불채무를 확정한 것이 아니다.
5. 결제기일 기준 경과일수 또는 발행일 참고치와 그 단서를 유지한다. 실제 입금일·지급기일·독촉 여부를 추측하지 않는다.
6. `receivables-check.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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |