From 771f5129dab11280a5804e8e0691b7134d0a2bba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Karla=20Valc=C3=A1rcel=20Mart=C3=ADnez?= <99458559+karla-vm@users.noreply.github.com> Date: Mon, 20 May 2024 14:43:00 -0400 Subject: [PATCH] CMDCT-3660: Refactor HTML in JSON Templates (#11696) --- services/app-api/forms/mcpar.json | 372 ++++++++++++++++++------------ services/app-api/forms/mlr.json | 37 +-- 2 files changed, 246 insertions(+), 163 deletions(-) diff --git a/services/app-api/forms/mcpar.json b/services/app-api/forms/mcpar.json index 582128480..ed237b1a1 100644 --- a/services/app-api/forms/mcpar.json +++ b/services/app-api/forms/mcpar.json @@ -181,21 +181,30 @@ "spreadsheet": "A_Program_Info", "info": [ { - "type": "span", - "content": "Enter the names of Beneficiary Support System (BSS) entities that support enrollees in the program for which the state is reporting data. Learn more about BSS entities at " - }, - { - "type": "externalLink", - "content": "42 CFR 438.71", - "props": { - "href": "https://www.ecfr.gov/current/title-42/chapter-IV/subchapter-C/part-438/subpart-B/section-438.71", - "target": "_blank", - "aria-label": "42 CFR 438.71 (link opens in new tab)." - } + "type": "p", + "children": [ + { + "type": "html", + "content": "Enter the names of Beneficiary Support System (BSS) entities that support enrollees in the program for which the state is reporting data. Learn more about BSS entities at " + }, + { + "type": "externalLink", + "content": "42 CFR 438.71", + "props": { + "href": "https://www.ecfr.gov/current/title-42/chapter-IV/subchapter-C/part-438/subpart-B/section-438.71", + "target": "_blank", + "aria-label": "42 CFR 438.71 (link opens in new tab)." + } + }, + { + "type": "html", + "content": "See Glossary in Excel Workbook for the definition of BSS entities." + } + ] }, { - "type": "html", - "content": ". See Glossary in Excel Workbook for the definition of BSS entities.

Examples of BSS entity types include a: State or Local Government Entity, Ombudsman Program, State Health Insurance Program (SHIP), Aging and Disability Resource Network (ADRN), Center for Indepedent Living (CIL), Legal Assistance Organization, Community-based Organization, Subcontractor, Enrollment Broker, Consultant, or Academic/Research Organization.

" + "type": "p", + "content": "Examples of BSS entity types include a: State or Local Government Entity, Ombudsman Program, State Health Insurance Program (SHIP), Aging and Disability Resource Network (ADRN), Center for Indepedent Living (CIL), Legal Assistance Organization, Community-based Organization, Subcontractor, Enrollment Broker, Consultant, or Academic/Research Organization." } ] } @@ -224,21 +233,26 @@ "subsection": "In Lieu of Services and Settings Offered", "info": [ { - "type": "span", - "content": "If In Lieu of Services and Settings (ILOS) are available in this managed care program, enter the name of each ILOS offered, as approved in the managed care plan contract(s). Do not include short-term IMD stays. You are required to complete this section if ILOS are available. Do not include short-term IMD stays. Access " - }, - { - "type": "externalLink", - "content": "guidance on In Lieu of Services on Medicaid.gov", - "props": { - "href": "https://www.medicaid.gov/medicaid/managed-care/guidance/lieu-of-services-and-settings/index.html", - "target": "_blank", - "aria-label": "guidance on In Lieu of Services on Medicaid.gov (link opens in new tab)." - } - }, - { - "type": "span", - "content": "." + "type": "p", + "children": [ + { + "type": "html", + "content": "If In Lieu of Services and Settings (ILOS) are available in this managed care program, enter the name of each ILOS offered, as approved in the managed care plan contract(s). Do not include short-term IMD stays. You are required to complete this section if ILOS are available. Do not include short-term IMD stays. Access " + }, + { + "type": "externalLink", + "content": "guidance on In Lieu of Services on Medicaid.gov", + "props": { + "href": "https://www.medicaid.gov/medicaid/managed-care/guidance/lieu-of-services-and-settings/index.html", + "target": "_blank", + "aria-label": "guidance on In Lieu of Services on Medicaid.gov (link opens in new tab)." + } + }, + { + "type": "html", + "content": "." + } + ] } ], "spreadsheet": "A_Program_Info" @@ -1055,8 +1069,12 @@ "content": "Access Measures" }, { - "type": "html", - "content": "

Describe the measures the state uses to monitor availability, accessibility, and network adequacy. Report at the program level.

Revisions to the Medicaid managed care regulations in 2016 and 2020 built on existing requirements that managed care plans maintain provider networks sufficient to ensure adequate access to covered services by: (1) requiring states to develop quantitative network adequacy standards for at least eight specified provider types if covered under the contract, and to make these standards available online; (2) strengthening network adequacy monitoring requirements; and (3) addressing the needs of people with long-term care service needs (42 CFR 438.66; 42 CFR 438.68).

42 CFR 438.66(e) specifies that the MCPAR must provide information on and an assessment of the availability and accessibility of covered services within the MCO, PHIP, or PAHP contracts, including network adequacy standards for each managed care program.

" + "type": "p", + "content": "Describe the measures the state uses to monitor availability, accessibility, and network adequacy. Report at the program level." + }, + { + "type": "p", + "content": "Revisions to the Medicaid managed care regulations in 2016 and 2020 built on existing requirements that managed care plans maintain provider networks sufficient to ensure adequate access to covered services by: (1) requiring states to develop quantitative network adequacy standards for at least eight specified provider types if covered under the contract, and to make these standards available online; (2) strengthening network adequacy monitoring requirements; and (3) addressing the needs of people with long-term care service needs (42 CFR 438.66; 42 CFR 438.68).

42 CFR 438.66(e) specifies that the MCPAR must provide information on and an assessment of the availability and accessibility of covered services within the MCO, PHIP, or PAHP contracts, including network adequacy standards for each managed care program." } ] }, @@ -1527,15 +1545,20 @@ "drawerTitle": "Report program characteristics & enrollment for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -1591,15 +1614,20 @@ "drawerTitle": "Report financial performance for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -1734,15 +1762,20 @@ "drawerTitle": "Report encounter data for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -1813,15 +1846,20 @@ ], "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2015,15 +2053,20 @@ "drawerTitle": "Report appeals by service for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2165,15 +2208,20 @@ "drawerTitle": "Report state fair hearings and external medical reviews for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2271,15 +2319,20 @@ "drawerTitle": "Report on grievances for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2376,15 +2429,20 @@ ], "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2536,15 +2594,20 @@ ], "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -2689,8 +2752,8 @@ "spreadsheet": "D2_Plan_Measures", "info": [ { - "type": "html", - "content": "

Report on individual measures in each of the following eight domains: (1) Primary care access and preventive care, (2) Maternal and perinatal health, (3) Care of acute and chronic conditions, (4) Behavioral health care, (5) Dental and oral health services, (6) Health plan enrollee experience of care, (7) Long-term services and supports, and (8) Other. For composite measures, be sure to include each individual sub-measure component.

" + "type": "p", + "content": "Report on individual measures in each of the following eight domains: (1) Primary care access and preventive care, (2) Maternal and perinatal health, (3) Care of acute and chronic conditions, (4) Behavioral health care, (5) Dental and oral health services, (6) Health plan enrollee experience of care, (7) Long-term services and supports, and (8) Other. For composite measures, be sure to include each individual sub-measure component." } ] }, @@ -2954,8 +3017,8 @@ "spreadsheet": "D3_Plan_Sanctions", "info": [ { - "type": "html", - "content": "

Describe sanctions that the state has issued for each plan. Report all known actions across the following domains: sanctions, administrative penalties, corrective action plans, other. Include any pending or unresolved actions.

42 CFR 438.66(e)(2)(viii) specifies that the MCPAR include the results of any sanctions or corrective action plans imposed by the State or other formal or informal intervention with a contracted MCO, PIHP, PAHP, or PCCM entity to improve performance.

" + "type": "p", + "content": "Describe sanctions that the state has issued for each plan. Report all known actions across the following domains: sanctions, administrative penalties, corrective action plans, other. Include any pending or unresolved actions.

42 CFR 438.66(e)(2)(viii) specifies that the MCPAR include the results of any sanctions or corrective action plans imposed by the State or other formal or informal intervention with a contracted MCO, PIHP, PAHP, or PCCM entity to improve performance." } ] }, @@ -3206,15 +3269,20 @@ "drawerTitle": "Program integrity for", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " - }, - { - "type": "internalLink", - "content": "Add Plans", - "props": { - "to": "/mcpar/program-information/add-plans" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing plans. You won’t be able to complete this section until you’ve added all the plans that participate in this program in section A.7. " + }, + { + "type": "internalLink", + "content": "Add Plans", + "props": { + "to": "/mcpar/program-information/add-plans" + } + } + ] } ] }, @@ -3420,7 +3488,7 @@ "spreadsheet": "D4_Plan_ILOS", "info": [ { - "type": "span", + "type": "p", "content": "If In Lieu of Services and Settings (ILOS) are available in this managed care program, report ILOS utilization for each plan during the contract rating period. Select \"Enter\" for each plan listed below to indicate whether or not ILOS were offered by the plan, select which ILOS the plan offered, and enter data on utilization for each ILOS offered." } ] @@ -3592,19 +3660,24 @@ "spreadsheet": "E_BSS_Entities", "info": [ { - "type": "span", - "content": "Per 42 CFR 438.66(e)(2)(ix), the Managed Care Program Annual Report must provide information on and an assessment of the operation of the managed care program including activities and performance of the beneficiary support system. Information on how BSS entities support program-level functions is on the " - }, - { - "type": "internalLink", - "content": "Program-Level BSS", - "props": { - "to": "/mcpar/program-information/add-bss-entities" - } - }, - { - "type": "span", - "content": " page." + "type": "p", + "children": [ + { + "type": "html", + "content": "Per 42 CFR 438.66(e)(2)(ix), the Managed Care Program Annual Report must provide information on and an assessment of the operation of the managed care program including activities and performance of the beneficiary support system. Information on how BSS entities support program-level functions is on the " + }, + { + "type": "internalLink", + "content": "Program-Level BSS", + "props": { + "to": "/mcpar/program-information/add-bss-entities" + } + }, + { + "type": "html", + "content": " page." + } + ] } ] }, @@ -3612,15 +3685,20 @@ "drawerTitle": "Report on", "missingEntityMessage": [ { - "type": "span", - "content": "This program is missing BSS entities. You won’t be able to complete this section until you’ve added all the names of BSS entities that support enrollees in the program. " - }, - { - "type": "internalLink", - "content": "Add BSS entities", - "props": { - "to": "/mcpar/program-information/add-bss-entities" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "This program is missing BSS entities. You won’t be able to complete this section until you’ve added all the names of BSS entities that support enrollees in the program. " + }, + { + "type": "internalLink", + "content": "Add BSS entities", + "props": { + "to": "/mcpar/program-information/add-bss-entities" + } + } + ] } ] }, diff --git a/services/app-api/forms/mlr.json b/services/app-api/forms/mlr.json index e532ce16b..fceec71d3 100644 --- a/services/app-api/forms/mlr.json +++ b/services/app-api/forms/mlr.json @@ -21,7 +21,7 @@ }, "praDisclosure": [ { - "type": "span", + "type": "html", "content": "PRA Disclosure Statement
According to the Paperwork Reduction Act of 1995, no persons are required to respond to a collection of information unless it displays a valid OMB control number. The valid OMB control number for this information collection is 0938-0920 (Expires: June 30, 2024). The time required to complete this information collection is estimated to average 6 hours per response, including the time to review instructions, search existing data resources, gather the data needed, and complete and review the information collection. If you have comments concerning the accuracy of the time estimate(s) or suggestions for improving this form, please write to: CMS, 7500 Security Boulevard, Attn: PRA Reports Clearance Officer, Mail Stop C4-26-05, Baltimore, Maryland 21244-1850" } ] @@ -205,17 +205,22 @@ "label": "I. MCO, PIHP, or PAHP Name", "hint": [ { - "type": "span", - "content": "Enter the full name of the plan relevant to this report. Do not abbreviate plan names. All MCOs/PIHPs/PAHPs contracted in a specific program should be reported, including non-credible plans with small enrollment. Plan names should reflect those used in the Medicaid enrollment report: " - }, - { - "type": "externalLink", - "content": "\"Managed Care Enrollment by Program and Plan\"", - "props": { - "href": "https://www.medicaid.gov/medicaid/managed-care/enrollment-report/index.html", - "target": "_blank", - "aria-label": "Link opens in new tab" - } + "type": "p", + "children": [ + { + "type": "html", + "content": "Enter the full name of the plan relevant to this report. Do not abbreviate plan names. All MCOs/PIHPs/PAHPs contracted in a specific program should be reported, including non-credible plans with small enrollment. Plan names should reflect those used in the Medicaid enrollment report: " + }, + { + "type": "externalLink", + "content": "\"Managed Care Enrollment by Program and Plan\"", + "props": { + "href": "https://www.medicaid.gov/medicaid/managed-care/enrollment-report/index.html", + "target": "_blank", + "aria-label": "Link opens in new tab" + } + } + ] } ] } @@ -272,7 +277,7 @@ "label": "L. Eligibility group", "hint": [ { - "type": "span", + "type": "html", "content": "Enter the eligibility group for this MLR report. Most states provide MLR reports for all populations. In this case, select \"All Populations.\" If the state is providing additional detail for specific eligibility groups, see below for instructions related to each group." }, { @@ -287,7 +292,7 @@ }, "children": [ { - "type": "span", + "type": "html", "content": "For separate CHIP reporting: States that intend to report MLRs for separate CHIP-only programs should select \"Standalone CHIP\". These separate child health assistance programs are defined in " }, { @@ -310,7 +315,7 @@ }, "children": [ { - "type": "span", + "type": "html", "content": "For SUPPORT Act reporting: States that intend to qualify for the SUPPORT Act Section 4001 MLR provision must provide an MLR for the eligibility group described in section 1902(a)(10)(A)(i)(VIII) (referred to here as \"the Expansion Group\"). Select \"Group VIII Expansion Adult Only\"." } ] @@ -324,7 +329,7 @@ }, "children": [ { - "type": "span", + "type": "html", "content": "For States that intend to report separate MLRs for elibility groups that are served under the same program, select \"Other, specify\"." } ]