Skip to content

Deduct vendor service fees from Nevada LIHEAP energy costs - #11203

Draft
hua7450 wants to merge 2 commits into
PolicyEngine:mainfrom
hua7450:nv-liheap-utility-providers
Draft

hua7450 wants to merge 2 commits into
PolicyEngine:mainfrom
hua7450:nv-liheap-utility-providers

Conversation

@hua7450

@hua7450 hua7450 commented Nov 21, 2026 •

Copy link
Copy Markdown
Collaborator

Nevada measures a household's energy cost "excluding any service fees" (Energy Assistance Program Manual, Section 507), and Appendix A of the manual lists an annual deduction for 11 rural electric vendors and for Southwest Gas. This PR adds two inputs for the household's electricity and natural gas vendors and subtracts each vendor's deduction from that vendor's bill before the model computes the Fixed Annual Credit.

Fixes #11202

Changes

  • nv_liheap_electricity_provider: the 11 electric vendors in Appendix A, NV_ENERGY, OTHER and UNSPECIFIED (the default).
  • nv_liheap_natural_gas_provider: SOUTHWEST_GAS, SOUTHWEST_GAS_SOUTH_MULTI_FAMILY, NV_ENERGY, OTHER and UNSPECIFIED (the default).
  • payment/vendor_deduction/electricity.yaml and natural_gas.yaml: the SFY2026 and SFY2027 annual amounts.
  • nv_liheap_energy_cost subtracts the electric vendor's deduction from the electricity bill, and the gas vendor's deduction from the gas bill when gas heats the home. Each bill stops at zero.
  • nv_liheap_energy_cost drops its documentation attribute; the same notes are comments in the formula.

NV_ENERGY, OTHER and UNSPECIFIED deduct nothing, so a household that reports no vendor keeps its current result.

Example

A three-person Fallon household with $24,960 of wages, a $600 gas bill and a $1,440 electricity bill in SFY2026:

Vendors reported Energy cost Fixed Annual Credit
None $2,040.00 $1,588.22
City of Fallon and Southwest Gas $1,610.40 $1,158.62

The deductions are $300.00 for the City of Fallon and $129.60 for Southwest Gas, and the credit falls by their sum, $429.60.

Effect on eligibility

A household in subsidized housing with all utilities included in rent is ineligible "unless they have an energy burden" (Sections 501 I and 503), and nv_liheap_eligible reads that burden as an energy cost above zero. The energy cost now excludes the vendor's service fee, so such a household whose only bill is below its vendor's deduction has no energy burden and becomes ineligible.

Subsidized, heat in rent, solar heat, $300 electricity bill, SFY2026 Energy cost Eligible
No vendor reported $300.00 Yes
Alamo Power District ($380.04 deduction) $0.00 No

Limitations

  • Appendix A lists unit charges for NV Energy (Nevada Power and Sierra Pacific) and no dollar deduction. No input carries usage in kilowatt hours or therms, so an NV Energy bill keeps its service fee.
  • The manual does not state how the deduction enters the calculation. This PR reads the table heading, "Use deductions below unless vendor provides usage only", together with Section 507, as a subtraction from the vendor's annual dollar total, bill by bill, floored at zero.
  • The $360 solar-vendor credit in Section 505 G has no input.

Tests

  • nv_liheap_energy_cost.yaml Cases 4-9: both vendor tables, the SFY2027 amounts, a deduction larger than the bill, the southern multi-family Southwest Gas amount, a home whose gas bill is outside the energy cost, and two households that show each bill stops at zero on its own (a floor on the total would give a lower cost).
  • nv_liheap.yaml Case 29 (SFY2026) and Case 30 (SFY2027, where the deduction brings the credit down to the $360 minimum).
  • eligibility/nv_liheap_eligible.yaml Case 14: the subsidized, utilities-in-rent pair in the table above.

The cases were not run locally; CI runs them.

Sources

axiom: needed

🤖 Generated with Claude Code

Section 507 of the Energy Assistance Program Manual leaves service fees
out of the energy cost, and Appendix A lists an annual deduction for 11
rural electric vendors and Southwest Gas. Add nv_liheap_electricity_provider
and nv_liheap_natural_gas_provider, the SFY2026 and SFY2027 deduction
amounts, and subtract each vendor's deduction from that vendor's bill.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (8999568) to head (f1bf932).
⚠️ Report is 308 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main    #11203   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         4    +3     
  Lines           24        84   +60     
=========================================
+ Hits            24        84   +60     
Flag Coverage Δ
unittests 100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

- Comments state what Appendix A prints for NV Energy and label the
  no-deductible-fee treatment as an inference.
- Remove the `documentation` attribute from nv_liheap_energy_cost and keep its
  notes as formula comments; note in nv_liheap_eligible that a bill removed by
  its vendor deduction leaves no energy cost.
- Tests: eligibility Case 14 (subsidized, heat in rent, with and without a
  listed vendor), energy-cost Case 9 (each bill floors at zero on its own),
  nv_liheap Case 30 (SFY2027 minimum credit); Case 4 uses Boulder City.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement Nevada LIHEAP vendor service fee deductions

1 participant