Skip to content

lbiz-partners/hometax-doum / skills/hometax-tax-hub

hometax-tax-hub

Verified

홈택스 도움 스킬의 진입점. 개인사업자의 개업부터 매출·지출, 신고, 납부·환급, 증명, 정정·폐업까지 홈택스 업무를 연결한다. '홈택스 도움 스킬로', '이번 달 세금 업무', '무엇부터 해야 할지' 같은 요청과 여러 업무가 섞인 요청에 사용한다. 부가세·종소세·세금계산서·지출분류가 명확한 단일 요청은 각 전용 스킬이 맡는다. Free 안내와 설치된 Pro 계산·대조 및 전문가 검토 범위를 구별한다.

references/live-ui-verification.md

View on GitHub
# 로그인 전 실제 홈택스 화면 검증 기록

확인일: 2026-09-17 KST. 기계 판독 기록은 저장소 `docs/verification/live-ui-checks.json`(스킬 패키지에는 넣지 않음). 실제 브라우저에서 확인한 대표 경로의 관찰 결과다. 24개 업무는 제품의 업무 묶음이며 전체 메뉴 수가 아니다.

<!-- block:live-screen -->
실제 화면에서는 개인/사업자 상태와 추가 인증·설치·신고기간 제한을 확인한다. 조회 전 초기 값과 조회 후 결과, 작성 화면과 실제 접수·발급·납부를 구별한다. 빈 결과는 선택한 기간·자료원 안에서만 해석한다.
<!-- /block -->

## 로그인 전 확인 범위

- 19개 대표 경로: 로그인 요구 확인.
- 4개 대표 경로: 공개 안내 또는 입력 화면 확인(H01·H09·H14·H16).
- 1개 대표 경로: 공개 조회 결과(H12).
- 추가 계산 사례 S01: 주택임대 공개 모의계산과 로컬 엔진의 5개 항목 대조(H11·H13 연결).
- 이 로그인 전 검사에서는 인증 완료·실제 신고·납부·증명 발급·상담 발송이 0건이었다. `service-catalog.json`의 `live_ui_verified=false`는 업무 전체 완료 검증을 뜻한다. 위 부분 검증과 혼동하지 않는다.

| 업무 | 실제 대표 경로 | 확인한 단계 | 남은 업무 증거 |
|---|---|---|---|
| H01 처음 설정·사업장 전환 | 로그인 → 전자계산서 업무 진입 후 로그인 안내 | 공개 입력 화면 확인 | 사업장·기간·과세유형·자료 보유 확인 |
| H02 사업자등록 신청·정정 | 증명・등록・신청・ 사업장현황 → 개인 사업자등록 신청 | 로그인 요구 확인 | 신청 접수·등록/정정 결과·등록증 내용 확인 |
| H03 휴업·재개업·폐업 | 증명・등록・신청・ 사업장현황 → 휴업·폐업 신고 | 로그인 요구 확인 | 처리결과와 마지막 신고·납부·인건비 후속 확인 |
| H04 계좌·카드·전자송달 | 계산서·영수증·카드 → 사업용 신용카드 등록 및 조회 | 로그인 요구 확인 | 등록/변경 결과·조회 공백·공제 확인 |
| H05 전자세금계산서·전자계산서 | 계산서·영수증·카드 → 전자(세금)계산서 건별발급 | 로그인 요구 확인 | 실제 승인·전송·수정 연결과 수금 상태 분리 |
| H06 현금영수증 | 계산서·영수증·카드 → 현금영수증 건별 발급 | 로그인 요구 확인 | 승인·취소·실제 환불 확인 |
| H07 지출·매입증빙 | 계산서·영수증·카드 → 현금영수증 매입내역(지출증빙) 조회 | 로그인 요구 확인 | 분류 근거·중복·누락·검토결정 확인 |
| H08 매출·정산·입금 | 계산서·영수증·카드 → 신용카드·판매(결제)대행 매출자료 조회 | 로그인 요구 확인 | 자료 범위·매출/증빙/정산/입금의 차이 확인 |
| H09 부가세 기본 | 세금신고 → 부가가치세 과세신고(일반·간이·대리납부) | 공개 안내 화면 확인 | 신고 접수·국세 납부·환급 구별 |
| H10 부가세 심화 | 세금신고 → (모의계산)부가가치세 세액비교 | 로그인 요구 확인 | 자료·항목 대조와 전문가 확인사항 |
| H11 종합소득세 | 세금신고 → 일반신고(모든신고안내유형) → 정기신고 | 로그인 요구 확인 | 소득·기납부·공제 확인과 국세/지방세 완료 분리 |
| H12 장부·결산·공동사업 | 세금신고 → 기준·단순경비율(업종코드) 조회 | 공개 조회 결과 확인 | 본인 검토용 집계·원자료 차이·전문가 인계 |
| H13 면세사업장현황 | 증명・등록・신청・ 사업장현황 → 사업장현황 신고/내역조회 | 로그인 요구 확인 | 대상·예외·업종별 첨부·접수 확인 |
| H14 원천세·외주비 | 세금신고 → 원천세 신고 → 일반신고 | 공개 안내 화면 확인 | 원천세 접수·국세·지방세·지급명세서 별도 확인 |
| H15 지급명세서·소득자료 | 지급명세·자료·공익법인 → 지급명세서 제출/내역조회 | 로그인 요구 확인 | 대상자·귀속/지급기간·수정/중복·접수 확인 |
| H16 직원 연말정산·퇴직 | 장려금·연말정산·기부금 → 편리한 연말정산 > (모의계산) 연말정산 자동계산 → 2025년 | 공개 입력 화면 확인 | 연간 지급·공제자료·정산·지급명세서 준비 |
| H17 국세증명 | 증명・등록・신청・ 사업장현황 → 소득금액증명 | 로그인 요구 확인 | 요구문서·사업장·기간·발급일·원문 확인 |
| H18 접수·고지·납부 | 납부·고지·환급 → 납부할 세액 조회/납부 | 로그인 요구 확인 | 접수·국세납부·지방신고·지방납부 각각 확인 |
| H19 환급 | 납부·고지·환급 → 환급금 상세조회 | 로그인 요구 확인 | 예상·결정·충당·실입금 분리 확인 |
| H20 기한후·수정·경정청구 | 세금신고 → 일반신고(모든신고안내유형) → 수정신고 | 로그인 요구 확인 | 원신고·변경근거·접수·결정·납부/환급 확인 |
| H21 기한연장·유예 | 증명・등록・신청・ 사업장현황 → 신고기한 연장신청 | 로그인 요구 확인 | 신청 접수와 승인·새 기한을 구별 |
| H22 장려금·포인트·지원 | 상담·불복·제보 → 세금포인트 조회 | 로그인 요구 확인 | 자격자료·신청·심사·결정·입금/혜택 구별 |
| H23 상담·소명·대리인 | 상담·불복·제보 → 인터넷 상담하기 | 로그인 요구 확인 | 통지·기한·사실자료·전문가 인계·권한 결과 |
| H24 조건부 세목·외부 연계 | 증명・등록・신청・ 사업장현황 → 해외금융계좌 신고 | 로그인 요구 확인 | 기관별 공식 경로·필요자료·전문가 확인 |

