Skip to main content
Glama
korean-tax-calc-mcp

korean-tax-calc-mcp

korean-tax-calc-mcp — Korea Tax Calculator MCP (한국 세금 계산)

데모: 결산 자료 폴더(계정별 원장·대장·계약서) → 법인세 세무조정과 해외법인 거래 검토 → 부가가치세 신고서 → 원천징수이행상황신고서, 탭마다 법정서식인 검토용 엑셀

영상: Claude 앱 + 이 서버와 짝 서버 korean-tax-mcp. 결산 자료 폴더를 주고 한 줄씩 세 번 요청하면 법인세 세무조정, 부가가치세 신고서, 원천징수이행상황신고서가 법정서식 엑셀로 나옵니다(2026-11-13, 회사·인물·금액은 가상 예시).

PyPI MCP Registry License: MIT Built with Upstage Solar Pro 4 · English

Korean tax calculations for AI agents — code, not guesses.

세금 계산은 AI가 자주 틀립니다. 이 서버는 법인세·소득세·부가가치세·원천세·국제조세·상속증여세 계산과 세무조정을 코드로 하고, 결과마다 근거 조문을 붙입니다. 도구 142개, 세율·한도 연도표 2016~2026, 연도표가 없는 해는 추정하지 않고 멈춥니다. 외국 기업·주재원·한국 자회사용 계산(외국인 근로자 단일세율, 비거주자 원천징수, 외국법인 지점세, 국외전출세 등)도 있고, 영어로 물어도 됩니다 — 도구 설명 첫 줄이 영어이고 find_tool은 영어 검색어도 받습니다. 결과는 법정서식 검토용 엑셀로 내보낼 수 있습니다.

세무 자문이 아닙니다. 결과는 근거·계산 과정을 보여 주는 참고 자료이며, 신고·불복 판단은 세무 전문가와 확인하세요. 생성형 AI는 PDF 도구 3개와 국내 비교기업 후보 도구의 매출 행 분류(선택)에만 쓰며 결과에 표시합니다 — 면책·AI 고지 전문

설치

claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp
{
  "mcpServers": {
    "korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] },
    "korean-tax":      { "command": "uvx", "args": ["korean-tax-mcp"], "env": { "LAW_OC": "법제처 OC(무료, 선택)" } }
  }
}

키 없이 동작합니다. 두 번째 줄은 조문·해석을 찾는 짝 서버 korean-tax-mcp이고, 계산만 쓰려면 첫 줄만 넣어도 됩니다.

Related MCP server: fin-law-mcp

작동 방식

flowchart LR
  Q["질문 — 한국어·영어"] --> F["find_tool<br/>평소 말·영어 검색어로 도구 찾기"]
  D["결산 자료<br/>원장·대장·계약서"] --> M
  F --> M["AI<br/>사실관계를 도구 입력으로 옮김"]
  M --> V["입력 확인<br/>모르는 항목·빠진 값 거부"]
  V --> T["그해 기준값<br/>세율·한도·공제율 2016~2026"]
  T --> E["계산·세무조정 도구<br/>법인세·소득세·부가세·원천세<br/>국제거래·상속증여"]
  T --> P["외국인·외국계 도구<br/>단일세율·외국인기술자 감면<br/>비거주자 원천징수·상속증여<br/>지점세·국외전출세"]
  E --> R["결과<br/>금액·계산 과정<br/>근거 조문·한계"]
  P --> R
  R --> X["집계·검토용 엑셀<br/>법정서식·판단 근거"]
  T -.->|표 없는 연도| N["멈춤<br/>추정 계산 안 함"]
  M -.->|요건·조약 세율| K["korean-tax-mcp<br/>조문·해석·요건 안내·PE 판정"]
  R -.->|결과의 조문 확인| K
  F -.->|계산 도구 없는 질문| K

끝수 처리 — 과세표준은 1원 미만을, 세액 계산값(산출세액·공제·감면·가산세)은 원 미만만 버려 원 단위로 냅니다(원 미만 처리 규정이 없는 곳은 최종 금액에서만 버림). 국고·지방자치단체에 실제로 내거나 돌려받는 금액은 10원 미만을 버려 결과의 납부할 금액(10원 미만 버림)(환급뿐이면 환급받을 금액(10원 미만 버림))에 따로 보여 줍니다 — 국고금 관리법 제47조, 지방세기본법 제59조. 원천징수세액은 한 소득자·한 번 지급분 합계에서 버립니다(withholding_tax·nonresident_withholding은 그 값을 바로 10원 단위로 냄).

이렇게 물어보세요

질문

쓰는 도구

"2025 사업연도 과세표준 5억 법인세 산출세액은?"

corporate_tax

"가지급금 3월 1일 2억 대여, 9월 30일 1억 회수 — 인정이자 계산해줘"

deemed_interest

"과소신고 1천만 원을 10월 7일에 납부하면 가산세는?"

underreporting_penalty · late_payment_penalty

"결산자료 폴더 보고 2025 사업연도 법인세 세무조정해서 법정서식 엑셀로 줘. 해외법인 거래도 같이 봐줘"

세무조정 도구 → income_adjustment_total → export_workbook

"2기 부가세 확정신고도 검토해서 신고서 서식으로 줘"

부가세 부품 도구 → vat_return_general

"이번 달 원천징수 내역으로 원천징수이행상황신고서 만들어줘"

withholding_tax 등 → withholding_return

"외국인 직원 2025년 총급여 8천만 원 — 단일세율 19%가 누진세율보다 유리해?"

foreign_worker_flat_tax

"미국 모회사에 사용료 10만 달러를 보내면 원천징수 세액은?"

nonresident_withholding (조약 제한세율은 korean-tax-mcp treaty_withholding_rates)

어떤 도구를 쓸지 모르면 find_tool에 평소 말로 물어보면 됩니다.

링크: English README · 사용 사례 · 소개 페이지 · 국영문 용어집 · llms.txt · 변경 이력 · 짝 서버 korean-tax-mcp(근거) · korean-report-hwpx(공문서 HWPX)


korean-tax-mcp는 조문·부칙·해석·판례를 찾는 짝 서버입니다. 같이 두면 근거 찾기 → 계산 → 서식이 한 대화에서 이어지고, 이 서버의 find_tool도 계산 도구가 없는 질문(월세·연금계좌 세액공제, 주식 양도 등)에 바로 부를 조문 호출값을 돌려줍니다.

새 버전으로 바로 바꾸려면 uvx --refresh korean-tax-calc-mcp(uvx는 받은 버전을 캐시합니다). 특정 버전 고정은 uvx korean-tax-calc-mcp@0.61.0.

선택 키: LAW_OC(세무조사 판정 도구 2개의 법제처 조문 조회), UPSTAGE_API_KEY(PDF 표 추출·공시 매출 행 분류), VWORLD_KEY(부동산 공시가격 조회), DART_API_KEY(국내 비교기업 후보 — OpenDART에서 본인 키를 무료 발급, 약관상 본인만 사용. 없으면 그 도구만 꺼짐).

  • "퇴직금 1억, 근속 15년 퇴직소득세"

  • "기업업무추진비 원장 5건 그대로 줄게 — 2025 사업연도 세무조정 뽑아줘"

  • "미국 판매법인 영업이익률 7.5%, 비교대상 8곳 이익률 줄게 — 정상가격 범위 안이야?"

  • 외국 기업·주재원 질문은 아래 '외국 기업·주재원·한국 자회사' 참조

  1. 입력 확인 — 모르는 항목·빠진 값이 있으면 계산하지 않고 무엇이 필요한지 알려 줍니다.

  2. 그해 기준값 — 세율·한도는 코드 안 연도표(법인세·소득세 2016–2026, 부가세 2016년 1기–2026년 2기), 항목별 판단 기준은 facts_vocab.json(107개 항목, 적용 기간·근거 조문 포함)에서 꺼냅니다. 연도표는 각 연도 시행본과 부칙으로 대조했습니다.

  3. 계산 — 조문 순서대로 계산합니다. 예: 과세표준 → 그해 세율 구간 → 산출세액.

  4. 세무조정 항목 — 조정 도구는 익금산입·손금불산입 같은 조정과 금액, 소득처분(유보·상여·기타사외유출, 국제거래는 임시유보 등), 근거 조문을 함께 돌려줍니다. 이 항목을 그대로 집계 도구에 넣습니다.

  5. 집계와 서식 — 법인세는 income_adjustment_total, 부가가치세는 vat_return_general, 원천세는 withholding_return이 서식 칸 순서로 모으고, export_workbook이 같은 호출을 다시 실행해 법정서식 엑셀을 만듭니다.

요건과 과세연도별 판단(세액공제 대상 여부, 정상가격 산출방법, 국내사업장 판정 등)은 짝 서버 korean-tax-mcp가 맡습니다. 이 서버는 요건을 갖춘 금액을 받아 계산만 하고, 결과에서 조문 확인을 안내합니다.

도구 142개 중 PDF 도구 3개와 국내 비교기업 후보 도구를 뺀 137개는 생성형 AI 없이 코드로 동작합니다. 그중 시세·공시가격 조회 2개는 KRX·브이월드 공개 데이터를 가져오기만 합니다. PDF 도구 3개와 국내 비교기업 후보 도구는 UPSTAGE_API_KEY가 있을 때만 Upstage를 씁니다(후보 도구는 OpenDART 공시를 가져오고, 키가 없으면 매출 행을 이름 규칙으로 분류).

도구는 하나씩도 쓰지만, 앞 도구의 결과가 다음 도구의 입력이 되도록 이어집니다.

flowchart TD
  L["장부·사실관계<br/>항목 이름·금액·증빙"] --> A["항목별 세무조정<br/>기업업무추진비·감가상각·대손<br/>인정이자·지급이자·승용차"]
  L --> I["국제거래<br/>정상가격 범위·대여 이자·파견 인건비<br/>외국자회사 배당·배당간주"]
  A -->|세무조정 항목| T["차가감소득금액<br/>income_adjustment_total"]
  I -->|세무조정 항목| T
  T -->|기준소득| D["기부금 한도<br/>donation_limit"]
  D -->|한도초과액| T
  T --> B["과세표준<br/>이월결손금 한도"]
  B --> C["산출세액<br/>corporate_tax"]
  C --> G["세액공제·감면·최저한세<br/>고용·투자·연구개발·창업감면"]
  G --> X["법정서식 엑셀<br/>export_workbook"]
  V1["부가세 부품 도구<br/>과세표준·간주공급·매입세액·환산·대리납부"] --> V2["부가가치세 신고서<br/>vat_return_general"] --> X
  W1["원천징수 계산<br/>거주자·비거주자·근로·일용"] --> W2["원천징수이행상황신고서<br/>withholding_return"] --> X
  P["외국인·외국계 개별 계산<br/>외국인 단일세율·기술자 감면<br/>비거주자 양도 원천징수·상속증여<br/>지점세·국외전출세"] -->|계산 시트| X
flowchart LR
  U["세금 질문<br/>한국어·영어"] --> L["korean-tax-mcp<br/>근거: 조문·해석·조약·요건·PE"]
  U --> F["find_tool<br/>korean-tax-calc-mcp"]
  F -->|맞는 계산 도구| C
  F -.->|계산 도구 없음 → 조문 호출값| L
  L -->|"요건 충족 금액·조약 제한세율"| C["korean-tax-calc-mcp<br/>계산·세무조정·법정서식"]
  C -.->|"결과의 조문 확인 안내"| L
  C --> X["검토용 엑셀"]
  L --> H["korean-report-hwpx<br/>검토서·보고서 HWPX"]
  C --> H

근거는 korean-tax-mcp가 찾고, 이 서버가 계산·세무조정·법정서식 엑셀을 만들고, korean-report-hwpx가 검토 결과를 한글(HWPX) 보고서로 만듭니다.

영어로 물어도 한국 조문 근거로 답합니다. 도구 설명 첫 줄은 영어 한 줄 뒤에 국문 용어를 붙인 형식이고(예: Entertainment expense limit and non-deductible excess for corporate tax (기업업무추진비 한도).), find_tool은 "late payment penalty", "transfer pricing arm's length range" 같은 영어 검색어도 받습니다. 영문 용어는 법제처 영문법령을 따랐고(국영문 용어집), 결과는 한국 조문을 인용합니다. 짝 서버와 함께 푼 사례는 사용 사례에 있습니다.

질문

도구

이 사람이 한국 거주자인가?

짝 서버 korean-tax-mcp의 residency_check · residency_report

나라별 조세조약 제한세율

korean-tax-mcp의 treaty_withholding_rates · tax_treaty

비거주자·외국법인에 지급하는 이자·배당·사용료·용역 대가의 원천징수

nonresident_withholding

국외사업자에게 산 용역의 부가가치세 대리납부

vat_reverse_charge

국외지배주주 차입금 중 배수 초과분 이자(과소자본)

thin_capitalization

정상가격 범위, 비교대상 기업 선정, 국내 비교기업 후보·프로필 비교, 국제거래명세서

arm_length_range · tp_comparable_screen · kr_comparable_candidates · kr_comparable_profile_compare · ksic_lookup · international_transaction_statement

외국납부세액공제(법인·개인)

foreign_tax_credit · individual_foreign_tax_credit

외국자회사 배당 — 익금불산입과 외국납부세액공제 비교, 2026년 수령분 100% 익금불산입(조세특례제한법 제23조의2)

foreign_subsidiary_dividend

해외 파견 직원 — 정상가격 가산 청구액, 손금, 국외근로 비과세

expat_cost_recharge

저세율국 자회사의 특정외국법인(CFC) 과세

cfc_deemed_dividend · cfc_actual_dividend · cfc_share_disposal

해외현지법인 명세서, 해외직접투자 외국환 신고, 해외금융계좌 신고

overseas_subsidiary_statement · foreign_exchange_reporting · overseas_account_reporting

외국인 근로자 단일세율 19%와 누진세율 비교, 외국인기술자 감면

foreign_worker_flat_tax · foreign_expert_income_reduction

비거주자의 국내 부동산·주식 양도 원천징수, 비거주자 상속세·증여세

nonresident_capital_gains_withholding · nonresident_inheritance_gift

국내 지점이 있는 외국법인 — 지점세, 국내사업장(PE) 판정

branch_profits_tax · korean-tax-mcp의 permanent_establishment_guide

거주자 대주주의 국외 이주 — 국외전출세

emigration_exit_tax

본사 세무팀·외국 회계사가 읽을 영문 표기 법정서식 엑셀·검산 시트 — 라벨을 'English (국문)'으로

export_workbook·verify_workbook에 lang="en"

직접 짠 계산 근거·보고용 엑셀의 금액 칸을 계산 도구 결과와 대조하고, 대조하지 않은 금액을 알려 줌

verify_workbook

질문 예:

  • "한국 자회사가 미국 모회사에 사용료 10만 달러를 지급해요. 원천징수 세액은 얼마이고 조약으로 무엇이 달라지나요?"

  • "2026년에 베트남 자회사로 엔지니어를 파견했어요. 5% 가산해 얼마를 청구하고, 급여 중 얼마가 한국에서 손금인가요?"

  • "한국 자회사가 지분 30%인 싱가포르 회사에서 2026년에 배당을 받았어요. 익금불산입과 외국납부세액공제 중 무엇이 맞나요?"

  • "외국인 직원인데 2025년 총급여가 8천만 원이에요. 단일세율 19%가 일반 세율보다 싼가요?"

아래 표는 export_workbook이 만드는 법정서식 파일의 시트 구성입니다. 수식 칸에는 계산 값도 함께 저장해 휴대폰·메신저 미리보기처럼 수식을 다시 계산하지 않는 곳에서도 값이 보입니다(Excel에서 열면 수식으로 다시 계산). 만든 파일을 openpyxl 등으로 다시 저장하면 그 값이 지워지므로, 글·라벨을 바꿀 때는 입력(labels·scenarios·sources·issues·review_notes)을 고쳐 다시 호출하고, 다시 저장했다면 verify_workbook을 거치면 값이 다시 채워집니다 — labels는 {원래 라벨: 표시할 글} 표로, 영문 문서에 국문으로 남은 라벨(결과의 번역_없음)에 영문을 붙일 때 씁니다.

계산 근거·보고용 Excel은 AI가 직접 짭니다 — 구성·시트·이름은 자유이고, 읽는 사람의 질문 단위로 필요한 줄만 넣습니다. 금액은 계산 도구를 호출해 얻고, 저장한 뒤 verify_workbook으로 금액 칸을 대조합니다. 대조하지 않은 금액은 사용자에게 밝힙니다.

  • verify_workbook(path, checks, auto) — 계산 도구 결과마다 짧은 호출_id(예: c7)가 붙습니다. checks에 {cell: "시트!칸", call: "c7"}만 적으면 그 호출의 결과와 칸 값을 견줍니다(key를 빼면 값이 같은 결과 키를 찾고, 없으면 가장 가까운 키와 차이를 알림). 칸만 적거나 auto=true를 주면 보관된 모든 호출 결과에서 같은 값을 찾습니다 — 같은 숫자가 우연히 일치할 수 있어 '자동(값 일치)'으로 따로 표시하고 셉니다. 호출_id는 서버가 켜져 있는 동안만 살아 있으므로(최근 300건) 기록이 없으면 {cell, tool, args}로 대조합니다.

  • 돌려주는 것: 일치·불일치(두 값과 차이), 어떤 대조에도 걸리지 않은 금액 목록, 부가 점검. 사본에는 대조 결과 시트('검산') 한 장을 붙입니다 — 한 줄 요약, 대조 표(근거는 번호로, 같은 근거는 표 아래에 한 번만), 대조 안 한 금액은 시트마다 한 줄. 원본은 그대로이고 사본의 수식 칸에는 값을 채웁니다.

  • export_workbook — 한국 법정서식(별지 서식) 엑셀을 만듭니다. 칸 번호·문구가 정해진 신고 서식이며, 일반 계산 근거 통합 문서에는 쓰지 않아도 됩니다. 선택 입력(scenarios·sources·issues·actions·key_figures·extra_sheets·labels·detail)은 표준 틀의 계산 근거가 필요할 때를 위해 그대로 남아 있습니다.

선택 입력(scenarios·sources·issues·actions·key_figures 가운데 하나라도 줄 때)의 요약 시트는 한 화면입니다 — 핵심 숫자 표(항목 / 금액 / 계산 위치 링크 / 메모, 합계 줄은 굵게 + 노랑), 조치·기한 표, 쟁점 수 한 줄, 색 범례. 뒤 시트 구성과 detail 안내는 시트에 찍지 않고 결과의 시트_안내·서식_안내로만 돌려줍니다. 아래 표는 선택 입력 없이 만들 때의 시트입니다.

시트

내용

요약

세액 요약, 세무조정 항목별 조정·금액·소득처분·근거 조문·계산 시트, 호출별 주요 값, 검토·확인 필요 사항(review_notes로 넘긴 자료 불일치·가정·쟁점)

목록

서식 원문의 출처, 서식 틀이 없는 도구, 호출별 계산 시트 안내

법정서식

아래 표의 서식. 금액 칸은 '입력·가정'의 이름이나 앞 칸을 가리키는 수식이고, 줄마다 도구 값과 "일치/확인 필요" 대조

계산 N

도구 호출마다 한 장 — 결과, 계산 과정, 판단, 근거

입력·가정

서식 수식이 참조하는 입력값과 이름

판단·근거

항목별 결론, 금액, 근거 조문과 이유

scenarios·sources·issues·actions·key_figures 가운데 하나라도 주면 통합 문서가 됩니다(주지 않으면 위 구성 그대로). 기본은 아래 앞 시트와 '계산 상세' 한 장이고, 뒤 시트는 detail로 고릅니다.

시트

내용

요약(Summary)

한 화면 — 핵심 숫자 표(항목 / 금액: 시나리오 시트 칸을 가리키는 수식 / 계산 위치 링크 / 메모, 합계 줄 강조), 조치·기한 표(actions), 쟁점 수, 색 규칙 범례. 줄은 key_figures로 고르고, 안 주면 블록마다 권고 열(recommended)의 결과 줄

입력·출처(Inputs)

입력값과 법정 세율·이율을 한곳에 모으고 값마다 출처(문서명·조문) 열

시나리오 시트

계산을 열로 나란히(예: A 계약대로 / B 대안) 놓고 오른쪽에 근거·메모 열. 입력 칸을 가리키는 수식이고 블록 끝에서 도구 값과 대조

자유 형식 시트(extra_sheets)

도구 계산이 아닌 표를 받은 그대로 — 머리 행 4행, 첫 행 5행. 같은 시트 안의 수식과 계산 도구 결과 링크({from_call, from_row})만 받고, 시트 머리에 "계산 도구의 검증을 거치지 않음"

쟁점 목록(Issues Log)

번호·쟁점·발견·위험도·조치 — 적어 준 글을 그대로 표로(도구는 쟁점을 판단하지 않음)

계산 상세(Calc detail)

계산별 도구 결과와 판단·근거를 한 장에 위아래로

detail

뒤에 붙는 시트

compact(기본)

'계산 상세' 한 장. 신고 서식이 있으면 요약 끝에 안내 한 줄

forms

'계산 상세' + 신고 서식 시트

full

신고 서식, 계산별 '계산 N', 입력·가정, 판단·근거, 목록까지 전부

색 규칙은 파랑 = 입력, 초록 = 다른 시트 링크, 검정 = 수식, 노랑 = 핵심 결과·가정입니다.

세목

서식

법인세

별지 제3호(과세표준 및 세액조정계산서), 제4호(최저한세조정계산서), 제8호(갑)(공제감면세액), 제15호(소득금액조정합계표, 처분 코드), 제16호의2(수입배당금), 제20호(1)(2)(감가상각 정률·정액), 제21호(기부금), 제23호(갑)(을)(기업업무추진비), 제26호(갑)(을)(업무무관 지급이자), 제29호(업무용승용차), 제32호·제33호(퇴직급여·퇴직연금), 제34호(대손), 제50호(을)(유보)

부가가치세

별지 제21호 신고서 제1쪽 (1)(30)(20162024년 과세기간과 2025년 제1기 예정신고는 그 해 서식 판)과 제4쪽 가산세액 명세, 공제받지 못할 매입세액 명세서(별지 제22호), 의제매입세액 공제신고서(별지 제15호), 대손세액 공제신고서(별지 제19호(1)), 부동산임대공급가액명세서(별지 제25호), 공통매입세액 안분·일괄공급 안분 계산 근거(서식 없음, 시행령 제63조·제64조)

원천세

원천징수이행상황신고서(소득세법 시행규칙 별지 제21호) 제1쪽, 이자·배당 원천징수영수증·지급명세서(별지 제23호(1)), 비거주자 원천징수영수증·지급명세서(별지 제23호(5))

국제조세

국제조세조정에 관한 법률 시행규칙 별지 제16호(갑)(국제거래명세서), 제20호(정상가격 산출방법 신고서), 제30호(갑)(특정외국법인 유보소득 계산), 제31호(갑)(을)(병)(합산과세 판정), 제32호(갑)(을)(적용범위 판정), 제47호(해외현지법인 명세서), 제48호(재무상황표) — 2021 사업연도부터. 2016~2020 사업연도는 그 해 서식 판: 국제거래명세서(구 별지 제8호(갑) 2016·2017·2018판, 별지 제16호(갑) 2021판 — 국외특수관계인별 한 장), 정상가격 산출방법 신고서(구 별지 제1호의3 2015·2020판, 별지 제20호 2021판), 해외현지법인 명세서·재무상황표(구 법인세법 시행규칙 별지 제81호·제82호, 별지 제47호·제48호 2021판)

종합소득세·양도·증여

종합소득세 별지 제40호(1)의 이자·배당소득명세서와 근로·연금·기타소득명세서, 양도소득세 별지 제84호 신고서 세액 계산·부표1, 증여세 별지 제10호

lang="en"을 주면 시트 이름, 요약 시트 라벨, 표 머리글, 결과 키를 'English (국문)'으로 적습니다(예: "Tax base (과세표준)"). 번역표는 용어집이고, 용어집에 없는 국문 라벨은 그대로 두어 요약 시트의 'Untranslated labels (번역 없음)' 목록과 결과의 warnings에 모읍니다. 법정서식 시트는 한국어 그대로 두고 시트마다 한 줄 영문 안내를 붙이며, 도구가 돌려준 문장(결론·이유·주의·한계)은 번역하지 않고 'Notes (Korean original)' 칸에 둡니다. 도구가 돌려준 근거 조문은 규칙으로 영문 인용으로 바꿉니다 — 법령명은 법제처 영문법령의 제명, 조문 번호는 "제98조제1항제6호" → "Art. 98(1)6" 꼴이고 처음 나올 때 국문을 병기합니다(예: "Corporate Tax Act (법인세법) Art. 98(1)6"). 근거의 서술 구절은 용어집에 통째로 있는 것만 영문으로 적고, 영문 제명을 확인하지 못한 법령과 용어집에 없는 구절은 국문 그대로 두어 결과의 번역_없음에 올립니다(labels에 넣어 다시 호출하면 그 글로 적음). verify_workbook(lang="en")의 'Tool check' 시트도 결과 키와 근거를 같은 방식으로 적고 labels를 받습니다. 숫자와 수식은 국문 엑셀과 같습니다.

서식 틀은 법제처 국가법령정보센터의 서식 원문(PDF)과 칸 배치를 대조해 만들었습니다. 서식에 따라 일부 쪽·칸만 옮겼고(인적사항, 부표 등은 제외), 옮기지 않은 부분은 '목록' 시트에 적습니다. 계산 과정을 보여 주는 참고 자료이며 세무조정계산서 작성·신고 대리가 아닙니다.

묶음 이름을 누르면 도구 목록이 펼쳐집니다.

도구

하는 일

corporate_tax

산출세액

entertainment_limit

기업업무추진비 한도

deemed_interest

가지급금 인정이자

unfair_transaction

부당행위 기준

loss_carryforward_limit

이월결손금 한도

nonbusiness_interest_disallowance

업무무관 지급이자(가지급금 제외 판정·적수·순위)

business_car_expense

업무용승용차

donation_limit

기부금 한도

nonprofit_reserve_limit

비영리내국법인 고유목적사업준비금 손금산입 한도(법 제29조)

bad_debt_allowance

대손충당금 한도

missing_receipt_disallowance

적격증빙 미수취

dividend_received_deduction

수입배당금 익금불산입

tax_adjustment_schedule

연도별 세무조정 묶음 — 여러 사업연도의 순손익·조정 → 각 사업연도 소득·이월결손금 공제·과세표준·산출세액·항목별 유보 잔액, 국외특수관계인 정상가격 조정의 임시유보·출자의 증가·이전소득 배당(법인세법 제14조·제13조·제67조, 국조령 제22조~제25조)

loss_carryback_refund

결손금 소급공제 환급 — 직전 사업연도 법인세 환급액과 이월할 결손금(법인세법 제72조)

loss_carryforward_ledger

이월결손금 다기간 추적 — 발생 연도별 잔액, 연도별 공제액·과세표준, 공제기간 경과 소멸(법인세법 제13조①, 영 제10조②)

provision_reserve_ledger

충당부채(포인트·마일리지, 판매보증) 세무조정 다기간 추적 — 연도별 적립·사용·유효기간 소멸에 따른 손금불산입·손금산입·유보 잔액(법인세법 제40조)

asset_grant_reserve

일시상각충당금

corporate_deemed_rent_income

임대보증금 간주익금

liquidation_income

청산소득

disaster_loss_credit

재해손실세액공제

도구

하는 일

foreign_tax_credit

외국납부세액공제

branch_profits_tax

외국법인 지점세(법인세법 제96조) — 재투자 인정액·자본금상당액 증감·송금액 기준, 조약 세율

emigration_exit_tax

국외전출세(소득세법 제118조의9~18) — 출국일 시가 의제 양도, 연도별 세율, 신고·납부유예 안내

thin_capitalization

과소자본

arm_length_range

정상가격 범위와 조정액 — 비교대상 이익률로 사분위·전체 범위, 중위값, 분석대상 값의 범위 안 여부, 조정액과 조정 방향(국조령 제15조⑤⑥). 사분위 계산법 기본은 국세청 기본통칙 8-15…1(위치 (n+2)/4·(3n+2)/4), 엑셀 QUARTILE.INC·EXC·미국식(26 CFR §1.482-1(e)(2)(iii)(C))은 선택, 결과에 세 방식 민감도. 분석대상이 국내 법인인지 국외 법인인지는 필수 입력

tp_comparable_screen

비교대상 기업 선정 — 유료 데이터베이스에서 내보낸 후보 목록(CSV·엑셀)에 독립성·자료·업종·규모·손실·연구개발·광고·특수관계 매출·부문·특수 상황 기준과 사람의 판단(사유 필수)을 적용해 회사별 탈락 사유표, 최종 비교대상, 다년 가중평균 지표, 사분위 범위, 기준을 바꿨을 때의 민감도, 개별기업보고서 부록 표를 냄. 도구가 스스로 적용하는 기준은 법정(최대주주 50%, 둘 이상)뿐이고 관행 기준은 screens로 받은 값만(값·출처는 조문 MCP transfer_pricing_guide). 지속 손실은 기본 사람 확인(자동 제외는 선택), 연도별로 비교대상이 달라도 됨(전 연도 자료 필수는 선택), 다년 범위와 함께 연도별 사분위 범위, 운전자본 조정(선택)을 켜면 조정 전·후 범위

ksic_lookup

한국표준산업분류(11차) 코드 찾기 — 업종 이름 ↔ 코드, 상위 단계·하위 세세분류, 10차 코드 → 11차(구·신 연계표). 국내 비교기업 후보에 넣을 코드를 정할 때. 분류표는 통계청 고시 해설서 원문에서 뽑아 단계별 항목 수를 고시 표와 대조

kr_comparable_candidates

국내 비교기업 후보 — OpenDART 공시(상장 재무 API·비상장 감사보고서 원문)에서 업종 코드로 후보를 모아 연도별 재무와 후보 프로필(매출 구성 6갈래·재고·원재료 재고·유형/무형자산·연구개발·광고·운전자본·특수관계 매출·최대주주 지분)을 근거(접수번호·계정)와 값 상태(확보/불명-없음/불명-못찾음)로 냄. 후보 행은 tp_comparable_screen 입력 열 그대로. 본인 DART_API_KEY 필요

kr_comparable_profile_compare

국내 비교기업 프로필 비교 — 분석대상 프로필(비율)과 후보 프로필을 매출 구성·재고·유형자산·연구개발·광고·판관비·품목 키워드의 차이·배수를 내고, rules로 받은 기준으로 가까움/다름/불명을 판정해(재고·유형자산은 하나만 다르면 사람 확인, 둘 다면 제외 후보) 특수관계 거래 비중·실질 지배 신호 문장(법정 판정 아님)·지속 손실은 사람 확인으로 돌려 포함 후보·사람 확인·제외 후보로 나누고, 사람 확인 목록(사유·근거)과 tp_comparable_screen manual_decisions 초안(사람 확정)을 냄. 관행 기준값은 도구에 없음 — rules가 없으면 법정 기준만. 사유 코드와 기준값마다 법정·법정 준용·관행·우리 규칙 구분 표시

international_transaction_statement

국제거래명세서(국조칙 별지 제16호서식(갑)) 칸 집계 — 국외특수관계인별 매출·매입 계, 대여금·차입금 적수(금액×일수)·평균, 국제거래명세서·요약손익계산서·정상가격 산출방법 신고서 제출 의무(국조법 제16조②·시행령 제36조)·기한, 함께 낼 서식

foreign_subsidiary_dividend

외국자회사 수입배당금 익금불산입·외국납부세액공제

foreign_subsidiary_liquidation

해외 자회사 청산 손익 — 의제배당 또는 청산손실과 손금 귀속 사업연도(법인세법 제16조①4호)

cfc_deemed_dividend

특정외국법인(CFC) 유보소득 배당간주액 — 저율과세·지분율 10%·적용제외·배당가능 유보소득·적용되는 배당간주(전부/수동소득) 판정(국조법 제27조~제31조)

cfc_actual_dividend

특정외국법인 실제 배당의 익금불산입 — 배당간주로 과세된 유보소득을 실제로 배당받으면 발생 순서대로 소진해 익금불산입(중간외국법인 경유 한도 포함), 세무조정 익금불산입·△유보와 원장 갱신(국조법 제32조①·영 제68조, 2016~2020 구 조문)

cfc_share_disposal

특정외국법인 주식 양도 때 배당간주 미배당분의 익금불산입 — (양도 주식분 배당간주금액 − 실제 배당액)을 양도차익 한도로(국조법 제32조②, 2016~2020 구 조문)

overseas_subsidiary_statement

해외현지법인 명세서·재무상황표 — 제출 대상(10%·1억원, 특수관계)·손실거래명세서·기한(6개월), 재무상황표 항등식 확인(국조법 제58조, 영 제98조)

expat_cost_recharge

해외 파견 인건비 청구액·정상가격·손금·비과세

individual_foreign_tax_credit

거주자 외국납부세액공제 — 국가별 한도·조약 제한세율 상한·10년 이월·퇴직소득(소득세법 제57조)

foreign_exchange_reporting

해외직접투자 해당 여부·외국환 신고(사전/사후) 기한·기관·서류, 사후관리 보고서 일정, 청산, 해외직접투자명세 기한

overseas_account_reporting

해외금융계좌 신고의무(월말 잔액 5억 초과)·면제·신고기한·미신고 과태료·수정신고 감경·소명 불이행 과태료(국조법 제53조·제90조)

corporate_filing_obligations

외부감사·외부세무조정·국제거래 자료 제출 의무 판정

도구

하는 일

tax_crime_settlement_amount

통고처분 벌금상당액 — 조세범 처벌절차법 시행령 별표(2014.6.30.·2019.2.12.·2026.2.27. 개정본)로 범칙행위별 1차·2차·3차 이상 금액, 상습 가중·수정신고 감경·방조·심신미약, 경합(가장 무거운 것 + 1/2 또는 합산), 10원 미만 절사, 처벌법 벌금 상한

nominee_gift_tax

명의신탁재산 증여의제 증여세 — 과세표준(명의신탁재산의 금액 − 감정평가수수료, 증여재산공제 없음)·산출세액·신고세액공제, 납세의무자(2019.1.1. 이후 의제분 실제소유자, 2018 이전 취득 해태분 종전), 신고기한·부과제척기간 만료일

도구

하는 일

sme_status

중소기업·소기업 해당 여부 — 업종별 매출 기준(2016, 20172024, 2025), 자산총액, 독립성, 국내 관계기업 합산, 유예기간(조특령 제2조)

startup_tax_reduction

창업중소기업 세액감면 — 창업일·지역·청년·업종(위탁제조·통신판매 포함)별 대상 판정·감면율·감면기간·감면세액(조특법 제6조)

sme_special_tax_reduction

중소기업 특별세액감면 — 규모·지역·업종별 감면율, 한도 1억원, 최저한세(조특법 제7조)

reduction_income_segments

구분경리 감면 대상 소득 — 감면 사업과 그 밖의 사업의 공통익금·공통손금 안분, 결손 사업 결손금 안분, 공제한 이월결손금 귀속, 주된 사업(조특법 제143조, 법인칙 제75조·제76조)

integrated_employment_credit

통합고용세액공제 — 상시근로자 증가 인원 × 1인당 금액, 최초 공제 과세연도와 뒤 12년, 감소 시 중단·추가 납부, 정규직 전환·육아휴직 복귀, 2026 과세연도 개정 계산식(조특법 제29조의8, 20232026)

employment_increase_credit

고용증대 세액공제 — 2018~2024년 증가 인원 × 1인당 금액, 2·3차 공제, 감소 시 중단·추가 납부, 2020년 사후관리 유예, 통합고용과의 선택(조특법 제29조의7·제127조⑪)

integrated_investment_credit

통합투자세액공제 — 연도·규모·자산 구분별 기본공제율, 직전 3년 평균 초과분 추가공제, 20232025 임시 공제, 수도권과밀억제권역 증설투자 배제(조특법 제24조·제130조, 20212026)

rnd_tax_credit

연구·인력개발비 세액공제 — 일반연구·인력개발비 당기분과 증가분 중 선택, 4년 연평균 요건(조특법 제10조①3호, 2016~2026)

minimum_tax

최저한세

minimum_tax_adjustment

최저한세 조정(감면·공제 배제 순서·별지 제4호·제8호서식(갑))

rural_special_tax

농어촌특별세 — 조특법 감면세액 × 20%, 조문별 비과세 여부(농특세법 제4조·시행령 제4조, 2016~2026 연도별 목록과 개정 부칙 적용례)

도구

하는 일

income_tax

종합소득세

withholding_tax

원천징수

nonresident_withholding

비거주자 원천징수

nonresident_capital_gains_withholding

비거주자·외국법인 국내 부동산·주식 양도소득 원천징수(10%·양도차익 20% 중 적은 금액, 상장주식 25% 미만·조약 면제 제외)

nonresident_inheritance_gift

비거주자 상속세(기초공제 2억원만, 신고기한 9개월)·비거주자 수증자 증여세(증여재산공제 없음, 연대납부)

withholding_return

원천징수이행상황신고서(별지 제21호서식 제1쪽) 집계 — 코드별 가감계·총합계·조정환급·납부세액(2016~2026년 귀속, 신고일에 시행 중인 서식)

retirement_income_tax

퇴직소득세

wage_income_tax

근로소득세

foreign_worker_flat_tax

외국인근로자 단일세율(17%·19%) vs 누진세율 비교 — 적용기간·시작 기한·특수관계기업·사택 이익, 지방소득세 포함 (조특법 제18조의2)

foreign_expert_income_reduction

외국인기술자 소득세 감면 — 최초 근로일별 감면 구간과 감면세액 (조특법 제18조)

daily_worker_withholding

일용근로자

deemed_bonus_resettlement

소득처분 상여 재정산

special_tax_credit

특별세액공제

capital_gains_income

양도소득

inheritance_tax

상속세

gift_tax

증여세

estimated_business_income

추계 사업소득

personal_deduction

인적공제

pension_income

연금소득금액

income_loss_offset

결손금 공제

pension_account_withdrawal

연금계좌 인출

inheritance_gift_valuation

상속·증여재산 평가

capital_gains_tax

양도소득 산출세액

housing_deemed_rent_income

주택 간주임대료

housing_rental_income

주택임대소득(비과세·분리과세)

child_tax_credit

자녀세액공제

dividend_tax_credit

배당세액공제(비교산출세액)

religious_income

종교인소득

individual_donation_expense

개인사업자 기부금 필요경비 한도

capital_gains_unfair_transaction

양도소득 부당행위계산 — 저가양도·고가취득 시가 재계산(3억·5% 기준), 증여 후 10년 내 양도 비교 판정(소득세법 제101조)

도구

하는 일

vat_deemed_rent

간주임대료

vat_deemed_input_credit

의제매입세액

vat_common_input_allocation

공통매입세액 안분

vat_simplified_taxpayer

간이과세 납부세액

vat_card_sales_credit

카드 발행세액공제

vat_bad_debt_credit

대손세액공제(회수하면 매출세액 가산)

underreporting_penalty

과소신고가산세

late_payment_penalty

납부지연가산세

withholding_late_payment_penalty

원천징수 납부지연가산세(국세기본법 제47조의5, 3%+일할, 한도). tax="local"이면 함께 특별징수한 지방소득세분(지방세기본법 제56조)

invoice_penalty

세금계산서 가산세

invoice_penalty_bundle

세금계산서 가산세 묶음 — 한 거래에 가산세 사유가 여럿일 때 중복 배제(부가가치세법 제60조② 후문·⑨) 후 합계

assessment_limitation

부과제척기간

refund_claim_deadline

경정청구 기한(통상 5년·후발적 3개월·증액경정분 3개월, 토·일·공휴일 기한 특례 반영)

vat_exempt_use_deemed_supply

면세전용 간주공급

vat_input_tax_deduction

매입세액 공제 판정

vat_deemed_supply_items

간주공급 판정

vat_tax_base_adjustments

과세표준 조정 — 반품(환입)·에누리·할인·장려금·대손금, 마일리지·포인트 결제 거래의 공급가액(부가가치세법 제29조, 시행령 제61조)

vat_supply_timing

공급시기 판정(예정·확정 귀속)

도구

하는 일

bad_debt_adjustment

대손 조정

entertainment_adjustment

기업업무추진비 조정

deemed_dividend_bonus_shares

무상주 의제배당

financial_income_aggregate

금융소득 합산

other_income_aggregate

기타소득

earned_income_gross_pay

근로소득 총급여

simplified_vat_return

간이과세 확정신고

vat_return_general

일반과세자 부가가치세 신고서(별지 제21호서식) 집계 — 부품 도구 결과를 차가감 납부(환급)세액까지 합산

vat_foreign_currency_base

외화 대가 부가가치세 과세표준 환산(시행령 제59조·제95조제3항)

vat_reverse_charge

국외사업자 용역등 대리납부(법 제52조)

common_input_tax

공통매입세액 정산

input_tax_recalculation

매입세액 재계산

bundled_supply_split

토지·건물 안분

depreciation_adjustment

감가상각 시부인

retirement_allowance_adjustment

퇴직급여충당금

deemed_dividend_capital_reduction

감자 의제배당

inventory_valuation_adjustment

재고자산 평가

income_adjustment_total

차가감소득금액

도구

하는 일

stock_major_shareholder

주식 양도세 대주주 판정(주주 명부로 지분율·합산 범위까지)

stock_capital_gains_tax

주식 양도소득세(과세 대상 여부·세율·예정신고기한)

unlisted_stock_valuation

비상장주식 상속·증여 평가(순손익·순자산 가중평균, 할증)

stock_basis_income_tax

비상장주식 소득세법 기준시가

building_standard_price

건물 기준시가(국세청 고시 산식)

stock_price_lookup

상장주식 시세 조회(KRX)

official_property_price

부동산 공시가격 조회(브이월드, VWORLD_KEY)

도구

하는 일

related_judge

특수관계(생계를 함께하는 친족 포함)

kinship_check

친족관계

ownership_ratio

간접보유비율

dominant_shareholder

지배주주

tunnelling_gift

일감몰아주기

tunnelling_gift_nts

일감몰아주기(국세청 산식)

return_precheck

신고서 사전검토

precheck_schema

사전검토 입력 목록

도구

하는 일

extract_relations

관계표

tunnelling_from_pdf

일감몰아주기 자료

return_precheck_pdf

법인세 신고서

도구

하는 일

tax_priority_distribution

국세 우선권 매각대금 배분

도구

하는 일

export_workbook

한국 법정서식(별지 서식) 엑셀

verify_workbook

직접 만든 엑셀을 저장한 뒤 금액 칸을 계산 도구 결과와 대조(호출_id로)

도구

하는 일

find_tool

평소 말로 맞는 도구 찾기

  • 법정서식 엑셀: 시트 구성과 서식 목록은 위 '엑셀 — 직접 짠 통합 문서의 검산과 법정서식 엑셀' 참조. 기업업무추진비는 entertainment_limit 도구로도 별지 제23호(갑)·(을)가 나옵니다.

  • 국제거래 조정의 연결: 정상가격 범위·국외 대여 이자·파견 인건비·외국자회사 배당·배당간주·충당부채 도구는 결과에 세무조정 항목(조정·금액·소득처분·근거)을 함께 돌려주므로 income_adjustment_total에 그대로 넣어 소득금액조정합계표(별지 제15호서식)까지 이어집니다. 정상가격 조정은 반환 여부 확인 전까지 임시유보(코드 700)로 적습니다.

  • 원장 그대로 입력: 세무조정 도구는 장부 항목(이름·금액·증빙·성격)을 그대로 받아 항목 판단 → 세무조정 → 소득처분까지 돌려줍니다.

  • 쟁점 표시: 비거주자 원천징수·과소자본 결과에는 다툼이 될 수 있는 지점과 확인할 자료를 함께 붙입니다(결론은 내리지 않음).

  • 지원 연도: 법인세 2016–2026 사업연도, 소득세 2016–2026 귀속연도, 부가가치세 2016년 1기–2026년 2기, 가산세·제척기간은 현행 조문. 그 밖의 연도는 오류로 멈춥니다. 지방소득세는 별도입니다.

처리하지 못하는 경우에는 계산하지 않고 "입력 확인 필요"나 오류로 멈추거나, 결과의 판단에 "확인 필요"로 알립니다. 결과를 쓰기 전에 아래에 해당하는지 먼저 확인해 주세요.

공통

  • 지원 연도 밖(법인세 2016–2026 사업연도, 소득세 2016–2026 귀속연도, 부가가치세 2016년 1기–2026년 2기)과 지방소득세

  • 주택 수·특수관계·사업 관련성처럼 사실관계 판단이 먼저인 항목은 사용자가 판단해 넣은 값으로 계산합니다(도구가 판단하지 않음)

  • 합병·분할 세무조정 전용 도구는 없습니다

도구

처리하지 않는 경우

retirement_allowance_adjustment

확정기여형 전환 전 근무분 퇴직급여충당금(시행규칙 제31조제2항)은 입력한 금액을 떼어 두는 것까지만 처리 — 금액 계산, 확정기여형만 있는 회사의 입력, 그 몫의 지급·이전, 관련 부인누계 구분은 하지 않음. 별지 제33호서식 ⑧이 음수일 때의 익금산입

capital_gains_income·capital_gains_tax

분양권·조합원입주권·주식, 2018.4.1. 전 양도 지정지역 3주택 이상 가산, 주택 수 계산, 비과세 보유기간 예외, 주거용 전환, 고가주택 일부 양도

stock_capital_gains_tax

2019년 이전 국외주식, 파생상품, 양도차손 통산

housing_rental_income

겸용주택 주택 부분 판정, 공동소유 주택의 주택 수 판정(주택 수를 직접 넣으면 계산)

dividend_tax_credit

종합소득공제가 금융소득 외 소득보다 큰 경우, 조세특례제한법 제104조의27 배당(2016–2018), 다른 세액공제·감면

religious_income

근로소득 선택 경로, 간이세액표·연말정산 세액, 비과세 요건 판정, 다른 기타소득과의 300만 원 합산 판정

gift_tax

상속세 및 증여세법 제58조제1항 단서(가산분 증여세가 제척기간 만료로 부과되지 않은 경우)

inheritance_gift_valuation

토지·건물 소유자가 다를 때 환산가액 안분, 공동저당 안분

unlisted_stock_valuation

평가심의위원회, 자산별 시가의 평가기간 판정, 국외 비상장주식

vat_supply_timing

상품권·가공·무인판매기·국내 위탁판매·간주공급, 부동산 임대·선불 연회비, 외국항행용역, 폐업일 의제, 공급시기 후 발급 가산세(수출은 직수출·중계무역·보세구역반출·위탁판매수출·외국인도수출·위탁가공무역·원료반출 지원)

vat_deemed_supply_items

2020년 제1기 이전 사용인 선물 한도

refund_claim_deadline

2016년 전 사유·통지, 2015년 전 개정 경과조치, 후발적 사유 해당 여부 판정

tax_priority_distribution

가압류채권 안분·흡수배당, 담보권 순환관계, 공과금, 납세담보 등(입력 확인 필요로 반환). 조세 상호간은 압류한 조세가 먼저 채우는 흡수까지 계산하고, 교부청구 조세끼리는 다시 나누지 않음

individual_donation_expense

기부금 세액공제 금액 자체

stock_major_shareholder

시가총액 조회(사용자가 계산해 넣음)

minimum_tax_adjustment

선박표준이익(119), 법인세법 제59조 감면·공제 순서와 적용제외 항목 한도, 기부금 한도 재계산, 공제감면세액계산서(부표)·추가납부세액(을)

각 도구의 설명에 자세한 범위가 있습니다.

계산 기준을 무엇으로 확인했는지입니다.

자료

쓰임

확인 방법

법령 시행본(법률·시행령·시행규칙)

세율·한도·공제율 연도표, 요건이 바뀌는 시점

지원 연도마다 그 해 시행본을 받아 대조. 조문 조회는 korean-tax-mcp(법제처 Open API)

개정 부칙

개정 규정이 어느 과세연도·어느 거래분부터 적용되는지

부칙의 적용례·경과조치 대조. 적용례가 없으면 해석을 검색하고, 확인하지 못하면 계산하지 않고 안내

법정서식 원문

서식 틀의 칸 배치·줄 번호·작성방법

법제처 국가법령정보센터 서식 PDF

국세청 해석(질의회신·심판례)

조문만으로 갈리는 지점의 처리, 결과의 '주의'·'판단'에 문서번호로 인용

국세법령정보시스템에서 요지와 본문 확인

국세청 신고안내

일감몰아주기 증여의제 산식 등

발간물 원문

사실관계 어휘(facts_vocab.json)

107개 항목의 판단 기준, 적용 기간, 근거 조문, 별칭

조문 대조 후 패키지에 내장

KRX·브이월드 공개 데이터

상장주식 시세, 개별공시지가·주택 공시가격

조회할 때마다

외국환거래규정

해외직접투자 신고·사후보고

2015~2026 전 판 대조

각 도구 결과의 '근거'에 조문이, '주의'·'한계'에 확인하지 못한 범위가 적힙니다. 버전별로 무엇을 어떤 원문과 대조했는지는 변경 이력에 있습니다.

AI가 도구를 언제 부르고, 도구의 답을 언제 믿을지 정해 주는 다섯 줄입니다. 서버 안내문(instructions)에도 같은 규칙이 들어 있지만, 클라이언트에 따라 안내문을 약하게 반영하거나 읽지 않습니다. 아래를 시스템 프롬프트에 넣으면 더 잘 지킵니다(Claude Desktop 프로젝트 지침, Claude Code의 CLAUDE.md, 그 밖의 맞춤 지침).

세금 질문에 답할 때 korean-tax-mcp와 korean-tax-calc-mcp를 이렇게 쓴다.
1. 숫자 하나, 판단 하나마다 쓸 수 있는 도구가 있는지 먼저 찾는다. 이름을 모르면 find_tool로 찾고, 귀속·공급시기는 timing_rules를 먼저 본다.
2. 도구가 있으면 손으로 풀기 전에 도구부터 부른다.
3. 도구의 답과 내 계산이 다르면 바로 고르지 않는다. 입력을 다시 확인하고, 차이를 가르는 조문을 law_article로 열어 요건을 사실관계에 하나씩 맞춰 본다.
4. 조문에서 도구가 틀렸다는 근거를 못 찾으면 도구의 답을 따른다. 다른 값을 쓰면 그 이유(입력 오류 또는 조문 번호)를 한 줄 적는다.
5. 답이 두 개 나오면(안분 전후, 전체와 과세분 등) 질문이 묻는 하나만 답한다.

Anthropic의 BM25 도구 검색(tool_search_tool_bm25)으로 에이전트를 만들면 한글 검색어는 맞지 않습니다(2026-11-14 확인: 설명에 그대로 있는 한국어 낱말로 찾아도 결과 0건, 영어 낱말은 찾음). 영어 검색어로 찾거나(모든 도구 설명 첫 줄이 영어), 한국어 용어도 맞는 정규식 도구 검색(tool_search_tool_regex)을 쓰세요. 어떤 도구를 쓸지 모르면 find_tool을 먼저 부르세요 — 한국어·영어 질의를 받습니다.

작성 주체(정확한 고지): 0.3.0부터 0.12.2까지(2026-10-10부터 10-26까지)는 Solar Pro 4(Solar Work CLI)가 코드를 쓰고 CodeSolar가 리뷰, Claude가 테스트로 교차 검증했습니다(0.8.0 일부 문법 오류와 0.9.2는 Claude가 수정·작성). 0.13.0(2026-10-28)부터는 기존 계산기 뼈대는 Solar Pro 4 그대로이고, 새 도구·연도별 조문 대조·버그 수정은 Claude(Anthropic)가 작성하며 CodeSolar가 리뷰합니다. 0.26.0(2026-11-10)부터 새 도구는 Claude가 명세·정답 테스트를 먼저 쓰고 Solar Pro 4가 뼈대를 구현한 뒤 Claude가 검수·보완합니다(커밋별 작성자 표기). 버전별 작성 주체는 CHANGELOG 각 절 머리에 적혀 있습니다.

  • 면책: 이 도구의 결과는 세무 자문이 아닙니다. 법령·해석을 바탕으로 계산·판정 과정을 보여 주는 참고 자료이며, 실제 신고·세무조사·불복 판단은 세무사·회계사·변호사 등 전문가에게 확인하세요. 근거 조문·판례는 원문으로 확인하세요.

  • 세무대리 아님: 이 도구는 세무사법 제2조의 세무대리(세무조정계산서 작성, 신고 대리, 세무상담 등)를 수행하지 않으며, 그 업무는 세무사와 등록한 공인회계사·변호사만 할 수 있습니다(세무사법 제20조). 법령에 적힌 산식을 코드로 옮겨 입력값에 대한 계산 과정을 보여 주는 소프트웨어이고, 입력 사실관계의 확인과 최종 판단은 세무 전문가(세무사·회계사·변호사)와 함께 해 주세요.

  • AI 사용 고지: PDF 검토 도구 3개와 kr_comparable_candidates를 뺀 계산·판정·조회 도구는 모두 코드로 동작하며 생성형 AI를 쓰지 않습니다. PDF 검토 도구 3개(extract_relations, tunnelling_from_pdf, return_precheck_pdf)는 UPSTAGE_API_KEY가 있으면 생성형 AI(Upstage Solar Pro 4)로 표를 추출하며 결과에 그 사실을 표시합니다. 키가 없으면 pypdf로 로컬 텍스트 추출(host_ai 모드) 후 정리 안내에 따라 다음 도구 입력으로 직접 정리할 수 있습니다. kr_comparable_candidates는 UPSTAGE_API_KEY가 있으면 공시 매출 표의 행 이름과 사업보고서 '사업의 개요'(최대 4,000자, 비상장은 감사보고서 회사 개요 주석)만 생성형 AI(Upstage Solar Pro 4)에 보내 재화·용역·SW·플랫폼·기타로 분류하고(금액은 원문 숫자 그대로, 제품/상품 구분은 원문 매출원가·재고 숫자로) 결과에 분류 방법을 표시합니다. 키가 없으면 이름 규칙으로 분류하고 '정확도 낮음'으로 표시합니다.

  • 데이터 전송: UPSTAGE_API_KEY를 설정해 PDF 도구를 사용할 때만 문서 내용이 Upstage API(api.upstage.ai)로 전송됩니다. 시세 조회(stock_price_lookup)는 KRX로 종목코드·날짜를, 공시가격 조회(official_property_price, VWORLD_KEY 필요)는 브이월드로 주소·필지번호·연도를 보냅니다. 국내 비교기업 후보(kr_comparable_candidates, DART_API_KEY 필요)는 OpenDART로 회사 고유번호·연도·접수번호를 보내고, UPSTAGE_API_KEY가 있으면 공시 매출 행 이름(금액 제외)과 공시된 사업의 개요(최대 4,000자)를 Upstage로 보냅니다. 키 없이 사용하면(pypdf 로컬 추출) 외부 전송이 없습니다. 민감정보가 담긴 문서는 API 전송 시 넣지 마세요.

비교대상 선정 기준 예시값(0.60.x까지 도구 기본값)

0.61.0부터 tp_comparable_screen·kr_comparable_profile_compare에는 관행 기준값이 없습니다. 아래는 이전 결과를 재현할 때 넣던 값의 예시일 뿐 기준이 아니며, 실제 값과 출처는 짝 서버 korean-tax-mcp의 transfer_pricing_guide(비교대상 선정 기준)에서 받아 넣습니다.

도구

입력

0.60.x 값

tp_comparable_screen

screens

{"independence_pct": 25, "independence_bvd_reject": ["C", "D", "U"], "loss_years": 2, "loss_action": "exclude", "require_all_years": true, "rnd_max": 0.03, "adv_max": 0.05, "related_max": 0.25, "segment_min": 0.75, "special_flags": ["start_up", "bankruptcy", "restructuring", "merger", "delisted"], "outlier_k": 1.5}, quartile_method: "excel_inc"

kr_comparable_profile_compare

rules

{"mix_max_diff": 0.2, "coverage_min": 0.8, "coverage_max": 1.2, "ratio_low": 0.5, "ratio_high": 2.0, "ppe_abs_tol": 0.05, "rnd_abs_tol": 0.01, "advert_mult": 2.0, "advert_abs_tol": 0.01, "related_review": 0.25, "unknown_review_count": 3, "mix_unverified_review": 0.1} — 값만 같고, 재고·유형자산 조합(하나만 다르면 사람 확인)은 0.61.0 규칙

라이선스

MIT © 2026 Upstage · Created by Mia(윤승미)

Available Tools

142 tools
arm_length_rangeA
Read-onlyIdempotent

Transfer pricing arm's length range: interquartile range, median and adjustment amount (정상가격 범위). 정상가격 범위와 조정액 — 비교대상 이익률 등으로 사분위·전체 범위, 중위값·평균값을 구하고 분석대상 당사자의 값이 범위 안인지, 벗어나면 기준점까지의 차이와 조정액(국제조세조정에 관한 법률 시행령 제15조제5항·제6항). 언제: 국외특수관계인 거래의 이익률이 정상가격 범위 안인지 확인하고 범위를 벗어난 경우 조정액을 구할 때. 입력: 비교대상 값 → comparables, 분석대상 값 → tested_value, 지표 분모 금액 → base_amount, 범위 종류 → range_type, 기준점 → point·point_value, 분석대상이 거주자인지 → tested_is_resident, 지표 방향 → higher_is_more_income, 사분위 계산법 → quartile_method, 사업연도 → year. 계산: 범위 안이면 조정 없음. 벗어나면 기준점(중위값·평균값·직접입력)과의 차이 × base_amount = 조정액(원 미만 절사). 분석대상이 거주자가 아니면 방향을 뒤집어 거주자 소득이 과소인지 과다인지 표시하고, '방향'에 한 문장으로 적음. tested_is_resident를 비우면 계산하지 않고 되물음. 결과: 비교대상 수·최솟값·제1사분위·중위값·제3사분위·최댓값·평균값, 범위, 사분위_방식(방식·n·근거), 사분위_민감도(통칙·엑셀 INC·미국식), 범위 안 여부, 조정 필요 여부, 기준점, 차이, 거주자 소득(과소·과다), 방향, 조정액, 판단·근거·주의. 결과의 '비교대상_확인'은 비교가능 거래의 뜻(시행령 제14조제1항제1호), 분석요소(시행규칙 제6조제1항), 내부 비교가능 거래를 먼저 볼 것(시행규칙 제7조제1항제4호), 이익률 자료만으로는 타당성을 확인할 수 없다는 점을 알려 줌. 2016~2020년 개시 사업연도는 구 시행령 제6조제4항·제5항, 구 법 제4조(2020년 개시분부터 제4조의2)와 구 법 제9조·구 시행령 제15조의 임시유보로 근거를 냄. 범위 밖: 비교대상이 적절한지(비교가능성·차이 조정·손실 기업 처리)는 판단하지 않음. 사분위 계산법은 기본이 국세청 기본통칙 8-15…1(결과 사분위_방식에 방식·n·근거, 다른 두 방식은 사분위_민감도), 기준점 선택은 국조법령이 특정하지 않음(조문에는 없고, 2022.3.18. 시행규칙부터 거래가격 조정신고서 작성방법이 정상사분위범위 기재를 전제 — OECD 이전가격지침 3.57의 통계적 도구) — 선택 이유는 보고서에 밝혀야 함. 데이터베이스 후보 목록을 거르는 일은 tp_comparable_screen.

Inputs: comparables (required), tested_value (required), year, point, +6 more.

assessment_limitationA
Read-onlyIdempotent

Statute of limitations: national tax assessment limitation period and expiry date (부과제척기간). 국세 부과제척기간과 만료일(2020년 이후 부과분 기준 현행 조문). 언제: 어느 과세기간의 세금이든 부과·제척기간이 언제까지인지 역산한다. 입력: 법정신고기한(원천징수분은 법정납부기한, YYYY-MM-DD) → due_date, 부과 성격(일반·무신고·부정행위) → case, 역외거래 여부 → offshore, 상속세·증여세 여부 → inheritance_gift, 원천징수분 → withholding. 기한 특례: 법정신고기한(납부기한)이 토·일·공휴일·대체공휴일·근로자의 날이면 다음 날이 기한(국세기본법 제5조제1항)이라 그다음 날부터 기산하고, 만료일이 토요일·공휴일이면 다음 날 만료(국세기본법 제4조·민법 제161조, 기본통칙 4-0…2). 공휴일표 2016~2027. 결과: 제척기간(년)·법정신고기한(적용)(원천징수분은 법정납부기한(적용))·기산일·만료일(이월 전 역법상 만료일 함께), 근거(국세기본법 제26조의2제1항·제2항·제4항, 시행령 제12조의3, 기한이 미뤄졌으면 제5조제1항, 만료일이 미뤄졌으면 제4조). 일반 5년(역외 7년), 무신고 7년(역외 10년), 부정행위 10년(역외 15년), 상속·증여 10년(부정 등 15년). 역외 7년·10년은 2019.1.1. 이후 납세의무 성립분부터이고 그 전 성립분은 5년·7년(역외 부정행위 15년은 법률 제12848호 부칙 제4조로 2015.1.1. 이후 부과할 수 있는 날이 개시하는 분부터 — 이 도구 범위인 법정신고기한 2016.1.1. 이후분은 모두 15년). 법정신고기한 2016.1.1. 이후만 지원. 경정청구가 있으면 제척기간이 지나도 청구일부터 2개월 안에 경정할 수 있음(제26조의2제6항제3호) — 경정청구 기한은 refund_claim_deadline.

Inputs: due_date (required), case, offshore, accrued_on, +2 more.

asset_grant_reserveA
Read-onlyIdempotent

Government subsidy and insurance gain: temporary depreciation reserve and compression reserve (일시상각충당금·압축기장충당금). 국고보조금·공사부담금·보험차익 일시상각충당금·압축기장충당금 세무조정. 언제: 국고보조금·공사부담금·보험차익으로 사업용자산을 취득·개량한 법인의 손금산입·충당금 상계·처분 계산. 입력: 사업연도 → year, 재원 구분 → kind, 수령액 → received, 자산별 내역 → assets(취득·개량가액·사용액·상각·처분·충당금 등). 결과: 손금산입 한도·충당금 설정금액·상계액·처분 익금·사용계획·미사용·기말 잔액·소득금액 순영향·세무조정·근거. 일시상각충당금·압축기장충당금 계산.

Inputs: kind (required), year (required), assets (required), received (required), +5 more.

bad_debt_adjustmentA
Read-onlyIdempotent

Corporate bad debt tax adjustment for bad debts and bad debt allowance (대손금 세무조정). 대손금·대손충당금 세무조정(법인세법 제19조의2·제34조, 시행령 제19조의2·제61조). 언제: 법인세 세무조정에서 대손금 인정 여부와 대손충당금 한도·한도초과를 함께 계산할 때. 입력: 사업연도(20162026) → year, 중소기업 여부 → sme, 전기 대손충당금 한도초과액(원) → prior_excess, 장부상 대손충당금 {opening, offset, provision, closing, reversal?}(원) → book, 장부상 설정대상 채권 전기말·당기말(원) → receivables_prev_end_book·receivables_end_book, 대손금 목록 [{kind, amount, arose_in, instrument?, months_since_default?, mortgage?, months_since_due?, related_party?, date?, account?, detail?, booked?, memo_excluded?, excluded_reason?, recipient?, lent_on?, related_at_lending?, related_at_event?}] → writeoffs, kind: 소멸시효완성·화해·확정판결·부도6개월·회수불능(파산·강제집행·형의집행·사업폐지·사망·실종)·회수기일2년경과, booked: '상계'|'손비'|'전기부인'(전기 장부 대손·세무 부인 유보 채권 — 당기 요건 충족 시 손금산입 △유보), excluded_reason: '채무보증구상채권'|'특수관계인업무무관가지급금'(법 제19조의2제2항) — 대손금·설정대상 채권에서 빼고 손금불산입, 소득처분은 recipient(귀속자, 영 제106조제1항제1호), guarantee_item: 18(영 제19조의2제6항 호 — 손금 인정 채무보증이면 구상채권을 제외하지 않음, 호별 시행일 대조)·guarantor_business('건설업'|'전기통신업', 5호), booked='전기부인' + excluded_reason: 당기 대손사유 확정 시 전기 유보 정리(손금산입 △유보 + 손금불산입 귀속자 처분), 대손실적률 소수 자릿수(기본 3) → loss_rate_digits, 사업연도 개시일·종료일 → fy_start·fy_end(선택, 역년이 아닐 때), 장부 채권 중 법 제19조의2제2항 채권 잔액(전기말·당기말, 원) → excluded_receivables_prev_end_book·excluded_receivables_end_book. 결과: 판단(항목별·근거)·계산(세법상 당기 대손금·전기말·당기말 채권·실적률)·결과(한도·한도초과)·세무조정({구분, 조정, 금액, 소득처분})·서식_표·계산식_입력. 지원 안 함: 영 제19조의2제6항 각 호의 사실 요건(업종·직접 관련성·특수관계 등) 판단 — guarantee_item 입력을 그대로 믿음. 대손금·대손충당금 세무조정.

Inputs: sme (required), book (required), year (required), writeoffs (required), +8 more.

bad_debt_allowanceA
Read-onlyIdempotent

Bad debt allowance limit: receivables x max(1%, loss ratio) and excess (대손충당금 한도). 대손충당금 한도(채권잔액 × max(1%, 대손실적률))와 한도초과. 언제: 매출채권 등에 대해 대손충당금을 설정할 때 손금산입 한도를 구한다. 입력: 채권잔액(원) → receivables, 대손실적률(소수, 예: 0.02 = 2%) → loss_rate, 설정할 대손충당금(원) → set_amount, 이전 disallowed(원) → prior_disallowed. 결과: 한도·한도초과, 근거(법인세법 제34조, 시행령 제61조제2항). Bad debt allowance limit.

Inputs: loss_rate (required), set_amount (required), receivables (required), prior_disallowed.

branch_profits_taxA
Read-onlyIdempotent

Branch profits tax on a foreign corporation's Korean permanent establishment (지점세, 법인세법 제96조). 외국법인 국내사업장의 지점세 — 과세대상소득금액(각 사업연도 소득금액 − 법인세 등 − 법인지방소득세 − 재투자 인정액 − 과소자본 손금불산입액 + 자본금상당액감소액)에 조약 세율을 곱한다. 언제: 외국법인 지점이 법인세를 낸 뒤 본점 송금 이윤에 추가로 내는 세금을 구할 때. 조약이 지점세를 허용하지 않으면 0. 입력: year(사업연도 2016~2026), pe_income(각 사업연도 소득금액), corporate_tax(제95조 법인세), treaty_allows_branch_tax(조약 허용 여부), credits_reductions·penalties_additional(제96조제2항제1호 가목·나목), local_income_tax, thin_cap_disallowed, capital_begin·capital_end(자본금상당액), untaxed_retained_prior(직전 사업연도 말 미과세누적유보소득), treaty_branch_rate(조약 세율, 생략 시 100분의 20), residence_country_taxes_korean_branches(제96조제1항 단서), treaty_basis·remitted_profit·prior_year_taxable(송금액 기준 조약), pe_closed(의제사업연도). 결과: 지점세, 과세대상 금액, 세율·근거, 계산 내역(재투자 공제·자본금상당액 증감), 연도별 인용 조문, 한계. 재투자 인정액은 시행령 제134조제1항(자본금상당액증가액 + 음수 미과세누적유보소득, 한도 있음), 결손 사업연도는 같은 조 제4항, 송금액 기준은 제5항. 조약의 지점세 허용·세율은 조문 MCP tax_treaty로 확인한다. 과세표준 1원 미만·세액 원 미만을 버리고, 납부할 때 10원 미만 끝수를 버린다(국고금 관리법 제47조).

Inputs: year (required), pe_income (required), corporate_tax (required), treaty_allows_branch_tax (required), +13 more.

building_standard_priceA
Read-onlyIdempotent

Building standard market price by NTS formula for capital gains and gift tax (건물 기준시가). 건물 기준시가 — 국세청 「건물 기준시가 계산방법 고시」 산식(신축가격기준액 × 구조지수 × 용도지수 × 위치지수 × 경과연수별 잔가율 × (상증세만) 개별건물 특성 조정률, ㎡당 1,000원 미만 버림 × 면적). 양도세 기준시가(소득세법 제99조제1항제1호나목)와 상속·증여 보충적 평가(상증법 제61조제1항제2호)에 쓴다. 언제: 일반 건물(상가·사무실·공장·창고 등)의 기준시가가 필요할 때 — 비상장주식 평가(unlisted_stock_valuation의 assets 기준시가), 상속·증여 신고, 양도세 환산취득가액. 주택·아파트는 공시가격(official_property_price), 오피스텔·일괄고시 상업용은 국세청 고시가격을 쓴다. 입력: 적용연도 → year, 면적 → area_m2, 구조·용도 → structure·use, 부속토지 공시지가 → land_price_per_m2, 신축연도 → built_year, 상증세면 purpose='상증세'와 층수·연면적·지붕·층별·안전등급. 지수표는 2026년 고시(제2025-39호) 원문. 2007~2025년은 그 해 신축가격기준액에 2026 지수표를 적용한 근사(결과에 표시). 결과: 기준시가·㎡당 금액·지수·잔가율·조정률, 판단(산식·시가 우선·국세청 감정평가 가능성·범위), 근거.

Inputs: use (required), year (required), area_m2 (required), structure (required), +9 more.

bundled_supply_splitA
Read-onlyIdempotent

VAT bundled supply allocation of land and building price (일괄공급 안분). 토지·건물 일괄공급 안분(부가법 제29조제9항, 영 제64조제1항). 언제: 토지와 건물(기계장치 등 다른 자산 포함)을 함께 공급하며 가액 구분이 불분명할 때 공급가액을 안분한다. 안분 순서: 감정가액이 모든 자산에 있으면 감정가액 비례(공급시기가 속하는 과세기간의 직전 과세기간 개시일 ~ 공급시기 과세기간 종료일의 감정만) → 모든 자산에 기준시가가 있으면 기준시가 비례(제1호) → 그 밖에는 장부가액 비례 후 기준시가가 있는 자산은 그 합계액을 기준시가로 재안분(제2호 단서). 입력: 일괄 거래가액(원) → total_price, 부가세 포함 여부 → vat_included, 감정평가가액 {building, land} → appraisal, 기준시가 {building, land} → standard_value, 장부가액 {building, land} → book_value, 다른 자산 → other_assets, 감정평가일·공급시기 → appraisal_date·supply_date, 건물 과세 비율 → building_taxable_ratio. 결과: 판단·결과(건물_공급가액(과세분)·토지_가액·부가가치세, 해당 시 기타자산·과세표준_합계·건물_면세분)·산식·근거.

Inputs: total_price (required), vat_included (required), appraisal, book_value, +5 more.

business_car_expenseA
Read-onlyIdempotent

Business passenger car expenses disallowance: business-use ratio, KRW 8M depreciation cap (업무용승용차 관련비용). 업무용승용차 관련비용 손금불산입(업무사용비율·사적사용·미작성 시 기준비율·감가상각 연 800만 원 한도). 언제: 임원·직원이 사용하는 승용차 관련비용을 어디까지 손금으로 인정할지 계산할 때. 입력: 사업연도(20162026, 개시일이 속하는 해) → year, 유지비(유류·보험·수선 등, 원) → upkeep, 세법상 감가상각비(5년 정액, 원) → depreciation, 장부상 감가상각비(원) → booked_depreciation, 운행기록부 작성 여부 → log_kept, 업무사용비율(소수, 작성 시) → business_ratio, 보유 월수(112) → months, 부동산임대업 주업 등 특정법인 여부 → rental_corp, 법인 전용번호판 부착 여부 → plate_ok, 사업연도 개시일·종료일 → fy_start·fy_end, 2024.1.1. 이후 지출분 비율 → share_from_2024(선택). 기준일: 번호판 요건(영 제50조의2제4항 단서)은 2024.1.1. 이후 지출하는 관련비용부터(대통령령 제34266호 부칙 제7조). 사업연도가 2024.1.1.을 걸치면 그 뒤 지출분만 업무사용금액 0원 — share_from_2024가 없으면 사업연도 일수로 안분. 날짜가 없으면 사업연도 표(2024 개시부터)로 보고 2023 사업연도면 주의를 붙임. 결과: 업무사용비율·손금불산입·감가상각 한도 등, 근거(법인세법 제27조의2, 시행령 제50조의2).

Inputs: year (required), upkeep (required), log_kept (required), depreciation (required), +9 more.

capital_gains_incomeA
Read-onlyIdempotent

Real estate capital gains income amount: one-house exemption, long-term holding deduction (양도소득금액). 토지·건물·주택의 양도차익 → 1세대1주택 비과세·고가주택 안분 → 장기보유특별공제(표1·표2) → 양도소득금액(소득세법 제89조·제92조·제95조·제97조·제103조, 시행령 제154조·제156조·제159조의4(2021.2.17. 전 제159조의3)·제160조·제176조의2·제163조). 언제: 부동산 양도소득금액·장기보유특별공제를 양도일 기준 공제율·고가주택 기준(2021.12.8. 전 9억원, 이후 12억원)으로 계산할 때. 입력: 자산 종류 → asset_type, 취득일·양도일 → acquisition_date·transfer_date, 양도가액·취득가액(실지거래가액) → transfer_price·acquisition_price, 자본적지출·양도비 → capital_expenditure·transfer_expenses, 등기 여부 → registered, (환산취득가액) acquisition_price=0이고 취득·양도 당시 기준시가 둘 다 있으면 환산취득가액 자동 계산(소득세법 시행령 제176조의2제2항제2호, 제163조제6항). (부담부증여) burdened_gift={증여가액, 채무액, 평가:'시가'|'기준시가', 취득_기준시가?, 취득가액_실지?} — 비율=채무액÷증여가액, 양도가액=증여가액×비율(=채무액), 취득가액: 평가='기준시가'면 취득_기준시가×비율+개산공제(토지·건물 3%, 미등기 0.3%), '시가'면 취득가액_실지×비율. transfer_price·acquisition_price와 함께 입력 불가. (주택) 1세대1주택 여부 → one_house, 비과세 요건 충족 → exempt_met, 거주기간(년) → residence_years, (주택, 1주택 아님) 다주택 중과(제104조제7항) → houses_count(1세대 주택 수)·adjusted_area(양도일 현재 조정대상지역)·exclusion_reason(배제 사유, 선택). 중과 대상 아님이 확실하면 heavy_multi_home=False. 중과: 2018.4.1.2021.5.31. 양도 2주택 +10%p·3주택 이상 +20%p, 2021.6.1. +20%p·+30%p, 장기보유특별공제 배제(제95조제2항), 단기 보유는 제104조제1항제2호·제3호 세액과 비교해 큰 세액. 한시 배제: 2019.12.17.~2020.6.30. 보유 10년 이상(영 12호), 2022.5.10.~2026.5.9. 보유 2년 이상(영 12호의2) — 날짜로 도구가 판정. 2026.5.10. 이후 나·다목 경과 요건은 exclusion_reason='한시배제_경과'(사용자 주장). 기본공제·과세표준·산출세액까지 → apply_basic_deduction(True면 제104조 세율로 산출세액·지방소득세도 계산: 보유 1년 미만·2년 미만 단기세율, 미등기 70%, 비사업용 토지 → non_business_land, 지정지역 비사업용 토지 → designated_area). 지원하지 않음(error): 분양권·조합원입주권·주식, 2018.4.1. 전 양도 지정지역 3주택 이상 가산(제104조제4항제1호·제2호), 주택 수 계산(사용자 판단), 비과세 보유기간 예외, 주거용 전환, 고가주택 일부 양도. 토지는 one_house=False, exempt_met=False 입력해도 오류 아님(주택 요건 무관). 결과: 판단(비과세·고가주택·적용 표, 환산취득가액 사용 시 필요경비 선택 근거)·결과(양도차익·과세대상 양도차익·보유·거주기간·공제율·장기보유특별공제액·양도소득금액, 선택 시 기본공제·과세표준·산출세액·지방소득세·적용 세율)·산식·근거.

Inputs: asset_type (required), transfer_date (required), acquisition_date (required), one_house, +23 more.

capital_gains_taxA
Read-onlyIdempotent

Capital gains tax and local income tax from capital gains tax base (양도소득세). 양도소득 과세표준 → 산출세액·지방소득세(소득세법 제104조제1항·제4항·제7항). 언제: 양도소득 과세표준이 이미 주어졌거나 따로 계산했을 때 세율을 적용한다(가액부터 계산하면 capital_gains_income에 apply_basic_deduction=True). 입력: 과세표준 → base, 자산 종류 → asset_type, 취득일·양도일 → acquisition_date·transfer_date, 등기 → registered, 비사업용 토지 → non_business_land, 지정지역 → designated_area, 다주택 중과(주택) → houses_count·adjusted_area·exclusion_reason(선택). 세율: 2년 이상 기본세율(제55조) / 1년 이상 2년 미만 40%(주택 60%, 2021.6.1. 전 양도 주택은 기본세율) / 1년 미만 50%(주택 70%, 2021.6.1. 전 40%) / 미등기 70% / 비사업용 토지 기본세율+10%p(지정지역 2018~ +20%p) — 둘 이상이면 큰 세액. 다주택 중과(제104조제7항, 조정대상지역): 2018.4.1.2021.5.31. 양도 2주택 +10%p·3주택 이상 +20%p, 2021.6.1. +20%p·+30%p, 단기 보유는 제104조제1항제2호·제3호 세액과 비교해 큰 세액. 한시 배제(영 제167조의3제1항·제167조의10제1항 12호 2019.12.17.~2020.6.30. 보유 10년 이상, 12호의2 2022.5.10.~2026.5.9. 보유 2년 이상)는 날짜로 판정, 그 밖의 배제 사유와 2026.5.10. 이후 나·다목 경과 요건은 사용자 주장(exclusion_reason). 지원하지 않음: 2018.4.1. 전 양도 지정지역 3주택 이상 가산(제104조제4항제1호·제2호), 주택 수 계산(사용자 판단), 분양권·조합원입주권·주식. 결과: 산출세액·지방소득세(10%)·적용 세율·세율 후보·근거.

Inputs: base (required), asset_type (required), transfer_date (required), acquisition_date (required), +8 more.

capital_gains_unfair_transactionA
Read-onlyIdempotent

Capital gains wrongful calculation for related party transfers (양도소득 부당행위계산). 양도소득 부당행위계산(소득세법 제101조(1항·2항·3항), 시행령 제98조(1항)·제167조(3항·4항·5항·6항)).

언제: 특수관계인 간 자산 양도·취득이 시가와 현저히 차이가 나 부당행위계산 부인 대상인지, 또는 증여 후 수증자가 양도할 때 증여자가 직접 양도한 것으로 볼지 계산한다. 입력: mode — '저가고가'(기본) | '증여후양도'. [저가고가] transaction — '양도' | '취득'. market_value — 시가(원, 상증법 준용 평가액). price — 거래가액. related_party — 특수관계인 여부. counterparty_is_corporation, corporate_tax_market_value_applies, fraud — 법인 상대 거래 예외·영 제167조(6항) 관련. [증여후양도] gift_date, transfer_date — YYYY-MM-DD. donee_relation — '배우자' | '직계존비속' | '기타특수관계인'. donee_gift_tax, donee_capital_gains_tax, donor_direct_capital_gains_tax — 각 세액(원). income_belongs_to_donee — 수증자 귀속분이면 적용 제외. 결과: [저가고가] 부당행위계산·차액·차액비율(정수 만분율)·기준_3억_충족·기준_5퍼센트_충족·조정후_양도가액|조정후_취득가액. [증여후양도] 증여자_직접양도_간주·수증자_세액합계·증여자_직접양도세액·적용제외_사유.

Inputs: mode, fraud, price, gift_date, +11 more.

cfc_actual_dividendA
Read-onlyIdempotent

CFC actual dividend exclusion of previously taxed deemed dividend (특정외국법인 실제 배당). 특정외국법인 실제 배당의 익금불산입 — 배당간주로 이미 과세된 유보소득을 나중에 실제로 배당받을 때, 그 금액을 익금(개인은 배당소득)에서 뺀다. 언제: 배당간주(cfc_deemed_dividend)로 익금산입한 뒤 그 특정외국법인에서 실제 배당을 받았을 때. 입력: 받은 과세연도 → year, 실제 배당액 → actual_dividend, 배당간주 원장 → ledger, 중간외국법인 경유 → intermediate, 법인·개인 → entity, 법인 이름 → cfc_name. 계산: 익금불산입 = min(실제 배당액, 배당간주금액 중 아직 소진하지 않은 금액) — 배당 가능한 유보소득이 발생한 순서대로 소진. 중간외국법인 경유면 한도 = Σ(특정외국법인→중간외국법인 실제 배당 × 당시 보유비율) − 과거 익금불산입액. 결과: 익금불산입, 일반배당(나머지), 소진 내역, 원장 갱신(다음 호출의 ledger), 세무조정(익금불산입·△유보 — income_adjustment_total·export_workbook에 넣음), 판단·근거·주의. 근거(받은 과세연도별): 20162019 구 국조법 제20조제1항(이월익금)·구 시행령 제36조의6, 2020 구 법 제19조의2제1항·구 시행령 제35조, 2021 법 제32조제1항·시행령 제68조. 2023년부터 법인세법 제18조의4제3항(95% 익금불산입 미적용) 안내.

Inputs: year (required), ledger (required), actual_dividend (required), entity, +2 more.

cfc_deemed_dividendA
Read-onlyIdempotent

CFC deemed dividend of retained earnings of low-tax foreign subsidiaries (특정외국법인 배당간주). 특정외국법인 유보소득 배당간주액 — 저세율국 자회사가 배당하지 않고 쌓아 둔 이익을 내국인 주주가 배당받은 것으로 보는 금액(국제조세조정에 관한 법률 제27조~제31조).

언제: 해외 지주회사·페이퍼컴퍼니·저세율국 자회사의 유보소득이 합산과세 대상인지와 배당간주금액을 계산할 때. 연도: 20162026 사업연도. 저세율 기준은 2021년까지 15%, 2022년 17.5%, 20232025년 16.8%, 2026년 17.5%(법인세 최고세율의 70%)이고, 근거 조문 번호(2019년까지 구 법 제17조제19조, 2020년 제17조제17조의3, 2021년부터 제27조~)와 수동소득 범위도 연도에 맞춰 낸다. 입력: year — 특정외국법인 사업연도 개시일이 속하는 연도(20162026). pretax_incomes — 최근 3개 사업연도 이내 조정 후 세전이익(원) 목록(13개, 음수=0으로 봄). taxes_paid — 같은 길이 실제 부담 세액(원, 0 이상). ownership_chains — 내국인에서 특정외국법인까지 단계별 보유비율 목록의 목록(곱의 합 = 보유비율). ownership_with_related_ratio — 10% 판정용 비율(특수관계인 직접 보유 포함, 없으면 보유비율과 같음). related_party — 특수관계 요건(법 제27조2호) 기본 True. months — 사업연도 개월 수(112, 기본 12). fy_end — 특정외국법인 사업연도 종료일(YYYY-MM-DD, 선택). distributable — dict: unappropriated_retained_earnings 등 키(모두 원, 0 이상, 없으면 0). fixed_facility_active_business — 고정 시설 실질 사업(법 제28조2호) 여부 기본 False. holding_company_exemption — 해외지주회사 예외(법 제28조3호) 여부 기본 False(호출자 판정). listed_industry — 허용 업종명(선택). listed_industry_share / listed_industry_related_share — 그 업종 수입금액·특수관계 비중(선택, 01). same_country_unrelated_sales_share — 도매업 같은 국가 비특수관계 판매 비중(선택, 0~1). passive_main_business — 수동소득 주된 사업(법 제29조2호) 여부 기본 False. passive_income / passive_excluded_dividends / total_revenue — 수동소득·배제배당·총수입금액(원, 선택). 결과: 특정외국법인_해당·배당간주_적용·적용방식·적용제외_사유·실제발생소득_연평균·실제부담세액_연평균· 기준세율_만분율·실제부담세율_만분율·주식보유비율_만분율·배당가능_유보소득·배당간주금액· 익금귀속_기준일·익금귀속_과세연도·단계별_계산, 판정 명세서 확인 값(판정보유비율·조정후세전이익_합계·납부세액_합계·실제부담세율·수동소득비율). 서식: export_workbook(layout='forms')에서 2021 사업연도부터 별지 제30호서식(갑, 배당간주 적용 때)·제31호서식(갑·을·병)·제32호서식(갑: 해외지주회사, 을: 고정 시설 실질 사업) 틀을 채움 — pretax_incomes·taxes_paid는 첫 값을 해당 사업연도, 다음을 직전·전전 사업연도로 적음.

Inputs: year (required), taxes_paid (required), pretax_incomes (required), ownership_chains (required), +16 more.

cfc_share_disposalA
Read-onlyIdempotent

CFC share disposal exclusion of undistributed deemed dividend (특정외국법인 주식 양도). 특정외국법인 주식 양도 때 배당간주 미배당분의 익금불산입 — 배당간주로 과세됐지만 아직 실제로 배당받지 않은 금액을 양도차익 한도로 익금(개인은 양도소득)에서 뺀다. 언제: 배당간주로 익금산입한 특정외국법인의 주식을 팔 때. 입력: 양도 과세연도 → year, 양도 주식분 배당간주금액 합계 → deemed_total, 그 주식의 실제 배당액 → actual_paid, 양도차익 → gain, 법인·개인 → entity, 일부 양도 비율 → sold_ratio. 계산: (양도한 주식에 대한 배당간주금액 합계 − 그 주식에 실제로 배당한 금액), 0 이하는 0, 양도차익 한도. 결과: 익금불산입(법인)·양도소득 제외(개인), 계산 전 금액, 양도차익 한도, 세무조정(익금불산입·△유보), 판단·근거·주의. 근거(양도 과세연도별): 20162019 구 국조법 제20조제2항, 2020 구 법 제19조의2제2항, 2021 법 제32조제2항.

Inputs: gain (required), year (required), actual_paid (required), deemed_total (required), +3 more.

child_tax_creditA
Read-onlyIdempotent

Child tax credit by tax year, incl. birth and adoption credit (자녀세액공제). 자녀세액공제(소득세법 제59조의2) 귀속연도별 계산 — 기본공제대상 자녀 수별 금액·6세 이하 추가공제·출산·입양 공제. Child tax credit by tax year (20162026). 언제: 종합소득세 신고·연말정산에서 자녀세액공제 금액을 구할 때(자녀 수·나이·출산·입양·손자녀). 입력: 귀속연도(20162026) → year, 자녀 목록 → children(나이·기본공제대상 여부·출산·입양·순서), 손자녀가 있는 2023년 이전 귀속분만 신고·연말정산일 → settlement_date. 결과: 자녀세액공제 합계와 제1항 인원별 금액·제2항 6세 이하 추가(20162017)·제3항 출산·입양, 자녀별 판단·산식·근거(개정 부칙 포함). 연도별: 제1항 20162023 15만·30만·초과 1명당 30만 / 2024 15만·35만·30만 / 2025~ 25만·55만·40만. 연령 2019 7세 이상(7세 미만 취학아동 포함)·2020 7세·2023 8세·2026 9세(2017년생은 13세, 2026.4.21 부칙). 손자녀 2024~(2023 귀속은 2024 이후 연말정산·신고분). 제2항 6세 이하 추가 20162017만. 제3항 2016 1명당 30만, 2017 첫째 30만·둘째 50만·셋째 이상 70만. 지원 안 함: 2016 전·2027 이후 귀속, 산출세액 초과분 처리(제61조)·다른 공제와 적용순서, 2022년 이전 귀속 손자녀를 2024년 이후 신고·결정하는 경우(입력 확인 필요로 멈춤). 아동수당 수급 여부는 조문 요건이 아니어서 묻지 않는다.

Inputs: year (required), children (required), settlement_date.

common_input_taxA
Read-onlyIdempotent

VAT common input tax settlement and allocation for mixed taxable and exempt business (공통매입세액 정산). 겸영사업자 공통매입세액 안분·정산 + 공통사용재화 공급(부가법 제40조, 영 제81조제83조·제63조, 규칙 제54조3항). 언제: 과세·면세 겸영 사업자의 예정·확정신고에서 공통매입세액 공제액과 공통사용재화 공급 시 추가 매출세액을 계산한다. 입력: · 공급가액(예정·확정별 과세·면세), 예정 불공제액, 직전 과세기간 공급가액, 공통사용재화 공급 목록. · 공통사용재화 공급 항목 acquired_period(선택): 그 재화를 공급받은 과세기간('YYYY-1'|'YYYY-2'). - 이번 신고 과세기간과 다르면 그 재화의 매입세액은 이번에 공제하지 않음(0). 판단 "공급받은 과세기간에 이미 안분 — 이번 공제 없음(시행규칙 제54조3항)". - 같으면 직전 과세기간 비율로 안분 공제(지금처럼). - 없으면 지금처럼 하되 주의 "공급받은 과세기간과 공급한 과세기간이 같을 때만 안분 공제(규칙 제54조3항) — acquired_period로 확인". · 원장: ledger=[{항목, 매입세액 | 매입가액(→×10%, 둘 중 하나), 사용처:'과세'|'면세'|'공통'|'실지귀속'|'불공제', 과세비율(01) | 횟수:{과세,면세} | 면적:{과세,면세}}]. 사용처별 처리는 어휘 공통매입세액_귀속.판단.사용처별에서 읽음. prior_common_input_tax: 확정신고에서 ledger 사용 시 예정신고 기간의 공통매입세액. 기존 prior_nondeductible는 그대로. · 정산: settlements=[{항목?, 총공통매입세액, 면적|공급가액|면세비율, 기불공제|이미공제세액}] — 제81조제4항로 안분한 매입세액을 사용면적·공급가액이 확정된 과세기간 확정신고 때 정산(영 제82조, 별지 제22호 서식 (15)~(19)란). 결과: 판단·계산·결과(공제매입세액·추가_매출세액)·산식·근거. 계산의 실지귀속_공제는 기존 계산 키 유지. settlements가 있으면 결과.정산_가산또는공제((19) 합계, +면 납부세액 가산·공제매입세액 감소)와 서식_표.

Inputs: year (required), filing (required), ledger (required), period (required), +7 more.

corporate_deemed_rent_incomeA
Read-onlyIdempotent

Corporate deemed gross income from rental deposits in real estate leasing (임대보증금 간주익금). 법인 임대보증금 간주익금(조특법 제138조, 조특령 제132조). 언제: 법인이 부동산임대업에서 임대보증금을 받을 때 그중 일부를 간주익금으로 익금산입할지 계산한다. 입력: 사업연도(2016~2026) → year, 임대물건 목록 [{구분, 보증금, 건설비, 임대면적비율, 일수}] → rentals, 비주택 금융수익 합계(원) → financial_income, 정기예금이자율(소수·% 모두 허용, 생략 시 연도표) → rate, 차입금 과다 여부 → debt_over_2x, 부동산임대 주업 여부 → rental_main_business. 결과: 간주익금·보증금적수·건설비상당액적수·제외_주택보증금·세무조정, 판단(건물별 결론), 근거(조세특례제한법 제138조제1항·제2항, 시행령 제132조).

Inputs: year (required), rentals (required), rate, debt_over_2x, +2 more.

corporate_filing_obligationsA
Read-onlyIdempotent

External audit and external tax adjustment obligations plus transfer pricing filing duties (외부감사·외부세무조정 의무). 외부감사(외감법 제4조)·외부세무조정(법인세법 제60조제9항)·국제거래 자료 제출 의무(국조법 제16조·제34조·제36조·제58조) 판정. 언제: 법인 사업연도 종료 후 외부감사 대상 여부, 외부세무조정(세무대리인 조정) 의무, 국제거래명세서·요약손익계산서· 정상가격산출방법신고서·국제거래정보통합보고서·해외직접투자명세서 제출 의무를 한 번에 판정할 때. 입력: year — 사업연도(20162026, 개시일이 속하는 해). corp_type — '주식회사'|'유한회사'(기본 주식회사). 사업연도 개시일·종료일 → fy_start·fy_end(선택, 사업연도가 역년과 다를 때). 수익·자산·부채·종업원 → revenue·revenue_prev·assets·liabilities·employees. 유한회사 사원 수 → members(선택). 설립일 → established_on(선택). 외국자회사·국외사업장·특례·준비금·결정경정·합병분할·해외직접투자 → 각 bool. 국외특수관계인 거래 합계·상대방별 최대 → related_goods/services/intangibles, party_max_goods/services/intangibles. 국외특수관계 없는 자와의 국제거래 금액 → third_party_goods/services/intangibles(선택 — 정상가격 산출방법 신고서 면제 가목의 전체 금액에만 더함, 사전-2022-법규국조-0527). 결과: 외부감사는 대상 여부·충족조건, 외부세무조정은 대상 여부·사유(제17호) 목록, 국제거래명세서·요약손익계산서·정상가격산출방법신고서·국제거래정보통합보고서 각각 대상 여부, 해외직접투자명세는 대상 여부·기한. 판단·근거. 연도별 기준: 외부감사 — 2019.10.31. 이전 개시 사업연도(fy_start, 없으면 역년) 구 기준: 자산 120억 / 상장 / 부채 70억+자산 70억 / 종업원 300명+자산 70억, 주식회사만. 2020년부터 자산 또는 매출 500억, 4개(자산 120억·부채 70억·매출 100억·종업원 100명) 중 2개(유한회사 5개 중 3개). 값은 모두 직전 사업연도 기준. 국제거래명세서 — 2022년까지 국외특수관계인 거래가 있으면 제출, 2023년부터 재화 5억·용역 1억·무형 1억 모두 이하면 면제. 요약손익계산서·정상가격 산출방법 신고서 — 2022년까지 재화·용역 금액만, 2023년부터 무형자산 금액 포함. 해외현지법인 명세서등·국제거래명세서 기한 — 사업연도 종료일이 속하는 달의 말일부터 6개월. 2021.1.1. 전 개시 사업연도는 종전 기한(법인세 신고기한)이 2021.1.1. 현재 지나지 않았을 때만 6개월, 지났으면 종전 기한(법률 제17651호 부칙 제5조·제17조·제23조·제28조). 12월 결산이면 2019 사업연도까지 3.31., 2020 사업연도부터 6.30.

Inputs: year (required), assets, fy_end, listed, +24 more.

corporate_taxA
Read-onlyIdempotent

Corporate tax calculated tax amount (corporate income tax) from tax base and rate table, prorated for short years (법인세 산출세액). 법인세 산출세액(사업연도 과세표준 × 세율표, 1년 미만 사업연도 월할 환산). 언제: 법인세 신고·세무조정에서 과세표준이 정해졌을 때 산출세액을 구한다. 입력: 과세표준(과세표준, 원) → base, 사업연도(20162026) → year, 월수(112) → months, 성실신고확인대상 소규모 법인(제60조의2제1항제1호) 여부 → small_rental_corp. 결과: 산출세액·과세표준·사업연도·월수와 근거(법인세법 제55조제1항·제2항). 세율표는 사업연도별(20162017, 20182022, 2023~2025, 2026)로 다르고, 소규모 법인 세율(제55조제1항제2호)은 2025.1.1. 이후 개시 사업연도부터 적용. Corporate income tax on a tax base for a fiscal year (rate table, prorated for short fiscal years).

Inputs: base (required), year (required), months, small_rental_corp.

daily_worker_withholdingA
Read-onlyIdempotent

Daily worker withholding tax on daily wages (6%, 55% credit) (일용근로자 원천징수). 일용근로자 원천징수세액((일급 − 근로소득공제) × 6% × (1 − 55%), 1천 원 미만 소액부징수). 언제: 일용근로자에게 일급을 지급할 때 원천징수할 세액을 계산한다. 입력: 일급(원) → daily_wage, 지급연도(2016~2026) → year, 근로 제공일(선택) → work_date. 연도: 일용 근로소득공제 1일 10만원(2018.12.31.까지 근로 제공분), 15만원(2019.1.1. 이후 발생 소득분 — 법률 제16104호 부칙 일반적 적용례). 근로 제공일 기준이라 2018.12.에 일하고 2019년에 받으면 10만원 — work_date로 구분. 결과: 원천징수세액, 근거(소득세법 제134조제3항·제129조제1항제4호·제47조제2항·제86조). Withholding on daily workers' wages.

Inputs: daily_wage (required), year, work_date.

deemed_bonus_resettlementA
Read-onlyIdempotent

Deemed bonus year-end resettlement: additional withholding after income disposition (소득처분 상여 재정산). 소득처분 상여 연말정산 재정산(추가 원천징수세액). 언제: 법인세 소득금액 변동으로 상여 처분이 발생했을 때 해당 근로자의 연말정산을 재정산해 추가 원천징수세액을 구한다. 입력: 귀속연도 당초 총급여(원) → gross_pay, 당초 과세표준(원) → tax_base, 소득처분 상여(원) → bonus, 귀속연도(2016~2026) → year, 근로소득세액공제 외 세액공제 합계(원) → other_credits, 당초 결정세액(원, 모르면 생략) → prev_decided. 결정세액 = 산출세액 − 근로소득세액공제 − 표준세액공제 13만 원(other_credits=0일 때, 제59조의4제9항·제137조제3항 — wage_income_tax 결정세액(참고)와 같은 기준) − other_credits. 당초·재정산 모두 같은 식. 결과: 재정산총급여·재정산과세표준·재정산결정세액·당초결정세액·추가 원천징수세액·표준세액공제, 근거(법인세법 제67조, 소득세법 시행령 제192조, 소득세법 제137조). Year-end resettlement after a deemed bonus (income disposition) is added to wages.

Inputs: year (required), bonus (required), tax_base (required), gross_pay (required), +2 more.

deemed_dividend_bonus_sharesA
Read-onlyIdempotent

Deemed dividend per shareholder on capitalization of reserves (bonus shares) (의제배당). 잉여금을 자본에 전입(무상증자)할 때 주주별 의제배당 금액. 언제: 법인이 잉여금을 자본에 전입해 무상주를 발행할 때 주주별 의제배당을 계산한다. 입력: year — 사업연도(2016~2026). source — 재원(어휘 '의제배당_잉여금자본전입.판단.재원별' 키): 주식발행초과금·자본준비금·재평가적립금(과세 제외), 이익잉여금·자기주식처분이익·상환주식_주식발행초과금·자기주식소각이익_2년내(과세 대상), 재평가적립금_토지1%(과세 대상·Gross-up 비대상), 자기주식소각이익(과세 제외). capitalized_amount — 자본전입액(원). par_value — 액면가(원/주). shareholders — [{name, shares, self_stock?:bool}]: 무상증자 직전 보유주식수, 발행법인 자기주식은 self_stock=true. self_stock_allotment — '다른주주에게교부' | '미교부': 자기주식 몫 무상주를 다른 주주에게 교부했는지. shareholder_type — '법인' | '개인': 근거 조문(법인세법 제16조 / 소득세법 제17조)이 다름. 결과: 주주별 {배정주식수, 전입전지분율, 전입후지분율, 의제배당, 과세여부, 근거}, 전입후총주식수, 재원구분, 과세대상합계, 산식. 재원 어휘에 없으면 'error' 반환(계산하지 않음). 상환주식_주식발행초과금(이익잉여금으로 상환된 상환주식의 주식발행액면초과액)은 2024.2.29. 이후 자본에 전입하는 분부터 과세(법인세법 시행령 제12조제1항제5호, 2024.2.29. 부칙 제4조) — 그 전 전입분은 의제배당 아님. 재평가적립금을 일부만 전입하면 1% 토지분은 전입액 × (1% 토지 재평가차액 ÷ 재평가차액 전체)로 나눠 넣을 것(법인세법 시행령 제12조제4항, 소득세법 시행령 제27조제5항).

Inputs: year (required), source (required), par_value (required), shareholders (required), +4 more.

deemed_dividend_capital_reductionA
Read-onlyIdempotent

Deemed dividend on capital reduction, share cancellation, withdrawal or dissolution (의제배당). 감자·주식소각·퇴사·탈퇴·해산 시 의제배당 = 받은 금전·재산가액 − 소멸 주식 취득가액. 언제: 유상감자·주식소각·퇴사·탈퇴·해산으로 주주가 대가를 받았을 때 의제배당을 계산한다. 무상주 과세 여부는 deemed_dividend_bonus_shares로 먼저 판단해 kind에 넣는다. 입력: shareholder_type — '법인' | '개인'. event — '감자' | '주식소각' | '퇴사·탈퇴' | '해산'. resolution_date — 결의일 등(YYYY-MM-DD). acquisitions — [{date, shares, kind, unit_cost?, source?}]: 유상취득은 unit_cost, 무상주_과세는 액면가액, 무상주_비과세는 0. 처분은 보유 감소. cash_received — 받은 금전(원). property_value — 금전 외 재산 시가(원). cancelled_shares — 소멸 주식 수(퇴사·탈퇴·해산은 생략 시 전부). par_value — 1주당 액면가액(무상주_과세가 있으면 필수). 결과: 의제배당금액, 단기소각주식수(결의일 전 2년 이내 비과세 무상주 — 먼저 소각, 취득가액 0; 개인은 주식발행초과금 전입분 제외), 평균단가(나머지 주식 총평균), 소멸주식 취득가액, 소각 후 1주당 장부가액, 산식, 근거. 사실이 빠지거나 맞지 않으면 'error'와 '필요 입력'을 돌려주고 계산하지 않음.

Inputs: event (required), acquisitions (required), cash_received (required), resolution_date (required), +4 more.

deemed_interestA
Read-onlyIdempotent

Deemed interest on provisional payments to related parties and wrongful calculation check (가지급금 인정이자). 가지급금 인정이자(적수 × 시가 이자율)와 부당행위계산 여부. 언제: 특수관계인 가지급금 이자와 부당행위 3억·5% 판정을 함께 구할 때. 입력: 가지급금 증감 [{date, amount(원, 대여 +, 회수 -)}] → movements, 사업연도 종료일(YYYY-MM-DD) → year_end, 시가 이자율(소수) → market_rate(rate_mode='입력'일 때), 실제 이자율(소수) → charged_rate, 실제 받은 이자 금액(원) → received_interest, 사업연도 개시일(YYYY-MM-DD, 생략 시 year_end 기준 자동 계산) → fiscal_start, 동일인 가수금 [{date, amount(원, 입금 +, 반환 -), offset_blocked(상계 불가 여부), 이름?}] → deposits, 이자율 계산 방식('입력'|'가중평균'|'당좌선택') → rate_mode, 차입금 [{borrowed_on, amount, rate, repaid_on?, related?, unclear_creditor?}] → borrowings(rate_mode='가중평균'일 때). 결과: 적수(가수금 상계 후)·가지급금적수(상계 전)·가수금적수·시가이자·수령이자·차액·익금산입액·부당행위 여부·계산(대여건별, rate_mode='가중평균'일 때), 근거(법인세법 제52조, 시행령 제88조제3항·제89조제3항, 시행규칙 제43조). 국외특수관계인 대여(foreign_related=True): 국제거래에는 법인세법 제52조를 적용하지 않고(국조법 제4조제2항) 정상이자율과의 차액을 익금산입(국조법 제7조) — 3억·5% 기준 없음. 원칙은 채무액·만기·보증·신용을 고려해 산출한 정상이자율(rate_mode='입력', 시행령 제11조제1항). rate_mode='당좌선택'은 시행규칙 제3조제1호의 간주 정상이자율(당좌대출이자율)로, 법 제8조제1항제6호의 방법이라 제1호~제5호로 산출할 수 없는 경우에만 쓴다(법 제8조제1항 단서). 입력한 이자율이 정상이자율인지는 판정하지 않음. '가중평균'은 쓰지 않음. 2020년까지 개시한 사업연도: 구 국조법 제3조제2항·제4조, 구 시행령 제6조제7항. 간주 정상이자율(당좌대출이자율, 구 시행규칙 제2조의2)은 2017.2.7. 이후 자금거래분부터(대통령령 제27837호 부칙 제2조)라 그 전에 대여한 금액이 있으면 '당좌선택'을 받지 않고 '입력'으로 계산. 구법에서는 간주 이자율이 제1호 이자율과 나란한 선택지(구 시행령 제6조제7항 각 호의 어느 하나).

Inputs: year_end (required), movements (required), deposits, rate_mode, +6 more.

depreciation_adjustmentA
Read-onlyIdempotent

Corporate tax depreciation adjustment: depreciation limit vs book depreciation per asset (감가상각 시부인). 법인세 감가상각 시부인 — 개별 자산별 상각범위액과 회사계상액 비교(법인세법 제23조, 시행령 제26조·제28조·제30조·제31조·제32조). 언제: 감가상각비 세무조정(상각부인액·시인부족액·전기 부인액 추인·감면법인 의제상각)과 세무상 미상각잔액을 구할 때. 입력: year — 사업연도(2016~2026), method — 정액법|정률법|무신고(asset_class 필요). useful_life 또는 rate — 내용연수(별표4 상각률) 또는 상각률. acquisition_cost·booked_depreciation — 기말 취득가액·당기 감가상각비. accumulated_dep_begin 또는 accumulated_dep_end — 기초 또는 기말 감가상각누계액. expensed_capex·repair_total·periodic_repair·prior_book_value — 비용 처리한 자본적 지출과 즉시상각의제 예외 판단(600만원·2019년까지 300만원 미만, 직전 장부가액 5% 미만, 3년 미만 주기 수선). prior_deemed_capex — 전기 이전 즉시상각의제 누계(정액법). prior_disallowed — 전기말 상각부인누계액(△유보면 음수). in_service_date — 기중 취득·사용개시일(월할, 1개월 미만은 1개월). fy_start·fy_end — 사업연도(12개월만 지원). tax_exempt — 법인세 면제·감면 여부. 기타 무형자산(영 제24조제1항제2호차목, 대통령령 제35350호 부칙 제6조: 2025.2.28.이 속하는 사업연도에 감가상각하는 경우부터): asset_class='기타무형자산'. 신고(method='정액법', useful_life=기업회계기준 내용연수 n년) → 취득가액 × 경과월수 ÷ (n×12). 무신고 → 취득가액 ÷ 5(5년 균등). 그 전 사업연도, 무신고분의 사업연도 중 사용개시(월할 방법 미확정)는 범위 밖으로 돌려줌. 결과: 세무조정(상각부인액 유보, 추인·감가상각의제 △유보)·상각범위액·회사계상액·기말 상각부인누계액·세무상 미상각잔액·판단·근거. 사실이 빠지거나 맞지 않으면 error와 필요 입력을 돌려주고 계산하지 않음.

Inputs: year (required), method (required), acquisition_cost (required), booked_depreciation (required), +15 more.

disaster_loss_creditA
Read-onlyIdempotent

Corporate disaster loss tax credit for assets lost in a disaster (재해손실세액공제). 법인 재해손실세액공제. 언제: 재해로 자산을 상실한 법인의 법인세 세액공제를 계산할 때. 입력: 사업연도 → year, 자산(assets 또는 assets_before/assets_lost), 당기 법인세 → current_tax, 공제대상 법인세에서 차감할 세액 → other_credits 또는 credit_items, 미납 법인세 → unpaid_prior_tax, 가산세 → penalty 또는 penalty_items. 결과: 자산상실비율·공제대상 법인세·재해손실세액공제·판정·자산계산과정(assets 사용 시)·판단(credit_items·penalty_items 사용 시)·근거. 공제대상 법인세 = 미납 법인세 + max(당기 법인세 − 조세특례제한법 공제, 0) + 가산세(시행령 제95조제3항 대상). 법인세법 공제(credit_items '법인세법')는 공제대상 법인세에서 빼지 않음. '기타' 가산세도 제외.

Inputs: year (required), assets, penalty, assets_lost, +6 more.

dividend_received_deductionB
Read-onlyIdempotent

Dividends received exclusion from gross income for domestic corporations (수입배당금 익금불산입). 내국법인 수입배당금액 익금불산입(피출자법인별 익금불산입률·지급이자 차감·세무조정). 언제: 법인세 세무조정에서 수입배당금 익금을 부인할 때. 입력: 사업연도 → year, 피출자법인 목록 → investees, 지급이자 → interest_paid, 차감 이자 → interest_excluded, 자산총액 적수 → total_assets_jeoksu. 결과: 익금불산입액의 피출자법인별 내역·세무조정·근거. 수입배당금 익금불산입 계산.

Inputs: year (required), investees (required), fy_end, fy_start, +5 more.

dividend_tax_creditA
Read-onlyIdempotent

Dividend tax credit and comparative tax under financial income global taxation (배당세액공제). 배당세액공제와 금융소득 종합과세 비교산출세액(소득세법 제56조·제62조·제15조2호). 언제: 금융소득이 2천만원을 넘어 종합과세될 때 일반산출세액(제62조1호)·비교산출세액(제62조2호)·종합소득 산출세액·배당세액공제액(Gross-up과 한도 중 적은 금액)을 구할 때. 입력: 귀속연도(20162026) → year, 금융소득 항목(financial_income_aggregate 형식) → items 또는 그 결과 숫자(grossup, financial_14, financial_25, partner_dividend), 금융소득을 뺀 종합소득 과세표준 → other_base(또는 과세표준 전체 → taxable_base). 결과: 일반산출세액(1호: (이자소득등 − 2천만 + 다른 과세표준) × 기본세율 + 2천만 × 14%), 비교산출세액(2호: 이자소득등(Gross-up 제외) × 원천징수세율 + 다른 과세표준 × 기본세율, 출자공동사업자배당 비교세액 포함), 종합소득 산출세액(큰 금액), 배당세액공제 한도(산출세액 − 비교산출세액), 배당세액공제액 = min(Gross-up, 한도), 공제 후 세액. 연도: 20162026. Gross-up 가산율은 지급일 기준 — 2023.12.31.까지 지급 11%, 2024.1.1.2026.12.31. 지급 10%(법률 제19933호 부칙), 2027.1.1. 이후 지급 11%. 항목에 paid_date를 주면 그 날짜로, 없으면 귀속연도 안 지급으로 봄. 원천징수되지 않은 비영업대금 이익은 2016년 14%, 2017년부터 25%(제62조2호 가목, 법률 제14389호 부칙 제2조제1항). 지원하지 않음(입력 확인 필요로 멈춤): 종합소득공제가 금융소득 외 소득보다 커서 다른 과세표준이 음수(또는 출자공동사업자배당보다 작음)인 경우, 조세특례제한법 제104조의27 배당(20162018 옛 특례). 2026.1.1. 이후 고배당기업 배당 특례(separate_election=true)는 종합과세에서 빠지고 그 분리 산출세액은 financial_income_aggregate 결과 '특례배당_산출세액'으로 따로 — 이 도구 산출세액에는 넣지 않음, 외국납부세액공제 등 다른 세액공제·감면(제15조2호 — 이 도구 결과 뒤에 적용), 비거주자.

Inputs: year (required), items, grossup, other_base, +4 more.

dominant_shareholderA
Read-onlyIdempotent

Controlling shareholder test for beneficiary corporation in intra-group transfer gift tax (지배주주 판정). 수혜법인의 지배주주 판정(상증법 시행령 제34조의3제1항). 언제: 일감몰아주기 증여의제이익 계산에서 수혜법인의 지배주주가 누구인지 판정할 때. 입력: 수혜법인(이름) → corp, people={이름: {구분: "개인"|"법인"}} → people, family=[[a, b, "부모자녀"|"배우자"]] → family, stakes=[[보유자, 법인, 지분율(0~1)]] → stakes(related_judge와 동일 형식). 기준일: 수혜법인 사업연도 종료일 → on. 최대주주등을 묶는 친족 범위가 2023.2.28.까지 6촌 혈족·4촌 인척, 2023.3.1.부터 4촌 혈족·3촌 인척(국세기본법 시행령 제1조의2제1항). 결과: 지배주주(이름)·판정 이유·친족 범위. 수혜법인의 지배주주를 판정한다(중견기업 중 직접보유 최고자 / 법인이면 직접+간접 최고 개인).

Inputs: corp (required), family (required), people (required), stakes (required), +1 more.

donation_limitA
Read-onlyIdempotent

Corporate donation limit (special 50%, general 10%), excess and carryforward (기부금 한도). 기부금 손금산입 한도(특례기부금 50%, 일반기부금 10%)와 한도초과·이월. 언제: 기부금을 손금산입할 때 한도와 한도초과액을 구한다. 입력: 기준소득(과세표준 계산 전 소득금액, 원) → base_income, 특례기부금 지출액(원) → special, 일반기부금 지출액(원) → general, 결손금(원) → carried_loss, 특례 이월액(원) → special_carry, 일반 이월액(원) → general_carry, 중소기업 여부 → sme, 사회적기업 여부 → social_enterprise, 사업연도(2016~2026, 개시일이 속하는 해) → year, 사업연도 개시일·종료일 → fy_start·fy_end, 신고일 → filing_date(선택). 기준일: 이월분 먼저 공제(제24조제6항)는 2020.1.1. 이후 과세표준 신고분(법률 제16833호 부칙 제4조), 사회적기업 20%는 2019.1.1. 이후 신고분(법률 제16008호 부칙 제4조제1항), 30%는 2026.1.1. 이후 개시 사업연도 지출분(법률 제21217호 부칙 제3조), 결손금 차감 한도는 2021.1.1. 이후 개시 사업연도 지출분(법률 제17652호 부칙 제6조). 신고일은 filing_date, 없으면 fy_end(없으면 역년 종료일)의 신고기한으로 봄. 날짜를 주지 않고 경계 연도면 주의를 붙임. 결과: 한도·한도초과·이월 손금산입, 근거(법인세법 제24조).

Inputs: year (required), base_income (required), sme, fy_end, +8 more.

earned_income_gross_payA
Read-onlyIdempotent

Employment earned income total salary: taxable vs non-taxable pay items and wage deduction (근로소득 총급여액). 근로소득 항목별 과세·비과세를 판정하고 귀속연도를 확인해 총급여액·근로소득공제·근로소득금액을 계산한다(소득세법 제20조·제12조3호·제47조, 시행령 제11조·제12조·제17조·제17조의24·제38조·제49조). 언제: 연말정산·종합소득세 신고에서 급여·상여·수당·복리후생 급여 자료로 총급여액과 근로소득금액을 구할 때. 입력: 귀속연도(20162026) → year, 항목 목록 [{kind, amount, facts}] → items. kind와 facts(필요한 사실): · 급여·상여 — 다른 해 근로분이면 service_year · 잉여금처분상여 — resolution_date(결의일 연도 귀속) / 인정상여 — service_year · 식사대 — months, meal_provided / 자가운전보조금 — months, vehicle(본인소유|본인명의임차|기타), business_use, actual_travel_reimbursed · 출산·보육수당 — purpose(보육: months, child_age(과세기간 개시일 현재 만 나이, 6세 이하) / 출산: 2024~ within_2y_of_birth·payment_count(사용자별 지급 차수)·related_party, 그 전 months. 2024년 지급분은 2021.1.1. 이후 출생 자녀면 child_born_on(출생일)으로 2년 요건을 대신함. 2025~ 요건 미충족 출산 급여는 전액 과세). 보육 한도: 20162023 월 10만원(출산 포함), 20242025 월 20만원(근로자 1인당), 2026~ 자녀 1명당 월 20만원 — 2026는 child_ages(자녀별 개시일 나이 목록) 또는 child_count, 또는 자녀별 항목으로 나누고 facts.child(자녀 이름)를 다르게 · 직무발명보상금 — retired(퇴직 후면 기타소득), 2024 related_party · 연장근로수당 — eligible_occupation, 해당 시 prior_year_gross(필수)·monthly_regular_wage(광산·일용은 mine_or_daily). monthly_regular_wage가 없으면 같은 호출 항목으로 영 제17조제1항 월정액급여를 산정(연간 합계 ÷ months, 기본 12) — 지급 형태가 이름만으로 정해지지 않는 항목(직무발명보상금·학자금·출산 급여 등)은 facts.regular_monthly(매월 정기 지급 여부) · 사택제공이익 — position / 주택자금대여이익 — sme(2024~ related_party, 2024년은 2024.2.28.까지 발생분 accrued_before_20240229 — 비과세) · 지급일: 식사대(2023.1.1. 이후 받는 분)·출산·보육수당(2024.1.1.·2026.1.1. 이후 지급분)·연장근로수당(2026 과세기간 지급분)은 부칙이 지급분 기준 — 귀속연도와 다른 해에 지급했으면 facts.paid_date(YYYY-MM-DD)로 항목을 나눠 넣으면 지급일 한도 적용(넣지 않으면 귀속연도 한도, 경계 연도엔 주의) · 학자금 — beneficiary(본인|가족), 본인이면 requirements_met / 실비변상여비 — actual_cost · 단체보험료(연 한도) / 사회보험료_본인부담분_회사대납(과세) / 사회보험료_사용자부담분 — insurance 결과: 항목별(과세액·비과세액·근거·사유)·제외 항목(다른 해·다른 소득)·총급여액·비과세 합계·근로소득공제·근로소득금액.

Inputs: year (required), items (required).

emigration_exit_taxA
Read-onlyIdempotent

Departure tax (exit tax) on a Korean resident major shareholder's domestic shares (국외전출세, 소득세법 제118조의9~제118조의18). 국외전출세 — 출국일 시가로 양도한 것으로 보아 양도소득금액 − 연 250만원 = 과세표준, 세율은 출국일로 고른다. 언제: 대주주인 거주자가 해외로 이주하면서 보유한 국내주식에 내는 양도소득세와 신고기한·납부유예·실제 양도 후 공제를 확인할 때. 입력: departure_date(출국일), residence_years_in_10(10년 중 국내 주소·거소 기간), major_shareholder(직전 연도 말 대주주 여부), holdings(종목별 출국일 시가·필요경비·중소기업 여부·국외주식등 여부), holdings_reported·unreported_face_value(보유현황 미신고 가산), manager_reported(납세관리인 신고), foreign_worker_exempt(외국인근로자 국외주식등 제외). 결과: 납세의무 여부, 양도소득금액·과세표준·산출세액·미신고 가산, 세율 구간, 신고·납부기한, 조정공제·외국납부세액공제·비거주자 세액공제 안내, 납부유예 요건·이자상당액, 재전입 환급, 한계. 세율: 2018년 출국분 20%, 2019년 이후 출국분 3억원 이하 20%·초과 25%(2019년 출국분 중소기업 주식등은 20%, 2018.12.31. 법률 제16104호 부칙 제1조 단서). 2027.1.1. 이후 출국분(법률 제21221호 부칙 제8조): 국외주식등(양도가액 합계 5억원 초과분만 대상)은 중소기업 10%·그 밖 20%, 대주주 판정에서는 국외주식등을 뺀다. 세율이 다른 주식등이 섞이면 양도차손은 양도소득금액 비율로 나눠 공제하고, 연 250만원 공제 순서에 따른 세액 범위를 함께 보여 준다. 대주주 기준·출국일 시가는 입력값이다. 과세표준 1원 미만·세액 원 미만을 버리고, 납부할 때 10원 미만 끝수를 버린다(국고금 관리법 제47조).

Inputs: holdings (required), departure_date (required), major_shareholder (required), residence_years_in_10 (required), +4 more.

employment_increase_creditA
Read-onlyIdempotent

Employment increase tax credit for 2018-2024 headcount growth and clawback (고용증대 세액공제). 고용을 증대시킨 기업에 대한 세액공제 — 20182024년에 상시근로자가 늘어난 기업의 과세연도별 공제 대상 세액과 인원 감소 시 추가 납부액(조세특례제한법 제29조의7). 언제: 2022년까지 직원이 늘어난 회사가 그 해와 뒤 12년의 공제를 구하거나, 2023·2024년 증가분을 통합고용세액공제와 비교할 때. 입력: 과세연도 → year, 기업 규모 → size, 연도별 상시근로자 수 → headcounts, 수도권 밖 여부 → outside_capital_area, 이 공제를 적용한 해 → only_first_years. 계산: 늘어난 인원(전체 증가 인원 한도) × 1인당 금액 — 청년등은 중소기업 1,100만원(수도권 밖 1,200만원, 2021·2022년 수도권 밖 1,300만원), 중견 800만원, 그 밖 400만원. 청년등 외는 중소기업 700만원·770만원, 중견 450만원, 그 밖 0. 최초 공제 과세연도와 그 뒤 1년(중소·중견기업 2년) 동안 공제. 전체 인원이 최초 공제 과세연도보다 줄면 중단, 청년등만 줄면 청년등 외 금액으로 공제. 준 해에는 추가 납부액 계산. 결과: 공제 대상 세액, 추가 납부세액, 계산(최초 공제 과세연도별 증가 인원·차수·1인당 금액·공제액·추가 납부), 판단·근거·주의. 2020년에 인원이 준 2018·2019년 최초 공제분은 사후관리 유예(제29조의7제5항~제7항): 2020년은 추가 납부 없음, 2021년에 회복하면 공제 재개, 2021·2022년에 줄면 추가 납부 — headcounts에 2018년부터 넣음. 범위 밖: 2019.1.1. 전에 신고한 2018 과세연도분, 2020.1.1. 전에 신고한 감소 과세연도의 종전 사후관리 식, 2017년 이전 제도, 최저한세·이월(minimum_tax_adjustment), 통합고용세액공제(integrated_employment_credit).

Inputs: size (required), year (required), headcounts (required), credits_taken, +3 more.

entertainment_adjustmentA
Read-onlyIdempotent

Entertainment expense tax adjustment for corporate tax, incl. pre-2024 years (기업업무추진비 세무조정). 기업업무추진비 세무조정 — 2023년 이전 사업연도의 "접대비"와 같은 항목(2024.1.1. 명칭 변경, 법률 19193). 접대비 문제·장부도 이 도구로 계산한다(법인세법 제25조, 시행령 제40조·제41조·제42조). 언제: 법인세 신고에서 기업업무추진비 손금불산입을 항목별로 계산할 때. 입력: · 사업연도(20162026) → year, 중소기업 여부 → sme, 사업연도 월수(112, 기본 12) → months, 현물 평가 시 부가가치세 포함 여부(기본 True) → include_vat. · 사업연도 개시일·종료일 → fy_start·fy_end, 과세표준 신고일 → filing_date(선택 — 사업연도가 역년과 다르거나 신고일 기준 부칙을 정확히 고를 때). · 원장: ledger=[{항목, 금액, 증빙:'없음'|'영수증 등'|'적격'(기본 '적격'), 성격?:'교제목적'|'직원단체_법인'|'직원단체_비법인'|'임직원부담'|'현물'|'경조금'|'문화', 시가?, 장부가액?, 건당기준초과?:(기본 true), 지출일?:YYYY-MM-DD}], 지출일을 주면 적격증빙 기준금액(영 제41조제1항)을 그날로 고름(2021.1.1. 이후 지출분부터 상향, 대통령령 제31443호 부칙 제9조). revenue={매출액, 특수관계매출?(기본 0), 매출할인등:{일반?, 특수관계?}(기본 0)}. 증빙 허용값(어휘 기반): · 없음 — 지출 증빙이 전혀 없는 건(손금불산입·상여, 귀속 대표자) · 영수증 등 — 영수증 등은 있으나 적격증명서류가 아닌 건(건당 기준 초과 시 손금불산입·기타사외유출) · 적격 — 적격증명서류(세금계산서·계산서·신용카드·현금영수증) 수취 건(한도 시부인 대상) 성격 판단(어휘 기업업무추진비_포함항목.판단.성격별): · 없음·교제목적 → 포함(법 제25조제1항) / 직원단체_법인 → 포함(영 제40조제2항) / 직원단체_비법인 → 제외(복리후생비) · 임직원부담 → 제외(영 제40조제1항) / 현물 → 포함(max(시가, 장부가액) + 부가세, include_vat 기본 True, 영 제42조제6항·법 제36조제1항제3호) / 경조금·문화·전통시장 → 기존과 동일 · 사적사용 → 시부인 대상 제외, 직접 손금불산입(상여, 법인세법 제19조제2항·시행령 제40조제1항) · 전통시장 → 포함(「전통시장 및 상점가 육성을 위한 특별법」상 전통시장에서 쓴 적격 기업업무추진비, 조특법 제136조제6항, 전통시장등 추가한도 대상) · 지역사랑상품권 → 포함(지역사랑상품권으로 지급한 적격 기업업무추진비, 조특법 제136조제6항, 2026.1.1. 이후 신고분부터 전통시장등 추가한도 대상 — 법률 제21223호 부칙 제31조) · 온누리상품권 → 포함(온누리상품권으로 지급한 적격 기업업무추진비, 조특법 제136조제6항, 2026.5.12.이 속하는 사업연도 지출분부터 전통시장등 추가한도 대상 — 법률 제21612호 부칙 제4조) 기준일: 전통시장등 비율은 신고일로 고름 — 2024.1.1. 이후 신고분 10%(전통시장), 2026.1.1. 이후 신고분 20%(+지역사랑상품권). 날짜를 주지 않으면 사업연도 표(역년 가정)로 고르고 경계 연도면 주의를 붙임. 2020 수입금액 특례는 2020년이 두 사업연도에 걸치면 일할(조특법 제136조제5항). · 원장 합계: ledger_total(원장·계정 합계)을 주면 ledger 금액 합계와 대조. ledger는 원장 행을 직접 더해 한 줄로 합치지 말고 행마다 넣는다. 결과: 판단(항목별·근거)·결과(한도·한도초과)·세무조정(구분·금액·소득처분)·소득처분별_합계·손금불산입_합계·계산(원장 합계 대조 포함). 기업업무추진비 세액공제.

Inputs: sme (required), year (required), ledger (required), fy_end, +6 more.

entertainment_limitA
Read-onlyIdempotent

Entertainment expense limit and non-deductible excess for corporate tax (기업업무추진비 한도). 기업업무추진비(접대비) 한도와 한도초과액. 언제: 법인세 세무조정에서 기업업무추진비 손금불산입액을 구할 때. 입력: 사업연도(2016~2026, 개시일이 속하는 해, 2023년까지는 '접대비') → year, 수입금액(일반, 중단사업부문 매출 포함 기업회계 매출액) → general_revenue, 특수관계인 수입 → related_revenue, 중소기업 여부 → sme, 지출액(접대비) → expensed, 문화비 → culture, 전통시장등 지출 → market, 사업연도 월수 → months, 사업연도 개시일·종료일 → fy_start·fy_end, 신고일 → filing_date(선택). 기준일: 전통시장등 추가한도는 2024.1.1. 이후 신고분 10%(전통시장, 법률 제19936호 부칙 제35조), 2026.1.1. 이후 신고분 20%(지역사랑상품권 포함, 법률 제21223호 부칙 제31조), 온누리상품권은 2026.5.12.이 속하는 사업연도 지출분부터(법률 제21612호 부칙 제4조). 2020 수입금액 특례는 2020년에 속하는 일수로 일할(조특법 제136조제5항). 날짜를 주지 않으면 사업연도 표(역년 가정)로 고르고 경계 연도면 주의를 붙인다. 결과: 한도·한도초과액(손금불산입)·근거(법인세법 제25조, 시행령 제42조), 날짜를 주면 기준(신고일·비율·대상·2020년 일수). 기업업무추진비 한도와 한도초과액 계산; 접대비가 한도를 넘는가 확인할 때 쓴다.

Inputs: sme (required), year (required), expensed (required), general_revenue (required), +7 more.

estimated_business_incomeA
Read-onlyIdempotent

Estimated business income for businesses without adequate books (추계 사업소득금액). 추계 사업소득금액(소득령 제143조, 제208조제5항). 언제: 장부가 없거나 불충분한 사업자의 사업소득금액을 추계로 계산할 때. 입력: 귀속연도(2016~2026) → year, 업종군(가·나·다) → industry_group, 직전연도 수입금액(원) → prior_year_revenue, 수입금액 목록 [{구분, 금액}] → revenues, 증빙 입증 지출 목록 [{구분, 금액}] → expenses, 기준경비율 → base_rate, 단순경비율 → simple_rate, 신규 사업 여부 → new_business, 배율(소수·% 허용, 생략 시 귀속연도 기본) → multiplier. 연도: 단순경비율 대상의 '해당 과세기간 수입금액' 요건은 2019년 귀속부터(영 제143조제4항, 2018.2.13. 개정), 2018년까지는 신규사업자에만 적용. 복식부기의무자의 사업용 유형자산 처분액 수입금액 산입은 2018년 귀속부터(법 제19조제1항제20호, 2017.12.19. 신설). 배율(규칙 제67조): 2019 과세기간까지 간편 2.6·복식 3.2, 2020 과세기간부터 간편 2.8·복식 3.4 — 기획재정부령 제781호(2020.3.13.) 부칙 제9조: 시행일이 속하는 과세기간 전 발생 소득분은 종전 배율(결정·경정 시점과 무관). 수리 및 기타 개인서비스업 중 부가령 제42조제1호 인적용역(personal_service=true, 다군)은 2023 과세기간부터 단순경비율 직전 수입 기준 3,600만원(영 2023.2.28. 개정 부칙 제7조제1항: 시행일이 속하는 과세기간 발생 소득부터) — 간편장부·당해 수입 기준은 다군 그대로. 결과: 사업소득금액·계산(수입금액·장부구분·적용방법·주요경비·기준경비율_소득·한도), 판단(수입금액 구성·제외·적용방법 사유·주요경비 제외), 근거(소득세법 시행령 제143조·제208조제5항).

Inputs: year (required), expenses (required), revenues (required), base_rate (required), +6 more.

expat_cost_rechargeA
Read-onlyIdempotent

Expatriate cost recharge to overseas subsidiary with markup, deductibility, exemption (해외 파견 인건비). 해외 파견 인건비 청구액·손금·비과세 계산. 언제: 해외 현지법인에 파견한 직원의 인건비를 본사가 현지법인에 청구(정상가격 마크업 포함)할 때, 청구액에 따른 본사 손금·손금불산입·정상가격 조정 익금산입과 근로자 국외근로 비과세(월 100만원, 건설·선박은 2023년까지 300만원·2024년부터 500만원)를 함께 구할 때. 입력: year — 사업연도(2016~2026). items — 항목별 [이름, 급여, 사회보험, 체재비, 귀속(본사/현지법인/공통), 공통비율(공통일 때), 마크업, 청구액, 국외근로_개월, 국외근로_유형, 거주자]. 결과: 합계·항목별(원가, 현지법인 귀속원가, 정상청구액, 청구액, 미청구, 본사 손금, 본사 손금불산입, 소득처분, 정상가격 조정 익금산입, 근로자 비과세), 판단·근거.

Inputs: year (required), items (required), sme_or_midsize.

export_workbookA
Idempotent

Builds Korean statutory return forms (법정서식 · 별지 서식) as an Excel (.xlsx) file — the filing forms with fixed box numbers and wording, amounts as live formulas — saved in output_dir with its absolute path in result '파일'. Not needed for a general workings workbook: build that yourself and run verify_workbook on the saved file. 한국 법정서식(별지 서식) 엑셀을 만든다 — 칸 번호·문구가 정해진 신고 서식. 일반 계산 근거 통합 문서에는 쓰지 않아도 된다(계산 근거·보고용 Excel은 직접 짜고, 저장한 뒤 verify_workbook으로 금액 칸을 대조). 계산 도구 호출을 calls로 넘기면 서식 틀 시트(금액 칸은 수식)와 계산·입력·판단 근거 시트가 든 .xlsx를 output_dir에 저장하고 절대경로(결과.파일)를 돌려준다. 언제: 법인세·소득세·부가가치세·원천징수·상속세 및 증여세 신고 서식(별지 서식) 틀에 계산 결과를 채운 엑셀이 필요할 때, 세무조정 결과를 서식 칸 번호로 검토할 때. 계산 근거·보고용 통합 문서는 직접 짠 뒤 verify_workbook. 입력: title — 문서 제목(파일명 기본값). calls — [{label, tool, args}] 목록(1~30개). tool 이름이 없거나 'export_workbook'이면 오류(재귀 금지). output_dir — 저장할 폴더(기본: '.'). 없으면 오류. filename — 파일명(기본: title, .xlsx 자동). '/ \ : * ? " < > |'는 '_'로 대체. layout — 'forms'(기본: 서식 틀 시트 + 계산 N + 입력·가정 + 판단·근거) 또는 'steps'(요약 + 계산 N + 입력·가정 + 판단·근거). company·period·biz_no — 서식 머리에 적는 법인명(상호·성명)·사업연도 표기·사업자등록번호(기본 ''). review_notes — 검토·확인 필요 사항 {항목, 내용}. 맨 앞 '요약' 시트에 실림. lang — 'ko'(기본) 또는 'en'(English view for foreign readers): 시트 이름·요약 시트 라벨·표 머리글·결과 키를 'English (국문)'으로(예: 'Tax base (과세표준)'), 근거 조문은 영문 인용으로 적는다. 번역표는 docs/glossary_ko_en.md이고 없는 국문 라벨은 그대로 두어 결과.번역_없음에 모은다(번역을 지어내지 않음 — 영문을 붙이려면 labels에 넣어 다시 호출). 법정서식 틀 시트는 한국어 신고 서식 그대로이고 요약 시트에 시트마다 한 줄 영문 안내가 붙는다. 도구가 돌려준 문장은 번역하지 않는다. With lang='en', write review_notes and other texts you pass in English. '요약' 시트(layout='forms'): 세액 요약(소득금액 집계·산출세액 call이 있을 때), 세무조정 항목별 근거와 계산 시트, call별 주요 값, 검토·확인 필요 사항. 시트 규칙: '계산 N'은 N번째 call(오류 call 포함, call마다 한 장). 같은 도구를 여러 번 부르면 신고서 한 부에 한 장인 서식(별지3·15·34, 부가 별지19 등)은 마지막 call이 본 시트, 앞선 call은 '<시트> (호출 N)' 시트. 자산·거래·소득자마다 한 장인 서식(별지20·별지84·증여 별지10·원천 별지23 등)은 첫 call이 본 시트, 다음 call은 '<시트> (2)'·'(3)'. 여러 call을 한 장의 행·합계로 모으는 줄(부가 신고서 (4) 간주공급·(8) 대손세액 가감·(29) 가산세액, 별지25 부동산임대)은 한 장. 서식 칸은 그 값을 만든 call에서 채운다. 선택: 표준 틀의 계산 근거가 필요할 때 — scenarios(call을 열로 나란히 놓는 시나리오 시트)·sources(입력 출처, from_call·from_row·less로 호출 사이 부족분·차액을 수식으로 연결)·issues(쟁점 목록)· actions(조치·기한)·key_figures(요약 시트 핵심 숫자)·extra_sheets(도구 계산이 아닌 표 — 틀 고정: 4행 머리글, 5행부터, 첫 열 A, 수식은 같은 시트의 표 안 칸만, '계산 도구의 검증을 거치지 않음' 표시)· labels({원래 키·라벨: 표시할 글})·detail(뒤 시트 — compact 기본: '계산 상세' 한 장 / forms: + 신고 서식 / full: 전부). 하나라도 주면 맨 앞에 요약·입력·출처·시나리오 시트가 생기고(다 없으면 기존 출력 그대로), 꼴은 각 입력의 설명에 있다. 맞지 않는 입력은 오류나 warnings로 알려 준다. 이런 통합 문서는 직접 짜는 쪽이 기본이다 — 읽는 사람에게 필요한 줄만 고를 수 있다.

결과: 결과.파일 — 저장한 .xlsx 파일의 절대경로(output_dir 안, 같은 이름이 있으면 ' (2)'를 붙임). 수식 칸에 계산 값도 함께 저장해 휴대폰·미리보기에서도 값이 보임(Excel은 열 때 수식으로 다시 계산). Re-saving the file with openpyxl or similar drops those stored values — 파일을 다시 저장하면 그 값이 지워지므로 고칠 것은 입력으로 넘겨 다시 호출하거나 verify_workbook으로 값을 다시 채운다(결과.파일_안내). 결과.시트 — 시트 이름 목록. 결과.call_수 — calls 길이. 결과.오류_call — 오류 발생한 call의 label 목록. 계산 값을 쓰지 못한 칸이 있으면 warnings. 선택 입력을 줬을 때만: 결과.통합_시트·결과.detail·결과.시트_안내(뒤 시트 구성)·결과.서식_안내(compact에서 서식이 있을 때 — 이 두 안내는 시트에 찍지 않고 결과로만), 결과.자유_시트·결과.자유_시트_안내(extra_sheets), 결과.labels_적용(labels). lang='en'일 때만: 결과.lang, 결과.번역_라벨_수, 결과.번역_없음(국문 그대로 찍힌 라벨·근거 구절·법령명), 결과.번역_없음_안내. lang='en'이면 결과 JSON의 키도 영어 — result.file·result.sheets·result.call_count·result.failed_calls·result.untranslated·result.file_note, basis(위 결과.* 이름과 같은 뜻). 근거 — '계산 도구 결과 정리(세무 자문 아님)'.

Inputs: calls (required), title (required), lang, biz_no, +14 more.

extract_relationsA
Read-onlyIdempotent

Relationship table extraction from shareholder, family and officer PDF documents (관계표 추출). 주주명부·가족관계·임원명단 PDF에서 관계표(people/family/stakes/officers)를 추출한다. 언제: 세무조사·의료법인 친족확인 등에서 PDF 문서에 있는 관계표를 도구 입력으로 정리할 때. 입력: PDF 파일 경로 → pdf_path. 결과: people·family·stakes·officers 추출 결과(초안) + AI 생성 표시(필요 시). related_judge에 넣기 전에 사람이 확인한다. UPSTAGE_API_KEY 없이도 pypdf 로컬 추출 후 정리 가능(기본), 키 설정 시 Document Parse + Solar Pro 4로 더 정교한 표 추출. 주주명부·가족관계·임원명단 PDF에서 관계표를 뽑는다.

Inputs: pdf_path (required).

financial_income_aggregateA
Read-onlyIdempotent

Financial income global taxation: interest and dividend aggregation and gross-up (금융소득 종합과세). 종합소득 합산 금융소득(이자·배당)과 Gross-up 계산(소득세법 제14·16·17·56조). 언제: 종합소득세 신고에서 금융소득 종합과세 대상 여부와 배당가산(Gross-up)액을 계산할 때. 입력: 귀속연도(2016~2026) → year, 금융소득 항목 목록 [{kind, amount, ...}] → items. kind 허용값(어휘 기반, 별칭 포함): · 예금이자 / 비영업대금이익 / 소비대차전환이자(거래 대금이 소비대차로 바뀐 뒤의 이자) · 외상매출금지급기일연장이자 — 지급기일 연장 대가(사업소득) · 저축성보험차익 — 만기·해지 보험금 − 납입보험료 · 투자신탁환매이익 / 파생결합사채이익 / 장내파생상품이익(양도소득) · 상장법인현금배당·비상장법인현금배당·인정배당 — Gross-up 대상(paid_date로 지급일 가산율) · 의제배당_잉여금자본전입 — 무상주(재원 source) · 의제배당_감자 — 감자 의제배당(2025.1.1. 이후 취득분 중 법인세 미과세는 corp_tax_paid=false → Gross-up 제외) · 재평가적립금감액배당·자본준비금감액배당 — 제17조제3항제6호·제7호(2025.1.1. 이후 지급분 Gross-up 제외, paid_date) · 고배당기업배당 — 조특법 제104조의27(2026.1.1. 이후 받는 배당, 법률 제21223호 부칙 제23조): separate_election=true면 특례배당소득을 종합과세표준·Gross-up에서 빼고 분리 산출세액(2천만 이하 14%, 3억 이하 280만+20%, 50억 이하 5,880만+25%, 초과 123,380만+30%), false면 일반 상장배당. 2천만원 기준금액 판정 포함 여부는 근거 없음(해석례 없음)이라 두 경우를 함께 보여줌 · 출자공동사업자배당 — 무조건 종합과세, 2천만원 판정 제외, 원천 25% · 외국법인배당·환매조건부매매차익 — 조건부 종합과세 · 법원보증금이자·비실명이자·비실명배당(paid_date로 지급일 세율)·직장공제회초과반환금 — 분리과세, 합계 제외 · 손해배상법정이자(기타소득)·공익신탁이익(비과세)·통합발행채권할인액 — 합계 제외 결과: 판단(항목별 이자/배당/제외·Gross-up 대상 여부)·결과(이자소득금액·배당소득금액·합산액)·계산(중간값). 금융소득 종합과세·배당가산.

Inputs: year (required), items (required).

find_toolA
Read-onlyIdempotent

Tool finder: find the right tool among Korean tax calculators (계산 도구 찾기). 맞는 계산 도구 찾기 — 도구가 많으니, 어떤 도구를 쓸지 모르겠으면 먼저 이걸 부른다. 언제: 계산 문제를 받았는데 맞는 도구 이름이 바로 떠오르지 않을 때, 또는 '이 계산 도구는 없다'고 판단하기 전에 반드시. 입력: 찾는 계산 → query(평소 말, 세목·쟁점·조문 무엇이든), 개수 → n. 결과: 후보 도구 목록(이름·한 줄 설명·언제 쓰는지·일치 이유). 후보가 없으면 계산 도구가 없는 것이니 korean-tax-mcp로 조문을 찾는다. 엑셀·스프레드시트·계산 근거(excel·xlsx·workings)를 찾는 말이면 결과에 '엑셀 문서' 한 줄 — 직접 짠 뒤 verify_workbook으로 대조(법정서식 엑셀은 export_workbook). 메모·의견서·Word(docx) 문서를 찾는 말이면 결과에 '메모 문서' 한 줄 — korean-tax-mcp tax_memo_guide → build_tax_memo(이 서버는 메모를 만들지 않음).

Inputs: n, query, keyword.

foreign_exchange_reportingA
Read-onlyIdempotent

Overseas direct investment foreign exchange reporting, post-reporting and liquidation (해외직접투자 외국환 신고). 해외직접투자 외국환 신고·사후보고·청산 판정. 해외법인 설립·대여·증자·청산 시 외국환거래법 의무와 세무(국조법 §58, 법인세 손금) 연결을 함께 본다.

언제: 해외법인 신설출자·증자·지분양수·금전대여·임원파견·지점설치·지분매각·청산·내용변경 이벤트의 해외직접투자 해당 여부, 신고(사전신고/사후보고) 구분·기한·기관·첨부서류, 사후관리 보고서 일정(외화증권취득·송금·연간사업실적·청산·지분매각 등), 국조법 제58조 해외직접투자명세 제출 기한을 한 번에 판정할 때.

입력: event — 반드시 허용값 중 하나. ownership_ratio_after — 출자 후 소유 비율(소수, 지분 10%↑면 해외직접투자). loan_term_months — 금전대여 기간(개월, 기투자 법인 + 12개월↑면 해외직접투자). amount_usd — 이번 건 금액(USD). cumulative_usd — 누적 투자금액 합계(USD, 기본 amount_usd). main_bank_type — 신고기관(주채권은행/여신최다은행/지정은행, 기본 지정은행). financial_business — 금융·보험업 여부(기본 False, 해당 시 제9-10조 별도 안내). event_date — 이벤트 날짜(YYYY-MM-DD, 필수). fiscal_year_end — 사업연도 종료일(YYYY-MM-DD, 선택 시 event_date 연도 12-31). counterparty_resident — 지분양수·지분매각 상대가 거주자면 사후보고/지분매각보고 3개월 적용. paid_in — 납입·대여 실행 여부(기본 True, False면 외화증권취득보고서 미생성). recovered_usd — 청산 시 회수액(USD, 선택).

날짜별 규정(외국환거래규정 제9-5조·제9-9조, event_date 2016~2026만 지원): 유보금증자 사후보고 — 2019.5.2.까지 최대주주 아닌 경우만(largest_shareholder), 2023.7.3.까지 기한 규정 없음, 2023.7.4.부터 3개월. 거주자로부터 지분양수 — 2023.7.3.까지 사전신고, 2023.7.4.부터 3개월 사후보고. 누적 50만불 이내 — 2023.7.3.까지 1개월 사후보고, 2025.2.9.까지 3개월, 2025.2.10. 삭제. 내용변경 — 2017년까지 변경신고(사전), 2018.1.1.부터 3개월, 2023.7.4.부터 회계기간 종료 후 5월. 지분매각(거주자에게) — 2018.1.1. 즉시, 2021.6.18. 7영업일, 2022.1.3.부터 3개월. 연간사업실적보고서 — 면제 가능·투자현황표 갈음 기준 50만·100만불(2018년까지) → 100만·200만불(2019.1.1.) → 200만·300만불(2022.1.3.) → 300만불 초과만 대상(2025.2.10.).

결과: 해외직접투자_해당(bool), 사유, 신고({구분:'사전신고'|'사후보고'|'해당없음', 기관, 기한, 서류:[...], 비고?}), 사후관리([{보고서, 기한|'즉시'|'대상 아님', 근거}]), 세무({해외직접투자명세_기한, 안내:[...]}). 판단·근거·주의 포함.

Inputs: event (required), paid_in, amount_usd, event_date, +9 more.

foreign_expert_income_reductionA
Read-onlyIdempotent

Foreign engineer/researcher income tax reduction by first-work-start date (외국인기술자 소득세 감면). 외국인기술자가 국내에서 받는 근로소득에 대해 최초 근로일부터 정해진 기간 동안 소득세를 50%(소재·부품·장비 단서는 3년 70% 뒤 2년 50%) 감면하는 금액을 귀속연도별로 계산한다(조세특례제한법 제18조). 언제: 외국인 기술자·연구원의 연말정산이나 종합소득 신고에서 감면 기간과 감면세액을 정할 때, 단일세율 특례와 어느 쪽이 나은지 비교할 때. 입력: 귀속연도(20162026) → year, 국내 최초 근로일 → first_work_date, 총급여(비과세 제외) → gross_pay, 시행령 제16조제1항 해당 호와 요건 충족 → category·category_requirements_met, 소재·부품·장비 → sobujang, 국적·특수관계·단일세율 신청 → korean_national·related_party_employer·flat_rate_elected, 산출세액(선택) → computed_tax 또는 과세표준 → tax_base, 다른 종합소득금액 → other_income_amount, 감면율별 총급여(선택) → eligible_wage_70·eligible_wage_50, 그 밖의 세액공제 → other_credits. 규칙(연말 시행본 문언과 부칙): 최초 근로일 2018.12.31. 이전 — 2년이 되는 날이 속하는 달까지 50%(법률 제16009호 부칙 제40조), 2019.1.1. 이후 — 5년(부칙 제7조), 2023 귀속부터 10년(법률 제19199호, 부칙 제9조: 시행 당시 5년이 지나지 않은 사람에게도 적용). 최초 근로 기한: 2018.12.31.(20162018 시행본), 2021.12.31.(20192021), 2023.12.31.(20222023), 2026.12.31.(2024~2026). 소재·부품·장비 단서는 최초 근로일 2020.1.1.2022.12.31.(법률 제16835호 부칙 제11조). 감면세액 = 산출세액 × 감면대상 근로소득금액 / 종합소득금액 × 감면율(소득세법 제59조의5 준용). 근로소득세액공제는 감면 비율만큼 줄임. 단일세율(제18조의2)을 고르면 감면을 적용하지 않음(같은 조 제3항). 원천징수: 20162019 시행본은 징수할 소득세의 50%, 2020 시행본부터는 징수할 소득세에서 감면세액을 뺀 금액(제18조제3항). 결과: 감면 구간(시작·끝 달·율), 그해 감면율별 달 수와 총급여, 산출세액·감면세액·근로소득세액공제·결정세액, 근거·한계.

Inputs: year (required), category (required), gross_pay (required), first_work_date (required), +11 more.

foreign_subsidiary_dividendA
Read-onlyIdempotent

Foreign subsidiary dividends received: 95% participation exemption vs foreign tax credit (외국자회사 수입배당금). 외국자회사 수입배당금: 익금불산입(법인세법 제18조의4, 2023.1.1. 시행, 지분 10%·해외자원개발 5% 이상 외국자회사 배당의 95% 익금불산입 — 2026.1.1.2026.12.31. 수령분은 조세특례제한법 제23조의2로 100%) vs 외국납부세액공제(제57조) 판정·계산. 언제: 외국자회사에서 배당을 받은 내국법인의 익금불산입 적용 여부와 익금불산입 금액·외국납부세액공제를 함께 구할 때. 입력: 배당 받은 날 → received_on, 지분율 → ownership_ratio, 보유 개월 → held_months, 배당 총액(원천징수 전) → dividend, 외국 원천징수세액 → foreign_withholding(선택, 기본 0), 자회사 법인세액·소득금액 → subsidiary_tax·subsidiary_income(간접외국납부세액 계산용, 선택), 혼성금융상품·특정외국법인 저세율·해외자원개발 여부 → hybrid·cfc_low_tax·resource_development, 배당간주금액 없는 특정외국법인(2026 특례) → cfc_no_retained_earnings, 차입금 이자·외국자회사 주식 장부가액 일별 합계·자산총액 일별 합계 → borrowing_interest·subsidiary_book_value_daily_sum·total_assets_daily_sum(2026 특례 차감, 선택). 결과: 제도(익금불산입/외국납부세액공제), 수입배당금액, 익금불산입액, 익금산입액, 직접·간접외국납부세액, 공제대상 외국법인세액, Gross-up 익금산입, 외국세 손금불산입, 판단·근거·서식. 지분율 요건은 배당 받은 날 기준(2023.1.1. 이후 10%, 그 전 25%; 해외자원개발 5%). 간접외국납부세액 = 자회사 법인세액 × 수입배당금액 ÷ (자회사 소득금액 − 법인세액), 원 미만 절사. 익금불산입 대상은 제57조제16항 적용 안 함(제57조제7항).

Inputs: dividend (required), held_months (required), received_on (required), ownership_ratio (required), +10 more.

foreign_subsidiary_liquidationA
Read-onlyIdempotent

Foreign subsidiary liquidation gain or loss: deemed dividend or loss and timing (해외 자회사 청산). 해외 자회사 청산 손익 — 잔여재산 분배액과 주식 취득가액을 비교해 의제배당 또는 청산손실, 손실의 손금 귀속 사업연도(법인세법 제16조제1항제4호). 언제: 해외현지법인을 청산하면서 투자주식에서 생기는 손익과 그 귀속 시기를 정할 때. 입력: 세무상 취득가액 → tax_basis, 잔여재산 분배액 → distribution, 청산·분배 완료일 → completed_on, 사업연도 종료일 → fy_end, 회계 장부가액 → book_value. 계산: 분배액이 취득가액을 넘으면 초과액은 의제배당. 못 미치면 차액은 청산손실 — 청산이 끝나 잔여재산 분배가 완료된 날이 속하는 사업연도의 손금(법인46012-442, 사전-2015-법령해석법인-0057, 사전-2021-법령해석법인-1372). 결과: 구분(의제배당·청산손실·손익 없음), 의제배당, 청산손실, 손금 귀속(사업연도 종료일·기준일), 유보 정리, 판단·근거·주의. 범위 밖: 자회사에 대한 대여금·미수금의 대손과 채권 포기(따로 판정), 의제배당의 익금불산입 요건(foreign_subsidiary_dividend), 외국환 청산보고(foreign_exchange_reporting).

Inputs: tax_basis (required), distribution (required), fy_end, book_value, +1 more.

foreign_tax_creditA
Read-onlyIdempotent

Corporate foreign tax credit: direct, deemed and indirect credit, per-country limit, carryforward (외국납부세액공제). 법인세 외국납부세액공제(직접·간주·간접, 국가별 한도, 한도초과 이월). 언제: 국외원천소득에 외국 법인세를 낸 내국법인의 공제액·Gross-up·이월액을 구할 때. 입력: year — 사업연도(20162026). 이월기간·손금산입방법 허용 여부가 연도별. base — 과세표준(원). base_includes_grossup — base에 Gross-up 포함 여부. method — '세액공제'|'손금산입'(2020년까지). countries — 국가별 foreign_income(Gross-up 전 국외원천소득), direct_tax, deemed_tax, related_costs(대응비용), reduction_excluded, subsidiaries(외국자회사 배당: dividend 원천징수 전, withholding_tax, received_on, ownership 소수, holding_months 배당기준일 현재, resource_dev, sub_income·sub_tax 자회사 소득금액·법인세액, participation_exempt 2023 제18조의4 적용 여부). months — 사업연도 월수. 결과: 간접외국납부세액, Gross-up 익금산입액, 국가별 국외원천소득·공제한도·공제액·한도초과 이월액·이월배제액, 산출세액, 공제액 합계, 이월공제기간, 산식, 근거. 지분율 요건은 배당 받은 날 기준(2022년까지 25%, 2023~ 10%, 해외자원 5%). 손자회사·이월액 공제·이월결손금 안분(영 §94제6항)은 반영 안 함 — 국외원천소득에 미리 반영.

Inputs: base (required), year (required), method (required), countries (required), +2 more.

foreign_worker_flat_taxA
Read-onlyIdempotent

Foreign worker flat-rate income tax option vs progressive tax (외국인근로자 단일세율 과세특례). 외국인 임원·사용인의 근로소득을 단일세율(2016 귀속 17%, 2017 귀속부터 19%)로 과세하는 경우와 일반 누진세율(근로소득공제·세액공제 적용)로 과세하는 경우를 같은 귀속연도로 계산해 어느 쪽이 적은지 보여 준다(조세특례제한법 제18조의2). 언제: 외국인 근로자의 연말정산이나 종합소득 신고에서 단일세율 특례를 신청할지 정할 때, 또는 원천징수를 단일세율로 할지 정할 때. 입력: 귀속연도(20162026) → year, 국내 최초 근로일 → first_work_date, 총급여(비과세 제외) → taxable_pay, 비과세 근로소득 → nontaxable_pay, 그중 사택 제공 이익 → housing_benefit_nontaxable, 누진세율 비교용 과세표준·세액공제(선택) → tax_base·other_credits, 지역본부·특수관계기업·외국인투자기업 예외·일용·국적 → regional_hq·related_party_employer·fie_excepted·daily_worker·korean_national, 재입국일(선택) → reentry_date, 월 지급액(선택) → monthly_pay. 규칙(연말 시행본 문언과 부칙): 단일세율은 비과세·공제·감면·세액공제를 모두 적용하지 않고 종합소득과세표준에 합산하지 않음(제18조의2제3항) — 비과세 급여도 과세대상에 들어감, 2024.1.1. 이후 지급분부터 사택 제공 이익 비과세는 유지(법률 제19936호 부칙 제6조). 적용기간: 최초 근로일부터 5년 이내에 끝나는 과세기간(2022 귀속까지), 20년(2023 귀속부터, 법률 제19199호 부칙 제10조로 시행 당시 20년이 지나지 않은 사람에게도 적용). 최초 근로 시작 기한: 20172018 시행본 2018.12.31., 20192021 2021.12.31., 20222023 2023.12.31., 2024~2026 2026.12.31.(지역본부는 기한 없음). 2016 시행본은 2016년 과세기간까지만. 2014.1.1. 전 근무 시작자: 2018.12.31.까지만 19%(법률 제14390호 부칙 제10조제1항), 2023 귀속부터는 기산일 2014.1.1.(기획재정부 소득세제과-135). 특수관계기업에 근로를 제공하면 제외(외국인투자기업 예외). 단일세율을 고르면 외국인기술자 감면(제18조) 등 감면을 함께 받을 수 없음(같은 조 제3항). 결과: 적용 가능 여부와 사유, 단일세율(과세대상·소득세·지방소득세), 누진세율(wage_income_tax와 같은 계산), 차이와 더 적은 쪽, 월 원천징수 비교, 근거·한계.

Inputs: year (required), taxable_pay (required), first_work_date (required), tax_base, +10 more.

gift_taxA
Read-onlyIdempotent

Gift tax: taxable value, gift deduction, tax base, calculated tax and tax payable (증여세). 거주자 수증자 증여세 과세가액·증여재산공제·과세표준·산출세액·납부할세액. 언제: 증여세 신고·계산 시. 입력: 증여일 → gift_date, 증여재산가액 → gift_value, 증여자 관계 → relation, 10년 내 동일 증여자 증여(합산, 직계존속은 그 배우자 포함) → prior_gifts_same_donor, 부담부증여 인수채무 → assumed_debt, 혼인·출산 공제 → marriage_birth, 합산분 기납부 증여세(그때 산출세액) → prior_gift_tax_paid, 합산분 과세표준 → prior_tax_base_same_donor. 사전 공제 입력(상증법 제47조제2항·제53조) — 같은 증여자 사전증여를 합산하면 증여재산공제는 합산 과세가액에서 한도까지 한 번 다시 계산한다: 합산하는 같은 증여자분에서 받은 공제 → prior_deduction_same_donor(빼지 않음), 합산하지 않는 다른 증여자(같은 공제 구분, 예: 조부모)분에서 받은 공제 → prior_deduction_used(한도에서 뺌). 합산하면서 prior_deduction_used만 주면 어느 쪽인지 몰라 '입력 확인 필요'. 나눠 준 증여가 한 번에 준 같은 합계보다 산출세액이 커지지 않는다. 납부세액공제(제58조): 합산한 사전증여에 대해 낸 증여세(prior_gift_tax_paid)를 공제하되, 한도(제2항) = 산출세액(제56조) × 가산한 증여재산의 과세표준 ÷ 합친 금액의 과세표준. 가산분 과세표준은 prior_tax_base_same_donor, 생략하면 prior_gifts_same_donor − prior_deduction_same_donor. 합산할 사전증여 없이 넣으면 '입력 확인 필요'. 제1항 단서(가산분 증여세가 부과제척기간 만료로 부과되지 않은 경우 공제 없음)는 판단하지 않음 — 그때는 prior_gift_tax_paid=0. 기타친족(제53조제4호): 2025.3.14. 이후 증여는 4촌 이내 혈족·3촌 이내 인척, 그 전 증여는 6촌 이내 혈족·4촌 이내 인척(법률 제20777호 부칙 제4조). 범위 밖이면 공제 0 — kin_type·kin_degree, 평소 말 관계는 촌수 자동. 세대생략 할증(제57조): 미성년자가 20억원 초과로 40%일 때 합산한 사전증여 중 2016.1.1. 전 증여분 → prior_gifts_before_2016·prior_surcharge_before_2016(상증령 부칙 제9조: 그 재산분은 산출세액 × 비율 × 30% − 종전 납부 할증세액). 결과: 과세가액·증여재산공제·과세표준·산출세액·할증세액·기납부세액공제(한도 적용 후)·신고세액공제·납부할세액, 계산의 납부세액공제_한도, 근거.

Inputs: relation (required), gift_date (required), gift_value (required), filed, +20 more.

housing_deemed_rent_incomeA
Read-onlyIdempotent

Housing deemed rent on lease deposits as individual business income (주택 간주임대료). 주택 임대 보증금 간주임대료 — 개인 사업소득 총수입금액 산입액(소득세법 제25조제1항, 시행령 제53조제3항·제4항). 언제: 개인이 주택을 전세·보증금으로 임대할 때 종합소득세(사업소득) 간주임대료를 계산한다. 부가가치세 간주임대료는 vat_deemed_rent, 법인은 corporate_deemed_rent_income. 입력: 귀속연도 → year, 소유 주택 전부(기준시가·면적·보증금·일수) → houses, 임대 금융수익 → financial_income, 추계 여부 → estimated, 정기예금이자율 → rate(생략 시 연도표). 판정(연도별): 3주택 이상 + 보증금 합계 3억 초과(전 기간) / 2026~: 2주택(기준시가 12억 이하 주택은 주택 수 제외) + 보증금 합계 12억 초과. 소형주택(면적·기준시가 기준 이하)은 주택 수에서 뺀다 — 2016 85㎡·3억, 20172018 60㎡·3억, 20192026 40㎡·2억. 산식: (보증금 − 3억, 적수가 큰 주택부터 차감)의 적수 × 60% × 1/365(윤년 366) × 정기예금이자율 − 금융수익(추계면 빼지 않음). 0보다 작으면 0. 결과: 과세 여부·주택 수(제외 사유)·총수입금액 산입액·주택별 적수·근거.

Inputs: year (required), houses (required), rate, estimated, +1 more.

housing_rental_incomeA
Read-onlyIdempotent

Individual housing rental income taxation: exemption and separate taxation (주택임대소득). 개인 주택임대소득 과세 판정 — 1주택 비과세, 총수입금액 2천만원 이하 비과세(2018)·분리과세 선택(2019), 분리과세 세액과 종합과세 참고값(소득세법 제12조2호나목, 제14조제3항제7호, 제64조의2). 언제: 개인이 주택을 월세·전세로 임대할 때 과세 여부와 분리과세(14%) 세액을 구하고, 분리과세와 종합과세 중 무엇을 고를지 비교한다. 간주임대료만 필요하면 housing_deemed_rent_income. 입력: 귀속연도 → year(20162026), 부부 합산 소유 주택 전부(월세·보증금·기준시가·등록임대 여부) → houses, 다른 종합소득금액 → other_income_amount(2019 분리과세 계산 시 필요), 종합과세 비교용 다른 과세표준 → other_taxable_base, 종합과세 시 주택임대 소득금액 → comprehensive_rental_income, 간주임대료 금융수익·추계·이자율 → financial_income·estimated·rate. 판정(연도별): 주택 수 1개(부부 합산·국외 포함)이고 국내·기준시가 기준 이하면 전액 비과세 — 기준 20162022 9억, 2023 12억(2022.12.31. 개정 부칙 제11조). 총수입금액(월세 + 간주임대료, 시행령 제8조의2제6항) 2천만원 이하: 20162018 비과세 / 2019 분리과세 선택 가능. 초과면 종합과세. 분리과세 산식: (총수입금액 − 필요경비 50%, 등록임대 60% − 다른 종합소득금액 2천만원 이하면 200만원, 등록임대 400만원 — 섞이면 수입금액 비율 안분) × 14%. 등록임대: 2019 공공지원·장기일반·단기 / 2020~ 아파트 매입 장기일반·단기는 2020.7.10. 이전 등록 신청분만(대통령령 제31083호, 2020.10.7. 시행). 의무임대기간 4년, 2020.8.18. 이후 등록 신청분 10년. 지원하지 않음(입력 확인 필요로 멈춤): 겸용주택 주택 부분 판정(제8조의2제4항), 공동소유 주택의 주택 수 판정(제8조의2제3항제2호 — 주택수_산입을 직접 입력하면 계산), 국외주택 보증금 간주임대료, 조특법 제96조 소형주택 임대 감면, 2016 전·2027 이후 연도. 결과: 과세 여부·구분(비과세|분리과세 선택 가능|종합과세)·주택 수·총수입금액(월세·간주임대료)·분리과세 세액·종합과세 참고 세액·의무임대기간·근거.

Inputs: year (required), houses (required), rate, estimated, +4 more.

income_adjustment_totalA
Read-onlyIdempotent

Corporate adjusted taxable income from net income plus and minus tax adjustments (차가감소득금액). 차가감소득금액 집계(법인세 과세표준 및 세액조정계산서). 언제: 당기순이익에서 세법상 익금산입·손금산입을 가감해 차가감소득금액과 각 사업연도소득금액을 구할 때. 입력: 당기순이익(원, 손실은 음수) → net_income, 조정 항목 목록 [{항목, 종류, 금액, 조정, 방향, 소득처분}] → items(다른 세무조정 도구의 세무조정 항목을 그대로 넣어도 됨), 기부금 한도초과액(원) → donation_excess, 기부금 한도초과 이월액 손금산입(원) → donation_carryover_deduction. 결과: 차가감소득금액·각사업연도소득금액·익금산입_손금불산입·손금산입_익금불산입·세무조정({구분, 조정(익금산입·손금불산입·손금산입·익금불산입), 금액, 소득처분}), 판단, 근거(법인세법 제18·19·21·23·24·25·28조 등). 소득처분은 유보·△유보·상여·배당·기타소득·기타사외유출·기타와, 국외특수관계인 거래의 정상가격 조정에 쓰는 임시유보·출자의 증가·이전소득 배당(국제조세조정에 관한 법률 시행령 제22조~제25조)만 받음.

Inputs: items (required), net_income (required), donation_excess, donation_carryover_deduction.

income_loss_offsetA
Read-onlyIdempotent

Global income after loss offset and loss carryforward deduction (결손금 공제). 결손금·이월결손금 공제 후 종합소득금액. 언제: 사업소득 결손금이나 이월결손금을 다른 종합소득에서 공제할 때. 입력: 귀속연도 → year, 소득 목록 → incomes(사업소득 제외), 이월결손금 → carryforwards(선택), 추계 여부 → estimated, 금융소득 분리과세분 → financial_flat_rate, 사업소득 상세 → business(선택), 이전 연도 이력 → history(선택, carryforwards와 상호 배제). 결과: 공제 후 소득금액·종합소득금액·이월결손금(다음 연도)·공제 내역·소멸·이력_계산·근거.

Inputs: year (required), incomes (required), history, business, +3 more.

income_taxA
Read-onlyIdempotent

Individual global income tax calculated tax amount by tax year rate table (종합소득세). 종합소득세 산출세액(귀속연도 세율표). 언제: 종합소득 과세표준이 정해지면 그에 대한 산출세액을 구한다(근로·사업·기타·이자·배당 등 종합과세 대상). 입력: 종합소득 과세표준(원) → base, 귀속연도(2016~2026) → year. 결과: 산출세액, 근거(소득세법 제55조). Comprehensive income tax on a tax base (year-specific rate table).

Inputs: base (required), year (required).

individual_donation_expenseA
Read-onlyIdempotent

Donation necessary expenses for sole proprietors: limit, credit and carryforward (개인사업자 기부금 필요경비). 개인사업자 기부금 필요경비 산입 한도(소득세법 제34조). 언제: 사업소득자의 종합소득세 신고에서 정치자금·고향사랑·특례·일반(종교) 기부금을 어디까지 필요경비로 넣고, 얼마가 세액공제·이월로 넘어가는지 계산할 때. 순서(시행령 제81조제4항): 정치자금·고향사랑 10만원 초과분(이월결손금 뺀 소득금액 한도) → 특례(기준소득−이월결손금) → 일반(종교 있으면 10% + min(20%, 종교 외), 없으면 30%). 이월분은 같은 구분에서 먼저 산입(제79조제4항). 현물은 시가(시가<장부가액이면 장부가액)(제81조제3항), 자원봉사용역은 봉사일수(8시간 단위 올림)×8만원(2024.2.28.까지 제공분은 5만원) + 부수 유류비(이동분 제외)·재료비(제81조제5항). 연도: 고향사랑 기부금은 2023년 귀속분부터(그 전 연도에 넣으면 거절). 일반기부금 이월은 2017년 귀속분까지 결과 문구에 5년→10년 전환(2019.1.1. 이후 신고분부터)을 표시. 입력: 기준소득금액 → base_income(이자·배당 제외), 이월결손금 → carried_loss, 기부금 → political·hometown·special·general·religious, 이월 → carried_*, 자원봉사 → volunteer, 현물 → in_kind. 결과: 필요경비 산입 합계·구분별 산입·한도초과 이월·기부금 산입 후 사업소득금액·정치·고향 세액공제 대상(10만원 이하), 판단, 근거. 세액공제(제59조의4) 금액 자체는 계산하지 않음 — 종합소득 기준은 별도.

Inputs: year (required), base_income (required), general, in_kind, +8 more.

individual_foreign_tax_creditA
Read-onlyIdempotent

Individual foreign tax credit for residents under income tax (거주자 외국납부세액공제). 거주자 외국납부세액공제(소득세법 제57조(1항·2항), 시행령 제117조(1항·2항·7항)).

언제: 거주자가 국외원천소득에 대해 외국에 납부한 세액이 있을 때 종합소득 또는 퇴직소득 산출세액에서 국가별 한도 이내로 공제하고, 한도 초과분은 이월 가능 여부와 이월기간을 계산한다. 입력: year — 귀속연도(2016~2026). calculated_tax — 종합소득산출세액 또는 퇴직소득산출세액(원, A). total_income — 종합소득금액 또는 퇴직소득금액(원, C). 0이면 오류. countries — [{country, foreign_income, foreign_tax, treaty_rate?, gross_amount?, russia_override?}]. income_kind — '종합'(기본) | '퇴직'. carryforward — [{country, year, amount}] (종합소득만, 이월된 미공제 외국소득세액). 이월공제기간은 2020년 과세기간까지 5년, 2021년부터 10년(2015년 이전 발생분은 2021년부터 기간 경과). 결과: 외국납부세액공제액·공제한도_합계·이월액·이월기간경과분·국가별 내역·산식. 주의: 외국납부세액공제신청서를 확정신고 때 제출(영 제117조(3항)), 국외원천소득은 대응비용을 뺀 금액(영 제117조(2항)).

Inputs: year (required), countries (required), total_income (required), calculated_tax (required), +2 more.

inheritance_gift_valuationA
Read-onlyIdempotent

Inherited and gifted property valuation: market value, supplementary method, collateral rule (상속·증여재산 평가). 상속·증여재산 평가: 시가 우선 → 보충적 평가(임대 재산은 임대료 등 환산가액과 큰 금액) → 담보권 특례(상증법 제60조·제61조제5항·제66조, 영 제49조·제50조제7항·제63조, 규칙 제15조의2). 언제: 상속·증여재산의 시가를 구할 때. 해당재산 가액이 있으면 시가, 없으면 유사재산, 둘 다 없으면 보충적 평가액(법 제61조). 입력: kind — '상속' 또는 '증여' valuation_date — 상속개시일·증여일 supplementary_value — 보충적 평가액(개별공시지가·기준시가 등) market_values — [{대상, 종류, 가액, 날짜}] 선택 secured_debt — {채권최고액?, 채무액?, 임대보증금?} 또는 목록 선택. 채권마다 min(채권최고액, 채무액), 여러 채권·임대보증금은 합계 lease — {연간임대료 | 월임대료, 임대보증금?} 선택. 시가가 없으면 max(supplementary_value, 연 임대료 ÷ 12% + 임대보증금) 지원하지 않음: 토지·건물 소유자가 다를 때의 환산가액 안분(영 제50조제8항 — 각자 몫을 계산해 넣음), 공동저당 안분(영 제63조제1항제2호). 결과: 평가액, 계산.시가·적용·담보채권액(·임대료_환산가액·보충적_평가액·제61조_평가액), 판단. 주의: 평가기간 밖 가액은 시가에서 제외(상속=전후 6개월, 증여=전 6개월~후 3개월).

Inputs: kind (required), valuation_date (required), supplementary_value (required), lease, +2 more.

inheritance_taxA
Read-onlyIdempotent

Inheritance tax: taxable value, deductions, tax base, calculated tax and tax payable (상속세). 거주자 피상속인 상속세 과세가액·상속공제·과세표준·산출세액·납부할세액. 언제: 상속세 신고·계산 시. 입력: 본래 상속재산가액 → estate_value, 상속개시연도 → year, 간주상속재산 → deemed_estate, 추정상속재산 목록 → presumed_items, 비과세·불산입·공과금·장례비용·봉안비용·채무·사전증여·특별공제 등. spouse.legal_share는 '3/5' 같은 분수 문자열 또는 0.6 같은 0 초과 1 이하 소수. 신고: 법정신고기한 안 신고 → filed=true(신고세액공제). 기한 뒤 신고 → filed=false, late_filed_on=기한후신고일 — 2020.1.1. 이후 기한후신고면 인적공제 합계와 일괄공제 5억원 중 큰 금액(제21조제1항, 법률 제16846호 부칙 제5조 — 상속개시일이 아니라 신고일 기준), 신고세액공제 없음. 무신고(late_filed_on 비움)면 일괄공제 5억원. 결과: 과세가액·상속공제합계·과세표준·산출세액·신고세액공제·납부할세액, 공제 내역, 근거. 상속세 과세가액·공제·세액 계산.

Inputs: year (required), estate_value (required), debts, filed, +28 more.

input_tax_recalculationA
Read-onlyIdempotent

VAT common input tax recalculation for depreciable assets (공통매입세액 재계산). 감가상각자산 공통매입세액 재계산(부가법 제41조, 영 제83조). 언제: 감가상각자산 매입 후 면세비율이 취득 과세기간 대비 5%p 이상 변동하면 확정신고 때 납부·환급세액을 재계산한다. 입력: · 자산 종류 → asset_type, 취득 과세기간 {year, period} → acquired, 과세기간별 면세비율 목록(취득~당기, 마지막이 당기) → ratios. · 기존: 해당 재화 매입세액 총액 → input_tax. · 일괄공급 안분 연결(신규 대안): bundle={total_price, vat_included, appraisal?:{building,land}, standard_value?:{building,land}, book_value?:{building,land}}. bundle이 주어지면 내부에서 bundled_supply_split과 같은 규칙으로 건물 공급가액을 안분해 부가가치세를 input_tax로 쓴다. input_tax와 bundle 둘 다 주면 error. 결과: 이력(기간별 비율·기준비율·변동·재계산 여부·경과과세기간수·세액)·결과(당기_납부세액_가산·매입세액, 건물_매입세액은 건물·구축물일 때만 주는 옛 이름 — 매입세액을 쓸 것)·판단(안분 기준)·근거.

Inputs: ratios (required), acquired (required), asset_type (required), bundle, +1 more.

integrated_employment_creditA
Read-onlyIdempotent

Integrated employment tax credit for headcount increase by tax year (통합고용세액공제). 통합고용세액공제 — 상시근로자가 늘어난 기업의 과세연도별 세액공제 대상액(조세특례제한법 제29조의8). 언제: 직원 수가 늘어난 회사가 그 해와 뒤 1~2년에 걸쳐 공제받을 금액을 구하거나, 창업감면·투자 세액공제와 함께 적용했을 때의 세 부담을 비교할 때. 입력: 과세연도 → year, 기업 규모 → size, 연도별 상시근로자 수 → headcounts, 수도권 밖 여부 → outside_capital_area, 정규직 전환·육아휴직 복귀 인원 → converted·returned_from_leave. 계산: 직전보다 늘어난 인원(전체 증가 인원 한도) × 1인당 금액 — 청년등은 중소기업 수도권 1,450만원·수도권 밖 1,550만원, 중견 800만원, 그 밖 400만원. 청년등 외는 중소기업 850만원·950만원, 중견 450만원, 그 밖 0. 최초 공제 과세연도와 그 뒤 1년(중소·중견기업 2년) 동안 같은 금액을 공제. 뒤 연도에 전체 인원이 최초 공제 과세연도보다 줄면 중단, 청년등만 줄면 청년등 외 금액으로 공제. 인원이 준 해에는 이미 공제받은 세액의 추가 납부액을 시행령 산식으로 계산하고, 실제로 공제받은 세액을 한도로 함. 정규직 전환·육아휴직 복귀는 1명당 1,300만원(중견 900만원), 상시근로자가 줄지 않은 해만. 결과: 기본공제, 정규직 전환·육아휴직 복귀 공제, 공제 대상 세액, 추가 납부세액, 계산(최초 공제 과세연도별 증가 인원·차수·공제액·추가 납부), 판단·근거·주의. 2026 과세연도: 2025 과세연도보다 늘어난 인원 × 금액(청년등 중소기업 700만원·수도권 밖 1,000만원, 중견 500만원, 그 밖 300만원. 청년등 외 중소기업 400만원·수도권 밖 700만원, 중견 300만원) — 2025.12.23. 개정 제29조의8제1항. 중소기업이 아니면 최소고용증가인원수(중견 5명, 그 밖 10명)를 넘게 늘어야 하고 그 인원에 대한 금액을 뺌. 개정 계산식에는 추가 납부가 없음. 2024·2025 과세연도 증가분의 2차·3차 공제와 추가 납부는 종전 규정으로 계산(법률 제21223호 부칙 제34조). 육아휴직 복귀 공제는 2026년에도 적용, 정규직 전환은 2024년 전환분까지. 범위 밖: 2022년 이전 증가분(고용증대 세액공제), 2027 과세연도 이후, 최저한세·이월(minimum_tax_adjustment), 농어촌특별세(rural_special_tax), 합병·분할 승계 인원 조정. 한계: 2025 과세연도 인원을 세는 방법은 국세청 2026.3.25. 공지(첨부 파일은 받지 못함)와 조문 MCP employment_credit_requirements_guide로 확인 — 이 도구는 넣은 인원으로만 계산.

Inputs: size (required), year (required), headcounts (required), converted, +4 more.

integrated_investment_creditA
Read-onlyIdempotent

Integrated investment tax credit for business asset investment, basic and additional (통합투자세액공제). 통합투자세액공제 — 사업용 자산 투자금액에 대한 기본공제와 추가공제(조세특례제한법 제24조). 언제: 기계장치 등 설비에 투자한 회사가 그 해 공제받을 금액을 구하거나, 창업감면·특별세액감면과 어느 쪽이 유리한지 비교할 때. 입력: 과세연도 → year, 기업 규모 → size, 자산 구분별 투자금액 → investments, 직전 3년 투자 합계 → prior3_total, 수도권과밀억제권역·증설 여부 → in_overconcentration_zone·expansion. 계산: 기본공제 = 투자금액 × 공제율(연도·규모·자산 구분별 — 중소기업 일반 자산은 본칙 10%, 2023~2025 임시 공제 12%). 추가공제 = 직전 3년 연평균 투자금액을 넘는 금액 × 3%(국가전략 4%, 임시·2025년부터 10%), 기본공제의 2배 한도. 2024·2025 과세연도는 본칙과 임시 공제 중 큰 쪽, 2023 과세연도는 임시 공제. 수도권과밀억제권역 안 증설투자는 배제. 2020 과세연도는 2021.1.1. 이후 신고분이라 2021 율표(국가전략 구분 없음) — 종전 투자세액공제와 하나만 선택(법률 제17759호 부칙 제4조제1항·제36조, 종전 공제는 계산 안 함). '졸업 뒤 3년' 율은 2025.1.1. 이후 개시 과세연도에 처음 졸업한 경우만(graduated_year, 법률 제20617호 부칙 제5조제2항) — 그 전 졸업이면 중견기업 율, 미입력이면 졸업 뒤 3년 율로 계산하고 판단에 표시. 졸업 기업의 임시 공제(2025 과세연도)는 제3호에 중소·중견·그 밖 율만 있어 graduate_status(중견기업·일반)의 율로 본칙과 비교. 결과: 기본공제, 추가공제, 공제 대상 세액, 적용(본칙·임시·배제), 계산(구분별 공제율·3년 연평균·초과 투자액·본칙과 임시 비교), 판단·근거·주의. 범위 밖: 공제 대상 자산 판정, 종전 자산별 투자세액공제(2020 과세연도 선택분 포함), 다른 목적 전용 시 납부세액, 최저한세·이월(minimum_tax_adjustment), 농어촌특별세(rural_special_tax).

Inputs: size (required), year (required), investments (required), months, +6 more.

international_transaction_statementA
Read-onlyIdempotent

Transfer pricing statement of international transactions with foreign related parties and filing duty (국제거래명세서). 국제거래명세서 칸 집계와 제출 의무 — 국외특수관계인별 거래를 국조칙 별지 제16호서식(갑) 칸 번호대로 모아 매출·매입 계, 대여금·차입금 적수(금액×일수 합계), 평균 대여금·차입금(적수 ÷ 사업연도 일수)을 내고, 국제거래명세서·요약손익계산서·정상가격 산출방법 신고서 제출 의무(국조법 제16조제2항, 시행령 제36조 — corporate_filing_obligations와 같은 연도표)와 제출기한, 함께 낼 서식(별지 제16호서식(을)·제17호·제18호·제19호·제20호)을 판정. 언제: 국외특수관계인(해외 자회사·모회사 등)과 거래가 있는 법인이 국제거래명세서를 작성하거나 제출 대상인지, 어떤 서식을 함께 내야 하는지 확인할 때. 엑셀: export_workbook(layout='forms')에 넣으면 별지 제16호서식(갑)과 정상가격 산출방법 신고서(별지 제20호) 시트를 채움. 20162020 사업연도는 그 해 서식 판 — 구 별지 제8호서식(갑)(2016·2017·2018판)·별지 제16호서식(갑) 2021판을 국외특수관계인별 한 장씩(5명까지), 정상가격 산출방법 신고서는 구 별지 제1호의3서식(2015·2020판)·별지 제20호서식 2021판. 그 해 서식에 없는 칸에 금액이 있거나 2022.3.18. 이후에 내는 분이면 구 서식 시트 대신 목록에 사유. 입력: 사업연도 → year(·fy_start·fy_end), 국외특수관계인별 매출·매입 거래 → parties[].sales·purchases(재화는 inventory·other_tangible, 무형자산은 royalty·intangible_sale, 용역은 guarantee·other_services·tangible_rental, 금전대차는 loans 건별 금액·일수와 interest, 가상자산·기타는 virtual_assets·other), 정상가격 산출방법 → parties[].transfer_pricing, 매출액 → revenue, 국외특수관계 없는 자와의 국제거래 금액 → third_party(선택). 계산(서식 작성방법 5·9·10): 매출 계 = 재고자산가상자산 외 칸 합계(대여금 적수 칸 제외, 평균 대여금·수입이자 포함), 매입 계도 같은 방식. 적수 = 합계(금액 × 일수) — 서식 예시 100원×60일 + 200원×180일 = 42,000원. 평균 = 적수 ÷ 사업연도 일수(365·366), 원 미만 절사 — 서식 예시 42,000 ÷ 365 = 115원. 판정: 2023.1.1. 이후 개시 사업연도는 재화 5억·용역 1억·무형자산 1억 모두 이하면 국제거래명세서 면제, 2022년까지는 국외특수관계인과 거래가 있으면 제출. 기한은 사업연도 종료일이 속하는 달의 말일부터 6개월(2020 사업연도분부터). 면제 금액은 매출·매입 합계로 재화(재고자산·기타 유형자산), 용역(지급보증·기타 용역·유형자산 사용료), 무형자산(사용료·매매 등)만 셈. 정상가격 산출방법 신고서 면제 가목(국제거래 전체 재화 50억·용역 10억, 2023년부터 무형자산 10억)에는 third_party 금액을 더함(사전-2022-법규국조-0527) — 넣지 않으면 국외특수관계인 거래만으로 판정. 결과: 매출·매입 계·적수·평균·이자 합계, 거래 유형별 합계와 국외특수관계인별 최대, 서식별 제출 여부·제출기한, 함께_낼_서식, 계산(국외특수관계인별 칸 값), 서식_표·계산식_입력(엑셀 서식 틀용), 판단·근거·주의·한계. 범위 밖: 정상가격 자체의 산출(arm_length_range·tp_comparable_screen), 주식 등 취득·양도와 가상자산 거래 명세(서식 제2쪽), 지급보증 정상가격(별지 제16호서식(을) 칸 계산).

Inputs: year (required), parties (required), filer, fy_end, +3 more.

inventory_valuation_adjustmentA
Read-onlyIdempotent

Corporate tax inventory valuation adjustment: tax valuation method and difference (재고자산 평가). 재고자산 평가 세무조정(세법상 평가방법 결정·평가차 유보). 언제: 법인세 세무조정에서 재고자산 기말평가액과 장부가액 차이를 유보로 조정할 때.

입력: year — 사업연도 개시 연도(2016~2026) fy_start/fy_end — 사업연도 개시일·종료일(YYYY-MM-DD). 생략 시 year-01-01/year-12-31 new_corp — 설립(수익사업 개시) 첫 사업연도인지 (최초 신고기한: 종료일 달 말일 + 3개월) items — [{category: '제품·상품'|'반제품·재공품'|'원재료'|'저장품'|'매매목적부동산', name?(표시용), reported_method: 원가법 6종|'무신고', reported_lcm?(저가법 신고 여부), used_method: 원가법 6종, used_lcm?(저가법 평가 여부), change_report?: {method, lcm?, filed_on: YYYY-MM-DD}, book_value: int≥0, valuations: {개별법·선입선출법·...·시가: int≥0}, prior_adjustment?: int(전기 유보 잔액)}]

결과: 세무조정사항 목록, 구분별 판정·세법 방법·평가액·조정액, 익금산입·손금산입 합계, 순조정액, 계산(기한 등), 근거. 근거: 법인세법 제42조제1항제2호·제2항, 시행령 제73조1호·제74조제1항~제6항.

Inputs: year (required), items (required), fy_end, fy_start, +1 more.

invoice_penaltyA
Read-onlyIdempotent

VAT tax invoice penalty tax for fictitious, missing or late invoices and e-invoice transmission (세금계산서 가산세). 세금계산서 가산세(가공 2%·3%·4%는 발급·수취일 기준, 미발급 2%, 지연발급 1% 등은 공급일 기준 세율)와 합계표 가산세·전자세금계산서 전송 면제. 언제: 세금계산서 발급·수취 의무를 위반했을 때 가산세 금액을 구한다. 입력: 공급가액(원) → supply_amount, 가산세 유형 → kind, 공급일(YYYY-MM-DD, 세율 기준) → supplied_on, 가공 세금계산서등 발급·수취일 → issued_on(kind='가공'은 issued_on 또는 supplied_on 필수), 전자세금계산서 전송 여부 → e_invoice_transmitted. 결과: 가산세·적용 세율, 근거(부가가치세법 제60조제2항·제5항·제6항·제7항, 가공은 제60조제3항제1호·제2호와 법률 제21218호 부칙 제3조 — 2026.1.1. 전 발급·수취분은 종전 3%). 매출처별합계표 미제출·예정분확정제출은 e_invoice_transmitted로 면제 여부 확인. True → 가산세 0(제54조제2항), None → 주의 메시지, False → 기존 금액.

Inputs: kind (required), supply_amount (required), issued_on, supplied_on, +1 more.

invoice_penalty_bundleA
Read-onlyIdempotent

VAT tax invoice penalty tax bundle with overlap exclusion for one supply (세금계산서 가산세). 세금계산서 가산세 묶음 계산(부가가치세법 제60조2항 후문·9항 중복 배제 적용). 언제: 하나의 거래(공급건)에 여러 가산세 사유가 함께 있을 때 중복을 배제하고 합계를 구한다. 입력: items=[{deal(거래 이름), kind(invoice_penalty의 kind와 같은 값), supply_amount(공급가액, 원), supplied_on?(공급일 YYYY-MM-DD, 선택), issued_on?(가공 세금계산서등 발급·수취일)}]. kind='가공'은 세율이 발급·수취일로 갈려(2%·3%·4%, 법률 제21218호 부칙 제3조) issued_on 또는 supplied_on이 없으면 계산하지 않음. kind: 지연발급·미발급·미발급_종이·지연전송·미전송·지연수취·매출처별합계표_미제출·매출처별합계표_예정분확정제출·신용카드매입공제·가공. 같은 deal 안에서: · 지연발급(제60조2항1호)·미발급·미발급_종이(2호)가 있으면 그 deal의 지연전송·미전송(3·4호)은 0 · 미발급·미발급_종이(2호)·가공(3호)이 있으면 그 deal의 매출처별합계표_*(6호)·지연수취·신용카드매입공제(7·5호)는 0 (단 5호 신용카드매입공제는 9항에 없으므로 그대로) · 지연발급(1호)·지연전송·미전송(3·4호)이 있으면 그 deal의 매출처별합계표_*(6호)는 0(9항2호) 결과: 가산세_합계, 계산.항목별: [{deal, kind, 가산세, 배제사유?}], 근거(부가가치세법 제60조2항 후문·9항).

Inputs: items (required).

kinship_checkA
Read-onlyIdempotent

Kinship degree check between two individuals and family scope for tax purposes (친족관계). 두 개인의 친족관계(혈족·인척 촌수, 배우자)와 기준일 친족 범위 해당 여부. 언제: 두 사람이 친족인지, 국세기본법·상증법상 친족 범위에 들어가는지 확인할 때. 입력: 당사자 a(이름) → a, 당사자 b(이름) → b, 기준일(YYYY-MM-DD) → on, family=[[a, b, "부모자녀"|"배우자"]] → family(related_judge와 동일 형식). 결과: 관계(촌수·배우자)·기준일·친족 범위·국기법 친족 여부·상증법 친족(사돈 포함) 여부. 두 개인의 친족관계(혈족·인척 촌수, 배우자)와 기준일 친족 범위 해당 여부를 확인한다.

Inputs: a (required), b (required), on (required), family (required).

kr_comparable_candidatesA
Read-onlyIdempotent

Korean comparable company candidates from DART filings: financials, revenue mix and profile (국내 비교기업 후보·프로필). 국내 비교기업 후보 만들기 — 금융감독원 전자공시(OpenDART)에서 업종 코드(KSIC 앞자리)로 상장·비상장 외감법인 후보를 모아 연도별 재무(매출·매출원가·판관비·영업이익·자산총계·재고·매출채권·매입채무)와 후보 프로필(매출 구성 6갈래·재고/매출·원재료 재고·유형/무형자산 비중·연구개발·광고·매출채권·운전자본·특수관계 매출·최대주주 지분)을 근거(접수번호·계정)와 함께 낸다. 언제: 이전가격 거래순이익률방법의 비교대상 후보를 국내 공시로 직접 찾고, 후보마다 기능·자산·위험 숫자를 붙여 분석대상과 비교하려 할 때. 입력: 업종 코드 앞자리 → industry_codes, 분석 연도 → years, 상장 구분 → listed, 매출 범위(마지막 연도, 원) → revenue_min·revenue_max, 후보 수 → limit(상한 100), 재무제표 기준 → fs_pref(별도 우선), 비상장 탐색 기간 → unlisted_window, 이번 실행 호출 상한 → max_calls, 색인만 쌓기 → build_index_only, 짧은 업종 코드 후보 거르기 → short_code_keywords(등록 코드가 입력보다 짧은 후보만 사업 설명 낱말로 거름, 예 ['화장품']). 결과: 후보_행(tp_comparable_screen 입력 열 그대로 + 접수번호·연결/별도·바꾼 칸), 후보_프로필(값마다 상태: 확보 / 불명-없음(계정 없음 → 0) / 불명-못찾음), 매출_분류_방법(원문 매출유형·Solar·규칙 — 규칙이면 정확도_낮음), 업종_짧은코드_포함(등록 코드가 입력보다 짧아 들어온 회사 — 세분류 확인), 호출 수, 멈춤 사유와 남은_회사_수(같은 입력으로 다시 부르면 이어서 계속). 처리: 재무는 상장 = 단일회사 재무 API(별도 우선, 없으면 연결), 비상장 = 감사보고서 원문 표(그 해 보고서, 없으면 다음 해 보고서의 전기 열). 매출 구성 금액은 원문 표 숫자만 쓰고, 원문 매출유형 칸(제품·상품·용역)이 있으면 그것을 먼저 쓰고, 없으면 Solar(UPSTAGE_API_KEY 있을 때, 행 이름 + 사업보고서 '사업의 개요' 최대 4,000자) 또는 이름 규칙으로 재화·용역·SW·플랫폼·기타까지만 나누고, 재화의 제품/상품 배분은 원문 매출원가(상품:제품, 없으면 재고 구성) 비율로 함 — 회계 신호가 없거나 분류와 회계가 엇갈리면 불명(사람 확인). 매출 구성 합계가 매출의 80~120%일 때만 비중을 확보로 둠. 키: 환경변수 DART_API_KEY(본인 발급, 무료 — opendart.fss.or.kr, 약관상 본인만 사용). 없으면 이 도구만 꺼지고 발급 안내를 돌려줌. 안전: 순차 호출·0.35초 간격·하루 상한(KR_COMPARABLES_DAILY_CAP, 기본 2,000)·실행 상한(max_calls)·한도 초과(020)·연속 오류 시 멈춤, 결과·오류에 키를 남기지 않음, 캐시(KR_COMPARABLES_CACHE_DIR, 기본 ~/.cache/korean-tax-calc-mcp/opendart)로 같은 요청은 다시 부르지 않음 — 처음 실행은 회사 수만큼 호출이 들고, 상한에 닿으면 다시 실행해 이어감. 색인: 기업개황(업종코드·결산월·법인구분)을 캐시 폴더의 회사 색인 파일에 쌓고, 다음 실행부터는 색인으로 업종을 먼저 걸러 업종이 맞는 회사만 재무를 부름. 비상장 모집단은 공시 목록을 하루씩 쪼개 모든 쪽을 받음(50쪽 상한에 걸려 빠지는 회사 없음). 결과의 색인(모집단_색인 n/N)이 완료가 아니면 같은 입력으로 다시 부르면 이어감. 한계(범위 밖): 비교대상이 적절한지 판단(프로필 비교·사람 검토 몫), 비상장 최대주주 지분(API 없음 → 불명), 12월 결산 외 회사·영업부문별 재무, 비상장 탐색은 기간 안 감사보고서를 낸 회사만.

Inputs: years (required), industry_codes (required), limit, listed, +7 more.

kr_comparable_profile_compareA
Read-onlyIdempotent

Korean comparable profile comparison against the tested party: functions, assets and risks item by item (국내 비교기업 프로필 비교). 국내 비교기업 프로필 비교 — 분석대상 당사자의 숫자 프로필(매출 구성·재고·유형자산·연구개발·광고)과 후보 프로필을 항목별로 나란히 놓고 가까움/다름/불명을 판정해 포함 후보·사람 확인·제외 후보로 나누고, 사람 확인 목록(사유·근거 접수번호·매출 행)과 tp_comparable_screen의 manual_decisions 초안을 낸다. 언제: kr_comparable_candidates로 만든 국내 후보를 분석대상과 기능·자산·위험 면에서 비교해 거르기 전에, 숫자로 갈리는 후보와 사람이 볼 후보를 나눌 때. 입력: 분석대상 프로필(비율) → tested {main_category: product|merchandise|service|sw_license|platform_fee|other, main_share, inventory_basis: ratio|raw_material, inv_to_sales, raw_material_inv, ppe_ratio, rnd_ratio, advert_ratio}, 후보 → candidates(kr_comparable_candidates 결과 그대로 또는 후보_프로필 목록), 기준 바꾸기 → rules(일부 키만). 기준값: 이 도구에는 관행 기준값이 없음 — rules로 받은 값만 씀(값·출처는 조문 MCP transfer_pricing_guide '비교대상 선정 기준'에서 받아 그대로 넣음). rules가 없으면 법정 기준만: 최대주주 50% 이상 → 제외 후보(I1, 국조법 시행령 제2조제2항 준용), 특수관계 매출 또는 매입 50% 이상 → 사람 확인(C2, 실질 지배 거래 의존), 결과 첫 줄 '안내'에 "관행 기준 미적용". 숫자(비중 차이·배수·차이)는 늘 냄. rules 키(단위, 없으면 그 기준 끔): mix_max_diff(비중 차이, 소수 예 0.2), coverage_min·coverage_max(커버리지 배, 예 0.8·1.2), ratio_low·ratio_high(재고/매출·유형자산/자산·연구개발/매출 배수, 예 0.5·2), ppe_abs_tol·rnd_abs_tol(비율 차이, 예 0.05·0.01), advert_mult·sga_mult(배수 x → 1/x~x, 예 3·2), advert_abs_tol·sga_abs_tol(비율 차이, 예 0.03·0.05), related_review(특수관계 매출·매입 비중, 예 0.2), loss_review_years(분석 연도 중 손실 연도 수, 예 2), unknown_review_count(불명 항목 수, 예 3), mix_unverified_review(분류로 정한 매출 행 비중, 예 0.1). 예는 형식 예시일 뿐 기준이 아님. 종합(준 기준만): 제외 후보 = M1 매출 구성 다름·K3 재고·유형자산 둘 다 다름·K4 원재료 재고 유무까지 다름·I1 / 사람 확인 = M0 매출 구성 불명·K1·K2·K5 하나만 다름·A1 광고판촉·A2 판관비율(분석대상 sga_ratio를 줄 때)·P1 품목 키워드(product_keywords) 겹침 없음·I2 특수관계 매출·매입·C2·I3 비상장 최대주주·지배기업 지분 50% 이상(지분만으로 제외 안 함)·L2 지속 손실·R1 매출 행 분류·U1 불명 다수 / 나머지 → 포함 후보. 표시만 = C1 실질 지배 신호 문장(임원 겸직·지배기업·유의적 영향력·자금 대여·보증·기업집단·사용료 — 참고), W3 연구개발, L1 손실 연도. I2·I3·C1·C2는 법정 특수관계 판정이 아님 — 판단은 조문 MCP. 결과(후보별 숫자·차이·근거 문장·접수번호)를 그대로 조문 MCP 판단 도구에 넘김. 결과: 비교표(사유 코드·표시), 종합 수, 사람_확인_목록(근거·품목 대조 원문·실질 지배 근거 문장), manual_decisions_초안(제외 후보의 reject 초안 — 사람이 사유 확인 후 reviewer를 채워 확정), 포함_후보_id, 사용_기준(값마다 법정·법정 준용·관행·우리 규칙 구분, 입력 여부). 범위 밖: 거래 단계·시장·계약 조건처럼 숫자로 안 잡히는 비교가능성, 비교대상이 적절하다는 결론. 대분류 꼬리표는 설명용.

Inputs: tested (required), candidates (required), rules.

ksic_lookupA
Read-onlyIdempotent

Korean Standard Industrial Classification (KSIC) code lookup by name or code (한국표준산업분류 코드 찾기). 한국표준산업분류(11차, 통계청 고시 제2024-203호) 코드 찾기 — 업종 이름으로 코드를, 코드로 이름·상위 단계·하위 세세분류를 찾고, 10차 코드는 11차로 연계한다. 언제: kr_comparable_candidates에 넣을 업종 코드를 정하기 전(기억으로 넣지 말고 여기서 확인 — 예: 화장품 도매는 46443, 46444는 비누·세정제 도매), 후보의 등록 코드가 짧을 때(예: '204') 그 아래 세세분류가 무엇인지 볼 때, 옛 보고서의 10차 코드를 11차로 바꿀 때. 입력: query → 업종 이름 낱말(띄어쓰기로 여러 낱말, 모두 들어간 항목) 또는 코드(대분류 문자 AU, 숫자 25자리), level → 이름 검색을 한 단계로 좁힘(선택). 결과: 이름 검색 → 맞는 항목(세세분류부터), 코드 → 이름·단계·상위·하위 세세분류(10차 코드면 11차 코드). OpenDART 기업개황 업종 코드는 11차. 근거·범위: 분류표·구·신 연계표는 고시 해설서 원문에서 뽑아 단계별 항목 수를 고시 표와 대조함. 어느 업종이 비교대상으로 적절한지는 판단하지 않음.

Inputs: query (required), level.

late_payment_penaltyA
Read-onlyIdempotent

Late payment penalty tax: unpaid tax x days x daily rate, split at rate changes (납부지연가산세). 납부지연가산세(미납 세액 × 일수 × 이율, 이율 변경일 기준 기간 안분). 언제: 세금을 법정납부기한보다 늦게 납부했을 때 일수분 가산세를 계산한다. 입력: 미납 세액(원) → unpaid_tax, 법정납부기한(YYYY-MM-DD) → due, 납부일·고지일(YYYY-MM-DD) → until, 납부고지 여부 → notice, 납세의무 성립일 → accrued_on. 일수(납세의무 성립일 기준): 2020.1.1. 전 성립분은 납부일·납세고지일까지(구 제47조의4제1항제1호, 법률 제16097호 부칙 제11조). 2020.1.1. 이후 성립분은 납부일까지, 납부고지가 있으면 납세고지일부터 고지서 납부기한까지 빼므로 고지일 전날까지(notice=true). until이 2026.7.1. 이후면 납부고지일(고지 전 납부는 납부일)의 전날까지(법률 제21212호). 결과: 가산세 총액·일수, 판단(일수 끝점과 근거), 근거(국세기본법 제47조의4, 시행령 제27조의4). 법정납부기한 2016.1.1. 이후만 지원. 납부고지서에 따른 납부기한 뒤의 가산세(3%·일수분·월 이율)는 계산하지 않음. until이 due와 같은 날이면 가산세 0, due가 토·일·공휴일이면 주의(기한 연장은 자동 반영 안 함). Late payment penalty with daily rate split at rate-change dates.

Inputs: due (required), until (required), unpaid_tax (required), notice, +1 more.

liquidation_incomeA
Read-onlyIdempotent

Corporate liquidation income on dissolution (청산소득금액). 청산소득금액(법인세법 제79조). 언제: 법인이 해산·청산할 때 청산소득금액을 계산한다. 입력: 환가 총액(원) 또는 [{항목, 금액}] → assets_realized, 부채 상환액(원) → liabilities_paid, 자본금(원) → capital, 자본잉여금+이익잉여금(원) → surplus, 세무상 유보 잔액(원, △유보는 음수) → yubo, 이월결손금 잔액(원) → carryforward_loss, 2년 이내 자본전입 잉여금(원) → capitalized_surplus_2y, 환급 법인세(원) → refund_tax. 결과: 청산소득금액·계산(잔여재산가액·자기자본총액·결손금_상계·자본금·잉여금)·판단, 근거(법인세법 제79조).

Inputs: capital (required), surplus (required), assets_realized (required), liabilities_paid (required), +4 more.

loss_carryback_refundA
Read-onlyIdempotent

Net operating loss carryback refund of prior-year corporate tax for SMEs (결손금 소급공제). 결손금 소급공제 환급 — 중소기업이 결손이 난 해에 직전 사업연도에 낸 법인세를 돌려받는 금액과 이월할 결손금(법인세법 제72조). 언제: 전년도에 법인세를 냈는데 올해 적자가 난 중소기업이 이월공제 대신 환급을 받을 수 있는지 볼 때. 입력: 결손 사업연도 → year, 결손금 → loss, 직전 과세표준 → prior_base, 직전 공제·감면세액 → prior_credits, 소급공제 신청액 → carryback. 계산: 환급세액 = 직전 산출세액 − (직전 과세표준 − 소급공제 결손금) × 직전 사업연도 세율. 한도 = 직전 산출세액 − 공제·감면세액(시행령 제110조제1항). 한도에 걸리면 한도만큼 환급받는 가장 작은 소급공제액을 함께 표시(나머지는 이월하는 편이 유리). 결과: 환급세액, 소급공제 결손금, 이월할 결손금, 계산(직전 산출세액·소급공제 후 세액·차액·한도), 판단·근거·주의. 범위 밖: 2020·2021년 한시 특례(조세특례제한법 제8조의4), 1년 미만 사업연도, 개인사업자, 환급 후 경정에 따른 추징세액.

Inputs: loss (required), year (required), prior_base (required), carryback, +1 more.

loss_carryforward_ledgerA
Read-onlyIdempotent

Net operating loss carryforward ledger: yearly deduction, balance and expiry (이월결손금). 이월결손금 다기간 추적 — 여러 사업연도의 소득·결손을 넣으면 발생 연도별 결손금 잔액, 연도별 공제액·과세표준, 공제기간이 지나 소멸하는 금액(법인세법 제13조제1항, 시행령 제10조제2항). 언제: 적자와 흑자가 섞인 여러 사업연도에 걸쳐 이월결손금을 어느 해에 얼마 공제하고 얼마가 남는지 볼 때. 입력: 사업연도별 소득 → years, 중소기업 등 여부 → sme, 기초 결손금 → opening_losses. 계산: 먼저 발생한 사업연도의 결손금부터 공제(시행령 제10조제2항). 공제 한도 = 각 사업연도 소득 × 한도율(중소기업 등 100%, 그 외 2017년까지 80%·2018년 70%·2019~2022년 60%·2023년부터 80%). 공제기간: 2019년까지 발생한 결손금은 10년, 2020년부터 발생한 결손금은 15년 안에 개시한 사업연도까지(법률 제17652호 부칙 제4조·제15조). 결과: 공제액 합계·과세표준 합계·소멸 합계·기말 결손금 잔액, 계산(연도별 한도율·공제한도·발생 연도별 공제·과세표준·결손금 잔액·소멸), 판단·근거·주의. 범위 밖: 채무면제이익 충당, 결손금 소급공제, 합병·분할 승계 결손금, 1년 미만 사업연도, 2008년 이전 발생 결손금.

Inputs: years (required), sme, opening_losses.

loss_carryforward_limitA
Read-onlyIdempotent

Net operating loss carryforward deduction limit rate by business year (이월결손금 공제 한도). 이월결손금 공제 한도율(사업연도 개시일 기준). 언제: 이월결손금이 있을 때 해당 사업연도에 얼마까지 공제되는지 한도율을 확인한다. 입력: 사업연도(2016~2026) → year, 중소기업 등 여부 → sme. 결과: 한도율(소수)과 근거(법인세법 제13조제1항 단서). 시행령 제10조제1항 각 호 법인(회생계획·경영정상화계획 이행 등)은 sme=True로 넣으면 100% — 같은 항 제7호(조세특례제한법 제74조에 따라 고유목적사업준비금을 손금산입할 수 있는 비영리내국법인)는 2024.1.1. 이후 개시 사업연도의 신고분부터(대통령령 제34266호 부칙 제2조). Limit on using loss carryforwards in a year; returns the deduction limit ratio by fiscal year start.

Inputs: sme (required), year (required).

minimum_taxA
Read-onlyIdempotent

Minimum tax: tax base before reductions times minimum tax rate, incl. SME grace years (최저한세). 최저한세(감면 전 과세표준 × 최저한세율). 언제: 세액감면·공제를 받은 뒤에도 납부해야 할 최저한세를 확인할 때(중소기업 졸업 유예 연차 포함). 입력: 감면 전 과세표준(원) → base_before_incentives, 사업연도(20162026) → year, 중소기업 여부 → sme, 졸업 후 경과 연차(05) → grace_year. 결과: 최저한세액, 근거(조세특례제한법 제132조제1항). Minimum corporate tax = base before incentives × minimum tax rate. 배제 순서·서식은 minimum_tax_adjustment.

Inputs: year (required), base_before_incentives (required), sme, grace_year.

minimum_tax_adjustmentA
Read-onlyIdempotent

Corporate minimum tax adjustment: credits and reductions excluded and carried forward (최저한세 조정). 법인세 최저한세 조정(조세특례제한법 제132조제1항, 시행령 제126조제5항, 미공제 이월 제144조). 언제: 세액감면·공제 후 세액이 최저한세 미달일 때 배제 내역을 구한다. 입력: year — 사업연도(20162026, 필수). sme — 중소기업 여부(기본 True). grace_year — 중소기업 졸업 후 경과 연차 05(127). sme=True면 0이어야 함(기본 0). months — 사업연도 월수 112(기본 12). net_income — 101 결산서상 당기순이익(음수 가능, 필수). income_add — 102 익금산입(≥0, 필수). income_deduct — 103 손금산입(익금불산입 포함, ≥0, 필수). reserve — 105 최저한세 적용대상 준비금(103에 포함된 금액, 기본 0). special_depreciation — 106 특별상각 및 특례자산 감가상각비(103에 포함, 기본 0). donation_excess — 108 기부금 한도초과액(기본 0). donation_carryover — 109 기부금 한도초과 이월액 손금산입(기본 0). loss_carryforward — 111 이월결손금(기본 0). nontaxable — 112 비과세소득(기본 0). nontaxable_mt — 113 그중 최저한세 적용대상(기본 0). exclusion_mt — 114 최저한세 적용대상 익금불산입·손금불산입(103에 포함, 기본 0). income_deduction — 116 소득공제(기본 0). income_deduction_mt — 117 그중 최저한세 적용대상(기본 0). reductions — 세액감면 [{code, amount}] 목록(기본 []). credits — 세액공제 [{code, current(당기발생, 기본 0), carryforward([{year, amount, period?}], 기본 [])}] 목록(기본 []). 이월공제기간(제144조제1항): 2019 사업연도까지는 발생 다음 사업연도부터 5년(창업 중소기업 제5조 7년·제10조 10년, 제10조제1항제1호 10년 — carryforward의 period에 5·7·10), 2020 사업연도부터 10년. 다만 종전 기간이 2021.1.1. 전에 지난 세액(12월 결산 5년 기준 2014 사업연도 이전 발생분)은 10년으로 늘어나지 않음(법률 제17759호 부칙 제35조·제51조, 서면-2022-법인-1779). 기간이 지난 이월분은 입력 오류로 거절. 10년 기간은 2021.1.1. 이후 과세표준을 신고하는 경우부터(부칙 제35조) — fy_start·fy_end·filing_date를 주면 신고일(없으면 신고기한)로, 없으면 사업연도 2020부터로 봄. exclusion_order — 신고 때 납세의무자가 고른 배제 순서(코드 또는 "105"·"106"·"114"·"113"·"117"). 빈 목록이면 시행령 제126조제5항 순서(기본 []). 결과: 별지 제4호서식 감면후·최저한세·조정감·조정후 란과 별지 제8호서식(갑) 공제감면세액, 배제_내역·이월_미공제·최저한세_적용제외·별지8 등. 감면전_산출세액 — 감면 등을 모두 배제했을 때의 산출세액. 이 값이 최저한세보다 적으면(예: 20232025 사업연도 일반법인 2억원 이하 9% < 최저한세율 10%) 판단 "최저한세가 산출세액보다 큼" — 납부할 세액은 그 산출세액. 배제 순서 근거: exclusion_order가 있으면 납세의무자 선택 순서, 없으면 시행령 제126조제5항(경정 때 순서 — 신고 때는 납세의무자가 고를 수 있음). 소득 항목(105·106·114·113·117) 배제 시 세무조정: 손금불산입(유보)·익금산입 등. 근거: 조세특례제한법 제132조제1항·제144조, 시행령 제126조제5항, 법인세법 시행규칙 별지 제4호·제8호서식(갑). 최저한세 적용제외 공제 가운데 조세특례제한법 제144조제1항에 적힌 공제(연구·인력개발비 16A·10D·16B, 10A·10B·10C)는 차감세액에서 적용제외 감면을 뺀 금액까지만 공제하고 넘는 금액은 이월_미공제로 돌려줌(이월분 먼저, 먼저 발생한 것부터). 한계: 선박표준이익(119), 외국납부세액공제·재해손실세액공제·동업기업 배분액의 한도와 이월, 적용제외 감면이 차감세액을 넘는 경우, 기부금 한도 재계산, 공제감면세액계산서(부표)·추가납부세액(을)은 다루지 않음.

Inputs: year (required), income_add (required), net_income (required), income_deduct (required), +19 more.

missing_receipt_disallowanceA
Read-onlyIdempotent

Missing qualified receipts: non-deductible entertainment expenses without valid evidence (적격증빙 미수취). 적격증빙 미수취 기업업무추진비 손금불산입(건당 3만 원(2020.12.31. 이전 지출분 1만 원), 경조금 20만 원 초과 + 적격증빙 없음). 언제: 접대비 등을 지출했는데 적격증빙을 받지 못한 건이 있으면 손금불산입액을 구한다. 입력: 사업연도(2016~2026, 개시일이 속하는 해) → year, 지출 건 목록 [{amount: 1회 지출액(원), qualified: 적격증빙 여부, congratulatory: 경조금 여부, spent_on?: 지출일}] → items, 사업연도 개시일·종료일 → fy_start·fy_end(선택). 기준일: 기준금액은 지출일로 고름(시행령 제41조제1항, 대통령령 제31443호 부칙 제9조·제19조 — 2021.1.1. 이후 지출분부터 3만 원). spent_on이 없으면 사업연도 표(개시연도)로 고르고, 사업연도가 2021.1.1.을 걸치거나(fy_start·fy_end) 2020 사업연도인데 결론이 갈리는 금액이면 주의를 붙임. 결과: 손금불산입 합계액, 근거(법인세법 제25조제2항, 시행령 제41조제1항). 적격증빙 미수취 기업업무추진비 손금불산입.

Inputs: year (required), items (required), fy_end, fy_start.

nominee_gift_taxA
Read-onlyIdempotent

Gift tax on deemed gift of nominee-held property: tax base, tax and taxpayer (명의신탁재산 증여의제). 명의신탁재산 증여의제 증여세(상속세 및 증여세법 제45조의2) — 증여의제일의 시행본으로 과세표준(명의신탁재산의 금액 − 감정평가수수료, 증여재산공제 없음)·산출세액·신고세액공제·납부할세액, 납세의무자(2019.1.1. 이후 의제분 실제소유자, 명의자 물적납세의무), 신고기한과 부과제척기간 만료일. 언제: 차명주식·차명 등록재산이 증여의제로 과세될 때 세액과 누가 내는지, 언제까지 부과될 수 있는지 계산할 때. 입력: 재산 가액 → asset_value, 유형 → trust_type, 증여의제일 → deemed_gift_date(타인명의), 소유권취득일 → acquisition_date(명의개서해태), 감정평가수수료 → appraisal_fee·share_appraisal_fee, 신고 여부 → filed, 명의자 구분 → nominee_kind. 시점 구분(법률 제16102호 부칙 제3조·제6조): 2019.1.1. 이후 의제분은 실제소유자가 납세의무자(제4조의2제2항)이고 합산배제(제47조제1항). 2018.12.31. 이전 의제분과, 2018.12.31. 이전 취득 후 명의개서 해태로 2019.1.1. 이후 의제되는 분은 종전 규정(명의자 납세의무, 실제소유자 연대, 같은 증여자 10년 내 증여재산 1천만원 이상이면 가산하고 납부세액공제 — prior_gifts_same_donor·prior_gift_tax_paid). 결과: 증여의제일·평가기준일·적용 규정·과세표준·산출세액·신고세액공제·납부할세액·납세의무자·연대·물적납세의무·법정신고기한·부과제척기간(assessment_limitation과 같은 계산). 2016~2026 의제분만. 범위 밖: 증여의제 요건(대상 재산, 조세회피목적, 반복 과세 제한 — 조문 MCP nominee_trust_guide), 세대생략 할증(조심 2014서5656에 따라 계산하지 않음), 가산세. 부동산실명법 과징금은 계산하지 않음(부과기준 안내는 조문 MCP nominee_trust_guide).

Inputs: asset_value (required), filed, trust_type, nominee_kind, +8 more.

nonbusiness_interest_disallowanceA
Read-onlyIdempotent

Non-deductible interest on non-business assets and related party loans (provisional payments) (업무무관 지급이자 손금불산입). 업무무관자산·가지급금 관련 지급이자 손금불산입 — 가지급금 제외 판정·적수·가수금 상계·지급이자 손금불산입 순위까지. 언제: 업무무관자산이나 특수관계인 가지급금이 있을 때 지급이자 중 얼마를 손금불산입하는지, 어떤 대여금이 가지급금에서 빠지는지(시행규칙 제44조 각 호) 판정한다. 입력: 차입금별 [{interest, jeoksu | principal·days | rate, kind?, withholding?}] → loans, 업무무관자산 적수(원·일) → nonbusiness_jeoksu, 가지급금 [{대상 | 상대방, 사유, 금액, 지급일, 회수일? | movements, 기준일?, 관련 정보}] → advances, 법인 이름 → company, 관계 자료(related_judge 형식) → relations, 가수금 [{이름, 금액, 일자, 반환일?, 상계불가?}] → deposits, 사업연도(20162026) → year, 개시일·종료일 → fiscal_start·fiscal_end. 판정: (0)특수관계인 — 가지급금에 상대방을 주면 company↔상대방을 법인세법 특수관계인(법 제2조12호, 영 제2조제8항 — 2019.2.12. 전 영 제87조제1항, 2019.2.12.2023.12.31. 영 제2조제5항) 각 호로 판정해(기준일: 기준일 또는 사업연도 종료일) 대상을 정한다 — 해당 없으면 비특수관계인, 법인이면 특수관계법인, 개인이면 officers·employees·stakes로 임원·직원·주주, 그 밖은 기타특수관계인. 임원·직원의 배우자 등이 지분 없이 상대방이면 relations.livelihood_shared의 생계 사실관계로 제8항제3호(생계를 함께하는 친족)를 판정 — 사실이 모자라 입력 확인 필요가 나오면 비특수관계인으로 넘기지 않고 확인할 항목·필요 자료를 돌려준다. 대상도 주면 대조만 하고 특수관계 여부(또는 규칙 제44조 6·7·7의2호에서 직원 여부)가 다르면 입력 확인 필요. (1)차입금 구분 — 채권자불분명(영 제51조제1항)·비실명(영 제51조제2항)·건설자금(영 제52조)은 영 제55조 순위로 먼저 손금불산입하고, 기업구매자금대출·금융회사 등 제외 차입금(영 제53조제4항)과 함께 업무무관 산식의 지급이자·차입금에서 뺀다. (2)가지급금 — 비특수관계인 대여는 제외, 규칙 제44조 각 호(미지급소득 소득세 대납은 총결정세액×미지급소득÷종합소득금액 한도, 직원 급료 가불은 월정급여 범위, 우리사주는 해당 회사 주식만, 중소기업 직원 주택자금 7의2호는 2020.1.1. 이후 개시 사업연도부터) 제외. (3)적수 — 대여일 산입·회수일 불산입·말일 산입, 동일인 가수금 적수 상계(영 제53조제3항, 약정으로 상계 불가면 안 함 — 규칙 제28조제2항). (4)업무무관 = 지급이자 × min(자산 적수, 차입금 적수) ÷ 차입금 적수(원 미만 절사). 결과: 순위별 손금불산입·소득처분(채권자불분명·비실명 대표자 상여·원천세 기타사외유출, 건설자금 유보, 업무무관 기타사외유출), 가지급금별 제외 판단, 동일인별 적수, 인정이자는 deemed_interest로 이어 계산할 movements 안내. 지원 20162026 사업연도. 지원 안 함: 일반차입금 건설자금이자 자본화 선택(법 제28조제2항), 업무무관자산 취득가액·적수 산정(영 제49조, 직접 적수 입력), 상대방 없이 대상만 준 가지급금의 특수관계 여부(입력 그대로 씀), 비소액주주등의 직원과 생계를 함께하는 친족(영 제2조제8항제3호가목 중 주주의 직원)·대표이사 구분(officers에 대표 표시 없음 — 임원으로 봄), 금융회사 주된 수익사업 판단 — 해당하면 입력 확인 필요 또는 직접 적수 입력. 근거(법인세법 제28조, 시행령 제51조제53조·제55조·제106조, 시행규칙 제28조·제44조).

Inputs: loans (required), year, company, advances, +5 more.

nonprofit_reserve_limitA
Read-onlyIdempotent

Nonprofit corporation reserve for proper purpose business deduction limit (고유목적사업준비금). 비영리내국법인 고유목적사업준비금 손금산입 한도(법인세법 제29조제1항·제5항제4호·제7항, 조세특례제한법 제74조제1항). 언제: 비영리내국법인이 고유목적사업준비금을 손금에 계상할 때 손금산입 한도와 한도초과액을 구한다. 입력: · year — 사업연도(2016 이상). 조세특례제한법 제74조 100% 특례는 2028년 이전 사업연도까지, 그 뒤는 50%로 계산하고 주의에 표시. · interest_income — 이자소득 금액(비영업대금의 이익 제외, 원, ≥0). · dividend_income — 배당소득 금액(상증세 과세가액 산입 주식 배당 제외, 원, ≥0). · welfare_loan_interest — 특별법 비영리법인 복지사업 융자이자(원, ≥0, 기본 0). · other_income — 그 밖의 수익사업 소득(원, 결손이면 음수). · reserve_booked — 계상액(원, ≥0, 필수). · entity — 법인 종류: '일반'(기본, 50%) | '공익법인_장학'(80%) | '조특법74'(2028년까지 100%, 이후 50%). · interest_separate_tax — 제62조 분리과세 선택으로 이자소득을 한도에서 제외 여부(기본 False). 결과: 이자배당등_합계·기타수익사업_소득·적용률·기타분_한도·한도·계상액·손금산입액·한도초과액·판단·근거. 근거: 법인세법 제29조제1항(+ 조특법74면 조세특례제한법 제74조).

Inputs: year (required), entity, other_income, reserve_booked, +4 more.

nonresident_capital_gains_withholdingA
Read-onlyIdempotent

Nonresident/foreign corporation capital gains withholding on Korean real estate and securities (비거주자·외국법인 양도소득 원천징수). 비거주자·외국법인이 국내 부동산등·주식·기타 유가증권을 양도하고 대가를 받을 때 지급자가 원천징수할 소득세·법인세와 지방소득세(10%). 언제: 비거주자·외국법인에게 국내 부동산·주식 양도대금을 지급하면서 원천징수세액을 구할 때, 상장주식 25% 미만·조약 면제·개인 지급자 같은 제외 사유를 함께 볼 때. 입력: 양도자 구분 → seller_type, 자산 구분 → asset_kind, 지급 연도 → year, 지급금액 → gross_price, 확인된 취득가액·양도비용 → acquisition_cost·transfer_expenses, 정상가격 → normal_price, 지급자가 개인 → payer_is_individual, 국내사업장 귀속 → attributable_to_pe, 국내사업장 유무 → has_domestic_pe, 증권시장 양도·최대 지분율 → listed_via_exchange·max_ownership_ratio, 조약 면제 → treaty_exempt·residence_country. 산식: 원천징수세액 = 지급금액 × 10%, 취득가액·양도비용이 확인되면 min(지급금액 × 10%, 양도차익 × 20%) — 소득세법 제156조제1항제5호(부동산등)·제7호(유가증권), 법인세법 제98조제1항제5호·제7호(2018년까지 각 제4호·제5호). 2016~2026 세율 같음. 제외: 국내사업장 귀속소득, 부동산등을 개인이 지급(제156조제1항·제98조제1항 괄호), 증권시장 상장주식 양도로 양도자+특수관계인 지분이 계속 25% 미만(소득세법 시행령 제179조제11항제1호 단서 — 외국법인은 국내사업장이 없을 때만, 법인세법 시행령 제132조제8항제2호 단서), 조약 면제(소득세법 제156조의2·법인세법 제98조의4 신청서 제출 전제). 결과: 원천징수세액·지방소득세·합계·적용 산식, 계산(지급금액 10%·양도차익 20%), 판단, 신고안내(개인 부동산등은 제121조제2항 분류과세로 별도 신고 필요 여부 확인, 외국법인 부동산등은 법인세법 제97조제1항 신고), 근거, 한계. 원 미만은 최종 세액만 버림.

Inputs: year (required), asset_kind (required), gross_price (required), seller_type (required), +10 more.

nonresident_inheritance_giftA
Read-onlyIdempotent

Nonresident inheritance and gift tax (비거주자 상속세·증여세). 비거주자 피상속인의 상속세(국내 재산만 과세, 기초공제 2억원만)와 비거주자 수증자의 증여세(증여재산공제 없음, 증여자 연대납부)를 계산하고 신고기한을 구한다. 언제: 피상속인이 비거주자인 상속, 수증자가 비거주자인 증여의 세액과 신고기한(상속 9개월·증여 3개월)을 구할 때. 거주자는 inheritance_tax·gift_tax. 입력: 상속·증여 구분 → kind, 상속개시일·증여일 → event_date, 국내 상속재산·증여재산가액 → value, 상속은 공과금·담보채무 → public_charges·debts, 국내 사전증여 → prior_gifts_heirs·prior_gifts_others, 외국 주소 → foreign_address, 증여는 관계 → relation, 합산 사전증여 → prior_gifts_same_donor, 인수채무 → assumed_debt, 세대생략 → generation_skip, 기납부 증여세 → prior_gift_tax_paid. 상속(비거주자 피상속인): 과세대상은 국내에 있는 모든 상속재산(상증법 제3조제2호), 사전증여는 국내 재산만 가산(제13조제2항), 차감은 해당 재산 공과금·담보채무·국내사업장 장부 채무만이고 장례비용 없음(제14조제2항), 공제는 기초공제 2억원(제18조)만 — 배우자·그 밖의 인적·일괄·금융재산·재해손실·동거주택·가업·영농상속공제는 '거주자의 사망' 요건(제18조의2·제18조의3·제19조~제23조의2, 2022년까지 제18조제2항). 신고기한은 상속개시일이 속하는 달의 말일부터 6개월, 피상속인이나 상속인이 외국에 주소를 두면 9개월(제67조제1항·제4항). 증여(비거주자 수증자): 과세대상은 국내에 있는 모든 증여재산(제4조의2제1항제2호, 2016년 증여는 거주자로부터 받은 국외 예금·적금 등도 포함), 증여재산공제·혼인출산공제 없음(제53조·제53조의2 '거주자가'), 증여자 연대납부(제4조의2제6항제3호, 2018년까지 제5항제3호), 신고기한 증여일이 속하는 달의 말일부터 3개월(제68조). 결과: 과세가액·공제·과세표준·산출세액·신고세액공제·납부할세액·신고기한, 판단(비거주자 제한·연대납부·과세대상), 근거, 한계.

Inputs: kind (required), value (required), event_date (required), debts, +21 more.

nonresident_withholdingA
Read-onlyIdempotent

Nonresident withholding tax on Korean-source income of nonresidents and foreign corporations, with net-of-tax gross-up; amounts only, so check characterization and treaty eligibility first with korean-tax-mcp royalty_withholding_guide, treaty_withholding_rates and tax_treaty (비거주자 원천징수). 비거주자·외국법인 국내원천소득 원천징수(소득세법 제156조 / 법인세법 제98조). 요건·소득구분·조약 적용 판단은 korean-tax-mcp royalty_withholding_guide(사용료)·treaty_withholding_rates·tax_treaty로 먼저 확인 — 이 도구는 주어진 세율·사실로 금액만 계산. 언제: 비거주자·외국법인에 이자·배당·사용료·인적용역·기타 소득을 지급할 때 원천징수세액을 구할 때, 세금 공제 후 금액을 지급하는 순액 약정의 과세표준을 역산할 때. 입력: 소득 종류(이자·배당·사용료·인적용역·기타) → income_kind, 지급액(원) → amount, 수취인 구분(개인/법인) → recipient_type, 거주지국(ISO 2자 또는 국명) → residence_country, 조세조약 제한세율(소수) → treaty_rate, 채권 이자 여부 → bond_interest, 국외지배주주 가능성 → related_party, 조약 대상조세의 지방소득세 포함 여부 → treaty_includes_local_tax, 인적용역 제공 장소 → service_location, 지급 연도 → year, 순액 약정 여부 → net_of_tax, 지방소득세까지 지급자 부담 → payer_bears_local_tax, 조약 대상조세 조문 번호 → treaty_covered_taxes_article. 순액 약정: net_of_tax=true면 과세표준 = 약정 순액 ÷ (1 − 원천징수세율)(법인세법 기본통칙 98-0…2). 예: 순액 1억 원·15% → 과세표준 117,647,058원. payer_bears_local_tax=true면 세율에 지방소득세분을 더함(15% → 16.5%, 과세표준 119,760,479원 — 유추). 과세표준은 원 미만 버림, 세액은 마지막에만 절사. 쟁점: 첫 줄은 조문 MCP 안내, 이어서 금액을 바꾸는 사실을 한 줄씩(사용료: 국내 미등록 특허, 소득 구분·세율, 조약 적용 절차, 납부·신고 기한, 정상가격, 다른 세목, 순액 약정). treaty_rate가 없으면 국내세율로 계산하고 제한세율 상한은 korean-tax-mcp treaty_withholding_rates로 확인하라고 안내. 연도: 국내세율(20%, 채권이자 14%)은 2016~2026 같음. 근거 호는 2018.12.31. 개정(2019.1.1. 시행)으로 바뀜 — 2018년까지 제1항제3호(이자·배당·사용료·기타)·제2호(인적용역), 2019년부터 제1호·제2호·제6호·제4호·제8호. 결과: 원천징수세액·지방소득세·적용 세율·국내세율, 근거(개인 소득세법 제156조 / 법인 법인세법 제98조). 적용세율 = min(국내세율, 조약 제한세율), 지방소득세는 원천징수세액의 10% 별도. 수취인_송금액 = 수취인 부담이면 지급액 − 합계, 순액 약정이면 약정 순액(지방소득세를 수취인이 부담하면 약정 순액 − 지방소득세). 순액 약정에서 과세표준 − 합계는 끝수(과세표준 원 미만·세액 10원 미만 버림) 때문에 약정 순액과 몇 원 다름 — 그 차이는 끝수_차이·끝수_설명에 따로 내며, 송금액으로 쓰는 값은 수취인_송금액. 인적용역 service_location='국외' → 국내원천소득 아님(소득세법 제119조6호·법인세법 제93조6호), 적용세율 0. 인적용역 service_location='국내' → 현행 20%. None이면 현행(20%+쟁점 표시). service_location은 인적용역 소득에서만 의미, 그 외 소득에는 무시. Non-resident/foreign corporation withholding tax on Korean-source income.

Inputs: amount (required), income_kind (required), recipient_type (required), residence_country (required), +9 more.

official_property_priceA
Read-onlyIdempotent

Real estate officially announced price lookup: land, apartment and house prices (공시가격). 부동산 공시가격 조회 — 주소(또는 PNU)로 개별공시지가(토지, 원/㎡)·공동주택가격(아파트, 세대별)·개별주택가격(단독)을 국토교통부 국가공간정보(브이월드)에서 가져온다. 상속·증여 보충적 평가(상증법 제61조제1항)와 양도세 기준시가(소득세법 제99조제1항제1호)에 쓰는 값. 언제: 비상장주식 평가(unlisted_stock_valuation의 assets 기준시가), 상속·증여재산 평가(inheritance_gift_valuation의 supplementary_value), 양도세 기준시가가 필요할 때. 시가(매매·감정 사례)가 있으면 시가가 우선(법 제60조) — 이 도구는 공시가격만. 입력: 주소 → address(또는 pnu), 종류 → kind, 기준연도 → year, 토지 면적 → area_m2, 아파트 동·호 → dong·ho. 주의: 이 도구는 외부(브이월드)로 주소·PNU·연도를 보냄. 인증키 VWORLD_KEY가 필요(vworld.kr 오픈API 인증키, 국가중점API 포함) — 없으면 안내와 직접 입력 대안을 돌려줌. 결과: 기준연도·공시가격(토지는 ㎡당과 총액), 연도별 목록, 판단(필지 확인·평가 사용법·기준일), 근거.

Inputs: ho, pnu, dong, kind, +3 more.

other_income_aggregateA
Read-onlyIdempotent

Resident other income: taxable classification, necessary expenses, withholding and aggregation (기타소득). 거주자의 기타소득 항목을 원래 사실관계로 받아 (1) 항목별 과세 구분(종합/분리/비과세/제외) (2) 비과세·필요경비 (3) 소득금액·원천징수세액 (4) 종합소득 합산액과 기납부세액까지 계산한다(소득세법 제21조·제12조·제14조제3항·제37조·제84조·제127조·제129조, 시행령 제18조제2항·제21조·제87조). 언제: 종합소득세 신고에서 기타소득의 과세 구분·필요경비·원천징수세액·종합소득 합산액을 계산할 때. 입력: 귀속연도(20162026) → year, 기타소득 항목 목록 [{kind, amount, ...}] → items. kind 허용값(어휘 기반, 별칭 포함): · 산업재산권대여 — 광업권·어업권·산업재산권·산업정보 등을 양도·대여하고 받는 금품 · 공익사업지상권대여 — 공익사업 관련 지역권·지상권 설정·대여 대가(필요경비율은 산업재산권대여와 같음, 공익사업과 무관한 지상권 대여는 사업소득) · 서화골동품양도 — 개당·점당 6천만원 이상 서화·골동품 양도(필요경비: 2020 과세기간부터 1억 이하 90%·초과분 80%, 2019년까지 80%, held_years≥10이면 90% — 2020.2.11. 개정 부칙 제36조, business_setup=true(2021 사업장 갖춤)면 사업소득이라 제외, museum=true 박물관·미술관 양도 비과세, living_domestic_artist=true 생존 국내 작가 작품 과세 제외, 무조건 분리과세 20%) · 일시적인적용역 — 고용관계 없이 일시적으로 제공한 강연·방송 해설·자문 등 인적용역의 대가 (산업재산권대여·공익사업지상권대여·일시적인적용역 필요경비율: 2017 80%, 2018은 receipt_date(받은 날) 필수 — 2018.3.31.까지 80%·2018.4.1.부터 70%, 2019 60%, 시행령 제87조) · 뇌물 — 뇌물로 받은 금품(몰수·추징 확정액은 forfeited로 입력, 기본 0) · 위약금·배상금 — 계약의 위약·해약으로 받는 위약금·배상금(계약금 대체분은 deposit_substituted로 입력, 기본 0, 주택입주 지체상금 제외. 계약금 대체분은 원천징수되지 않아 2019년 이전에는 선택적 분리과세 대상 아님 — 제14조제3항제8호가목 2020.1.1. 개정) · 주택입주지체상금 — 주택 입주 지연으로 받는 지체상금 · 연금외수령 — 연금계좌의 세액공제분·운용수익을 연금 외의 방식으로 수령한 금액(무조건 분리과세) · 직무발명보상금_퇴직후 — 퇴직 후 사용자등으로부터 받는 직무발명보상금(제21조제1항제22호의2, 같은 해 재직 중 받은 비과세액은 employment_exempt_used로 필수 입력, 비과세 연 한도 20172018 300만·20192023 500만·2024~ 700만(시행령 제18조제2항), 2024.1.1. 이후 지급분은 사용자등과 특수관계면 related_party=true — 비과세 없음(제12조5호라목 단서), paid_date(지급일) 선택, 2016은 22호의2가 없어 계산하지 않음, 선택적 분리과세는 2020~) · 배임수재 — 배임수재로 받은 금품(무조건 종합과세, 원천징수 제외, 소득세법 제21조제1항제24호) · 알선수재 — 알선수재로 받은 금품(무조건 종합과세, 원천징수 제외, 소득세법 제21조제1항제24호) · 복권당첨금 — 복권 당첨금(제21조제1항제2호, 제14조제3항제8호라목 무조건 분리과세, 필요경비는 actual_cost(구입비)만, 원천징수 20%·소득금액 3억원 초과분 30%(제129조제1항제6호가목). 과세최저한: year≥2023은 당첨금(분할 지급이면 합계) 건별 200만원 이하(제84조2호), 그 전은 소득금액 건별 5만원 이하) · 승마투표권환급금 — 승마·경륜·경정·소싸움·체육진흥투표권 환급금(제21조제1항제4호, 제14조제3항제8호마목 무조건 분리과세, 원천징수 20%·소득금액 3억원 초과분 30%). unit_bet=적중된 투표권의 단위투표금액(필요경비, 제37조제1항제1호, 기본 0), per_bet_refund=적중한 개별투표당 환급금(기본 amount), ticket_total=건별 권면 표시 금액 합계. 과세최저한(제84조1호): ticket_total≤10만원이고 (개별투표당 환급금≤10만원 또는 (≤unit_bet×100이면서 ≤200만원)) — 가·나목에 해당하면 ticket_total 필수 · 슬롯머신당첨금 — 슬롯머신·투전기 등 당첨금품(제21조제1항제14호, 제14조제3항제8호마목 무조건 분리과세, 원천징수 20%·소득금액 3억원 초과분 30%). stake=당첨 당시 투입한 금액(필요경비, 제37조제1항제2호, 기본 0). 당첨금 건별 200만원 이하 과세최저한(제84조2호) 결과: 판단(항목별 과세 구분·근거)·결과(종합소득 합산액·기납부세액·분리과세·비과세·선택적 분리과세 가능)·계산(항목별 소득금액·원천징수세액).

Inputs: year (required), items (required).

overseas_account_reportingA
Read-onlyIdempotent

Overseas financial account reporting duty and administrative fine (해외금융계좌 신고). 해외금융계좌 신고의무·과태료 판정(국조법 제53조(1항·2항)·제54조·제90조(1항·2항), 시행령 제92조(3항)·제93조(1항)·제94조·제147조(1항·2항·4항)).

언제: 거주자·내국법인이 보유한 해외금융계좌 매월 말일 잔액 합계가 기준금액(2018년 보유분부터 5억 원, 2017년까지 10억 원)을 초과하는지, 신고의무 유무·기한, 미신고·과소신고 과태료, 수정신고 감경, 소명 불이행 과태료를 계산한다. 입력: year — 신고대상 연도(20162026). month_end_totals_krw — 112월 말일 합산 잔액(원) 목록(길이 12). 또는 accounts. accounts — [{name, month_end_krw: 길이 12}] (둘 다 주면 오류, 둘 다 없어도 오류). holder — '거주자'(기본) | '내국법인'. foreigner_resident_years_in_korea_last10 — 외국인 거주자 최근 10년 국내 주소·거소 기간(년). 5 이하면 면제. overseas_korean_days_in_korea — 재외국민 국내 거소 일수. 2024년 보유분까지 183일 이하, 2025년부터 182일 이하면 면제(2018년까지는 2년 전부터의 일수). treaty_resident_of_other_country — 조세조약상 상대국 거주자면 면제. reported_amount_krw — 기한 내 신고한 금액(기본 0 = 미신고). corrected_on — 수정신고일(YYYY-MM-DD). unexplained_amount_krw — 소명 불이행 과태료 계산용 금액(원, 선택). assessed_on — 과태료 부과일(선택). 과태료 기준은 보유연도가 아니라 부과일로 갈린다: 2025.2.28. 이후 부과분은 10%·10억원 한도·소명 불이행 10%, 그 전은 누진표·소명 불이행 20%(2021.2.17. 전 부과분은 구 시행령 제51조 — 20억원 한도 없음). 결과: 신고의무·최고잔액·최고잔액_월·신고기한·위반금액·과태료·과태료_범위·감경비율·감경후_과태료·소명불이행_과태료·면제사유. 판단: 실질적 소유자 안내 — 명의와 무관하게 사실상 관리하는 자가 보유자(영 제94조(1항)), 내국인이 의결권 100% 직·간접 보유한 외국법인 계좌는 비조약국이면 실질적 소유자(영 제94조(2항)), 공동명의자는 각자 전체 잔액 보유로 봄(제53조(2항2호)). 주의: 신고기한은 공휴일 조정 없음(법 제53조(1항)), 기한 후 신고 감경은 영 제147조(4항2호) 표 확인.

Inputs: year (required), holder, accounts, assessed_on, +7 more.

overseas_subsidiary_statementA
Read-onlyIdempotent

Overseas subsidiary statement and financial status report filing duty (해외현지법인 명세서). 해외현지법인 명세서·재무상황표 — 해외직접투자를 한 거주자·내국법인이 내는 해외현지법인 명세서(별지 제47호서식)와 재무상황표(별지 제48호서식)의 제출 대상·기한을 판정하고 재무상황표 금액의 항등식을 확인한다(국제조세조정에 관한 법률 제58조제1항, 시행령 제98조제1항).

언제: 해외 자회사(해외현지법인)가 있는 법인·개인이 해외현지법인 명세서·재무상황표·손실거래명세서를 내야 하는지와 기한을 볼 때, 재무상황표 금액을 서식(export_workbook)으로 옮기며 합계가 맞는지 확인할 때. 입력: 과세기간 개시연도 → year, 제출인 → filer, 종료일 → fy_end, 현지법인 기본사항 → subsidiary, 직접·간접 지분율 → ownership_direct·ownership_indirect, 출자금액·대여금 → equity_investment·loan_investment, 특수관계 → related_party, 손실거래금액 → loss_single_year·loss_cumulative_5y, 재무상황표 코드별 금액 → financials, 가결산 → provisional. 판정: 재무상황표 — 직접 10% 이상이고 투자금액(출자+대여) 1억원 이상(영 제98조제1항제2호가목), 또는 직접·간접 10% 이상이고 특수관계(나목). 손실거래명세서 — 나목 해당자 중 손실거래금액이 법인 단일 50억원·5년 누적 100억원(개인 10억원·20억원) 이상(제3호). 20212026년 시행본 문언 같음. 20162020년 개시분: 종전 제출기한(법인 — 사업연도 종료일이 속하는 달의 말일부터 3개월, 개인 — 다음 연도 5.31.)이 2021.1.1. 전에 지났으면 구 법인세법 제121조의2제1항·구 시행령 제164조의2 (개인은 구 소득세법 제165조의2·구 시행령 제217조의2)와 구 법인세법 시행규칙 별지 제81호·제82호·제82호의2서식(개인은 구 소득세법 시행규칙 별지 제93호~제95호서식)으로 판정하고, 지나지 않았으면 현행 규정(법률 제17651호 부칙 제28조). 결과의 '적용_규정'에 표시. 엑셀 서식 틀: 종전 규정 적용 법인은 구 법인세법 시행규칙 별지 제81호·제82호서식(2014.3.14. 개정본), 2020년까지 개시분 중 현행 규정 적용분은 국조칙 별지 제47호·제48호서식 2021.3.16. 전부개정본(재무상황표는 제출기한이 2022.3.18. 이후면 2022판). 개인의 종전 규정 적용분은 틀 없음. 기한 — 종료일이 속하는 달의 말일부터 6개월(법 제58조제1항, 2021.1.1. 시행 법률 제17651호부터). 확인: 01 = 14 + 21, 56 = 27 − 30, 57 = 56 − 31, 58 = 57 + 38 − 42, 48 = 58 − 47, 82 = 71 + 76 − 77과 하위 과목 합계(08·14·21·23·27·31·38·42·77) — 식의 코드가 모두 있을 때만, 다르면 '확인 필요'. 결과: 명세서_제출대상·재무상황표_제출대상·재무상황표_사유·손실거래명세서_제출대상·제출기한·지분율·투자금액·항등식_확인·항등식_불일치, 판단·주의. 범위 밖: 해외영업소 설치현황표·해외부동산 명세서, 과태료 계산, 구 소득세법 시행규칙 별지 제93호·제94호서식 엑셀 틀.

Inputs: year (required), filer, fy_end, financials, +9 more.

ownership_ratioA
Read-onlyIdempotent

Direct and indirect ownership ratio of a holder in a corporation, incl. circular holdings (간접 보유비율). 보유자→법인 직접·간접 보유비율(경로별 곱 합산, 순환출자 반영). 언제: 일감몰아주기·지배주주 판정에서 특정인이 법인에 얼마나 간접 보유하는지 계산할 때. 입력: 보유자(이름) → holder, 대상 법인(이름) → target, stakes=[[보유자, 법인, 지분율(0~1)]] → stakes(직접보유비율, related_judge와 동일). 결과: 직접비율·경로별 비율·합계·순환출자 여부, 근거(상증법 시행령 제34조의3제2항 — 2020.2.10.까지는 제34조의2제2항). 보유자→법인 직접·간접 보유비율을 계산한다(간접은 단계별 직접보유비율의 곱, 경로별 합산, 순환출자는 단계별 모두 반영).

Inputs: holder (required), stakes (required), target (required).

pension_account_withdrawalA
Read-onlyIdempotent

Pension account withdrawal limit and withdrawal order (연금계좌 연금수령한도). 연금계좌 연금수령한도·인출순서 계산(소득세법 시행령 제40조의2·제40조의3, 2024.1.1. 시행본). 언제: 연금계좌에서 인출할 때 연금수령분(연금소득)과 연금외수령분(기타소득)을 구분한다. 입력: year — 귀속연도(과세기간) birth_date — 출생일 join_date — 연금계좌 가입일 start_request_date — 연금수령 개시 신청일 balance_at_period_start — 과세기간 개시일 현재 평가액(개시 신청 연도는 신청일 현재) withdrawal — 당해 인출액 contributions_total — 납입액 합계 contributions_not_deducted — 세액공제 받지 못한 납입액(과세제외금액) deferred_retirement_income — 이연퇴직소득(있으면 가입 5년 요건 생략) investment_income — 운용수익 결과: 연금수령분·연금외수령분 각 {과세제외금액, 이연퇴직소득, 그밖}, 사적연금_총연금액(종합과세 대상 사적연금), 이연퇴직_연금수령(연금소득·분리과세), 기타소득_연금외수령, 계산.연금수령연차·연금수령한도, 판단. 주의: contributions_not_deducted > contributions_total, 음수, 날짜 형식 오류 → error.

Inputs: year (required), join_date (required), birth_date (required), withdrawal (required), +6 more.

pension_incomeA
Read-onlyIdempotent

Pension income amount and global vs separate taxation (연금소득금액). 연금소득금액 계산. 언제: 연금소득의 종합과세·분리과세 구분과 연금소득금액을 구할 때. 입력: 귀속연도 → year, 공적연금 과세분 → public_pension, 사적연금 → private_pension, 퇴직소득 재원 연금 → retirement_source_pension, 의료목적 인출 → medical_withdrawal, 사적연금 선택 → private_choice, 공적연금 상세 → public_pension_detail(수령액·환산소득·과세제외기여금). 결과: 총연금액·분리과세연금소득·연금소득공제·연금소득금액·안내·근거. 공적연금 과세분은 public_pension_detail로 계산하거나 직접 입력.

Inputs: year (required), private_choice, public_pension, private_pension, +3 more.

personal_deductionA
Read-onlyIdempotent

Personal deduction for global income tax: basic and additional (인적공제). 종합소득 인적공제(기본공제·추가공제). 언제: 종합소득세 신고에서 기본공제·추가공제 금액을 구할 때. 입력: 귀속연도 → year, 납세자 정보 → taxpayer, 부양가족 목록 → persons. 결과: 기본공제·추가공제·인적공제·사람별 내역·근거. 기본공제 1인당 150만원, 추가공제(경로우대 100만·장애인 200만·부녀자 50만·한부모 100만).

Inputs: year (required), persons (required), taxpayer (required).

precheck_schemaA
Read-onlyIdempotent

Tax return precheck input schema: keys, units and required fields (사전검토 입력스키마). 신고서 사전검토 입력스키마. 언제: return_precheck·영어로 된 신고서 PDF 도구 입력 전에 어떤 키를 넣어야 하는지 확인할 때. 입력: tax=법인|부가|소득. 결과: 각 입력키의 의미·단위·필수 여부를 목록으로 반환한다.

Inputs: tax (required).

provision_reserve_ledgerA
Read-onlyIdempotent

Provision tax adjustment ledger for points, mileage and warranty provisions over multiple years (충당부채 세무조정). 충당부채(포인트·마일리지, 판매보증) 세무조정 다기간 추적 — 연도별 적립, 사용, 유효기간 소멸에 따른 손금불산입·손금산입·유보 잔액(법인세법 제40조). 언제: 포인트·마일리지나 판매보증 충당부채를 여러 사업연도에 걸쳐 설정·사용·환입할 때 연도별 세무조정과 유보 잔액을 구할 때. 입력: 연도별 적립액 → grants, 유효기간(년) → valid_years, 경과연수별 실제 사용률 → usage_pattern, 회계 설정 사용률 → expected_usage_rate, 부담률 → cost_ratio, 종류 → kind. 계산(적립 연도별 묶음): 적립한 해에 충당부채 = 적립액 × 설정 사용률 × 부담률 → 손금불산입(유보). 실제 사용한 해에 충당부채와 상계한 금액 → 손금산입(△유보). 설정 잔액을 넘는 사용분은 그해 비용(세무조정 없음). 적립 후 유효기간이 되는 해 말에 남은 충당부채를 환입 → 익금불산입(△유보), 미사용 적립액은 소멸. 근거: 손금으로 인정하는 충당금은 법에 따로 정한 것뿐(제33조제35조)이고 그 밖의 충당부채는 손금이 확정된 사업연도에 손금(제40조제1항). 20162026 같음. 결과: 유보 기말 잔액·합계, 계산(연도별 적립액·설정·사용·환입·소멸·유보 기말·세무조정 순액), 판단·근거·해석·주의. 2027년 이후에 생길 사용·환입·소멸은 예정으로 따로 표시. 범위 밖: 매출을 이연수익(계약부채)으로 잡는 방식(K-IFRS 제1115호 고객충성제도)의 세무조정, 회사 장부의 실제 전입·환입액과의 대사.

Inputs: grants (required), valid_years (required), usage_pattern (required), kind, +3 more.

reduction_income_segmentsA
Read-onlyIdempotent

Separate accounting of income eligible for tax reduction by business segment (구분경리). 구분경리 감면 대상 소득 — 세액감면 대상 사업과 그 밖의 사업을 함께 하는 법인의 사업별 소득금액과 감면 대상 소득, 주된 사업(조세특례제한법 제143조, 법인세법 시행규칙 제75조·제76조). 언제: 온라인 직접 판매와 도매처럼 감면 대상 사업과 대상이 아닌 사업의 매출이 섞여 있어 감면세액 계산에 넣을 소득을 나눠야 할 때, 또는 매출 구성으로 주된 사업을 볼 때. 입력: 사업별 수입금액·개별손금·감면 대상 여부 → segments, 공통익금 → common_income, 공통손금 → common_expenses, 업종이 같은지 → same_industry, 공제한 이월결손금 등 → deductions. 계산: 공통익금은 수입금액에 비례해, 공통손금은 업종이 같으면 수입금액·다르면 개별손금에 비례해 나눔 → 사업별 소득금액. 결손이 난 사업이 있으면 그 결손금 합계를 소득이 난 사업의 소득금액에 비례해 나눠 공제. 공제한 이월결손금 등은 감면 사업 발생분 전액, 불분명한 금액은 소득금액 비례분을 감면 대상 소득에서 뺌. 과세표준을 넘으면 과세표준까지. 결과: 감면 대상 소득, 과세표준, 감면 소득 비율, 각 사업연도 소득, 주된 사업(수입금액이 가장 큰 사업), 계산(사업별 표), 판단·근거·주의. 범위 밖: 업종 분류 판정, 개별손금이 없을 때의 작업시간·사용면적 기준, 감면세액 계산(startup_tax_reduction·sme_special_tax_reduction에 결과를 넣음), 개인사업자.

Inputs: segments (required), deductions, common_income, same_industry, +1 more.

refund_claim_deadlineA
Read-onlyIdempotent

Refund claim deadline: request for rectification, 5-year and 3-month subsequent claims (경정청구). 경정청구 기한(국세기본법 제45조의2) — 통상 5년·후발적 3개월·증액경정분 3개월, 기한 특례(제5조제1항) 반영. 언제: '경정청구 언제까지 할 수 있나', 경정청구기간 계산, 후발적 경정청구 기한. 입력: 청구 종류 → kind, 법정신고기한 → due_date(또는 세목 → tax와 기간 → year·fiscal_year_end·period·tax_base_date), 사유를 안 날·통지받은 날 → event_date, 성실신고확인 → sincere_filing, 상속 외국 주소 → abroad. 계산: 법정신고기한이 토·일·공휴일·대체공휴일·근로자의 날(노동절)이면 다음 날이 기한(제5조제1항) → 그 기한이 지난 후 5년(민법 제157조·제159조·제160조, 국세기본법 제4조: 기한의 5년 뒤 같은 날, 없으면 그 달 말일) → 그 날이 다시 토·일·공휴일이면 다음 날. 후발적은 안 날의 3개월 뒤 같은 날(제2항, 통상 기간과 별개), 증액경정은 통지받은 날의 3개월 뒤 같은 날(법정신고기한 후 5년 한도). 2024.12.31. 개정(2025.1.1. 시행) 전 증액경정분은 90일 — 시행 당시 3개월이 지나지 않았으면 3개월(부칙 제6조제1항). 공휴일표: 2016~2027(법정공휴일·대체공휴일·선거일·임시공휴일, data/kr_holidays.json). 표 밖의 해는 토·일·고정 공휴일만 보고 결과에 '확인하지 못함'으로 표시. 결과: 경정청구_기한·요일, 법정신고기한(법령상·적용·건너뛴 날), 기간_말일, 판정·근거. 원천징수(제45조의2제5항)는 납부기한, 종합부동산세(제6항)는 납부기한 기준. 지원하지 않음: 2016년 전 사유·통지, 종전 3년 청구기간이 2015.1.1. 전에 끝난 분(법정신고기한이 대체로 2011년 이전 — 부칙 제7조제2항에 따라 종전 규정, 입력 오류로 돌려줌), 후발적 2개월 경과조치. 사유가 후발적 사유(제2항 각 호, 시행령 제25조의2)에 해당하는지는 판단하지 않음.

Inputs: tax, kind, year, abroad, +6 more.

religious_incomeA
Read-onlyIdempotent

Religious worker income as other income: exemptions, expenses, withholding (종교인소득). 종교인소득(소득세법 제21조제1항제26호, 2018.1.1. 시행) 기타소득 계산 — 비과세(제12조5호아목) → 필요경비 표(시행령 제87조3호) → 기타소득금액 → 선택적 분리과세 가능 여부·원천징수·신고 안내. 언제: 목사·신부·승려 등 종교관련종사자가 종교단체로부터 받은 사례비 등의 종교인소득금액을 기타소득으로 계산할 때(20182026 귀속). 입력: 귀속연도(20182026, 2016·2017은 과세 전이라 오류) → year, 받은 금액 총액 → amount, 비과세 항목 → scholarship(학자금)·meals_in_kind(현물 식사)·meal_allowance+meal_months+meal_provided(식사대 월 10만원, 2023~ 20만원)· vehicle_allowance+vehicle_months+vehicle(자가운전보조금 월 20만원, 본인명의임차는 2025~)·expense_reimbursement(일직·숙직료·실비 여비·재해 지급액)· religious_activity_fund(종교활동비)·childcare_allowance+childcare_months+childcare_children(출산·보육 월 10만원, 2024~ 20만원, 2026~ 자녀 1명당 20만원)·housing_benefit(사택), 실제 필요경비 → actual_expense, 원천징수 여부 → withheld, 계산 경로 → route(기타소득|근로소득). 결과: 비과세 항목별·과세대상 받은 금액·필요경비(표 금액 vs 실제)·기타소득금액·선택적 분리과세 가능 여부(제14조제3항제8호가목 — 26호 열거, 300만원 이하·원천징수된 소득)·원천징수·신고 안내·근거·연도표. 지원하지 않음: 근로소득 선택 경로 계산(earned_income_gross_pay + wage_income_tax로 계산), 간이세액표 월별 원천징수세액·연말정산 세액, 비과세 요건(학자금 대상 학교, 사택 요건) 자체의 판정, 퇴직소득 해당 여부(시행령 제42조의2제4항제4호), 다른 기타소득과의 300만원 합산 판정.

Inputs: year (required), amount (required), route, vehicle, +15 more.

retirement_allowance_adjustmentA
Read-onlyIdempotent

Retirement allowance reserve and defined benefit pension tax adjustment (퇴직급여충당금). 퇴직급여충당금·확정급여형 퇴직연금충당금 세무조정(법인세법 제33조, 시행령 제44조의2·제60조, 시행규칙 제24조). 언제: 법인세 세무조정에서 퇴직급여충당금 한도초과, 퇴직금 지급 시 상계·부인액 추인, 퇴직연금 부담금 손금산입 한도를 함께 계산할 때. 입력: year — 사업연도(2016~2026), 추계액 적립비율은 연도표(2016년 이후 0%). allowance — 장부상 퇴직급여충당금 {opening, closing, provision?, paid_cash?, paid_pension?, other_increase?}. prior_disallowed — 기초 부인누계(유보). succeeded_disallowed — 합병 등으로 승계한 부인누계. estimate — 기말 추계액 {lump_sum, actuarial?}, 큰 금액을 씀. salary — 총급여 {total, dc_members?, not_eligible?}: 확정기여형 설정자·지급대상 아닌 자 제외. conversion_fund — 퇴직금전환금 기말잔액. pension — 확정급여형 {asset_closing, asset_opening?(운용자산 기초잔액, 있으면 운용자산기초·운용자산납입 도출), deposited?(당기 납입액, 있으면 운용자산납입에 사용), prior_deducted, book_provision?, book_paid?(운용자산 지급 중 장부 퇴직연금충당금 상계분), dc_transferred_allowance?}. 운용자산에서 퇴직금을 지급한 해에는 장부 퇴직연금충당금 상계분(book_paid)과 퇴직급여충당금 상계분(paid_pension)을 나눠 넣어야 세무상 연금충당금 잔액이 맞는다. 결과: 세무조정(구분·조정 손금불산입/손금산입·금액·소득처분 유보/△유보), 소득금액_순영향, 계산(세무상 잔액·한도). 입력이 모자라거나 장부 증감이 맞지 않으면 error. 확정기여형 전환: 설정 전 계상 퇴직급여충당금(시행규칙 제31조제2항)은 allowance.dc_conversion={prior_estimate_total: 직전 사업연도말 재직자 전원 추계액, prior_estimate_dc: 그중 해당 사업연도 확정기여형 설정자 추계액}으로 계산하거나 {amount}로 직접 입력(확정급여형 퇴직연금이 없어도 됨), related_disallowed(그 몫과 관련된 부인액)는 기초 부인누계에서 제외(별지 제32호서식 작성방법 2·3). 설정 전 근무기간분 부담금으로 지출해 충당금과 상계한 금액은 dc_conversion.paid(paid_cash에 포함)로 넣으면 설정 전 충당금에서 먼저 지출한 것으로 봄(법인세과-1032, 2009.9.21.). 한계: 그 몫과 관련된 부인액의 추인 시기는 계산하지 않음.

Inputs: year (required), allowance (required), prior_disallowed (required), salary, +4 more.

retirement_income_taxA
Read-onlyIdempotent

Retirement income tax on severance pay with service-year deduction (퇴직소득세). 퇴직소득세(근속연수공제·환산급여 방식). 언제: 퇴직금(퇴직급여)을 지급할 때 퇴직소득세를 계산한다. 입력: 퇴직소득금액(퇴직급여, 비과세 제외, 원) → income, 근속연수(160년) → years_of_service, 퇴직한 해 → retire_year(기본 2025), 2012.12.31. 이전 근속연수 → years_before_2013(20162019년 퇴직만). 계산: 20202026년 퇴직은 환산급여 방식. 20162019년 퇴직은 종전 규정(40% 정률공제 + 근속연수공제, 5배 환산 — 2012.12.31. 이전 근속분은 연분연승) 세액과 개정규정 세액을 2016년 80:20, 2017년 60:40, 2018년 40:60, 2019년 20:80으로 더함(법률 제12852호 부칙 제25조). 연도: 근속연수공제는 2023.1.1. 이후 퇴직 개정표(100만·200만·250만·300만), 2022년까지는 구표(30만·50만·80만·120만). 기본세율은 퇴직한 해 표. 결과: 퇴직소득세(산출세액)와 계산 단계 — 근속연수공제·환산급여·환산급여공제·퇴직소득과세표준·환산산출세액, 산식, 근거(소득세법 제48조·제55조제2항). Retirement income tax (근속연수공제·환산급여 방식).

Inputs: income (required), years_of_service (required), retire_year, years_before_2013.

return_precheckA
Read-onlyIdempotent

Tax return precheck: list of suspected errors before a tax audit (신고서 사전검토). 신고서 사전검토(조사 착수 전 오류 의심 목록). 언제: 세무조사 착수 전에 신고서 값으로 오류 의심 항목을 미리 점검할 때. 입력: data={입력키: 값}, tax=법인|부가|소득(생략 시 전체) — 입력키는 precheck_schema로 먼저 확인. 연도: 소득은 "귀속연도"(20162026), 부가는 "신고.과세기간"('YYYY-1'|'YYYY-2', 2016-12026-2)을 넣어야 그 연도 시행 규정(세율·공제·비과세 한도·감면 요건·공제율·이자율)으로 판정 — 없거나 범위 밖이면 연도에 따라 달라지는 규칙은 자료 부족. 결과: 오류 의심·이상 없음·자료 부족·사실 확인 필요.

Inputs: data (required), tax.

return_precheck_pdfA
Read-onlyIdempotent

Corporate tax return PDF precheck: extract forms and list suspected errors (법인세 신고서 PDF 사전검토). 법인세 신고서 PDF(별지 1·3·50호) → 표 추출 → 사전검토(오류 의심 목록). 언제: 법인세 신고서 PDF에서 값을 추출해 return_precheck 입력으로 정리할 때. 입력: PDF 파일 경로 → pdf_path. 결과: 오류 의심·이상 없음·자료 부족·사실 확인 필요 목록 + 서식 간 대사·세액 체인 재계산 + AI 생성 표시(필요 시). UPSTAGE_API_KEY 없이도 pypdf 로컬 추출 후 return_precheck 입력으로 정리 가능(기본), 키 설정 시 Document Parse + Solar Pro 4로 더 정교한 표 추출. 법인세 신고서 PDF에서 표를 추출해 사전검토한다.

Inputs: pdf_path (required).

rnd_tax_creditA
Read-onlyIdempotent

R&D tax credit: research and human resources development tax credit, current vs incremental (연구·인력개발비 세액공제). 연구·인력개발비 세액공제 — 일반연구·인력개발비의 당기분과 증가분을 계산해 큰 쪽을 고른 공제 대상 세액(조세특례제한법 제10조제1항제3호). 언제: 연구소·전담부서를 둔 회사가 그 해 연구개발비로 공제받을 세액을 구하거나, 창업감면과 함께 적용했을 때의 세 부담을 볼 때. 입력: 과세연도 → year, 기업 규모 → size, 당기 발생액 → current, 직전 4개 과세연도 발생액 → prior4, 수입금액 → revenue, 졸업 연도 → graduated_year. 계산: 당기분 = 발생액 × 공제율(중소기업 25%, 졸업 뒤 3년 15%·그 뒤 2년 10% — 2025년 이후 졸업은 20%·15%, 중견기업 8%, 일반기업은 수입금액 대비 비율의 절반·2% 한도). 증가분 = 직전 과세연도를 넘는 금액 × 50%(중견 40%, 일반 25%). 소급 4년간 발생이 없거나 직전 발생액이 4년 연평균보다 적으면 당기분만. 결과: 공제 대상 세액, 선택(당기분·증가분), 당기분, 증가분, 계산(공제율·4년 연평균·증가분 적용 가능 여부), 판단·근거·주의. 범위 밖: 신성장·원천기술과 국가전략기술 연구개발비, 연구·인력개발비 해당 여부 판정, 합병·분할 승계분 조정, 최저한세·이월(minimum_tax_adjustment).

Inputs: size (required), year (required), prior4 (required), current (required), +3 more.

rural_special_taxA
Read-onlyIdempotent

Special tax for rural development surtax on corporate and income tax reductions and credits (농어촌특별세). 농어촌특별세 — 조세특례제한법에 따라 법인세·소득세를 감면받은 세액에 붙는 농어촌특별세와 조문별 비과세 여부(농어촌특별세법 제4조·제5조). 언제: 세액공제·세액감면을 받는 회사가 본세와 함께 낼 농어촌특별세를 구하거나, 창업감면과 투자·고용 세액공제 중 어느 쪽이 실제로 유리한지 비교할 때. 입력: 과세연도 → year, 감면 조문과 감면세액 → items. 계산: 비과세 조문이 아니면 감면세액 × 20%. 비과세는 그 과세연도 말 시행본의 농어촌특별세법 제4조와 시행령 제4조 목록, 개정 부칙의 적용례로 판정(2016~2026 연도별, 12월 결산·기한 내 신고 기준). 창업중소기업 감면(제6조)·중소기업 특별세액감면(제7조)·연구인력개발비 세액공제(제10조)는 비과세, 통합투자세액공제(제24조)·통합고용세액공제(제29조의8)는 과세. 결과: 농어촌특별세 합계, 과세 대상·비과세 감면세액, 계산(항목별 과세 여부·세액·근거·확인할 것), 판단·근거·주의. 범위 밖: 저축·이자·배당 감면(세율 10%), 소득공제·비과세의 감면세액 환산, 관세·취득세·등록면허세·지방세특례제한법 감면, 12월 결산이 아닌 과세연도·기한 후 신고의 적용례 판정.

Inputs: year (required), items (required).

simplified_vat_returnA
Read-onlyIdempotent

VAT simplified taxpayer final VAT return net tax payable (간이과세자 확정신고). 간이과세자 부가가치세 확정신고 차가감납부세액 계산(부가가치세법 제63조·제68조의2·제69조·제46조). 언제: 간이과세자의 과세기간(1.112.31) 부가가치세 확정신고 시 차가감납부세액을 원래 사실관계에서 계산한다. 입력: · 과세연도(20162026) → year, 업종(부가가치세법 시행령 제111조제2항 표의 업종 — 소매업·음식점업·제조업·숙박업·건설업·운수 및 창고업·정보통신업· 금융 및 보험 관련 서비스업·전문·과학 및 기술서비스업·부동산임대업·그 밖의 서비스업 등, 띄어쓰기·'및' 표기 차이는 같은 업종으로 봄) → business_type. · 원장: ledger={공급:[{항목, 금액}], 매입:[{항목, 금액}]}. 항목명 → 역할 매핑은 어휘 간이과세자_원장항목.판단.공급/매입에서 읽음(항목명에 키워드가 포함되면 해당 역할). 공급 금액 전부 합(total), 공제 대상 합(카드발급), 마일리지 합(자기마일리지)으로 변환. 매입도 같은 식으로 변환. 대손 확정액(기본 0) → bad_debt_confirmed, 직전연도 합계 → prior_year_supplies, 예정부과 고지세액 → prepaid_assessed, 사업 개시일 → business_start, 휴업·폐업·유형전환일 → closed_on(있으면 그 기간 공급대가를 12개월로 환산해 면제 판정, 제69조제3항). · 20162020 과세기간과 2021 과세기간 상반기(2021.6.30.까지 공급하거나 공급받은 분)는 종전 산식: 업종별 부가가치율 5·10·20·30%(전기·가스·증기 및 수도 사업, 소매업·재생용 재료수집 및 판매업·음식점업, 제조업·농업·임업 및 어업·숙박업·운수 및 통신업, 건설업·부동산임대업·그 밖의 서비스업), 매입세액 × 부가가치율 공제, 음식점업·제조업의 면세농산물등 의제매입세액 공제(과세유흥장소면 entertainment_venue=true), 카드 발행세액공제 음식점업·숙박업 2.6%. year=2021은 ledger 항목마다 기간('상반기'·'하반기') 또는 공급일을 넣고, 종전 표의 업종명이 다르면 business_type_before_202107에 넣는다(법률 제17653호 부칙 제8조·제10조제13조). 결과: 판단(항목·결론·근거)·계산(과세표준·부가가치율·납부세액·공제·가산세)·결과(납부의무면제·예정부과세액_공제·차가감납부세액(음수면 환급세액, 제67조제2항)·환급세액)·산식·근거.

Inputs: year (required), ledger (required), business_type (required), closed_on, +6 more.

sme_special_tax_reductionA
Read-onlyIdempotent

Special tax reduction for SMEs by size, region and industry (중소기업 특별세액감면). 중소기업 특별세액감면 — 기업 규모·지역·업종별 감면율과 한도를 적용한 감면세액(조세특례제한법 제7조). 언제: 창업감면 대상이 아니거나 감면기간이 끝난 중소기업(도매·소매 포함)이 해마다 받을 수 있는 법인세 감면을 계산할 때. 입력: 과세연도 → year, 소기업·중기업 → size, 본점 수도권 여부 → hq_in_capital_area, 업종 묶음 → industry_group, 산출세액 → tax, 과세표준 → taxable_base, 상시근로자 수 → employees_prev·employees_now. 계산: 감면세액 = 산출세액 × 감면 대상 소득 ÷ 과세표준 × 감면율. 소기업 도매업등 10%, 소기업 그 밖 업종 수도권 20%·수도권 밖 30%, 중기업 수도권 밖 도매업등 5%·그 밖 15%, 중기업 수도권은 없음. 2018년부터 한도 1억원(상시근로자가 줄면 1명당 500만원 차감). 최저한세(과세표준 × 7%) 적용. 결과: 감면세액, 감면율, 감면 후 세액, 계산(감면 대상 세액·한도·최저한세), 판단·근거·주의. 범위 밖: 소기업 매출액 기준 판정, 수도권 중기업 예외 업종 10%, 성실사업자 110% 특례, 전기·수소차 임대업, 알뜰주유소 특례, 개인사업자.

Inputs: tax (required), size (required), year (required), taxable_base (required), +5 more.

sme_statusA
Read-onlyIdempotent

SME status test: small and medium enterprise, small enterprise, grace period (중소기업 해당 여부). 중소기업·소기업 해당 여부 — 업종별 매출 기준, 자산총액, 독립성, 유예기간으로 세법상 중소기업인지와 소기업·중기업 구분(조세특례제한법 시행령 제2조). 언제: 매출이 빠르게 커진 회사가 창업감면·특별세액감면·결손금 소급공제·최저한세 7% 같은 중소기업 규정을 그 해에도 적용받는지 볼 때. 입력: 과세연도 → year, 업종 기호 → industry_code, 매출액 → revenue, 자산총액 → total_assets, 국내 관계기업 → domestic_affiliates, 독립성 → in_disclosure_group·large_corp_owner, 처음 넘은 해 → first_exceeded_year, 창업일 → founded_on. 계산: 매출액(국내 관계기업 합산 — 50% 이상 소유는 전액, 미만은 소유비율만큼)이 업종별 기준(중소기업기본법 시행령 별표 1) 이내이고 자산총액 5천억원 미만이면 중소기업. 기준을 넘으면 처음 넘은 과세연도와 그 다음 5개 과세연도(2023년까지 처음 넘었으면 3개)는 유예기간. 독립성을 잃거나 창업 후 2년 안에 넘으면 유예 없음. 소기업은 매출액이 별표 3 기준 이내. 2025 과세연도부터 2025.9.1. 개정 기준(예: 화학제품 제조업·도소매 1,200억원, 소기업 120억원·60억원). 2016 과세연도는 2015.6.30. 개정 별표(제9차 분류 기호)와 업종 열거 방식, 2017 과세연도부터 2017.10.17. 개정 별표. 2016.1.1. 전 기준 소기업은 2019 과세연도까지 소기업. 결과: 중소기업(참·거짓), 구분(소기업·중기업·유예기간 중·중소기업 아님), 계산(기준 금액·합산 매출액·유예기간), 판단·근거·주의. 범위 밖: 2015년 이전, 주된 업종 판정, 해외 자회사(합산 대상 아님), 손자기업 간접 지배, 상장법인 유예 7년, 합병에 따른 유예 배제, 1년 미만 과세연도 환산.

Inputs: year (required), revenue (required), total_assets (required), industry_code (required), +7 more.

special_tax_creditA
Read-onlyIdempotent

Special tax credit for insurance, medical and education expenses vs standard tax credit (특별세액공제). 근로소득자 특별세액공제(보험료·의료비·교육비)와 표준세액공제 비교. 언제: 연말정산·종합소득세 신고에서 특별세액공제와 표준세액공제 중 선택할 때. 입력: 귀속연도 → year, 근로소득 종류('근로'|'일용근로'|'근로소득없음' — 계산은 '근로'만, 나머지는 특별세액공제 대상 아님으로 입력 확인 필요) → earner_type, 총급여액 → total_salary, 공제대상자 → persons, 지출 목록 → expenses, 근로소득 산출세액 → wage_computed_tax(선택), 월세액 세액공제액(원, 세액공제 한도·합계에 포함) → monthly_rent_credit, 기부금 세액공제액(원, 항목별 합계에 포함) → donation_credit, 특별소득공제 합계(원, 0이 아니면 표준세액공제 선택 불가) → special_income_deduction. 결과: 보험료·의료비·교육비 공제액·특별세액공제 합계·표준세액공제 선택·적용 공제·근거. 특별세액공제 vs 표준세액공제 비교. 연도별: 의료비 특정(2호) 중증질환자 등 2018~, 과세기간 개시일 현재 6세 이하 2024~, 미숙아·선천성이상아 20% 2022~. 교육비 체험학습 2017~, 대입전형료 2023~.

Inputs: year (required), persons (required), expenses (required), earner_type (required), +5 more.

startup_tax_reductionA
Read-onlyIdempotent

Start-up SME tax reduction: eligibility, reduction rate, period and amount (창업중소기업 세액감면). 창업중소기업 세액감면 — 창업일·지역·청년 여부·업종으로 감면 대상인지와 감면율, 감면기간, 그 과세연도 감면세액(조세특례제한법 제6조). 언제: 창업한 지 몇 해 안 된 중소기업이 이익이 난 해에 법인세를 얼마나 감면받는지, 위탁생산·온라인 판매 회사가 대상인지 볼 때. 입력: 창업일 → founded_on, 지역 → region, 과세연도 → year, 최초 소득 과세연도 → first_income_year, 산출세액 → tax, 과세표준 → taxable_base, 청년창업 → youth, 업종 → industry, 위탁제조 요건 → oem, 벤처 확인일 → venture_confirmed_on. 계산: 감면세액 = 산출세액 × 감면 대상 소득 ÷ 과세표준 × 감면율. 감면기간은 최초 소득 과세연도(사업 개시 후 5년이 되는 해까지 소득이 없으면 그 해)부터 5개 과세연도. 감면율은 창업일 기준 — 2016년 과밀억제권역 밖 50%, 2017.1.1.~2018.5.28. 청년 75%·50%, 2018.5.29.~2025년 청년 100%·50%와 과밀억제권역 밖 일반 50%, 2026년부터 100·75·50·25%. 위탁제조는 국내 제조업체 위탁·직접 기획·자기 명의·자기 책임 직접 판매를 모두 갖추면 제조업(시행규칙 제4조의2, 2017.3.17. 전은 제2조제1항 — 2016년 창업 포함). 도매업·소매업은 대상 아님. 100%가 아니면 최저한세 적용. 결과: 감면세액, 적용(제1항·제2항·대상 아님·감면기간 아님), 감면율, 감면 후 세액, 계산(감면기간·연차·감면 대상 세액·최저한세), 판단·근거·주의. 범위 밖: 2018.1.1.~5.28. 창업의 신성장 서비스업 75% 특례, 수입금액이 작은 창업기업 감면(제6항), 고용 증가 추가 감면(제7항), 창업보육센터·에너지신기술기업, 1년 미만 과세연도, 개인사업자.

Inputs: tax (required), year (required), region (required), founded_on (required), +8 more.

stock_basis_income_taxA
Read-onlyIdempotent

Unlisted stock standard market price per share for capital gains tax (비상장주식 기준시가). 비상장주식 소득세법 기준시가(영 제165조제4항) — 양도세 기준시가와 대주주 시가총액 판정(영 제157조제4항제2호)에 쓰는 1주당 가액. 상속·증여 평가와 달리 직전 사업연도 순손익만(÷10%), 순자산은 장부가액, 할증 없음, 하한 순자산가치×80%(2018.4.1.~). 언제: 비상장주식 양도세에서 기준시가가 필요하거나, stock_major_shareholder의 price(1주당 가액)에 넣을 값이 필요할 때. 입력: 양도일 → transfer_date, 발행주식총수 → shares, 직전 사업연도 순손익액 → prior_year_income, 장부 순자산 → book_net_asset. 결과: 1주당 기준시가, 순손익가치·순자산가치, 평가방법, 판단(할증 없음·이자율 확인 필요), 근거.

Inputs: shares (required), transfer_date (required), status, book_net_asset, +4 more.

stock_capital_gains_taxA
Read-onlyIdempotent

Stock capital gains tax on shares: taxability, basic deduction, rates (주식 양도소득세). 주식등 양도소득세 — 과세 대상 여부(상장주식은 대주주 양도·장외 양도만, K-OTC 중소·중견 소액주주 제외), 양도차익 → 기본공제(연 250만원) → 과세표준 → 세율(대주주 20%·3억 초과 25%, 1년 미만 비중소 30%, 소액주주 중소 10%·그 밖 20%, 국외 10%/20%; 연도별) → 산출세액·지방소득세·예정신고기한(반기 말일+2개월). 언제: 주식을 팔았을 때 세금이 얼마인지, 과세 대상인지 물을 때. 대주주 여부는 먼저 stock_major_shareholder로 판정한다. 입력: 양도일 → transfer_date, 시장 → market, 대주주 → major_shareholder, 중소기업 → sme, 양도가액·취득가액·필요경비 → transfer_price·acquisition_price·expenses(또는 gain), 취득일 → acquisition_date. 지원하지 않음: 2019 이전 국외주식(제118조의2), 파생상품, 상장주식 장내 소액주주(과세 대상 아님으로 답함), 양도차손 통산 계산. 결과: 과세대상·양도차익·기본공제·과세표준·적용세율·산출세액·지방소득세·예정신고기한, 세율 후보(경합 시 큰 세액), 판단, 근거.

Inputs: market (required), transfer_date (required), sme, gain, +8 more.

stock_major_shareholderA
Read-onlyIdempotent

Major shareholder test for stock capital gains tax by holding ratio and market value (대주주 판정). 주식 양도소득세 대주주 판정 — 양도일·시장·직전 사업연도 종료일 현재 지분율·시가총액으로 대주주 여부(소득세법 시행령 제157조·제167조의8, 2016~2026 구간별 기준: 코스피 1%/25억→15억→10억→50억 등)와 특수관계인 합산 방식을 판정한다. 주주 명부(total_shares·own_shares·holders·price)를 주면 지분율·시가총액과 주주별 합산 여부("처남은 2023년부터 인척 2촌이라 최대주주군일 때만 합산" 등)까지 도구가 계산한다. 언제: "나 대주주야?", 주식 양도세 세율·과세 여부를 정하기 전에. 결과의 판정(대주주/아님/확인 필요)을 stock_capital_gains_tax의 major_shareholder에 넣는다. 입력: 양도일 → transfer_date, 시장 → market, 본인 지분율·시가총액 → own_ratio·own_mcap, 특수관계인 합계 → related_ratio·related_mcap, 최대주주군 여부 → is_max_group, 벤처 → venture. 결과: 판정·이유·적용 기준(지분율·시가총액)·합산 방식, 판단(기준일·시가 산정·확인 필요), 근거(시행령 조항·개정령·시행일). 시가총액은 사용자가 계산해 넣는다(도구가 시세를 조회하지 않음).

Inputs: market (required), transfer_date (required), price, holders, +12 more.

stock_price_lookupA
Read-onlyIdempotent

Listed stock price lookup from KRX for year-end value or gift tax valuation (상장주식 시세). 상장주식 시세 조회 — KRX 정보데이터시스템(pykrx)에서 종가를 가져와 (1) 직전 사업연도 종료일 최종시세가액(소득세법 시행령 제157조제4항제1호, 휴장이면 직전거래일) 또는 (2) 상속·증여 평가 시가(평가기준일 전후 2개월 종가 평균, 상증법 제63조제1항제1호가목)를 돌려준다. 언제: 대주주 판정(stock_major_shareholder의 price·own_mcap)이나 상속·증여 주식 평가에 넣을 가액이 필요할 때. 입력: 종목코드 → ticker, 기준일 → day, 용도 → mode(close|avg_2m). 주의: 이 도구만 외부(KRX)로 조회하며 보내는 정보는 종목코드·날짜뿐. pykrx가 없으면 설치 안내를 돌려줌(pip install 'korean-tax-calc-mcp[stock]'). pykrx의 'KRX 로그인 실패' 경고는 종가 조회와 무관(로그인 불필요). 비상장주식은 상증법 보충적 평가 도구로. 결과: 종가 또는 2개월 평균·거래일수·기간, 판단(직전거래일 사용 여부·기간 조정 확인 필요), 근거.

Inputs: day (required), ticker (required), mode.

tax_adjustment_scheduleA
Read-onlyIdempotent

Multi-year tax adjustment schedule: taxable income, tax base, calculated tax and yubo balances (연도별 세무조정). 연도별 세무조정 묶음 — 여러 사업연도의 결산서상 순손익과 세무조정을 넣으면 각 사업연도 소득, 이월결손금 공제, 과세표준, 산출세액, 항목별 유보 잔액을 해마다 이어서 계산(법인세법 제14조·제13조·제55조·제67조). 언제: 여러 해에 걸친 세무조정(인정이자, 충당부채, 이전가격 조정, 한도초과 등)을 한 표로 모아 연도별 세액과 유보·결손금 잔액을 볼 때. 입력: 사업연도별 순손익과 조정 → years, 중소기업 등 여부 → sme, 기초 유보 → opening_reserves, 기초 결손금 → opening_losses. 계산: 각 사업연도 소득 = 결산서상 당기순손익 + 익금산입·손금불산입 − 손금산입·익금불산입. 유보로 처분한 조정은 항목별 잔액(기초·증가·감소·기말)으로 다음 해에 넘김. 출자의 증가로 조정한 금액은 유보·사외유출과 따로 항목별 당기·누계로 보여 줌(국제조세조정에 관한 법률 제13조, 시행령 제23조). 결손이 난 해의 결손금은 먼저 발생한 것부터 뒤 사업연도 소득에서 공제(loss_carryforward_ledger와 같은 규칙) → 과세표준 × 그 해 세율 = 산출세액. 결과: 합계(각 사업연도 소득·과세표준·산출세액·기말 유보·기말 결손금 잔액), 계산(연도별 순손익·가산·차감·각 사업연도 소득·소득처분 사외유출 합계·유보 표·이월결손금 공제·과세표준·산출세액), 판단·근거·서식·주의. 범위 밖: 각 조정 금액이 맞는지(각 계산 도구로 구해 넣음), 세액공제·감면·최저한세, 다른 조정 뒤 소득으로 다시 계산하는 한도(기부금 등), 1년 미만 사업연도.

Inputs: years (required), sme, opening_losses, opening_reserves.

tax_crime_settlement_amountA
Read-onlyIdempotent

Tax crime settlement: notice of disposition fine equivalent amount (통고처분 벌금상당액). 통고처분 벌금상당액 — 조세범칙행위에 대해 지방국세청장·세무서장이 통고하는 벌금상당액을 시행령 별표 부과기준(1차·2차·3차 이상, 가중·감경, 경합, 10원 미만 절사, 처벌법 벌금 상한)으로 계산. 언제: 조세범칙조사 뒤 통고처분 금액을 미리 계산하거나 검토할 때. 입력: 범칙행위 목록 → offenses, 통고처분일 → notice_date, 행위일 → act_date, 표 기준일 → table_basis. 계산 순서(별표 1호 사목): 위반 횟수 → 상습 50% 가중(제3조만) → 수정신고·기한 후 신고 감경 50·20·10%(제3조만, 조사 착수 전·추가세액 납부) → 방조 감경(재량, 입력) → 심신미약 등 50% 감경 → 경합(제7~9·11·15·16조 그룹은 가장 무거운 것 + 1/2, 합산액 한도 / 나머지는 합산 / 섞이면 각각 산정 후 합산). 10원 미만 절사, 처벌법 벌금 상한을 넘으면 상한. 결과: 범칙행위별 개별기준·단계·벌금상당액, 경합, 합계, 적용 별표(2014.6.30.·2019.2.12.·2026.2.27. 개정본), 경고, 납부·고발 안내. 범위 밖: 범칙행위·단서·상습·방조 해당 여부(조문 MCP tax_crime_guide), 통고·고발·무혐의 처분 선택과 위원회 심의.

Inputs: offenses (required), notice_date (required), act_date, table_basis.

tax_priority_distributionA
Read-onlyIdempotent

Priority of national taxes in auction proceeds distribution vs secured and wage claims (국세 우선권). 국세 우선권에 따른 매각대금 배분 순서·금액(경매·공매, 국세기본법 제35조·제36조). 언제: 체납자 재산이 경매·공매로 매각될 때 집행비용 → 최우선변제 → 당해세 → 법정기일과 담보 설정일 비교 → 임금 → 그 밖의 조세 → 일반채권 순으로 누가 얼마를 받는지 계산할 때. 입력: 매각대금 → sale_amount, 매각(허가)결정일 → sale_date, 채권 목록 → claims, 집행비용 → execution_cost, 재산 종류 → property_type, 직전 보유자 체납(양도된 재산) → prior_owner. 지원 연도: 2016.1.1.~2026.12.31. 매각결정분. 2023.4.1. 이후 매각결정분은 제1항제3호의2(양도 전 설정 담보 > 현 소유자 국세, 직전 보유자 체납액 한도 안 국세는 우선)·제3항 후단(3호의2 재산은 종부세만 당해세 우선)·제7항(주택 임차인 당해세 순위 대신 변제), 2024.1.1. 이후는 한도 안 국세를 법정기일이 설정일보다 빠른 것으로 한정. 지방세 당해세·법정기일 비교(지방세기본법 제71조), 국세·지방세 상호간 압류선착(제36조·지방세기본법 제73조, 압류 없으면 동순위 안분). 지원하지 않음(입력 확인 필요로 반환): 가압류채권과 후순위 담보권 안분·흡수배당, 담보권 사이 순환관계, 공과금, 납세담보(제37조), 3호·3호의2 담보 혼재·3호의2 담보 둘 이상, 일반임금채권과 전세권·확정일자 임차권의 순위, 제35조제7항 대상 임차인 둘 이상. 소액임차 일정액·최우선임금 범위는 계산된 금액을 넣는다(2분의 1 한도만 적용). 결과: 채권별 배분액·미배분액·단계별 근거, 배분 순서, 잔여(소유자 몫), 판단(적용한 개정·특례), 적용표.

Inputs: claims (required), sale_date (required), sale_amount (required), prior_owner, +2 more.

thin_capitalizationA
Read-onlyIdempotent

Thin capitalization: non-deductible interest on excess debt from foreign controlling shareholders (과소자본). 과소자본 손금불산입(국제조세조정에 관한 법률 제22조, 2020 사업연도까지 제14조). 언제: 국외지배주주로부터 차입한 금액이 출자금액의 기준 배수(기본 2배, 금융업 6배)를 초과할 때 초과분 지급이자를 손금불산입한다. 직접 차입·지급보증 차입이 섞여 있거나 이자율이 다른 차입금이 여럿이면 loans로 차입금별로 넣는다. 입력: 국외지배주주 출자금액(원) → equity, 차입금액(원) → borrowings, 지급이자 총액(원) → total_interest, 적용 배수(기본 2) → ratio, 사업연도(20162026) → year, 수취인 거주지국 → recipient_residence_country, 이자 조세조약 제한세율(소수) → interest_treaty_rate, 배당 조세조약 제한세율(소수) → dividend_treaty_rate, 수취인 구분(개인/법인) → recipient_type, 차입금별 목록 → loans(이때 borrowings·total_interest 생략), 연중 일수 → days_in_year. 출자금액(equity): 사업연도 종료일 현재 max(자산 − 부채(충당금 포함, 미지급 법인세 제외), 납입자본금) × 국외지배주주 납입자본금비율(시행령 제47조, 2020년까지 구 시행령 제25조제3항). 사업연도 중 자본이 변동했으면 나누어 계산한 적수 ÷ 연중 일수를 넣는다. loans 없이: 손금불산입 이자 = 지급이자 × 초과차입금 ÷ 총차입금(평균 이자율), 처분은 전부 배당으로 봄(종전 계산). loans로: 초과차입금적수 = 차입금 적수 합계 − 출자금액 적수 × 배수를 이자율 높은 차입금부터(같은 이자율이면 차입일이 늦은 것부터, 2021년부터는 이자율·차입일이 모두 같으면 적수 비율 안분) 채우고 차입금별 손금불산입 이자 = 배정 적수 × 이자율 ÷ 연중 일수(시행령 제48조, 시행규칙 별지 제24호서식(갑); 2020년까지 구 시행령 제25조제1항). 처분은 직접 차입분 배당, 특수관계인·지급보증 차입분 기타사외유출(시행령 제49조, 2020년까지 구 시행령 제25조제6항). 세무조정 항목을 함께 돌려줌(income_adjustment_total에 그대로). 결과: 초과차입금·손금불산입 이자·처분(배당/기타사외유출), loans를 넣으면 차입금별 배정·배당/기타사외유출 처분액·세무조정, recipient_residence_country 지정 시 배당 처분액의 원천징수 재계산(수취인 법인이면 '법인세 차액', 개인이면 '소득세 차액'), 근거(그해 조문 — 2021년부터 국제조세조정에 관한 법률 제22조·시행령 제46조제50조, 2020년까지 전부개정 전 제14조·시행령 제24조~제26조). 다루지 않음: 소득 대비 과다이자(제24조) 금액, 정상 차입조건 증명(제22조제4항)에 따른 제외. Thin capitalization disallowance.

Inputs: equity (required), year, loans, ratio, +7 more.

tp_comparable_screenA
Read-onlyIdempotent

Transfer pricing comparable company screening: rejection matrix, weighted average, sensitivity (비교대상 기업 선정). 비교대상 기업 선정(스크리닝) — 유료 데이터베이스에서 내보낸 후보 목록에 선정 기준을 적용해 회사별 탈락 사유표, 최종 비교대상, 다년 가중평균 지표, 사분위 범위, 기준을 바꿨을 때의 민감도를 냄. 언제: 이전가격 거래순이익률방법에서 비교대상을 거르고 탐색 과정·탈락 사유를 개별기업보고서(Ⅱ-11·12·13·15)에 남길 때. 입력: 후보 목록 → file_path 또는 rows, 분석대상 → tested_party, 분석 연도 → analysis_years, 사업연도 → tested_year, 기준 → screens, 사람 판단 → manual_decisions(사유 필수), 검색 기록 → search_log. 기준: S1a 독립성 법정 하한(최대주주 50% 이상, 끌 수 없음) / S1b 독립성(관행 — screens로 줄 때) / S2 자료 충분성 / S3 업종 코드 / S4 규모 / S5 지속 손실(screens.loss_years를 줄 때 — 기본은 사람 확인, 탈락은 loss_action=exclude, 경제위기 예외 시행령 제15조제7항) / S6 연구개발 / S7 광고 / S8 운전자본(표시) / S9 특수관계 매출 / S10 부문 / S11 특수 상황 / S12 사람 판단 / S13 이상치(표시만). S1a·둘 이상만 법정, 나머지는 screens로 받은 값만 적용([관행] 표시). 결과: 결과(후보·최종 수, 주_결과(단년이 기본 — 다년은 multi_year_reason이 있을 때, 서식 Ⅱ-11), 단년_범위, 다년 범위(계산법·n·조정점 중위값), 사분위_민감도(INC·국세청 통칙·미국식), 연도별_범위(연도마다 자료 있는 비교대상으로), 사람_확인(지속 손실 등), 운전자본 조정(wca, 선택)을 켜면 조정_전_범위도, 분석대상 값, 범위 안 여부), 탈락_매트릭스(모든 회사×모든 기준), 최종_비교대상(연도별 재무·지표), 민감도, arm_length_range_입력(그대로 넘기면 같은 사분위), 보고서_부록, 경고, 판단·근거·주의. 범위 밖: 데이터베이스 검색 자체, 회사별 기능·거래단계 비교, 비교대상이 적절하다는 결론. 최종 비교대상이 둘 미만이면 범위를 내지 않음(시행령 제15조제5항).

Inputs: tested_year (required), tested_party (required), analysis_years (required), fx, +14 more.

tunnelling_from_pdfA
Read-onlyIdempotent

Gift tax intra-group business transfer PDF review: extract tables and compute deemed gift (일감몰아주기 PDF 검토). 일감몰아주기 검토 자료 PDF → 표 추출 → 코드가 지배주주·출자관계·증여의제이익 계산. 언제: PDF로 된 일감몰아주기 검토 자료에서 관계표를 추출해 tunnelling_gift_nts 입력으로 정리할 때. 입력: PDF 파일 경로 → pdf_path. 결과: 지배주주·출자관계·증여의제이익 계산 결과(초안) + AI 생성 표시(필요 시). 자료의 사업연도를 읽어 그 사업연도 규정으로 계산(2017.12.31. 이전 종료분은 종전 계산식), 못 읽으면 2018.1.1. 이후 규정으로 계산하고 '확인 필요'에 표시. UPSTAGE_API_KEY 없이도 pypdf 로컬 추출 후 정리 가능(기본), 키 설정 시 Document Parse + Solar Pro 4로 더 정교한 표 추출. 결과는 사람 확인. 일감몰아주기 검토 자료 PDF에서 표를 뽑는다.

Inputs: pdf_path (required).

tunnelling_giftA
Read-onlyIdempotent

Gift tax: deemed gift profit from intra-group business transfer, simplified formula (일감몰아주기 증여의제이익). 일감몰아주기 증여의제이익(상증법 제45조의3, 제10항 과세제외매출액 직접 입력, 제14항·제15항 미반영). 언제: 일감몰아주기 검토에서 증여의제이익을 간단히 계산할 때(국세청 신고안내 전체 산식은 tunnelling_gift_nts 사용). 입력: 수혜자(이름) → beneficiary, 기업 규모(중소|중견|일반) → size, 총 매출액 → sales_total, sales_by_corp={거래처 법인: 매출액} → sales_by_corp, 세후영업이익 → after_tax_op_profit, people={이름: {구분: "개인"|"법인"}} → people, family=[[a, b, "부모자녀"|"배우자"]] → family, stakes=[[보유자, 법인, 지분율(01)]] → stakes, 제10항·제14항 과세제외매출액 → excluded_sales. 사업연도: 수혜법인 사업연도 종료일 → fiscal_year_end(개시일 → fiscal_year_start). 2017.12.31. 이전 종료분은 종전 계산식(일반: 정상거래비율의 1/2인 15% 초과 거래비율 × 3% 초과 보유비율, 중소·중견: 정상거래비율 초과 × 10% 초과), 중견 정상거래비율은 2017년 개시 사업연도부터 40%(그 전 50%). 2018.1.1. 이후 종료분은 현행식. 친족 범위는 2023.2.28.까지 6촌 혈족·4촌 인척. 20162026 종료 사업연도만 지원. 결과: 증여의제이익, 근거(상증법 제45조의3, 시행령 제34조의3 — 2020.2.10.까지는 제34조의2). 일감몰아주기 증여의제이익(상증법 제45조의3).

Inputs: size (required), family (required), people (required), stakes (required), +7 more.

tunnelling_gift_ntsA
Read-onlyIdempotent

Gift tax: deemed gift profit from intra-group business transfer, NTS 2026 filing guide formula (일감몰아주기 증여의제이익). 일감몰아주기 증여의제이익 — 국세청 2026 신고안내 산식(세후영업이익 제12항, 출자관계별 추가 과세제외 제14항제1호·제3호, 한계보유 제13항, 배당공제 제15항). 언제: 국세청 신고안내 공식에 따라 일감몰아주기 증여의제이익을 정확히 계산할 때. 입력: 기업 규모(중소|중견|일반) → size, 수혜법인(이름, 고정) → '수혜법인', 세후영업이익 제12항(원) → op_income, 과세표준(원) → taxable_income, 법인세 산출세액(원) → tax, 총 매출액(원) → sales_total, sales_by_corp={거래처 법인: 매출액(원)} → sales_by_corp, relations={관계명: 보유비율(소수)}(예: {'직접':0.2,'A경유':0.18}) → relations, 기본 과세제외매출액(제10항, 원) → base_excluded, holdings_in_related={특관법인: 지배주주등 보유비율(소수)} → holdings_in_related, indirect_corp_of={관계명: 그 경로 간접출자법인} → indirect_corp_of, excluded_by_corp={특관법인: 제10항 과세제외액(원)} → excluded_by_corp, dividends={관계명: [배당소득(원), 분모]}(제15항) → dividends, 토지등 양도소득 법인세(차감, 원) → land_tax, 공제·감면세액(차감, 원) → credits, 미환류소득 법인세(원, tax에 포함이 맞음) → unreturned_tax. 사업연도: 수혜법인 사업연도 종료일 → fiscal_year_end(개시일 → fiscal_year_start). 2017.12.31. 이전 종료분은 종전 비율·계산식(일반 15% 초과 × 3% 초과, 중소·중견 정상거래비율 초과 × 10% 초과, 중견 정상거래비율 2016년 개시분까지 50%), 2018.1.1. 이후 종료분은 현행식. 제12항·제14항·제15항 산식은 2026 신고안내 기준 그대로라 과거 사업연도는 당시 서식과 대조 필요. 2016~2026 종료 사업연도만 지원. 결과: 증여의제이익·단계별 계산·적용 비율, 근거(상증법 제45조의3, 시행령 제34조의3 — 2020.2.10.까지는 제34조의2, 국세청 2026 신고안내). 일감몰아주기 증여의제이익 — 국세청 2026 신고안내 산식.

Inputs: tax (required), size (required), op_income (required), relations (required), +13 more.

underreporting_penaltyA
Read-onlyIdempotent

Underreporting penalty tax (10% general, 40% fraud) with amended return reduction (과소신고가산세). 과소신고가산세(일반 과소신고 10%, 부정행위 40%)와 국세기본법 제48조제2항 수정신고 감면. 언제: 신고한 세액보다 실제 세액이 더 클 때 가산세 금액을 구하고, 수정신고를 했으면 감면을 적용한다. 입력: 과소신고한 세액(원) → additional_tax, 부정행위 여부 → fraud(기본 False), 감면 종류 → reduction, 법정신고기한 → due, 수정신고일 → amended_on, 미리 알았는지 → foreknown(기본 False), 전에 한 수정신고일 → prior_amended_on. 감면율: 수정신고일이 2020.1.1. 이후면 90·75·50·30·20·10%(1개월·3개월·6개월·1년·1년 6개월·2년 이내), 그 전이면 50·20·10%(6개월·1년·2년 이내). 2020.1.1. 전에 수정신고한 분을 2020.1.1. 이후 다시 수정신고하면 종전 비율(법률 제16841호 부칙 제22조 후단) — prior_amended_on. 결과: 가산세·감면전_가산세·감면율·감면액, 근거(국세기본법 제47조의3, 감면은 제48조제2항). Under-reporting penalty with amended-return reduction under Article 48(2).

Inputs: additional_tax (required), due, fraud, foreknown, +3 more.

unfair_transactionA
Read-onlyIdempotent

Wrongful calculation test for related party transactions vs market price (KRW 300M or 5%) (부당행위계산). 부당행위계산 기준(시가와 실제 거래가 차이 3억 원 이상 또는 5% 이상). 언제: 특수관계인과의 거래 가격이 시가와 크게 차이 나 부당행위계산 부인 대상인지 확인할 때. 입력: 시가(단가, 원) → market_price, 실제 거래 단가(원) → actual_price, 수량 → quantity, 100% 자회사 액면 증자 단독 인수 여부 → wholly_owned_capital_increase(기본 False). 결과: 시가총액·차액·차액비율·부당행위계산 여부, 근거(법인세법 제52조, 시행령 제88조제3항). 부당행위계산 기준(시가와 실제 거래가 차액이 3억 원 이상 또는 5% 이상이면 부인 대상). wholly_owned_capital_increase=True(시가가 액면 미만인 법인의 신주를 100% 단독 출자 법인이 전부 인수)면 차액이 있어도 부당행위계산=False로 계산 — 판단 근거는 조문 MCP(korean-tax-mcp) search_tax_rulings(query='100% 단독 출자 유상증자 신주 인수 부당행위계산'). 국외특수관계인 거래(foreign_related=True): 국제거래에는 법인세법 제52조를 적용하지 않음(국조법 제4조제2항) → 결과의 적용_규정이 '국조법 정상가격 조정', 부당행위계산은 False, 차액 전부가 조정대상_차액(3억·5% 기준 없음). 입력한 시가를 정상가격으로 본 차액이며 정상가격 산출 자체는 하지 않음. 예외 — transaction_type이 무상이전·채무면제, 무수익자산, 출연금대납, 자본거래면 국제거래라도 법인세법 제52조(국조령 제4조)로 종전처럼 판정.

Inputs: quantity (required), actual_price (required), market_price (required), year, +3 more.

unlisted_stock_valuationA
Read-onlyIdempotent

Unlisted stock valuation for inheritance and gift tax: net income and net asset value (비상장주식 평가). 비상장주식 상속·증여 평가(상증법 보충적 평가) — 순손익가치(3년 가중평균 3:2:1 ÷ 10%)와 순자산가치((순자산+영업권) ÷ 주식수)를 3:2(부동산 과다 2:3)로 가중평균, 하한 순자산가치×80%(2017.42018.3 70%), 순자산가치만 평가하는 사유(청산·개시 3년 미만·휴폐업·부동산 80%·주식 80%·존속 3년, 구간별), 최대주주 할증(2019까지 20/30%·중소 0, 2020 20%·중소 제외, 2023~ 중견 제외)까지 20162026 구간별로 계산한다. 언제: 비상장주식을 상속·증여받았을 때 1주당 평가액, 또는 비상장법인 지분의 상증법 가액이 필요할 때. 양도세 대주주 시가총액·기준시가는 산식이 달라 stock_basis_income_tax를 쓴다. 입력: 평가기준일 → valuation_date, 발행주식총수 → shares, 3년 순손익 → incomes, 순자산가액 → net_asset, 부동산 비율 → real_estate_ratio, 최대주주·중소기업 → is_max_shareholder·sme. 재무제표 입력: incomes에 각사업연도소득+가산·차감 항목, net_asset에 자산·부채 장부가액+평가차액+가감 항목을 주면 순손익액·순자산가액을 도구가 만들고 줄별 근거를 보여준다. 세무조정 연결: incomes 항목에 calls=[{tool, args}]를 주면 서버가 세무조정 계산기(income_adjustment_total·corporate_tax·entertainment_adjustment·donation_limit·dividend_received_deduction·business_car_expense·nonbusiness_interest_disallowance·depreciation_adjustment)를 실행해 각사업연도소득·가산·차감에 자동으로 넣는다(영 제56조제4항 항목만). 증감자(capital_changes)·추정이익(estimated_profit, 요건 판정)·자산별 평가(assets: 시가→기준시가→장부가액 선택, 장부가액 하한)까지 받는다. 지원하지 않음: 평가심의위원회, 자산별 시가의 평가기간(상속 전후 6개월·증여 전 6개월후 3개월) 판정(사용자가 기간 안 가액만 넣음), 국외 비상장. 결과: 1주당 평가액(할증 후·전), 순손익가치·순자산가치·가중평균(1주당 값은 원 단위 — 원 미만 반올림, 값이 없으면 키 생략), 평가방법, 할증률, 판단(사유·하한·확인 필요), 근거.

Inputs: shares (required), valuation_date (required), sme, kind, +15 more.

vat_bad_debt_creditA
Read-onlyIdempotent

VAT bad debt tax credit (10/110), recovery add-back and timing (대손세액공제). 대손세액공제(대손금액 × 10/110)와 대손금 회수 시 가산, 대손 확정 시기 판정. 언제: 외상 매출이 대손되었을 때 부가가치세 대손세액공제를, 공제받은 대손금을 회수했을 때 매출세액 가산액을 계산한다. 입력: 대손금액(부가세 포함, 원) → bad_debt_incl_vat, 재화·용역 공급 대가 채권 여부 → supply_receivable(기본 True), 회수분 여부 → recovered(기본 False), 대손 사유 → reason, 사유 발생일 → reason_date, 채권 종류 → receivable(기본 '외상매출금'), 중소기업 여부 → sme(기본 False), 저당권 설정 여부 → mortgage(기본 False), 공급일 → supply_date, 신고 과세기간 → period. 결과: 대손세액, 대손확정일, 공제_과세기간, 공제가능, 구분, 회수, 근거. 대손 사유·확정일이 없으면 "대손 사유·확정일을 확인하지 않음" 문장 추가. 엑셀(export_workbook): 공제분은 별지 제19호서식(1) 2., 회수분은 신고서 (8) 대손세액 가감에 가산(공제분은 △). VAT bad debt credit.

Inputs: bad_debt_incl_vat (required), sme, period, reason, +6 more.

vat_card_sales_creditA
Read-onlyIdempotent

VAT credit card sales tax credit (1.3%, annual cap KRW 10M) for sole proprietors (신용카드매출전표 등 발행세액공제). 신용카드매출전표 등 발행세액공제(공제율 1.3%, 연 한도 1,000만 원). 언제: 개인사업자가 신용카드·현금영수증 매출에 대해 발행세액공제를 얼마나 받는지 계산한다. 입력: 신용카드·현금영수증 발급분 공급대가(원) → amount, 공급일(YYYY-MM-DD, 세율·한도 연도표 기준) → supplied_on, 같은 해 이미 공제받은 금액(원) → used_this_year, 개인사업자 여부 → individual(기본 True), 직전 연도 공급가액 합계(원) → prior_year_supply(직전연도_공급가액_한도 초과 시 공제 0). 음식점업·숙박업 간이과세자 여부 → simplified_food_lodging(2021.6.30.까지 공급분 2.6%), 간이과세자 여부 → simplified(2018년 한도 적용 시점). 결과: 공제액·공제율(법인·한도 초과 시 0, 판단 문구 포함), 근거(부가가치세법 제46조제1항). 신용카드매출전표 등 발행세액공제; 공제율 1.3%(간이 음식·숙박 2.6%는 2021.7.1. 전), 연 한도 500만 원(2017년까지) → 1,000만 원(2018년 제2기 확정부터, 간이과세자는 2018년 과세기간부터), 개인사업자만 해당·직전 연도 공급가액 한도 이하. 공급일 2016~2026만 지원.

Inputs: amount (required), supplied_on (required), individual, simplified, +3 more.

vat_common_input_allocationA
Read-onlyIdempotent

VAT common input tax allocation between taxable and exempt business (공통매입세액 안분). 겸영사업자 공통매입세액 안분(불공제분 계산). 언제: 과세·면세 사업을 겸영할 때 공통 매입세액 중 얼마가 불공제인지 계산한다. 입력: 공통매입세액(원) → common_tax, 총공급가액(원) → total_supply, 면세공급가액(원) → exempt_supply. 결과: 불공제 매입세액, 근거(부가가치세법 시행령 제81조). 면세비율 5% 미만·공통매입세액 5만 원 미만이면 전액 공제. 불공제 = 공통매입세액 × 면세공급가액 ÷ 총공급가액. 확정신고에서 예정신고분을 정산하거나 신축 건물 면적 안분이 있으면 common_input_tax를 쓴다. 겸영사업자 공통매입세액 안분(불공제분 계산).

Inputs: common_tax (required), total_supply (required), exempt_supply (required).

vat_deemed_input_creditA
Read-onlyIdempotent

VAT deemed input tax credit on tax-exempt agricultural products purchased (의제매입세액공제). 의제매입세액공제(면세농산물 등 매입가액 × 공제율, 연장·운반비율 제외·공통분 안분). 언제: 음식점·제조업 등에서 면세농산물 등을 매입할 때 의제매입세액공제를 계산한다. 입력: 과세기간('YYYY-1' 또는 'YYYY-2') → period, 업종 → industry, 면세농산물 등 매입가액(원) → purchase, 해당 과세기간 과세표준(원) → base, 개인사업자 여부 → individual, 중소기업 여부(제조 법인) → sme, 면세농산물 등 총 구입액(원) → purchase_total, 구입액에 포함된 운반비(원) → freight_included, 과세사업 사용·소비액(원) → used_taxable, 면세사업 사용·판매액(원) → used_exempt, 실지귀속 불분명 기말재고(원) → ending_inventory_common, 해당 기간 과세 공급가액(원) → taxable_supply, 해당 기간 면세 공급가액(원) → exempt_supply. 결과: 공제대상 매입가액·의제매입세액·공제율·한도율·한도액(과세표준 × 한도율, 한도 없으면 null)·한도 적용 매입가액·과세비율·단계별 계산(입력한 단계만), 근거(부가가치세법 제42조, 시행령 제81조·제84조 — 공제율은 2017년까지 시행령 제84조제1항 표, 2018년부터 법 제42조제1항 표, 한도는 시행령 제84조제2항).

Inputs: period (required), industry (required), sme, base, +11 more.

vat_deemed_rentA
Read-onlyIdempotent

VAT deemed rent on lease deposits (deposit x interest rate x days) (간주임대료). 간주임대료(보증금 × 정기예금이자율 × 일수/연일수, 윤년이면 연수 366). 언제: 상가·오피스텔 등 임대 보증금을 받을 때 부가가치세 간주임대료를 계산한다. 입력: 보증금(원) → deposit, 과세기간 중 임대 일수(1~184) → days, 과세기간('YYYY-1' 또는 'YYYY-2') → period, 적용 이자율(소수, 생략 시 연도표) → rate. 결과: 간주임대료·적용_이자율, 근거(부가가치세법 시행령 제65조). VAT deemed rent on lease deposits.

Inputs: days (required), period (required), deposit (required), rate.

vat_deemed_supply_itemsA
Read-onlyIdempotent

VAT deemed supply and sales tax base by item (간주공급). 간주공급·판매 과세표준 판정(부가가치세법 제10조, 시행령 제19조의2·제20조·제66조). 언제: 재화의 판매·간주공급에 대한 부가가치세 과세표준을 항목별로 판정할 때. 입력: period=과세기간('YYYY-1'|'YYYY-2'), items=[{항목, 거래, 매입세액공제(bool), 금액?|시가?|감가상각?, 사용인_구분?, 인원?, 1인당_연간금액?, 견본_광고선전물?, 취득구분?, 반출?}]. 거래: '판매'|'면세전용'|'비영업용승용차전용'|'타사업장반출'|'개인적공급'|'사업상증여'|'폐업시잔존'. 감가상각: {구분:'건물'|'구축물'|'기타', 취득가액, 취득일, 공급일} → 간주시가 = 취득가액 × (1 − 체감률 × 경과과세기간수), 체감률 건물·구축물 5%·기타 25%. 취득구분(선택): '자기매입'(기본) | '사업양수'(사업양도로 취득, 양도자가 매입세액 공제받은 재화 — 제10조1항2호) | '수출영세율'(영세율 적용받은 재화 — 제10조1항3호). '사업양수'·'수출영세율'이면 매입세액공제가 False여도 간주공급 대상(시가·감가상각 간주시가 그대로). 양수 재화의 경과 과세기간은 사업을 양도한 자가 당초 취득한 날부터 셈 — 감가상각.취득일에 양도자의 당초 취득일을 입력(부가46015-1921, 1999.7.3.). 개인적공급: 시가(감가상각 간주시가) 전액 과세. 사용인에게 준 경조사·설날·추석·창립기념일·생일 등 재화만(영 제19조의2 3호) 목별로 사용인 1명당 연간 10만원 한도, 초과액만 과세 — 사용인_구분('경조사'|'설날·추석'|'창립기념일·생일', '명절'·'생일' 등도 됨), 인원(선물 받은 사용인 수, 시가는 그 합계), 1인당_연간금액(이 선물을 포함한 그 목의 1인당 연간 누계, 앞서 준 같은 목 선물 포함)을 넣는다. 목: 2024년 제2기부터 가 경조사·나 설날·추석·다 창립기념일·생일 등, 2020년 제2기~2024년 제1기는 설날·추석·창립기념일·생일이 한 목. 2020년 제1기 이전은 미지원. 사업상증여: 견본_광고선전물이 True면 0(법 제10조제5항 단서). 반출='국외'이면 해외 무상 반출로 수출 영세율(법 제21조제2항제1호), 해당 항목 과세표준은 영세율_과세표준으로 가고 과세표준(10%)에서는 제외. 결과: {결과: {과세표준, 영세율_과세표준}, 계산: {항목별: [{항목, 거래, 과세표준, 제외사유?, 영세율?}], 판단: [{항목, 결론, 근거}]}}. 규칙: '판매'·'타사업장반출'은 금액 그대로 과세(매입세액 공제 여부와 무관). 나머지 간주공급은 매입세액 공제 여부가 False면 0(자기매입만, 사업양수·수출영세율은 제외), True면 시가(또는 감가상각 간주시가) 과세.

Inputs: items (required), period (required).

vat_exempt_use_deemed_supplyA
Read-onlyIdempotent

VAT deemed supply on conversion to exempt use: tax base (면세전용 간주공급). 면세전용 간주공급 과세표준(부가법 제10조제1항, 부가령 제66조). 언제: 과세사업에 쓰던 재화를 면세사업에 전용할 때 간주공급 과세표준을 계산한다. 입력: 전용일(YYYY-MM-DD) → use_date, 전용 범위(전부/일부) → mode, 자산 목록 [{구분, 취득일, 취득가액, 매입세액공제, 시가, 취득구분}] → assets, 일부일 때 공급가액 {taxable, exempt} → supplies. 취득구분(선택): '자기매입'(기본) | '사업양수'(사업양도로 취득, 양도자가 매입세액 공제받은 재화 — 제10조1항2호) | '수출영세율'(영세율 적용받은 재화 — 제10조1항3호). '사업양수'·'수출영세율'이면 매입세액공제가 False여도 간주공급 대상(시가·감가상각 간주시가 그대로). 사업양수 재화의 취득일에는 사업을 양도한 자가 당초 취득한 날을 입력(부가46015-1921, 1999.7.3.). 결과: 과세표준·계산(자산별 경과과세기간수·간주시가·제외사유, 면세비율)·판단, 근거(부가가치세법 제10조제1항, 시행령 제66조).

Inputs: mode (required), assets (required), use_date (required), supplies.

vat_foreign_currency_baseA
Read-onlyIdempotent

VAT foreign currency tax base conversion at a user-given exchange rate (외화 과세표준 환산). 외화 대가 부가가치세 과세표준 환산 — 외화 거래(수출대금·대리납부 외화 지출 등)의 원화 과세표준을 사용자가 준 환율로 계산한다(환율 조회 없음). 언제: 외화로 공급대가를 받거나 외화를 지급하는 거래에서 원화 과세표준을 구할 때. 환율 조회는 하지 않고 사용자가 입력한다. 입력: · context — '공급'(기본, 영 제59조: 공급시기 전 환가분은 환가액, 이후는 공급시기 환율) | '대리납부'(영 제95조제3항: 원화매입이면 지급일 매도율, 보유외화면 지급일 기준환율). · items — 항목 목록. 각 항목: - 공통: 이름?(선택), 외화금액(숫자, >0, 필수), 통화?(str, 기본 'USD'). - 공급 맥락: 공급시기(YYYY-MM-DD, 필수), 공급시기_환율?(숫자 — 미환가분이 있으면 필수), 환가?([{환가일, 외화금액, 원화금액}] 선택). - 대리납부 맥락: 지급일(YYYY-MM-DD, 필수), 지급방식('원화매입'|'보유외화', 필수), 지급일_환율(숫자, 필수 — 원화매입이면 매도율, 보유외화면 기준환율). 결과: 과세표준_합계·항목별[{이름, 통화, 외화금액, 환가분{외화,원화}, 미환가분{외화,환율,원화}, 과세표준, 적용}]·판단·근거. 근거: 부가가치세법 제29조제3항, 시행령 제59조(공급) 또는 시행령 제95조제3항(대리납부).

Inputs: items, context.

vat_input_tax_deductionA
Read-onlyIdempotent

VAT input tax deduction: deductible vs non-deductible items (매입세액 공제). 매입세액 공제 판정(부가가치세법 제38조·제39조·제46조, 시행령 제75조). 언제: 부가가치세 신고에서 매입세액 중 공제·불공제 금액을 항목별로 판정할 때. 입력: period=과세기간('YYYY-1'|'YYYY-2'), filing='예정'|'확정', items=[{항목, 증빙, 공급가액?|공급대가?, 성격, 공급자?, 공급시기?, 발급일?, 실제공급가액?}]. 증빙: '세금계산서'|'신용카드'|'현금영수증'|'영수증'. 성격: '일반'|'접대'|'비영업용승용차'|'토지관련'|'면세사업'|'사업무관'. 공급자: '일반과세자'(기본)|'간이과세자_세금계산서'|'간이과세자_영수증'. 공급가액·공급대가 중 하나 이상 필요. 공급가액만 있으면 ×10%, 공급대가만 있으면 ×10/110. 실제공급가액이 있으면 필요적 기재사항 착오로 실제분 공제(영 제75조2호). 결과: {결과: {공제매입세액, 불공제매입세액}, 계산: {항목별: [{항목, 세액, 공제세액, 불공제사유?}], 판단: [{항목, 결론, 근거}]}}. 판단 순서: (1)성격별 불공제(접대·비영업용승용차·토지관련·면세사업·사업무관) → (2)증빙 '영수증' → (3)신용카드·현금영수증 + 간이과세자_영수증 → (4)세금계산서 발급시기(지연수취 가산세) → (5)실제공급가액(착오 기재). 확정신고기한 뒤 발급분(영 제75조7호)은 공급시기별로 다름 — 2019.2.11.까지 공급분은 불공제(7호 없음), 2019.2.12.~2022.2.14. 공급분은 6개월 이내, 2022.2.15. 이후 공급분은 1년 이내 발급분만 공제로 세되 수정신고·경정청구 또는 결정·경정이 있는 경우에 한한다는 주의를 붙인다. 간이과세자가 발급한 신용카드매출전표·현금영수증(공급자 '간이과세자_세금계산서')은 2021.7.1. 이후 공급분부터 공제, 2021.6.30.까지 공급분은 불공제(공급시기가 없으면 과세기간으로 판단: 2021년 제1기까지 불공제).

Inputs: items (required), filing (required), period (required).

vat_return_generalA
Read-onlyIdempotent

General taxpayer VAT return aggregation up to net payable or refundable tax (일반과세자 부가가치세 신고서). 일반과세자 부가가치세 신고서(별지 제21호서식) 집계 — 부품 도구 결과를 받아 (30) 차감ㆍ가감 납부(환급)세액까지 합산. 새 세법 판단은 하지 않음. 언제: 부가가치세 확정·예정신고 시 부품 도구(vat_input_tax_deduction·common_input_tax·vat_bad_debt_credit·vat_card_sales_credit·invoice_penalty_bundle·late_payment_penalty)의 계산 결과를 받아 별지 제21호서식 제1쪽 신고내용 순서로 합산해 (30) 차감ㆍ가감하여 납부할 세액(환급액)을 낸다. 입력: · 매출: sales_invoice(세금계산서 발급분), sales_buyer_invoice(매입자발행 세금계산서), sales_card_cash(신용카드ㆍ현금영수증 발행분), sales_other(기타 매출)·deemed_supply(간주공급, vat_deemed_supply_items 결과), sales_zero_invoice·sales_zero_other(영세율), prelim_omitted_sales(예정신고 누락 매출). · 매입: purchase_invoice(세금계산서 수취분 일반매입, common_input_tax 포함 전부), import_vat_deferred(수출기업 수입분 납부유예), purchase_invoice_fixed(고정자산매입), prelim_omitted_purchase(예정신고 누락 매입), purchase_buyer_invoice(매입자발행 세금계산서 수취), purchase_card_cash(신용카드ㆍ현금영수증 수취분, 그 밖의 공제매입세액 계산용), purchase_deemed(의제매입세액, vat_deemed_input_credit 결과), purchase_other_credit(그 밖의 공제매입세액), recovered_input(변제대손세액). · 공제받지 못할 매입세액: nondeductible(vat_input_tax_deduction 결과), common_nondeductible(common_input_tax 결과). · 경감·공제: other_credit(그 밖의 경감·공제세액), card_sales_credit(vat_card_sales_credit 결과), e_filing(전자신고 여부)·filed_on(신고일, 생략하면 확정신고 기한) → 전자신고세액공제는 조세특례제한법 시행령 제104조의5 제3항·제4항 연도표로 계산(예정신고 0). · 그 밖: small_biz_reduction(소규모 감면), prepaid_refund_pending(예정신고 미환급세액), prepaid_assessed(예정부과 고지세액), occasional_assessed(수시부과세액), prepaid_by_transferee·prepaid_buyer_special·prepaid_by_card_company(대리납부 등 기납부세액), penalties(가산세 목록 — invoice_penalty_bundle·late_payment_penalty 결과). · ledger(선택): 원장형 입력. 공급·매입·세액 항목명은 어휘 원장 허용값(공급: 세금계산서 발급분·매입자발행 세금계산서·신용카드·현금영수증 발행분·기타 매출·간주공급·영세율 세금계산서 발급분·영세율 기타·예정신고 누락 매출; 매입: 세금계산서 수취분 일반매입·고정자산·예정신고 누락 매입·매입자발행 세금계산서 수취·신용카드·현금영수증 수취분; 세액: 의제매입세액·그 밖의 공제매입세액·변제대손세액·공제받지 못할 매입세액·공통매입세액 면세사업분·대손세액·수입분 납부유예). ledger를 주면서 같은 항목의 scalar 입력을 0이 아닌 값으로 주면 error. 서식 엑셀: export_workbook에 이 call을 넣으면 '부가 별지21 신고서' 시트(제1쪽 신고내용 (1)(30), 금액 칸은 입력 이름, 세액·합계는 수식, 도구 값 대조)가 나옴 — 20162024년 과세기간과 2025년 제1기 예정신고는 그 해 신고서 판(칸 번호 (26)·(27)까지)의 '부가 별지21 신고서 YYYY판' 시트로 나옴. 결과: {결과: {과세표준·영세율_과세표준·매출세액·대손세액_가감·매출세액_합계·매입세액·공제받지못할_매입세액·매입세액_차감계·납부환급세액·경감공제세액·소규모감면세액·예정신고미환급세액·예정고지세액·수시부과세액·기납부세액_기타·가산세액계·차가감_납부세액·납부세액·환급세액}, 서식: {(1)~(30) 서식 원문 칸 이름}, 단계별_계산, 근거, 주의?, 원장대조?}.

Inputs: year (required), period (required), kind, ledger, +32 more.

vat_reverse_chargeA
Read-onlyIdempotent

VAT reverse charge: payment by proxy for services from foreign suppliers (대리납부). 국외사업자 용역등 대리납부(부가가치세법 제52조제1항·제2항, 시행령 제95조제1항·제2항). 언제: 국내사업장이 없는 비거주자·외국법인(또는 국내사업장이 있어도 비귀속)으로부터 용역등을 공급받아 대리납부할 때. 입력: · year — 귀속연도(2016~2026). · items — 항목 목록. 각 항목: - 이름?(선택), 공급자('국내사업장_없음'|'국내사업장_있음_비귀속'|'국내사업장_있음_귀속', 필수), - 대가(원, int≥0, 필수 — 외화는 vat_foreign_currency_base로 먼저 환산), 지급일(YYYY-MM-DD, 필수), 용도('면세'|'과세'|'불공제'|'공통'|'비사업', 필수). · taxable_supply·exempt_supply — 용도 '공통' 안분용 과세기간 공급가액(원, 선택 — 둘 다 필요). 결과: 대리납부세액_합계·항목별[{이름, 대상(bool), 사유, 과세표준, 세액, 기한_법정, 기한_적용}]·판단·주의·근거. 근거: 부가가치세법 제52조제1항·제2항, 시행령 제95조제1항·제2항. 전자적 용역(제53조의2 간편사업자등록)은 범위 밖.

Inputs: year (required), items (required), exempt_supply, taxable_supply.

vat_simplified_taxpayerA
Read-onlyIdempotent

VAT simplified taxpayer VAT payable step by step, incl. exemption from payment (간이과세자 납부세액). 간이과세자 납부세액 전 과정(과세표준·납부세액·매입공제·카드 발행세액공제·가산세·납부의무 면제 판정·차가감 납부세액). 언제: 간이과세자 부가가치세 신고 시 납부세액을 단계별로 계산한다. 입력: 공급대가(부가세 포함, 원) → supply_incl_vat, 업종별 부가가치율(소수, 예: 0.15 = 15%) → value_added_rate, 세금계산서 등 수취 매입 공급대가(원) → invoice_purchase_incl_vat, 자기적립마일리지 등 결제분 공급대가(원) → mileage_supply_incl_vat, 신용카드매출전표·현금영수증 등 발급분 공급대가(원) → card_cash_receipt_supply_incl_vat, 세금계산서 미수취 매입 공급대가(원) → no_invoice_purchase_incl_vat, 직전 연도 공급대가(원) → prior_year_supply_incl_vat, 예정부과 고지·수시부과세액(원) → prepaid_tax, 적용 연도(20162026) → year. business_start(사업 개시일, YYYY-MM-DD, 선택): 제69조3항 — 해당 과세기간 중 개업했으면 개시일12.31 공급대가를 12개월로 환산해 면제 판정. closed_on(휴업·폐업·유형전환일, YYYY-MM-DD, 선택): 제69조3항 — 해당 과세기간 중 휴업·폐업·유형전환이 있으면 1.1~closed_on 공급대가를 12개월로 환산해 면제 판정. industries(겸영 업종 목록, 선택): [{value_added_rate, supply_incl_vat}] — 제63조2항 후문, 공급대가·부가가치율 대신 업종별 납부세액 = Σ(공급대가 × 부가가치율 × 10%). supply_incl_vat와 industries를 같이 주면 error. 연도(2020.12.22. 개정, 2021.7.1. 시행 — 부칙 제8조·제10조·제12조): 2021.6.30.까지 공급받은 매입분 공제는 매입세액(공급대가 × 10/110) × 부가가치율, 2021.7.1.부터 공급대가 × 0.5%. 세금계산서 미수취 가산세 0.5%는 2021.7.1. 이후 공급받은 분만. 카드 발행세액공제는 2021.6.30.까지 음식점업·숙박업 2.6%(food_lodging), 그 밖 1.3%. 연 한도 2017년까지 500만원, 2018년부터 1,000만원. year=2021은 상·하반기가 섞이므로 매입·카드·미수취 금액이 있으면 2021.6.30.까지분을 *_before_202107에 넣어야 한다. 업종별 부가가치율도 2021.7.1.에 바뀌었으므로 2021년은 industries로 상·하반기를 나눠 넣는다. 결과: 과세표준·납부세액·매입공제·카드공제·가산세·공제합계·예정부과세액 공제·차가감 납부세액(음수면 환급세액)·환급세액·납부의무 면제 여부·면제_판정_공급대가·환산_개월수·단계별 계산, 근거(부가가치세법 제46조·제63조·제68조의2·제69조).

Inputs: year, closed_on, industries, prepaid_tax, +12 more.

vat_supply_timingA
Read-onlyIdempotent

VAT time of supply by transaction and tax base per filing period (공급시기). 부가가치세 공급시기 판정 — 거래별 공급시기·판정 사유와 예정신고기간·과세기간별 과세표준(공급가액) 합계. 언제: 장기할부·중간지급조건부·완성도기준지급·계속적 공급·용역 완료·수출·세금계산서 선발급 거래가 어느 과세기간(예정/확정)에 들어가는지 정할 때. 공급 2016-01-012026-12-31 지원. 입력: 거래 목록(종류·인도일/완료일·대가 지급 약정·세금계산서 발급일과 대가 수령일) → transactions, 사업자 구분('일반'|'간이') → business, 조회 기간 → period(선택). 판정: 장기할부 = 2회 이상 분할 + 인도(완료)일 다음 날부터 최종 지급기일까지 1년 이상(규칙 제17·19조) → 각 약정일. 중간지급조건부 = 계약금 약정일 다음 날부터 인도(완료)일까지 6개월 이상 + 기간 안 계약금 외 분할(규칙 제18·20조) → 각 약정일, 인도(완료)일 이후 약정분은 인도(완료)일(영 제28조제3항·제29조제1항 단서). 기간은 민법 제157조·제160조(초일 불산입, 해당일 전일 만료, 해당일 없으면 말일). 요건 미충족이면 인도(완료)일 일괄. 선발급 특례(법 제17조) 공급분 연도별 — 2017까지 제1항은 '동시에' 발급, 제3항은 청구·지급시기 별도기재+30일 모두 / 2018 제3항 별도기재+(30일 또는 과세기간 내 지급 확인) / 20192021 제3항 30일 약정 또는 과세기간 내 공급시기 도래+지급 확인 / 2022~ 지급 확인 요건 삭제(부칙 제6조). 장기할부·계속적 공급은 제4항(영 제30조) 발급일. 세금계산서 짝짓기(발급일 순): 공급시기 당일 발급분, 수령일이 있으면 이미 지난 공급시기분(지연발급)을 먼저 채우고 공급시기는 그대로 — 남는 금액만 뒤 공급시기의 선발급 특례로 판정. 대가 한 부분은 세금계산서 한 번만 짝지음. 미지원(입력 확인 필요): 상품권·가공·무인판매기·보세구역·위탁판매·간주공급, 선적일 외 수출(중계무역·외국인도 등), 부동산 임대·선불 연회비(영 제29조제2항), 외국항행용역, 폐업일 의제, 공급시기 후 발급 가산세. 결과: 기간별_과세표준·조회기간_과세표준, 거래별 공급시기·금액·신고기간·사유·근거, 판단(요건 경계 계산).

Inputs: transactions (required), period, business.

vat_tax_base_adjustmentsA
Read-onlyIdempotent

VAT tax base adjustments for returns, discounts, rebates, bad debts and points (부가가치세 과세표준 조정). 과세표준 조정 — 반품(환입)·에누리·할인·장려금·대손금, 마일리지·포인트 결제 거래의 공급가액(부가가치세법 제29조, 시행령 제61조·제70조). 언제: 반품·할인·장려금·포인트 결제가 있는 과세기간의 부가가치세 과세표준을 구할 때. 입력: 과세기간 → period, 조정 전 매출 공급가액 → sales, 조정 항목 → adjustments, 마일리지등 결제 거래 → mileage_sales, 부가세 포함 여부 → vat_included. 계산: 과세표준 = sales − 공급가액에 포함하지 않는 금액 + 마일리지등 결제 거래의 공급가액. 공급가액에 포함하지 않음(제29조제5항): 매출에누리, 환입, 도달 전 파손·훼손·멸실, 약정기일 전 수령 할인, 연체이자, 공급과 직접 관련 없는 보조금. 과세표준에서 공제하지 않음(제29조제6항): 판매장려금, 대손금. 마일리지등 결제(시행령 제61조 9호·10호, 2017.4.1. 이후 공급분): 공급가액 = 마일리지등 외 결제액 + 자기적립 외 마일리지등 결제분에 대해 제3자에게서 보전받는 금액. 자기적립마일리지등 결제분은 포함하지 않음. 자기적립 외 마일리지등 결제분을 보전받지 않고 자기생산·취득재화를 공급했거나(자기생산취득재화=True) 특수관계인에게서 부당하게 낮게 보전받으면(특수관계_저가보전=True) 시가가 공급가액(시가 입력 필요). 연도: 제29조제5항·제6항은 2016~2026 같음. 마일리지등 규정은 2017.4.1. 공급분부터(대통령령 제27838호 부칙 제1조·제2조). 2017.3.31.까지 공급분은 적립 마일리지 결제액을 에누리액으로 본 대법원 2015두58959 전원합의체·2019두58766 기준 금액과 구 시행령 제61조제4항 문언(마일리지 상당액 포함) 기준 금액을 함께 돌려줌. 결과: 과세표준·조정 전 매출·차감 합계·마일리지등 거래 공급가액·매출세액, 계산(항목별), 판단·근거.

Inputs: period (required), sales, adjustments, vat_included, +1 more.

verify_workbookA
Idempotent

After saving an Excel workbook (.xlsx file or spreadsheet — workings or a report) you built yourself, call this tool (직접 만든 엑셀 검산): it checks the amount cells against calculation tool results and adds one check sheet named 'Tool check'. Point each cell at a call by the call id that every calculation result carries, 호출_id (checks=[{cell, call}]) — no need to repeat tool and args — or pass auto=true to match every amount cell against the calls made so far. 직접 만든 Excel을 저장한 뒤 이 도구를 부른다 — 금액 칸을 계산 도구 결과와 대조해 검산 시트 한 장을 붙인다. 계산 도구 결과마다 붙는 호출_id를 checks의 call에 적으면 되고(tool·args를 다시 적지 않음), 일치·불일치(두 값과 차이)와 '대조 안 한 금액'(어떤 대조에도 걸리지 않고 대조된 칸과 수식으로 이어지지도 않는 금액 칸)을 돌려준다. 원인을 판단하지 않는다. 언제: 계산 근거·보고용 통합 문서를 직접 만들어 저장한 뒤 반드시, export_workbook이 만든 파일을 다른 프로그램으로 다시 저장해 계산값이 지워졌을 때, 받은 엑셀의 세액이 계산 도구 결과와 맞는지 볼 때. 입력: path — 통합 문서(.xlsx) 절대 경로. 원본은 고치지 않는다. checks — [{cell, call, key, tolerance, label}]. 금액 칸마다 하나씩 — 시나리오마다 그 시나리오를 계산한 호출의 호출_id로. 예(지어낸 값): {cell: "배당!C9", call: "c7"} — c7 결과의 숫자 값 가운데 칸 값과 같은 키를 찾아 대조(같은 값의 키가 여럿이면 모두 적고, 없으면 불일치로 가장 가까운 키와 차이). {cell: "배당!C9", call: "c7", key: "원천징수세액"} — 키를 정해 대조. 호출_id 기록이 없으면(서버를 다시 시작함, 오래된 호출) 그 줄만 '도구 호출 기록 없음 — tool+args로 다시'. {cell: "배당!C9", tool: "nonresident_withholding", args: {…}, key: "원천징수세액"} — 호출_id 없이: 도구를 지금 호출해 대조(같은 tool + args는 한 번만 계산). {cell: "배당!C9"} — 칸만: 보관된 모든 호출 결과에서 같은 값을 찾음(자동). 값이 같은 호출이 여럿이면 후보로 나열. auto — true면 금액 칸 전체(값 1,000 이상, 날짜·비율·다른 칸을 그대로 가리키는 링크 제외)를 보관된 호출 결과와 맞춰 본다. 자동으로 맞춘 줄은 방식이 '자동(값 일치)'이고 요약의 자동_일치로 따로 센다 — 같은 숫자가 우연히 일치할 수 있으므로 중요한 칸은 call로 명시한다. 입력을 그대로 되돌려준 값은 자동 대조에서 뺀다. annotate — true(기본): 사본에 '검산'(Tool check) 시트 한 장 — 한 줄 요약, 대조 표(칸·항목·통합 문서 값·도구 값·판정·근거 번호, 차이 열은 불일치가 있을 때만), 근거(번호마다 한 번), 대조 안 한 금액(시트마다 한 줄과 대표 칸 — 전체 목록은 결과.대조_안_한_금액), 부가 점검(문제가 있을 때만). 원래 시트는 그대로이고 사본의 모든 수식 칸에 값을 채운다 — 휴대폰·미리보기에서도 보인다. output_dir·filename — 사본 위치(기본: 원본 폴더, '<원본 이름>verified.xlsx'). lang — 'ko'(기본)·'en'(결과 키는 용어집으로 'Tax base (과세표준)', 근거는 영문 인용. 용어집에 없는 것은 국문 그대로). labels — {원래 키 또는 근거 구절: 표시할 글}. 결과.번역_없음에 나온 것을 영문으로 넣어 다시 호출하면 그 글로 적는다. 결과: 결과.요약 — {대조, 일치, 불일치, 읽지_못함, 도구_오류, 자동_일치, 자동_불일치, 대조_안_한_금액}. 대조~도구_오류는 명시 대조(call·tool을 적은 줄), 자동*은 값으로 찾은 줄. 결과.대조 — 전체 대조 줄 [{칸, 항목, 방식('명시'·'자동(값 일치)'), 도구, 호출, 키, 통합_문서_값, 도구_값, 차이, 판정, 근거, 후보}]. 결과.불일치 — 그 가운데 불일치 줄. 결과.대조_안_한_금액 — [{시트, 칸, 항목, 값}]: 계산 도구 대조를 거치지 않은 금액(사용자에게 밝힐 것). 결과.대조_안_한_금액_시트별 — {시트: 칸 수}. 대조를 거친 것으로 보는 칸은 일치한 칸, 그 칸의 수식이 가리키는 칸, 입력 숫자, 그런 칸들의 링크·합·차. 그 밖의 수식 칸 가운데 값이 1,000 이상인 칸(날짜·비율 서식 제외)이 여기에 온다. 결과.부가_점검 — 저장된 값이 없는 수식 칸 수, 저장된 값과 다시 계산한 값이 다른 칸, 원 미만 소수가 남은 금액 칸, 오류 칸, 수식 열에 직접 적은 숫자, 값을 계산하지 못한 수식 칸. 결과.사본 — 대조 결과 시트를 붙인 사본의 절대경로(annotate=true). 결과.다음 — 다음에 할 일 한 줄. 한계 — 금액 판정 기준, 수식 모양으로 정하는 범위, 호출_id 보관 범위, 자동 대조의 우연 일치. lang='en'일 때만(사본을 만들었을 때): 결과.lang, 결과.번역_없음, 결과.번역_없음_안내. labels를 줬을 때: 결과.labels_적용, 시트에 없는 키는 warnings. lang='en'이면 결과 JSON의 키도 영어 — result.summary{checked, matched, mismatched, unreadable, tool_errors, auto_matched, auto_mismatched, unchecked_amounts}·result.checks[{cell, item, method, tool, call, key, workbook_value, tool_value, difference, verdict, basis}]·result.mismatches·result.unchecked_amounts·result.copy·result.next_step, basis·limits. 근거 — '통합 문서의 칸 값과 계산 도구 결과 대조(세무 자문 아님)'.

Inputs: path (required), auto, lang, checks, +4 more.

wage_income_taxA
Read-onlyIdempotent

Employee earned income tax: wage deduction, calculated tax and determined tax (근로소득세). 근로소득공제·산출세액·근로소득세액공제·결정세액(참고). 언제: 근로소득만 있는 근로자의 연말정산에서, 또는 '연봉 얼마면 세금 얼마'를 어림할 때. 입력: 총급여(원, 비과세 제외) → gross_pay, 귀속연도(2016~2026) → year, 종합소득 과세표준(원, 모르면 생략) → tax_base. 결과: 근로소득공제·근로소득금액·과세표준·산출세액·근로소득세액공제·결정세액(참고: 표준세액공제 13만 원만 적용)·지방소득세, 근거(소득세법 제47조제1항·제55조·제59조·제59조의4제9항). Wage income: employment income deduction, computed tax and wage tax credit.

Inputs: year (required), gross_pay (required), tax_base.

withholding_late_payment_penaltyA
Read-onlyIdempotent

Withholding tax late payment penalty tax: 3% plus daily portion, 50% cap (원천징수 납부지연가산세). 원천징수 등 납부지연가산세(국세기본법 제47조의5제1항) — 미납세액 3% + 일수분(고지 전 10% 한도) + 납부고지 후분, 전체 50% 한도. 언제: 원천징수의무자(납세조합·부가가치세 대리납부자 포함)가 원천징수세액을 법정납부기한까지 내지 않았거나 적게 냈을 때. 입력: 미납·과소납부 세액(원) → unpaid_tax, 법정납부기한(YYYY-MM-DD) → due, 고지 전 납부일 또는 납부고지일(YYYY-MM-DD) → until, 납부고지가 있었으면 지정납부기한(납부고지서에 따른 납부기한) → notice_due, 실제 납부일 → paid_on, 독촉비용(원) → dunning_fee, 납부고지서별·세목별 세액(원, 생략 가능) → notice_amount, 세목(국세 national·지방소득세 특별징수분 local) → tax. 계산: 1호 미납세액 × 3% + 2호 미납세액 × 일수 × 1일 이율(시행령 제27조의4: 1만분의 3 → 2019.2.12.부터 10만분의 25 → 2022.2.15.부터 10만분의 22, 기간 안분), 1호 + 2호(고지 전)는 미납세액의 10% 한도. 2호 일수: until이 2026.7.1. 이후면 개정(법률 제21212호) — 법정납부기한 다음 날부터 납부고지일(고지 전 납부면 납부일)의 전날까지. 그 전이면 종전 — 납부일까지, 고지가 있으면 '납부고지일부터 납부고지서에 따른 납부기한까지' 제외라 고지일 전날까지. 고지 후(지정납부기한 다음 날부터 납부일): 지정납부기한이 2026.6.30. 이전에 지났으면 종전 규정(법률 제21212호 부칙 제4조) — 2호 일수분(납부일까지, 제4항 5년 한도), 아니면 개정 3호 — 미납세액 × 지정납부기한 다음 날부터 납부일 전날까지 경과 개월 수(제4항 5년 = 60개월 한도) × 월 1만분의 67(영 제27조의4제2항) + 4호 독촉비용. 제5항: 납부고지서별·세목별 세액 150만원 미만이면 고지 후분(개정 3호·4호, 종전 지정납부기한 후 2호 일수분) 없음. 전체는 미납세액의 50% 한도. 연도: 2020.1.1. 전 납세의무 성립분(지급일 기준, 법률 제16841호 부칙 제21조)은 종전 규정 — 3% + 납부기한 다음 날부터 자진납부일 또는 납세고지일까지 일수분, 10% 한도. 고지 후분은 구 국세징수법 가산금 대상이라 계산하지 않음. 제5항 소액 기준: 2021.12.31.까지의 날은 100만원 미만, 2022.1.1.부터의 날은 150만원 미만 — 지정납부기한이 2021년 이전이고 고지세액이 100만원 이상 150만원 미만이면 2021.12.31.까지의 날만 고지 후분을 계산(법률 제18586호 부칙 제7조). 일반 납부지연가산세(제47조의4, 3% 없음·한도 없음)는 late_payment_penalty. 지방소득세 특별징수분(tax='local', 지방세기본법 제56조 — 국세 가산세의 10%로 어림하지 않고 따로 계산): 미납 지방소득세 × 3% + 일수분(법정납부기한 다음 날부터 자진납부일 또는 납세고지일까지, 끝날 포함), 합계 10% 한도. 1일 이율(지방세기본법 시행령 제34조): 1만분의 3 → 2019.1.1.부터 10만분의 25(그 전에 납부기한이 지난 분은 종전 이율 — 대통령령 제29436호 부칙 제2조) → 2022.6.7.부터 10만분의 22(기간 안분 — 대통령령 제32665호 부칙 제2조). 국세와 바뀐 날·경과조치가 다르다. 2024.1.1. 이후 원천징수분(법률 제17768호 부칙 제6조)은 납세고지서에 따른 납부기한 뒤 2호의2(세액 × 1만분의 66, 그 납부기한이 2025.1.1. 이후) + 3호(1개월이 지날 때마다 월 1만분의 66, 60개월 한도, 납세고지서별·세목별 45만원 미만 제외)를 더하고 전체 50% 한도. 그 전 원천징수분의 고지 후분은 지방세징수법 가산금·중가산금이라 계산하지 않음. dunning_fee는 쓰지 않음. 결과에 기간별 이율·끝수 근거(지방세기본법 제59조)를 적는다. 지원 안 함: 제3항 적용 제외(주한미군·국가·지방자치단체 등) 판단, 고지 후 일부 납부(분할 납부) — 미납세액 전부를 paid_on에 낸 것으로 계산. until이 due와 같은 날(기한 당일 납부)이면 가산세 0. due가 토·일·공휴일이면 주의(국세기본법 제5조제1항 기한 연장은 자동 반영 안 함 — 다음 영업일을 due로). 결과: 가산세·3%분·일수분·10% 한도·일수·고지후분(종전 일수분 또는 개정 3호)·경과 개월·독촉비용·50% 한도·적용 규정, 근거(국세기본법 제47조의5, 시행령 제27조의4, 법률 제21212호 부칙). Withholding late-payment penalty (3% + daily, 10% cap before notice; after notice daily (old) or monthly 0.67% (from 2026-07-01); 50% overall cap). Set tax='local' for the local income tax collected together with the withholding (Framework Act on Local Taxes Art. 56).

Inputs: due (required), until (required), unpaid_tax (required), tax, +5 more.

withholding_returnA
Read-onlyIdempotent

Monthly withholding tax status return aggregation by income code (원천징수이행상황신고서). 원천징수이행상황신고서(소득세법 시행규칙 별지 제21호서식 제1쪽) 집계 — 소득 코드별 인원·총지급액·징수세액을 넣으면 가감계, 총합계, 조정환급, 납부세액을 서식 칸대로 계산. 언제: 한 달치 원천징수 내역을 이행상황신고서로 모으거나, 이미 낸 신고서가 지급 내역과 맞는지 대조할 때. 입력: 귀속연도·귀속월 → year·month, 지급월 → paid_month, 코드별 줄 → lines, 전월 미환급세액 등 환급 조정 → prior_unrefunded·prior_refund_claimed·trust_refund·other_refund·refund_claim, 신고·제출일 → filed_on. 서식 선택: 귀속연도가 아니라 신고·제출일 기준(각 개정령 부칙의 서식 적용례). 2016.1.1.~2026.3.19. 신고는 그날 시행 중인 서식의 칸(분납 A05·A06은 2016.2.25.부터, 종교인 A43·A44는 2018.1.1.부터, 가상자산 A49는 2021.3.16.부터, 금융투자소득 A71은 2022.3.18.~2024.12.31., 인적용역 A59는 2023.12.29.부터). 2026.3.20. 이후 신고는 <개정 2026. 3. 20.> 서식 — 사업소득 A27·A28 칸, 징수세액 가감계 A30 = A25 + A28. 2026.5.22. 개정은 제4쪽만이라 제1쪽 집계는 같음. 계산: 근로·퇴직·사업·기타·연금소득은 가감계(A10·A20·A30·A40·A47) 기준. 환급할 세액은 총합계에 넣지 않고 일반환급으로 모아, 조정대상 환급세액을 납부할 세액에 코드 순서대로 충당한 뒤 남은 금액이 납부세액. 세액 자체는 계산하지 않음 — 소득별 원천징수세액은 withholding_tax(거주자), nonresident_withholding(비거주자), wage_income_tax 등으로, 가산세는 withholding_late_payment_penalty로 구해 넣는다. 비거주자 개인의 인적용역·임대·사용료소득은 사업소득 칸(A25)에, 외국법인분은 법인원천 칸(A80)에 합산(줄에 비거주자=true를 주면 안내). 결과: 귀속·지급연월, 총지급액, 징수세액, 가산세, 당월조정환급세액, 납부세액, 차월이월 환급세액, 계산(코드별 행·환급세액 조정), 판단·근거·주의. export_workbook에 넣으면 '원천 별지21 이행상황신고서' 시트. 범위 밖: 2016.1.1. 전 신고분, 부표, 반기별 납부, 수정신고서 표기, 지방소득세. 서식 엑셀 시트는 2025.3.21. 서식 신고분만 만듦.

Inputs: year (required), lines (required), month (required), filed_on, +6 more.

withholding_taxA
Read-onlyIdempotent

Domestic withholding tax amount on interest, dividends, business and other income (원천징수세액). 국내 원천징수세액(소득세분). 언제: 이자·배당·사업·기타소득 등을 지급할 때 원천징수할 소득세액을 구한다. 입력: 소득 종류(이자·배당·비영업대금·사업·기타·봉사료·일용·비실명·외국인직업운동가·온투업이자) → kind, 지급액(원) → amount, 지급연도(20162026) → year, 외국인직업운동가 계약기간 3년 초과 여부 → contract_over_3_years, 지급일(선택) → paid_date, 부가가치세법 제26조제1항제15호 인적용역 계속·반복 공급 대가 여부 → continuous_personal_service. 소액부징수(제86조제1호): 원천징수세액 1천원 미만이면 징수하지 않음 — 이자소득은 제외(20162026 같음), 2024.7.1. 이후 지급하는 부가가치세법 제26조제1항제15호 인적용역 계속·반복 공급 사업소득도 제외(법률 제19933호 부칙). 연도: 비실명 38%(2017)·40%(2018)·42%(20192022)·45%(2023~), 외국인직업운동가 3%(2018)·20%(20192024는 계약기간 3년 이하만, 2025~ 제한 없음), 온투업이자 25%(2019)·14%(2020). 결과: 원천징수세액·적용 세율, 근거(소득세법 제129조). 지방소득세 10% 별도. 비거주자·외국법인은 nonresident_withholding 사용. 국내 withholding tax (소득세분) on interest, dividends, business income, etc.

Inputs: kind (required), amount (required), year, paid_date, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 142 tools

    Disambiguation2/5

    The tool set contains many overlapping pairs with unclear boundaries: entertainment_limit vs entertainment_adjustment vs missing_receipt_disallowance, withholding_late_payment_penalty vs late_payment_penalty, vat_simplified_taxpayer vs simplified_vat_return, vat_common_input_allocation vs common_input_tax, employment_increase_credit vs integrated_employment_credit, minimum_tax vs minimum_tax_adjustment, and tunnelling_gift vs tunnelling_gift_nts. Descriptions often clarify scope, but with 142 tools an agent will frequently struggle to pick the right variant.

    Naming Consistency3/5

    Most names use snake_case and are readable, but the convention is mixed: some are verb_noun (find_tool, export_workbook, verify_workbook), many are noun phrases (income_tax, corporate_tax, vat_input_tax_deduction), and prefixes vary across domains (vat_, nonresident_, foreign_, cfc_, kr_, ksic_). It is not chaotic, but there is no predictable single pattern across the whole set.

    Tool Count1/5

    142 tools is far beyond an appropriate scope for a single MCP server and will overwhelm tool selection, context windows, and maintenance. Even for the broad Korean tax domain, this is an extreme count compared with the 3-15 typical well-scoped range.

    Completeness4/5

    The surface is unusually broad, covering corporate tax, VAT, income tax, inheritance/gift, international tax, penalties, withholding, and workbook verification, so most common workflows have a corresponding tool. Some areas are explicitly out of scope or thin (e.g. local taxes, some customs/property tax areas, several required human-judgment steps), but major lifecycle coverage is present.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants and terminals to retrieve and cross-reference Korean legal sources through 10 tools built on 42 Ministry of Government Legislation APIs, covering statutes, precedents, administrative rules, ordinances, treaties, and interpretations. Adds hallucination-resistant citation verification, article impact graphs, point-in-time diffing of in-force versions, case citator checks, and applicable-law-at-the-time analysis.
      10
      4,982 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Korean tax, accounting, and finance professionals to pull statute text, delegated enforcement decrees and rules, NTS rulings, and annexes in a single lookup, and to check whether every statute or article citation in an AI draft actually exists (±verified, missing, or unverifiable), with statutory-formula calculations for items like executive severance limits and entertainment-expense caps.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Korean tax law for AI agents: search NTS rulings, court and Tax Tribunal decisions; read point-in-time statutes with the Act → Decree → Rule chain and amendment history; basic rules and execution standards; 96 tax treaties with withholding rates; forms and schedules; and verify citations in drafts. Fact-pattern comparison is done by your AI (or optional on-prem/cloud Upstage Solar).
      14
      54
      4,055 PyPI
      10
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Korean real-estate tax engine: computes acquisition, property, comprehensive holding, capital gains, gift and inheritance tax, citing the statute article behind every result. Regression-tested against 991 court and tribunal rulings.
      43
      1
      AGPL 3.0