Registry entry
South Korea Year-end Tax Settlement — Report of Income Deduction & Tax Credit
Report filed by a wage & salary income earner (including foreign employees) to their withholding agent (employer) as part of Korea's annual year-end tax settlement (연말정산), declaring the personal deductions, income deductions, and tax credits the filer claims for the tax year. The withholding agent uses this report plus attached documentary evidence to compute the filer's final income tax and either collect additional tax or refund overwithheld tax. Covers income-earner identification and residency/tax-withholding-ratio elections, the statement of personal deduction for dependents (relationship, basic/elderly/disabled/single-parent/newborn status) and associated insurance/medical/education/credit-card expenditure, pension premium deduction, special income deduction (health/employment insurance, housing rental and mortgage loans), other income deductions (pension/housing-purchase savings, investment contributions), the foreign-worker-specific tax reduction/exemption pathways (inter-government agreement, technology introduction contract, Restriction of Special Taxation Act, tax treaty), tax credits (pension accounts, insurance, medical, education, donations, foreign tax credit, housing mortgage interest, monthly rent), and the additional-documents checklist covering a secondary workplace and companion statements. Sourced from the National Tax Service's own English-language 'Easy Guide for Foreigners' Year-end Tax Settlement' (2025 edition), which reproduces the Ministry of Economy and Finance's gazetted Enforcement Rule of the Income Tax Act Attached Form No. 37(1)-(3) as an official English original (not a translation) in Chapter IX 'Tax Forms'. Does not model the granular sub-matrices the source form itself breaks each aggregate deduction into (housing mortgage loan interest ceilings by borrowing year/term-length/interest-rate type; investment association contributions by contribution year and association; housing-purchase savings by product type), the companion 'Statement of Income Deduction & Tax Credit for Pension, Savings, etc.' form's own per-account line items, the separate 'Application for Flat Tax Rate for Foreign Employees' (Form 8) or 'Application for Non-Taxation & Exemption ... Under a Tax Treaty' (Form 29-2(3)) election forms (referenced here only as companion documents), the NTS Hometax simplified year-end tax settlement service's data-lookup workflow, or the withholding agent's own tax computation/withholding-receipt issuance step. Does not submit the report; the live NTS Hometax service (hometax.go.kr) and the filer's withholding agent are always authoritative (see VERIFICATION.md).
Registry entry
kr/nts/year-end-tax-settlement-income-deduction-report
Machine access
- Schema document
registry/kr/nts/year-end-tax-settlement-income-deduction-report/1.0.0/schema.jsonapplication/schema+json- Verification record
registry/kr/nts/year-end-tax-settlement-income-deduction-report/1.0.0/VERIFICATION.mdtext/markdown- Registry catalog
registry/index.jsonone record per schema id
Field reference
117 fields across 9 steps, read from the published schema.json, with names, types, requiredness, and validation as the document states them. The live government form remains the authoritative source.
Income Earner Details
-
incomeEarnerNamestring requiredName of income earner
length: 0–100classification: pii -
residentAlienRegistrationNumberstring requiredThe income earner's Korean resident registration number, or alien registration number for a foreign national.
length: 0–20classification: pii -
placeOfWorkstring requiredPlace of work
length: 0–200 -
businessRegistrationNumberstring requiredBusiness registration no. (of the withholding agent/employer)
length: 0–20 -
householdHeadOrMemberenum requiredHousehold head/member
enum: head | member -
nationalitystring requiredNationality
length: 0–100 -
nationalityCodestring optionalISO country-acronym code, referenced against the NTS website's ISO country code lookup.
length: 0–10 -
lengthOfServiceStartDatedate requiredLength of service — start date
-
lengthOfServiceEndDatedate optionalLeft blank for a filer who remains employed at the end of the tax year.
-
residencyStatusenum requiredResidency
enum: resident | non_resident -
stateOfResidencestring optionalState of residence
length: 0–100 -
stateOfResidenceCodestring optionalISO country code for the non-resident's state of residence.
length: 0–10 -
changeOfPersonalDeductionItemsenum requiredIf 'same_as_last_year', a copy of the resident register does not need to be submitted.
enum: same_as_last_year | changed -
paymentInInstallmentsboolean requiredPayment in installments
-
taxWithholdingRatioenum requiredThe filer may elect to have 120%, 100%, or 80% of the monthly-withheld tax amount withheld going forward.
enum: 120 | 100 | 80
Statement of Personal Deduction, Income Deduction & Tax Credit
-
numberOfPersonsEligibleForPersonalDeductioninteger requiredNo. of persons eligible for personal deduction
range: 1–∞ -
numberOfChildreninteger optionalNo. of children (among persons eligible for personal deduction)
range: 0–∞ -
filerIsWomanboolean requiredApplies where the filer's global income tax base is 30 million won or less and the filer is a woman with no spouse who is head of household with dependants, or a woman with a spouse.
-
filerIsSingleParentboolean requiredFiler qualifies for the single-parent additional deduction
-
filerDisabilityCodeenum optional1 = disabled person under the Act on Welfare of Persons with Disabilities; 2 = wounded/disabled person under the Act on the Honorable Treatment of Persons of Distinguished Service to the State; 3 = severely ill patient needing continued treatment.
enum: 1 | 2 | 3 -
primaryDependentRelationshipCodeenum optional0 = income earner, 1 = income earner's lineal ascendant, 2 = spouse's lineal ascendant, 3 = spouse, 4 = income earner's lineal descendant, 5 = spouse's lineal descendant, 6 = sibling, 7 = person eligible for assistance, 8 = foster child.
enum: 9 values -
primaryDependentNamestring optionalPrimary dependent — name
length: 0–100classification: pii -
primaryDependentCitizenOrForeignerenum optionalPrimary dependent — Citizen/Foreigner
enum: citizen | foreigner -
primaryDependentRegistrationNumberstring optionalPrimary dependent — Resident (alien) registration no.
length: 0–20classification: pii -
primaryDependentMeetsIncomeCriteriaboolean optionalThe dependent's annual income must be 1,000,000 won or less (5,000,000 won gross wage & salary income if wage & salary income is their only income).
-
primaryDependentIsBasicDeductionboolean optionalPrimary dependent — basic deduction claimed
-
primaryDependentIsElderlyboolean optionalPrimary dependent — the elderly (70 years or older)
-
primaryDependentIsDisabledboolean optionalPrimary dependent — disabled
-
primaryDependentDisabilityCodeenum optionalPrimary dependent — disability classification code
enum: 1 | 2 | 3 -
primaryDependentIsNewbornOrAdopteeboolean optionalPrimary dependent — newborn/adoptee in the tax year
-
dependentHealthInsurancePremiumnumber optionalHealth insurance premium paid on behalf of dependents
range: 0–∞ -
dependentEmploymentInsurancePremiumnumber optionalEmployment insurance premium paid on behalf of dependents
range: 0–∞ -
dependentCoverageInsurancePremiumnumber optionalCoverage (guarantee) insurance premium paid on behalf of dependents
range: 0–∞ -
dependentCoverageInsuranceForDisabledPremiumnumber optionalCoverage insurance premium for the disabled, paid on behalf of dependents
range: 0–∞ -
dependentIndemnityInsurancePremiumnumber optionalIndemnity insurance premium paid on behalf of dependents
range: 0–∞ -
dependentGeneralMedicalExpensesnumber optionalGeneral medical expenses (self and dependents)
range: 0–∞ -
dependentInfertilityTreatmentExpensesnumber optionalInfertility treatment expenses
range: 0–∞ -
dependentPrematureBabyMedicalExpensesnumber optionalPremature babies / babies with birth defects — medical expenses
range: 0–∞ -
generalEducationExpensesnumber optionalGeneral education expenses (self and dependents)
range: 0–∞ -
specialEducationExpensesForDisablednumber optionalSpecial education expenses for the disabled
range: 0–∞ -
creditCardSpendingnumber optionalCredit card spending
range: 0–∞ -
debitCardOrPrepaidCardSpendingnumber optionalDebit card / prepaid card spending
range: 0–∞ -
cashReceiptSpendingnumber optionalCash receipt spending
range: 0–∞ -
booksAndPerformanceTicketsSpendingnumber optionalOnly applicable for filers with gross wage & salary income of 70,000,000 won or less.
range: 0–∞ -
traditionalMarketSpendingnumber optionalAmount spent in traditional markets
range: 0–∞ -
publicTransportationSpendingnumber optionalAmount spent on public transportation
range: 0–∞
Special Income Deduction
-
nationalHealthInsurancePremiumCurrentWorkplacenumber optionalNational health insurance premium (incl. long-term care insurance) — principal (present) workplace
range: 0–∞ -
nationalHealthInsurancePremiumPreviousWorkplacenumber optionalNational health insurance premium — secondary (previous) workplace
range: 0–∞ -
employmentInsurancePremiumCurrentWorkplacenumber optionalEmployment insurance premium — principal (present) workplace
range: 0–∞ -
employmentInsurancePremiumPreviousWorkplacenumber optionalEmployment insurance premium — secondary (previous) workplace
range: 0–∞ -
hasHousingRentalLoanboolean requiredFiler has a housing rental loan (from an institution or a resident)
-
housingRentalLoanRepaymentAmountnumber optionalAggregate repayment amount across the loan's principal & interest; the source form breaks this down by lender type (institution vs. resident), not modelled separately here.
range: 0–∞ -
hasLongTermHousingMortgageLoanboolean requiredFiler has a long-term housing mortgage loan
-
longTermHousingMortgageLoanInterestRepaymentnumber optionalAggregate interest-repayment amount. The source form's deduction ceiling depends on the loan's borrowing year (before/after 2012), term length (10-15/15-29/30+ years), and interest-rate type (fixed/non-deferred vs. other) — a matrix of narrower sub-categories not modelled individually here (see VERIFICATION.md).
range: 0–∞
Other Income Deductions
-
individualPensionSavingsDepositnumber optionalDeduction ceiling: 720,000 won or 40% of the deposit, whichever is less.
range: 0–∞ -
smallBusinessMutualAidDepositnumber optionalDeposits in a mutual aid fund for small enterprises and small entrepreneurs
range: 0–∞ -
housingPurchaseSavingsDepositnumber optionalAggregate of the three qualifying housing-purchase savings products (savings account for housing purchase, worker's housing purchase savings, collective savings account for housing subscription); not broken out per product here.
range: 0–∞ -
investmentAssociationContributionsnumber optionalAggregate of contributions across ventures and investment associations, which the source form breaks out separately by contribution year (2023/2024/2025); not broken out per year here.
range: 0–∞ -
employeeStockOwnershipContributionsnumber optionalContributions to employee stock ownership association
range: 0–∞ -
longTermCollectiveInvestmentSecuritiesSavingsnumber optionalPayment into long-term collective investment securities savings
range: 0–∞
Tax Reduction/Exemption (Foreign Worker)
-
foreignWorkerExemptionPurposeenum requiredDetermines which foreign-worker-specific tax reduction/exemption pathway, if any, the filer claims.
enum: inter_government_agreement | technology_introduction_contract | restriction_of_special_taxation_act | tax_treaty | none -
technologyContractOrLaborStartDatedate optionalDate of entering into a technology introduction contract, or date of first providing labor
-
exemptionExpirationDatedate optionalDate of expiration of exemption
-
taxReductionForForeignWorkerReceivedDatedate optionalTax reduction on wage & salary income of foreign workers — date of receipt
-
taxReductionForForeignWorkerSubmittedDatedate optionalTax reduction on wage & salary income of foreign workers — date of submission
-
taxReductionUnderTaxTreatyReceivedDatedate optionalTax reduction on wage & salary income under a tax treaty — date of receipt
-
taxReductionUnderTaxTreatySubmittedDatedate optionalTax reduction on wage & salary income under a tax treaty — date of submission
Tax Credits
-
retirementPensionAccountDepositnumber optionalRetirement pension account deposit (Korea Scientists & Engineers Mutual-Aid Association pension, or retirement pension under the Employees' Retirement Benefits Guarantee Act)
range: 0–∞ -
pensionSavingsDepositnumber optionalPension savings deposit
range: 0–∞ -
isaExpiredPensionAccountDepositnumber optionalDeposits in a pension account when ISA expired
range: 0–∞ -
coverageInsurancePremiumForCreditnumber optionalCoverage insurance premium (tax credit, ceiling 1,000,000 won at 12%)
range: 0–∞ -
coverageInsuranceForDisabledPremiumForCreditnumber optionalCoverage insurance premium for the disabled (tax credit, ceiling 1,000,000 won at 15%)
range: 0–∞ -
medicalExpensesForCreditnumber optionalMedical expenses for self / under-6 / 65-or-older / disabled dependents (tax credit at 15%)
range: 0–∞ -
infertilityTreatmentExpenditureForCreditnumber optionalInfertility treatment expenditure (tax credit at 30%)
range: 0–∞ -
prematureBabyExpenditureForCreditnumber optionalPremature babies / babies with birth defects — expenditure (tax credit at 20%)
range: 0–∞ -
indemnityInsuranceReceiptForCreditnumber optionalIndemnity insurance premium receipt (tax credit at 15%)
range: 0–∞ -
selfEducationExpensesForCreditnumber optionalFiler's own education fees, including graduate school (tax credit at 15%)
range: 0–∞ -
numberOfPreschoolChildreninteger optionalWhen this is 1 or more, provide preschoolChildrenEducationExpenses alongside it.
range: 0–∞ -
preschoolChildrenEducationExpensesnumber optionalPre-school children — kindergarten/private education institute fees (ceiling 3,000,000 won/person)
range: 0–∞ -
numberOfSchoolAgeStudentsinteger optionalWhen this is 1 or more, provide schoolAgeStudentsEducationExpenses alongside it.
range: 0–∞ -
schoolAgeStudentsEducationExpensesnumber optionalElementary/secondary/high school students — fees (ceiling 3,000,000 won/person)
range: 0–∞ -
numberOfUndergraduateStudentsinteger optionalWhen this is 1 or more, provide undergraduateEducationExpenses alongside it.
range: 0–∞ -
undergraduateEducationExpensesnumber optionalUndergraduate students — fees (ceiling 9,000,000 won/person)
range: 0–∞ -
disabledSpecialEducationFeenumber optionalSpecial education fee for the disabled (total amount, no ceiling)
range: 0–∞ -
politicalDonationAmountnumber optionalUp to 100,000 won is credited at 100/110; the amount above 100,000 won at 15%/25%.
range: 0–∞ -
homeCountryDonationAmountnumber optionalUp to 100,000 won is credited at 100/110; above that, 15% (general) or 30% (special disaster area).
range: 0–∞ -
specialDonationAmountnumber optionalSpecial donations — donation amount (tax credit at 15% or 30%)
range: 0–∞ -
esopGeneralDonationAmountnumber optionalGeneral donations to employee stock ownership association
range: 0–∞ -
religiousOrganizationDonationAmountnumber optionalGeneral donations to religious organizations
range: 0–∞ -
hasForeignSourceIncomeboolean requiredFiler has foreign-source income eligible for foreign tax credit
-
foreignTaxPaidForeignCurrencynumber optionalForeign tax paid (foreign currency amount)
range: 0–∞ -
foreignTaxPaidWonCurrencynumber optionalForeign tax paid (won-currency equivalent)
range: 0–∞ -
foreignTaxCreditCountrystring optionalCountry of foreign-source income
length: 0–100 -
foreignTaxPaymentDatedate optionalDate of foreign tax payment
-
foreignTaxCreditApplicationSubmissionDatedate optionalDate of submission of foreign tax credit application
-
overseasPlaceOfWorkstring optionalOverseas place of work
length: 0–200 -
overseasServicePeriodStartDatedate optionalOverseas service period — start date
-
overseasServicePeriodEndDatedate optionalOverseas service period — end date
-
overseasPositionstring optionalPosition held at overseas place of work
length: 0–100 -
housingMortgageInterestTaxCreditPaymentnumber optionalHousing mortgage interest tax credit — interest payment (tax credit at 30%)
range: 0–∞ -
monthlyRentExpenditurenumber optionalMonthly rent expenditure (tax credit at 15% or 17%)
range: 0–∞
Additional Documents for Submission
-
submittedFlatTaxRateApplicationboolean requiredA separate companion application (Attached Form No. 8) electing the flat 19% tax rate on gross wage & salary income, in lieu of the standard progressive tax base computation.
-
hasSecondaryPreviousWorkplaceboolean requiredFiler has a secondary (previous) workplace this tax year
-
secondaryWorkplaceNamestring optionalName of secondary (previous) workplace
length: 0–200 -
secondaryWorkplaceBusinessRegistrationNumberstring optionalBusiness reg. no. of secondary (previous) workplace
length: 0–20 -
secondaryWorkplaceGrossWageSalarynumber optionalGross wage & salary from secondary (previous) workplace
range: 0–∞ -
secondaryWorkplaceTaxDeterminednumber optionalTax determined from the secondary (previous) workplace
range: 0–∞ -
submittedSecondaryWorkplaceWithholdingReceiptboolean optionalDid you submit the receipt of wage & salary income tax withholding from the secondary (previous) workplace?
-
submittedPensionSavingsStatementboolean requiredApplicable if claiming income deduction or tax credit for pension accounts, housing purchase savings, etc. — via the companion 'Statement of Income Deduction & Tax Credit for Pension, Savings, etc.' form.
-
submittedMonthlyRentAndMortgageStatementboolean requiredDid you submit a statement of income deduction & tax credit for monthly rent and repayment of principal and interest for housing mortgage from residents?
Declaration
-
declarationDatedate requiredDate of filing (year, month, day)
-
declarationAgreedboolean requiredI file this report in accordance with Article 140 of the Income Tax Act, and certify that I have examined this report and prepared it accurately to the best of my knowledge
Additional fields
-
hasDependentsboolean requiredGates the primary-dependent field group below. The source form provides a repeating table for every dependent listed under personal deduction items; GovSchema v0.3 fields are flat (no array/repeating-group model, see spec/v0.3/SPEC.md §6.1), so this document models only the filer's primary dependent (e.g. spouse or first child) when this is true.
Verification record
This file is the source-review record for this document version, per the manual-source-review-v1 practice. It documents the provenance of the published fields and states the current verification claim honestly.
Current claim
status:draftverification.method:manual-source-review-v1verification.lastVerifiedAt:2026-07-05
Every field in this schema was read directly from the text layer of the National Tax Service's own official English-language guide, which reproduces the gazetted Enforcement Rule of the Income Tax Act's Attached Form No. 37(1)-(3) as an English original (not a translation). It remains draft, not verified, because a live NTS Hometax portal walkthrough and a second independent reviewer's field-by-field pass have not yet occurred — see "What is NOT yet independently verified" below.
Access notes
- Retrieved directly from
nts.go.kr, HTTP 200, no login required, three editions cross-checked: the 2020 edition (nts.go.kr/upload/english/sub/2020 Easy Guide for Foreigners' Year-end Tax Settlement.pdf), a 2022 edition (d.nts.go.kr), and the current 2025 edition (issue date Dec. 2025,nts.go.kr/comm/nttFileDownload.do). All three are genuine text-layer PDFs (not scanned images); this document is sourced from the 2025 edition, the most current at retrieval time. - Extracted with
pdfjs-dist'sgetTextContent(238 pages), the same technique used throughout this registry for encrypted/complex-layout gov PDFs (see memory notegov-form-pdf-extraction). Chapter IX "Tax Forms" (guide pp.187-214) was read in full; Form 37(1)-(3) spans guide pp.199-203 (3 of the form's official 10 printed pages — the guide's English section reproduces only the substantive, non-duplicative pages of the form, per its own "(Page 1 of 10)"/"(Page 2 of 10)"/"(Page 3 of 10)" page markers). A second, coordinate-based extraction (grouping text items by y-position to reconstruct table rows) was run over the same three PDF pages to disambiguate the form's multi-column matrix layout (personal-deduction table, pension/insurance/housing-fund tables, tax-credit table) before fields were authored. - This is the fourth South Korean schema in the registry (
kr/mofa/passport-application-first-adult, GOV-1289;kr/koroad/driving-licence-application, GOV-1291;kr/nec/overseas-voter-registration, GOV-1294;kr/moj/visa-application, GOV-1292) and closes the last of the five KR verticals GOV-1289's research rated STRONG (Passport, DMV, Visa, National ID, Taxes) — only Business Formation remains unmodelled for KR, rated WEAK in that research since IROS/startbiz.go.kr both require certificate login. This is also the registry's first schema sourced from a guide document that is itself an official English original of a Korean gazetted form, rather than a bilingual form or a Claude-vision reading of a Korean-only source — the lowest translation-risk KR source found so far.
Sources examined
- Document
(id, version):kr/nts/year-end-tax-settlement-income-deduction-report/1.0.0 - Spec version: GovSchema
0.3.0 - Authority: National Tax Service (국세청, NTS), Republic of Korea
- Primary source (directly retrieved, HTTP 200, text layer read in full): https://www.nts.go.kr/comm/nttFileDownload.do?fileKey=01059b95704bfc331d222bb2b4e7a927 — "2025 Easy Guide for Foreigners' Year-end Tax Settlement" (Issue Date Dec. 2025), Chapter IX "Tax Forms", pp.199-203: Enforcement Rule of the Income Tax Act, Draft Attached Form No. 37(1)-(3), "Report of Income Deduction & Tax Credit / Report of Income Deduction & Tax Credit from Wage & Salary Income".
- Corroborating context (read for scope/background, not field-sourced): guide Chapter VI "Examples of Income Tax Calculation for 2025" (pp.139-151, used for the mock-data conformance run below), guide p.55 (documentary evidence table, used to populate
documents[]), guide p.211/213 (Form 8 and Form 29-2(3), the flat-tax-rate and tax-treaty companion election forms, referenced but not separately field-modelled), and guide p.205 (the companion "Statement of Income Deduction & Tax Credit for Pension, Savings, etc." form, likewise referenced but not separately field-modelled).
What was confirmed against the source
- Header/income-earner identification fields (
incomeEarnerNamethroughtaxWithholdingRatio): read verbatim from the form's own header block — name, resident/alien registration number, place of work, business registration number, household head/member, nationality (+code), length of service, tax reduction/exemption period, residency status, state of residence (+code), change-of-personal-deduction-items election, payment in installments, and the 120%/100%/80% tax-withholding-ratio election (form footnote: "you can choose between 120%, 100%, 80% of the tax amount that you withhold monthly"). - Section I (personal deduction / income deduction & tax credit items): the filer-level fields (
numberOfPersonsEligibleForPersonalDeduction,numberOfChildren,filerIsWoman,filerIsSingleParent,filerDisabilityCode) and the per-dependent fields (flattened to one primary dependent, per this registry's established repeating-table convention — seekr/moj/visa-application'smostRecentKoreaVisitPurposeprecedent, since spec v0.3 has no array/repeating-group model, SPEC.md §6.1) are sourced directly from the form's own column headers and its numbered Instructions 1-7 (relationship codes 0-8, age/income criteria, "Woman" eligibility conditions, disability classification codes 1-3, Citizen=1/Foreigner=9 codes). The education-expense/credit-card-spending/donation fields that follow in the same section (generalEducationExpensesthroughpublicTransportationSpending) are filer-level aggregate totals per the form's own second sub-table, not further broken out per dependent. - Section II (pension premium deduction) and Section III (special income deduction): national/other-public pension premium, national-health/employment-insurance premium (each split current-workplace/previous-workplace exactly as the form does), and the housing rental loan / long-term mortgage loan gating booleans and aggregate repayment fields, all sourced directly from the form's own labelled rows.
- Section IV (other income deductions): individual pension savings (with its 720,000-won-or-40%-of-deposit ceiling note), small-business mutual-aid deposits, housing-purchase savings, investment-association contributions, ESOP contributions, and long-term collective investment securities savings — sourced directly, aggregated across the form's own narrower sub-categories where noted (see "What is NOT yet independently verified" below).
- Section V (tax reduction/exemption & tax credit) — the foreign-worker- specific core of this document:
foreignWorkerExemptionPurpose's four named pathways (inter-government agreement, technology introduction contract, Restriction of Special Taxation Act, tax treaty) are transcribed verbatim from the form's own "Purpose of entry" checkbox row, alongside the receipt/submission-date field pairs for the RSTA and tax-treaty pathways. The tax-credit fields (pension account, special tax credit's insurance/medical/education/donation/foreign-tax-credit/housing-mortgage- interest/monthly-rent items, each with the form's own stated ceiling and credit-rate percentages) are transcribed directly from the form's own "Type of tax credit / Details / Ceiling / Tax credit ratio" table. - Section VI (additional documents for submission) and the Declaration: the four yes/no document checklist questions (flat-tax- rate application, secondary workplace, pension/savings statement, monthly rent & mortgage statement) and the filer's Article-140 declaration statement are transcribed verbatim, including the form's own note that a filer who fails to report secondary-workplace income to the withholding agent must file global income tax themselves or face penalty tax.
documents[]: sourced from two places — the form's own Section VI checklist (which gatespensionSavingsStatementandmonthlyRentAndMortgageStatement) and the guide's separate p.55 "Documentary evidence" table (which names the Alien Registration Certificate, the flat-tax-rate election form, and the foreign- engineer/employee tax-reduction application by their official titles).
Mock-data conformance run
A mock application packet (conformance/kr/nts/year-end-tax-settlement-income-deduction-report/1.0.0/application-packet.json) models a Chinese-national foreign engineer ("Yuan") employed since 2023-01-01, claiming the Restriction of Special Taxation Act's foreign- engineer tax reduction, with a spouse ("Amy") and one child ("Charlie") as dependents. Wage, national pension premium, national health insurance premium, and credit card spending figures are transcribed verbatim from the guide's own worked calculation example ("Case 5. A foreign engineer's year-end tax settlement", p.151) — Yuan/Amy/Charlie are the guide's own illustrative names, not real persons. Administrative values the calculation-only example does not state (registration numbers, business registration number, exemption expiration date, submission dates, declaration date) are synthesized illustrative values, flagged inline in application-packet.txt, consistent with this registry's established practice for calculation-example-derived packets (see kr/nec/overseas-voter-registration's declarationDate precedent).
A from-scratch evaluator script (not reused from any other schema's evaluator) was written to check the packet against every field's effective required/requiredWhen, enum/minimum/maxLength validation, every crossFieldValidation rule, and every documents[].requiredWhen condition:
- Result: 0 errors across all 117 fields, 3
crossFieldValidationrules, and 7documents[]entries. - 3 documents evaluated as required for this scenario:
residentAlienRegistrationCopy,incomeDeductionTaxCreditEvidence, andforeignEngineerOrEmployeeTaxReductionApplication(gated correctly onforeignWorkerExemptionPurpose = restriction_of_special_taxation_act). - Mutation testing (to confirm the evaluator is not vacuously passing): three deliberate single-field mutations were run against the same evaluator and packet. All three were correctly flagged: (1) removing
declarationAgreed→MISSING REQUIRED; (2) settingexemptionExpirationDatebeforetechnologyContractOrLaborStartDate→CROSS-FIELD VIOLATION(exemptionExpirationNotBeforeContractStart); (3) settingresidencyStatusto an out-of-enum value ("maybe") →ENUM VIOLATION.
What is NOT yet independently verified
- Granular sub-matrix breakdowns are deliberately aggregated, not modelled cell-by-cell: the source form itself further subdivides several of this document's aggregate fields — long-term housing mortgage loan interest by borrowing year (before/after 2012), term length (10-15/15-29/ 30+ years), and interest-rate type (fixed/non-deferred vs. other); investment-association contributions by contribution year (2023/2024/ 2025) and association (1/2); housing-purchase savings by product type (savings account for housing purchase / worker's housing-purchase savings / collective savings account for housing subscription). Modelling every combination would push this document well past 150 fields for narrow, low-incidence categories; each aggregation is flagged in the relevant field's own
description. - Three companion forms are referenced only as
documents[]entries, not separately field-modelled: the "Application for Flat Tax Rate for Foreign Employees" (Attached Form No. 8, guide p.211), the "Application for Non-Taxation & Exemption ... Under a Tax Treaty" (Attached Form No. 29-2(3), guide p.213), and the "Statement of Income Deduction & Tax Credit for Pension, Savings, etc." (guide p.205) each have their own field-level structure not modelled here — a future GovSchema document could model each as its ownkr/nts/...schema. - The NTS Hometax simplified year-end tax settlement service (the guide's own Appendix, pp.217-233) — the live portal workflow for looking up and submitting pre-filled income-deduction/tax-credit data — was not exercised; this document only models the paper/PDF form's own field set, consistent with the KR-registry-wide "no login-gated portal" sourcing constraint already recorded for
kr/moj/visa-application(HiKorea e-Application) andnz/dia/realme-verified-identity. - A live filing walkthrough and a second independent reviewer's field-by-field pass have not yet occurred.
Path to a verified claim (next step)
A second reviewer should independently re-download the 2025 edition PDF, re-extract Chapter IX pp.199-203, and cross-check each field's sourceRef against the extracted text (as done for the other three KR schemas' review gates). If confirmed with no material discrepancies, status can move from draft to verified and verification.method can be updated accordingly.
Re-verification
- Next review due:
2027-01-05(perverification.nextReviewBy). - Re-check against the NTS's next annual edition of the guide (published each December for the following year's settlement) for any changed ceilings, credit-rate percentages, or added/removed deduction categories — the guide itself documents such year-over-year changes in its own "Summary of Changes to Tax Laws" section.
View the raw record (VERIFICATION.md)
Version history
-
1.0.0draftlatestthis pagehas verification recordschema.json
Independent and non-affiliated
GovSchema is an independent, open-source project. This reference is not produced, reviewed, or endorsed by National Tax Service, Republic of Korea or any government. The authoritative source is always the live government form and its official instructions.