## 실제 계산 대조 사례

2025년 미등록 주택 1개, 연간 임대수입 12,000,000원, 임대 외 소득 0원인 가상 사례를 주택임대 종합·분리과세 모의계산에 입력했다. 종합과세 비교용 장부 필요경비는 6,000,000원, 감면은 적용하지 않았다. 아래 비교는 **분리과세 열**에 한정한다.

| 항목 | 홈택스 화면 | Pro 엔진 |
|---|---:|---:|
| 수입금액 | 12,000,000 | 12,000,000 |
| 필요경비 | 6,000,000 | 6,000,000 |
| 공제금액 | 2,000,000 | 2,000,000 |
| 과세표준 | 4,000,000 | 4,000,000 |
| 감면 전 산출국세 | 560,000 | 560,000 |

결과는 `matched_selected_fields`다. 홈택스는 이 가상 사례에서 종합과세 결정세액 200,000원도 표시했지만, Pro의 `residential_separate`는 종합과세 비교·유리한 신고 선택·지방세·건강보험료를 계산하지 않는다. 모의계산의 일치는 실제 신고서 입력이나 신고 완료의 증거가 아니다. 홈택스 자체 안내도 모의계산 결과를 신고·불복자료로 사용할 수 없다고 명시한다.

H12의 업종코드 조회는 2025년 701102 한 건의 결과를 확인했다. 화면에는 2026년 귀속 경비율은 2027년 4월 이후 조회 가능하다는 안내가 있다. 경비율과 주택임대 분리과세의 법정 필요경비율을 혼용하지 않는다.

## 로그인 후 검증을 이어가는 방법

1. 사용자가 직접 본인 인증을 완료하고 검사할 사업장·기간·권한을 확인한다. 비밀번호·OTP·인증서 비밀값을 대화나 파일에 받지 않는다.
2. 위 표의 업무를 선택하고 현재 화면의 명칭·연도·사업자 유형을 다시 확인한다. 공개 경로와 로그인 후 메뉴가 같다고 가정하지 않는다.
3. 조회 화면부터 확인하고 필요한 합계·행 참조만 가명으로 기록한다. 신고서에 가상 수치를 넣거나 임의로 임시저장하지 않는다.
4. 실제 입력·검증을 요청받은 경우 확인된 자료만 사용하고 입력 화면·오류 검증·제출 직전 요약을 따로 기록한다. 불일치와 1원 차이도 확인 없이 승인하지 않는다.
5. 제출·발급·납부·신청 취소 등 최종 행위는 사용자가 직접 수행한다. 접수번호·정상 처리·납부 결과는 별도 증거로 확인하며, 불명확한 제출을 반복하지 않는다.

## 기록 해석

각 기록에는 실제 이동 URL·확인 시각·대표 메뉴명·부분 검증 단계·증거 파일 SHA-256이 있다. 원본 캡처와 DOM은 별도 검증 산출물의 `qa/browser/`에 보관하며 스킬 패키지에 원본 이미지나 개인자료를 넣지 않는다. 화면은 바뀔 수 있으므로 URL만으로 결과를 재사용하지 않는다. Aside 앱 실행 오류 후 Playwright 브라우저로 실제 사이트를 확인했다. 로그인 및 외부 의존성이 있는 기능의 성공을 로컬 단위 테스트로 대신하지 않는다.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall