feat(pay): transcribe the OPPS drug packaging thresholds
Some checks failed
CI / lint (push) Failing after 42s
CI / notebooks-smoke (push) Successful in 1m57s
Deploy / changes (push) Successful in 17s
Infra CI / notebooks (push) Successful in 58s
CI / test (push) Successful in 4m7s
Infra CI / zotero (push) Successful in 22s
Infra CI / docs (push) Successful in 24s
Infra CI / api (push) Successful in 1m12s
Infra CI / bcda (push) Successful in 1m54s
Infra CI / llm (push) Successful in 1m2s
Infra CI / mc (push) Successful in 19s
Deploy / notebooks (push) Has been skipped
Deploy / zotero (push) Has been skipped
Deploy / docs (push) Has been skipped
Lean Pay / pay (push) Successful in 13s
Deploy / api (push) Successful in 1m25s
Deploy / bcda (push) Successful in 1m47s
Deploy / mc (push) Has been skipped
Deploy / llm (push) Successful in 1m14s
Deploy / report (push) Successful in 14s
Comment Pull / comment-pull (push) Failing after 52s
Notebooks Integration / notebooks-integration (push) Failing after 11m46s
Renovate / renovate (push) Successful in 1m58s
LLM Golden / llm-golden (push) Successful in 23m29s
Zotero Sync / zotero-sync (push) Successful in 3m11s
Package Supply Chain / pkg-supply-chain (push) Successful in 1m17s

Each OPPS rule year now stores the per-day drug packaging threshold
its own final rule adopts, from $90 in 2014 to $140 in 2025 and 2026.
CY2024 stays at the finalized $135, not the proposed $140. The $55
bypass threshold, the outlier amount, and the diagnostic
radiopharmaceutical thresholds are not this field.
This commit is contained in:
kert
2026-11-17 17:58:28 -05:00
parent 02b2e5a228
commit 2e40801daf
3 changed files with 151 additions and 67 deletions

View File

@@ -43,8 +43,11 @@ class RuleYear(BaseModel):
ASP × this factor = payment (1.06 = ASP + 6%)."""
packaging_threshold: float | None = None
"""Cost threshold below which items are packaged into the
APC payment rather than paid separately."""
"""Per-day OPPS drug packaging threshold ($). A drug, biological,
or therapeutic radiopharmaceutical at or below this cost is packaged
into the APC payment. Not the $55 bypass-list threshold, the outlier
fixed-dollar threshold, or the diagnostic-radiopharmaceutical
threshold."""
# Skin substitute specific
skin_sub_payment_method: str = "pass_through"
@@ -80,12 +83,18 @@ class RuleYear(BaseModel):
# CY2020 = 80.784, the as-published NFRM value that reproduces the CY2020
# Addendum B national rates we ingest (verified to the cent). CMS later cited
# a corrected $80.793, but the archived NFRM addenda — our source — use 80.784.
# packaging_threshold is the drug per-day threshold that year's final rule
# adopts. It is not the $55 bypass threshold, the outlier fixed-dollar
# amount, or (from CY2025) the diagnostic-radiopharmaceutical threshold.
RULES: dict[int, RuleYear] = {
2014: RuleYear(
year=2014,
conversion_factor=72.672,
outlier_threshold=2885.0,
# 78 FR 75022 (FR Doc 2013-28737): "adopting a CY 2014 packaging
# threshold of $90."
packaging_threshold=90,
cms_rule_id="CMS-1601-FC",
federal_register_citation="78 FR 75196",
skin_sub_payment_method="pass_through",
@@ -96,6 +105,9 @@ RULES: dict[int, RuleYear] = {
year=2015,
conversion_factor=74.144,
outlier_threshold=3075.0,
# 79 FR 66882 (FR Doc 2014-26146): "adopting a CY 2015 packaging
# threshold of $95."
packaging_threshold=95,
cms_rule_id="CMS-1613-FC",
federal_register_citation="79 FR 66770",
),
@@ -103,6 +115,9 @@ RULES: dict[int, RuleYear] = {
year=2016,
conversion_factor=73.725,
outlier_threshold=3250.0,
# 80 FR 70433 (FR Doc 2015-27943): "adopting a CY 2016 packaging
# threshold of $100."
packaging_threshold=100,
cms_rule_id="CMS-1633-FC",
federal_register_citation="80 FR 70298",
),
@@ -110,6 +125,9 @@ RULES: dict[int, RuleYear] = {
year=2017,
conversion_factor=75.001,
outlier_threshold=3575.0,
# 81 FR 79666 (FR Doc 2016-26515): "adopting a CY 2017 packaging
# threshold of $110."
packaging_threshold=110,
cms_rule_id="CMS-1656-FC",
federal_register_citation="81 FR 79562",
),
@@ -117,6 +135,9 @@ RULES: dict[int, RuleYear] = {
year=2018,
conversion_factor=78.636,
outlier_threshold=4325.0,
# 82 FR 52483 (FR Doc 2017-23932): "adopting a CY 2018 packaging
# threshold of $120."
packaging_threshold=120,
cms_rule_id="CMS-1678-FC",
federal_register_citation="82 FR 52356",
),
@@ -124,6 +145,9 @@ RULES: dict[int, RuleYear] = {
year=2019,
conversion_factor=79.490,
outlier_threshold=4550.0,
# 83 FR 58964 (FR Doc 2018-24243): "adopting a CY 2019 packaging
# threshold of $125."
packaging_threshold=125,
cms_rule_id="CMS-1695-FC",
federal_register_citation="83 FR 58818",
),
@@ -131,6 +155,10 @@ RULES: dict[int, RuleYear] = {
year=2020,
conversion_factor=80.784,
outlier_threshold=4625.0,
# 84 FR 61312 (FR Doc 2019-24138): "finalizing a packaging
# threshold for CY 2020 of $130." The next page says "adopting
# a CY 2019 packaging threshold of $130"; same dollar, year mistyped.
packaging_threshold=130,
cms_rule_id="CMS-1717-FC",
federal_register_citation="84 FR 61142",
),
@@ -138,6 +166,10 @@ RULES: dict[int, RuleYear] = {
year=2021,
conversion_factor=82.797,
outlier_threshold=5025.0,
# 85 FR 86032 (FR Doc 2020-26819): "implementing our proposal
# without modification to have a drug packaging threshold for
# CY 2021 of $130."
packaging_threshold=130,
cms_rule_id="CMS-1736-FC",
federal_register_citation="85 FR 86062",
),
@@ -145,6 +177,10 @@ RULES: dict[int, RuleYear] = {
year=2022,
conversion_factor=84.177,
outlier_threshold=5350.0,
# 86 FR 63636 (FR Doc 2021-24011): "finalizing our proposal
# without modification to have a drug packaging threshold for
# CY 2022 of $130."
packaging_threshold=130,
cms_rule_id="CMS-1753-FC",
federal_register_citation="86 FR 63458",
notes="Skin sub pass-through payment discussion, criteria for "
@@ -154,6 +190,10 @@ RULES: dict[int, RuleYear] = {
year=2023,
conversion_factor=85.585,
outlier_threshold=6175.0,
# 87 FR 71961 (FR Doc 2022-23918): "finalizing our proposal
# without modification to set the drug packaging threshold for
# CY 2023 at $135."
packaging_threshold=135,
cms_rule_id="CMS-1772-FC",
federal_register_citation="87 FR 72040",
skin_sub_payment_method="high_low_category",
@@ -165,6 +205,9 @@ RULES: dict[int, RuleYear] = {
year=2024,
conversion_factor=87.382,
outlier_threshold=6600.0,
# 88 FR 81780 (FR Doc 2023-24293): final $135 per day. The
# proposal was $140; the recalculation ($137.36) rounds to $135.
packaging_threshold=135,
cms_rule_id="CMS-1786-FC",
federal_register_citation="88 FR 82060",
skin_sub_payment_method="high_low_category",
@@ -174,6 +217,10 @@ RULES: dict[int, RuleYear] = {
year=2025,
conversion_factor=89.169,
outlier_threshold=7100.0,
# 89 FR 94237 (FR Doc 2024-25521): "a drug packaging threshold
# of $140 for CY 2025." The $630 on that page is the diagnostic-
# radiopharmaceutical threshold.
packaging_threshold=140,
cms_rule_id="CMS-1809-FC",
federal_register_citation="89 FR 100170",
skin_sub_payment_method="high_low_category",
@@ -184,6 +231,10 @@ RULES: dict[int, RuleYear] = {
year=2026,
conversion_factor=91.415,
outlier_threshold=7500.0,
# 90 FR 53701 (FR Doc 2025-20907): "the final CY 2026 drug
# packaging threshold remains at $140 per day." The $655 on
# that page is the diagnostic-radiopharmaceutical threshold.
packaging_threshold=140,
cms_rule_id="CMS-1834-FC",
federal_register_citation="90 FR 101174",
skin_sub_payment_method="flat_rate",

View File

@@ -11987,173 +11987,173 @@
"value": "7500"
},
{
"high": null,
"high": "90",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "90",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2014",
"role": "payment",
"rows": null,
"value": null
"value": "90"
},
{
"high": null,
"high": "95",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "95",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2015",
"role": "payment",
"rows": null,
"value": null
"value": "95"
},
{
"high": null,
"high": "100",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "100",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2016",
"role": "payment",
"rows": null,
"value": null
"value": "100"
},
{
"high": null,
"high": "110",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "110",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2017",
"role": "payment",
"rows": null,
"value": null
"value": "110"
},
{
"high": null,
"high": "120",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "120",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2018",
"role": "payment",
"rows": null,
"value": null
"value": "120"
},
{
"high": null,
"high": "125",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "125",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2019",
"role": "payment",
"rows": null,
"value": null
"value": "125"
},
{
"high": null,
"high": "130",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "130",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2020",
"role": "payment",
"rows": null,
"value": null
"value": "130"
},
{
"high": null,
"high": "130",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "130",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2021",
"role": "payment",
"rows": null,
"value": null
"value": "130"
},
{
"high": null,
"high": "130",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "130",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2022",
"role": "payment",
"rows": null,
"value": null
"value": "130"
},
{
"high": null,
"high": "135",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "135",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2023",
"role": "payment",
"rows": null,
"value": null
"value": "135"
},
{
"high": null,
"high": "135",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "135",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2024",
"role": "payment",
"rows": null,
"value": null
"value": "135"
},
{
"high": null,
"high": "140",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "140",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2025",
"role": "payment",
"rows": null,
"value": null
"value": "140"
},
{
"high": null,
"high": "140",
"integer": false,
"item": "opps.rules.RuleYear",
"kind": "unstated",
"low": null,
"kind": "published",
"low": "140",
"name": "packaging_threshold",
"note": "Not transcribed. Do not impute it.",
"note": "",
"period": "2026",
"role": "payment",
"rows": null,
"value": null
"value": "140"
},
{
"high": "1.06",

View File

@@ -94,6 +94,39 @@ class TestGoldenConversionFactors:
assert cur_cf > prev_cf
# Per-day drug packaging threshold the year's own OPPS/ASC final rule
# adopts. Not the $55 bypass-list threshold, the outlier fixed-dollar
# threshold, or the diagnostic-radiopharmaceutical threshold ($630 in
# CY2025, $655 in CY2026). CY2024's proposal was $140; the final
# recalculation rounds to $135.
_DRUG_PACKAGING_THRESHOLD: dict[int, float] = {
2014: 90, # 78 FR 75022
2015: 95, # 79 FR 66882
2016: 100, # 80 FR 70433
2017: 110, # 81 FR 79666
2018: 120, # 82 FR 52483
2019: 125, # 83 FR 58964
2020: 130, # 84 FR 61312
2021: 130, # 85 FR 86032
2022: 130, # 86 FR 63636
2023: 135, # 87 FR 71961
2024: 135, # 88 FR 81780
2025: 140, # 89 FR 94237
2026: 140, # 90 FR 53701
}
class TestDrugPackagingThreshold:
"""The adopted drug packaging threshold, one dollar per final rule."""
def test_every_rule_year_has_one(self) -> None:
assert set(RULES) == set(_DRUG_PACKAGING_THRESHOLD)
@pytest.mark.parametrize("year", sorted(_DRUG_PACKAGING_THRESHOLD))
def test_matches_the_adopted_final_rule_dollar(self, year: int) -> None:
assert RULES[year].packaging_threshold == _DRUG_PACKAGING_THRESHOLD[year]
class TestAddendumBFixtureConsistency:
"""CI-runnable correctness proof against a committed slice of real
Addendum B rows.