Repository navigation
Conversation
Form 2441 line 15 is line 12 plus grace-period carryovers used this year (line 13) less amounts forfeited or carried forward (line 14). The model used line 12 alone, so it taxed forfeited benefits and ignored carryovers. Two per-person inputs, both zero by default, carry lines 13 and 14; the federal exclusion, taxable_dependent_care_benefits and California's exclusion read the resulting line 15. A parameter keeps 2021 and 2022 as main computes them, since those years' relief rules are not modeled. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What was wrong
PolicyEngine-US took Form 2441 line 15, the employer dependent care benefits the filer received, to be line 12 alone. Line 12 is
dependent_care_employer_benefits: W-2 box 10, not counting any box 10 amount above the plan's exclusion, which the employer already reports as box 1 wages. Box 10 reports benefits "regardless of any employee forfeitures", and Form 2441 subtracts forfeited and carried-forward amounts on line 14 and adds prior-year benefits used in this year's grace period on line 13. The model had neither line, so it taxed benefits the filer never received and ignored carryovers the filer did receive.Example, 2025: a head of household with one child has $23,000 of box 1 wages and $5,000 in box 10, so the model's employment income is $28,000. The filer incurs $4,000 of qualified expenses (line 16) and forfeits the other $1,000.
The tax difference, $103.87, is the EITC on the $1,000 ($4,224.13 on main, $4,328.00 here). The IRS's own line 14 example ($5,000 in box 10, $50 forfeited, $4,950 of expenses) had the same defect: main taxed $50, and the form taxes $0. A filer who used $1,500 of 2024 benefits in the 2025 grace period on top of $4,000 in box 10 got a $4,000 exclusion and nothing taxable on main; the form gives line 15 of $5,500, a $5,000 exclusion and $500 taxable.
Box 10 amounts above the plan's exclusion are not line 12, and this PR does not change how they are treated. If one W-2 reports $6,000 in box 10 under a plan with a $5,000 exclusion, the $1,000 above it is already box 1 wages, so
dependent_care_employer_benefitsis $5,000 and employment income keeps the $1,000 as wages, as on main. A forfeiture then reduces only line 12: with $1,000 forfeited and $5,000 of expenses, line 15 is $4,000, the exclusion $4,000, line 26 $0 and AGI $24,000. A new case pins this.Law and sources
dependent_care_employer_benefitsleaves them out.The change
dependent_care_employer_benefits_prior_year_carryover(line 13) anddependent_care_employer_benefits_forfeited_or_carried_forward(line 14). They are per person because box 10 is per W-2 and each employee's plan amounts are their own, so a person's line 14 reduces only their own line 12 and line 13. A negative entry counts as zero.form_2441_line_15, returns each person's line 15: line 12, plus line 13, less line 14, floored at zero. It is a plain function, not a variable, so no one can set it as an input.dependent_care_assistance_exclusion(line 25),taxable_dependent_care_benefits(line 26) andca_dependent_care_assistance_exclusion(FTB 3506 line 26) read the helper instead of line 12 alone. On a joint return the line 26 total is split by each spouse's own line 15, so a forfeiture lowers the forfeiting spouse's line 15 and share rather than being spread by line 12. Because line 26 is computed for the return, the other spouse's share can still change: in the joint case it is $2,222.22 with the head's $1,000 forfeiture and $2,500 without.dependent_care_employer_benefitsdocuments that forfeited and carried-forward amounts stay in it, as in box 10, and also go in the line 14 input.docs/gov/irs/historical-validation.mdreplaces "Carryovers, forfeitures and self-employment plan deductions remain outside this employer-benefit calculation" with a description of the two inputs, and says California's FTB 3506 line 16 uses them too.2021 and 2022
The 2021 and 2022 forms say on line 21: "If you entered an amount on line 13, add it to the $10,500 or $5,250" (2022: "$5,000 or $2,500") "amount you enter on line 21." Section 214 of the Taxpayer Certainty and Disaster Tax Relief Act of 2020 let plans carry over unused benefits from plan years ending in 2020 and 2021, and Notice 2021-26, page 3 says such amounts "are disregarded for purposes of application of the limits for the subsequent taxable years". The 2020 and 2023 forms have no such addition.
The same relief lets a carryover pay for a child under 14, and the 2022 instructions add to line 21 only the part of line 13 carried over from plan years ending in 2020 or 2021. The model has neither rule. Adding line 13 to both line 15 and the cap would tax a carryover spent on a 13-year-old when the return has no qualifying person under 13, because the model then zeroes line 16, and would overstate the 2022 cap for non-calendar plans. A new parameter,
gov.irs.gross_income.dependent_care_assistance_programs.prior_year_carryover_omitted(true for 2021 and 2022, false otherwise), therefore leaves line 13 out of both the federal line 15 and the cap in those years, exactly as main does. Its description says what it does in the model, not what the relief does. Line 14 applies in every year; in 2021 and 2022 the federal calculation subtracts all of it from line 12, including any part forfeited from line 13.California counts line 13 in every year. FTB 3506 line 14 takes "the amount from federal Form 2441, line 13", and line 22 stays at $5,000 ($2,500) with no carryover addition in 2021 and 2022. So in 2021 a return with $3,000 in box 10, a $2,000 carryover and $9,000 of expenses gets a California exclusion of $5,000, where main gave $3,000; a new case pins it.
Alabama's 2021 worksheet is the one place a 2021 federal-rule result changes. Its Part II recomputes the credits "based on 2020 calculations using 2021 information", and line 4 enters the credit "based on 2020 Form 2441 Line 11" (2021 Form 40 booklet, page 20). The existing 2020-IRC pin in
tools/pinned_tbs.pyalready fixes the wholedependent_care_assistance_programssubtree at its 2020 values for that recompute, so the new parameter is false there. Like the 2020 form, the recompute counts line 13 in line 15 against the $5,000 cap.Invariants and how the tests check them
tests/core/test_dependent_care_benefits_received_invariants.pychecks these for 120 California tax units in each of 2020, 2021, 2022, 2023, 2025 and 2026, with random line 12, forfeitures up to line 12, carryovers and expenses, across single, joint, head of household and separate returns.irs_employment_incomeandpayroll_tax_gross_wagesstay at employment income less line 12 whatever lines 13 and 14 are.dependent_care_assistance_exclusion,ca_dependent_care_assistance_exclusion,ca_dependent_care_assistance_addition,ca_cdcc_relevant_expenses,cdcc_limit,cdcc_relevant_expenses,cdcc, AGI, federal and state income tax,ny_cdcc_max,va_child_dependent_care_deduction_cdcc_limit,id_household_and_dependent_care_expense_deduction,hi_dependent_care_benefits,ky_cdcc_potential,al_federal_income_tax_deduction,nd_renters_refund_federally_excluded_income,taxable_dependent_care_benefits,eitc_earned_income,ira_compensation,dependent_gross_incomeandhousehold_net_income. In this sampleca_dependent_care_assistance_additionanddependent_gross_incomewere zero in every year, as were the 2021 California exclusion and 2024ky_cdcc_potential, so those 18 arrays check nothing.ca_cdcc_relevant_expenseseach rose by $994, because California now counts line 13. The seeded test also compares federal results with and without the carryover in those years. Alabama's 2021 recompute is the deliberate exception above; this sample's Alabama units did not exercise it, and a YAML case pins it.New YAML cases
dependent_care_assistance_exclusion.yaml(+6, 56 cases): the IRS line 14 example ($4,950 excluded, $0 taxable); a $1,000 carryover with no box 10 ($1,000 excluded, credit limit $3,000 - $1,000 = $2,000); 2021 with $10,500 in box 10 and a $1,500 carryover, and 2022 with $5,000 in box 10 and a $1,500 carryover, where the form adds line 13 to both line 15 and the cap (each asserts only line 26 of $0 and AGI, which the model and the form share; the exclusions differ); 2023 with the 2022 facts (line 15 $6,500, $1,500 taxable); and negative line 13 and line 14 entries, which count as zero.taxable_dependent_care_benefits.yaml(+5, 11 cases): the $1,000 forfeiture above; box 10 above the plan's exclusion with a $1,000 forfeiture ($4,000 excluded, AGI $24,000); the $1,500 carryover above; a joint return where one spouse forfeits $1,000 of $5,000, so line 26 is $4,000 split $1,777.78 and $2,222.22; and a forfeiture entered for a spouse with no benefits of their own, which cannot reduce the other spouse's line 15 ($2,000 taxable, all the other spouse's).ca_dependent_care_assistance_exclusion.yaml(+3, 13 cases): a carryover-only return, and a $2,000 forfeiture of $5,000 with $4,000 of expenses, where line 15 (FTB 3506 line 16) of $3,000 sets both exclusions (main: $4,000), each with equal federal and California exclusions and no California addition; and 2021 with $3,000 in box 10 and a $2,000 carryover, where California excludes $5,000.al_federal_income_tax_deduction.yaml(+1, 17 cases): a 2021 head of household with two children, $3,000 in box 10 and a $2,000 carryover. The 2020-rule recompute excludes $5,000, cuts the 2020-rule credit from $600 to $200 and raises the deduction from $60 to $460. The case asserts only the Alabama deduction, because the model's federal 2021 exclusion ($3,000) leaves the carryover out where the 2021 form ($5,000) counts it.The federal exclusion file's header now defines the benefits as line 15 and line 12. The California file's header now says its assumption of no carryovers or forfeitures holds unless a case says otherwise.
Readers this reaches
With the new inputs present, the federal exclusion reaches
cdcc_limitandcdcc_relevant_expenses(Form 2441 line 28),ca_dependent_care_assistance_addition,ca_cdcc_relevant_expenses,id_household_and_dependent_care_expense_deduction,ny_cdcc_max(Form IT-216 line 5),va_child_dependent_care_deduction_cdcc_limitand Alabama's 2021 recompute. State credits computed fromcdccorpre_obbba_cdccfollow it as well: Kentucky'sky_cdcc_potentialfrom 2022 matches the federal credit, so with $5,000 in box 10, $2,000 forfeited, two children and $8,000 of expenses it rises from $40 to $120 in 2022 and 2025. California's own exclusion reachesca_dependent_care_assistance_additionandca_cdcc_relevant_expenses. Taxable benefits reachirs_gross_income(and so every state that starts from federal AGI),eitc_earned_income,ira_compensation, the dependent filing-requirement earned income anddependent_gross_income, andnd_renters_refund_federally_excluded_income. North Dakota's renter's refund treats as excluded income the part of wages that federal gross income leaves out, found by subtractingirs_employment_incomeand taxable benefits from wages. A forfeiture lowers taxable benefits, so that excluded part rises by the forfeited amount andnd_renters_refund_incomefalls by it: on the example's facts in North Dakota, from $24,000 to $23,000. The filer never received that amount.These read line 12 directly and do not change: Kentucky's 2021 recompute (
ky_cdcc_potential.formula_2021_01_01, Form 2441-K under the December 31, 2018 Code), which stays at $40 in 2021 on the same facts; Hawaii'shi_dependent_care_benefits; New York'sny_cdcc_qualifying_expenses; and Michigan's and Oklahoma's income lists. New York's credit therefore uses line 15 throughny_cdcc_maxbut line 12 throughny_cdcc_qualifying_expenses: on the Kentucky facts in New York,ny_cdcc_maxrises from $1,000 to $3,000,ny_cdcc_qualifying_expensesstays $3,000, andny_cdccrises from $186.75 to $560.25. No dataset carries the new inputs, so microsimulation results do not change.Relation to #10715
This closes the forfeiture finding from round 3 of #10715, in which Idaho's employment test under Idaho Code 63-3022A(1)(b)(iii) counted forfeited benefits as taxable. That finding's facts put $6,000 in box 10 on one W-2 beside $23,000 of box 1 wages, but under the W-2 rules the box 10 amount above the plan's exclusion, which is at most $5,000, is also box 1 wages and is not line 12, so at least $1,000 of that box 10 is already in the $23,000. #10715's Idaho case should use the example's facts instead: box 1 wages of $23,000, $5,000 in box 10, $1,000 forfeited and $4,000 of qualified expenses. On main, line 26 is $1,000, so income from employment is $24,000, over the $23,625 head of household threshold, and the deduction is allowed. With this change line 26 is $0, income from employment is $23,000 and the deduction is not allowed. These Idaho results are derived from the federal line 26 values above. They were not run here, because the Idaho employment test is not on main; #10715 adds the case once this merges.
A separate line 26 input is not needed. With lines 13, 14 and 16 as inputs, the model computes line 26 from the form's own lines, including zero. A line 26 input with a formula default would let one return's entry change another return's result in the same simulation.
Not in this PR
ca_dependent_care_assistance_additionis the federal exclusion less California's. Because the federal calculation leaves the carryover out in those years, a carryover that takes FTB 3506 line 16 above California's $5,000 cap is excluded on the federal form but not added back for California. For 2022, $5,000 in box 10 plus a $2,000 carryover gives a federal exclusion of $7,000 on the form and $5,000 for California, while the model's addback is $0, as on main.hi_dependent_care_benefitstreats as line 2 alone. Kentucky's 2021 Form 2441-K recompute and New York'sny_cdcc_qualifying_expenseslikewise use line 12. These results equal main's for the same line 12. Each needs its own state-law check (Hawaii's line 2 and 2021 conformity, Kentucky's 2021 form, New York Tax Law 606(c-2)(D)(ii)(a)) and its own cases.Test plan
ruff format --checkandruff checkpass on the seven changed or new Python files.changelog.d/fix-form-2441-carryover-forfeit.added.mdand.fixed.md.Local runs at this content (Core 3.36.0):
gov/irs/credits/cdccandirs_gross_income/taxable_dependent_care_benefits.yaml: 185 passed.credits/child_dependent_careandca_dependent_care_assistance_addition.yaml: 73 passed.household_and_dependent_careandretirement_benefits, New Yorkcredits, Virginiacdcc_expense, North Dakotarenters_refund, Hawaiicdcc, and Kentuckydependent_care_creditanddependent_care_service: 529 passed.tax/income, theirs_gross_incomefolder,eitc_earned_income.yaml,ira_compensation.yaml,dependent_gross_income.yaml, Michigan household resources, Oklahoma gross income, Maryland's dependent care subtraction and Georgia's dependent care credit: 374 passed.tests/core/test_dependent_care_assistance_exclusion_invariants.pyand the newtest_dependent_care_benefits_received_invariants.py: 14 passed. Withtest_pinned_branch_credit_dependents.py,test_separate_filer_and_dependent_care_wages.py,test_federal_2017_tax_history_properties.py,test_federal_credit_limit_order.py,test_hi_temporary_disability_insurance.pyandtest_nd_renters_refund_income_exclusions.py: 120 passed.tests/code_health/: 730 passed, 1 skipped.code_health/parameters.py,code_health/variable_names.py,test_parameter_files.pyandtest_parameter_scale_thresholds.py: 24 passed.git diff --check: clean.🤖 Generated with Claude Code