Merge pull request #1545 from CMSgov/QPPA-10635

QPPA-10635: Add support for SSP program

Author: chetanmunegowda

ERROR_MESSAGES.md

@@ -91,3 +91,4 @@ Any text in the following format `(Example)` are considered variables to be fill
 * 106 : CT - Promoting Interoperability data should not be reported in a PCF QRDA III file.
 * 107 : CT - There's missing NPI/TIN combination. The NPI/TIN `(npi)`-`(tin)` was active on the PCF practitioner roster for `(apm)` during the performance year but was not found in the file. Ensure your submission contains all NPI/TIN combinations that were active on your roster at any point during the performance year. Your QRDA III file and/or roster may require updates. The QPP website doesn't have access to roster updates made after December 13, 2025. It's critical to ensure your roster is up to date and your QRDA III file contains all NPI/TIN values that were active on your roster during the performance year. Contact your health IT vendor if your QRDA III file requires updates. You can find instructions on updating rosters in the PCF Practice Management Guide: (https://cmmi.my.salesforce.com/sfc/p/#i0000000iryR/a/t00000028RsP/dMF_romOmf5VLe7p5lUj8vch11mPmELP6ZuyI16vS.Y).
 * 108 : CT - Found an unexpected NPI/TIN combination. The NPI/TIN `(npi)`-`(tin)` was reported in the file but does not exist at the practice or was not active on the PCF practitioner roster for `(apm)` during the performance year. Ensure your submission only contains NPI/TIN combinations that were active on your roster at any point during the performance year. Your QRDA III file and/or roster may require updates. Note: The QPP website does not have access to roster updates made after December 13, 2025. It's critical that you ensure your roster is up to date and your QRDA III file contains all NPI/TIN values that were active on your roster during the performance year. Please contact your health IT vendor if your QRDA III file requires updates. You can find instructions on how updating rosters in the PCF Practice Management Guide (https://cmmi.my.salesforce.com/sfc/p/#i0000000iryR/a/t00000028RsP/dMF_romOmf5VLe7p5lUj8vch11mPmELP6ZuyI16vS.Y).
+* 109 : CT - Review the Clinical Document for program `(program name)`. Only the Promoting Interoperability (PI) measure category is permitted; found `(provided category)`.

commons/src/main/java/gov/cms/qpp/conversion/model/error/ProblemCode.java

@@ -203,7 +203,10 @@ public enum ProblemCode implements LocalizedProblem {
 		+ "all NPI/TIN values that were active on your roster during the performance year. "
 		+ "Please contact your health IT vendor if your QRDA III file requires updates. "
 		+ "You can find instructions on how updating rosters in the PCF Practice Management Guide "
-		+ "(https://cmmi.my.salesforce.com/sfc/p/#i0000000iryR/a/t00000028RsP/dMF_romOmf5VLe7p5lUj8vch11mPmELP6ZuyI16vS.Y).", true);
+		+ "(https://cmmi.my.salesforce.com/sfc/p/#i0000000iryR/a/t00000028RsP/dMF_romOmf5VLe7p5lUj8vch11mPmELP6ZuyI16vS.Y).", true),
+	SSP_PI_ONLY_MEASURE_CATEGORY(109, "Review the Clinical Document for program `(program name)`. "
+		+ "Only the Promoting Interoperability (PI) measure category is permitted; "
+		+ "found `(provided category)`.", true);
 
 	private static final Map<Integer, ProblemCode> CODE_TO_VALUE = Arrays.stream(values())
 			.collect(Collectors.toMap(ProblemCode::getCode, Function.identity()));

converter/src/main/java/gov/cms/qpp/conversion/decode/ClinicalDocumentDecoder.java

@@ -258,15 +258,15 @@ private Pair<String, String> getProgramNameEntityPair(String name) {
 				break;
 
 			case SSP_PI_INDIVIDUAL:
-				pair = new ImmutablePair<>(SSP_PI_INDIVIDUAL, ENTITY_INDIVIDUAL);
+				pair = new ImmutablePair<>(SSP_PROGRAM_NAME, ENTITY_INDIVIDUAL);
 				break;
 
 			case SSP_PI_GROUP:
-				pair = new ImmutablePair<>(SSP_PI_GROUP, ENTITY_GROUP);
+				pair = new ImmutablePair<>(SSP_PROGRAM_NAME, ENTITY_GROUP);
 				break;
 
 			case SSP_PI_APM:
-				pair = new ImmutablePair<>(SSP_PI_APM, ENTITY_APM);
+				pair = new ImmutablePair<>(SSP_PROGRAM_NAME, ENTITY_APM);
 				break;
 
 			default:

converter/src/main/java/gov/cms/qpp/conversion/encode/ClinicalDocumentEncoder.java

@@ -79,7 +79,7 @@ private void encodeToplevel(JsonWrapper wrapper, Node thisNode) {
 			wrapper.put(ENTITY_ID, thisNode.getValue(ENTITY_ID));
 		}
 
-		if ((Program.isApp(thisNode) || Program.isMips(thisNode) || Program.isAppPlus(thisNode))
+		if ((Program.isApp(thisNode) || Program.isMips(thisNode) || Program.isAppPlus(thisNode) || Program.isSsp(thisNode))
 				&& ENTITY_APM.equalsIgnoreCase(entityType)) {
 			wrapper.put(ENTITY_ID, thisNode.getValue(ENTITY_ID));
 		}

converter/src/main/java/gov/cms/qpp/conversion/model/Constants.java

@@ -67,6 +67,7 @@ public class Constants {
     public static final String ENTITY_VIRTUAL_GROUP = "virtualGroup";
     public static final String APP_PROGRAM_NAME = "app1";
     public static final String APP_PLUS_PROGRAM_NAME = "appPlus";
+    public static final String SSP_PROGRAM_NAME = "ssp";
     public static final String MIPS = "MIPS";
     public static final Set<String> MVP_ENTITIES = Set.of(ENTITY_INDIVIDUAL, ENTITY_GROUP, ENTITY_SUBGROUP, ENTITY_APM);
 

converter/src/main/java/gov/cms/qpp/conversion/model/Program.java

@@ -17,6 +17,7 @@ public enum Program {
 	PCF("PCF"),
 	APP("MIPS_APP1_INDIV", "MIPS_APP1_GROUP", "MIPS_APP1_APMENTITY"),
 	APP_PLUS("APP_PLUS_INDIV", "APP_PLUS_GROUP", "APP_PLUS_APMENTITY"),
+	SSP("SSP_PI_INDIV", "SSP_PI_GROUP", "SSP_PI_APMENTITY"),
 	ALL;
 
 	private final Set<String> aliases;
@@ -70,6 +71,16 @@ public static boolean isAppPlus(Node node) {
 		return extractProgram(node) == Program.APP_PLUS;
 	}
 
+	/**
+	 * Checks if a node is using the ssp program
+	 *
+	 * @param node
+	 * @return
+	 */
+	public static boolean isSsp(Node node) {
+		return extractProgram(node) == Program.SSP;
+	}
+
 	/**
 	 * Extracts a program type from a node
 	 *

converter/src/main/java/gov/cms/qpp/conversion/validate/ClinicalDocumentValidator.java

@@ -53,7 +53,7 @@ protected void performValidation(final Node node) {
 			String entityType = Optional.ofNullable(node.getValue(ENTITY_TYPE)).orElse("<missing>");
 
 			forceCheckErrors(node).valueIn(ProblemCode.CLINICAL_DOCUMENT_INCORRECT_PROGRAM_NAME.format(VALID_PROGRAM_NAMES, programName),
-				PROGRAM_NAME, MIPS_PROGRAM_NAME, PCF, APP_PROGRAM_NAME, APP_PLUS_PROGRAM_NAME);
+				PROGRAM_NAME, MIPS_PROGRAM_NAME, PCF, APP_PROGRAM_NAME, APP_PLUS_PROGRAM_NAME, SSP_PROGRAM_NAME);
 
 			if (ENTITY_VIRTUAL_GROUP.equals(entityType)) {
 				forceCheckErrors(node).value(ProblemCode.VIRTUAL_GROUP_ID_REQUIRED, ENTITY_ID);

converter/src/main/java/gov/cms/qpp/conversion/validate/SspClinicalDocumentValidator.java

@@ -0,0 +1,35 @@
+package gov.cms.qpp.conversion.validate;
+
+import gov.cms.qpp.conversion.model.Node;
+import gov.cms.qpp.conversion.model.Program;
+import gov.cms.qpp.conversion.model.TemplateId;
+import gov.cms.qpp.conversion.model.Validator;
+import gov.cms.qpp.conversion.model.error.LocalizedProblem;
+import gov.cms.qpp.conversion.model.error.ProblemCode;
+
+import java.util.Locale;
+
+import static gov.cms.qpp.conversion.model.Constants.CATEGORY;
+import static gov.cms.qpp.conversion.model.Constants.PROGRAM_NAME;
+
+@Validator(value = TemplateId.CLINICAL_DOCUMENT, program = Program.SSP)
+public class SspClinicalDocumentValidator extends NodeValidator {
+    private static final String ALLOWED_CATEGORY = "pi";
+
+    @Override
+    protected void performValidation(Node clinicalDocument) {
+        String programName = clinicalDocument.getValue(PROGRAM_NAME).toUpperCase(Locale.ROOT);
+        clinicalDocument
+                .getChildNodes(TemplateId.MEASURE_SECTION_V5)
+                .forEach(sectionNode -> {
+                    String category = sectionNode.getValue(CATEGORY);
+                    System.out.println("category: " + category);
+                    if (category == null || !ALLOWED_CATEGORY.equalsIgnoreCase(category)) {
+                        LocalizedProblem error = ProblemCode.SSP_PI_ONLY_MEASURE_CATEGORY
+                                .format(programName, category == null ? "none" : category);
+                        checkErrors(sectionNode)
+                                .valueIn(error, CATEGORY, ALLOWED_CATEGORY);
+                    }
+                });
+    }
+}

converter/src/test/java/gov/cms/qpp/conversion/model/ProgramTest.java

@@ -136,6 +136,41 @@ void testIsAppPlusAppEntityIsTrue() {
 		assertThat(Program.isAppPlus(node)).isTrue();
 	}
 
+	@Test
+	void testIsSspIndividualIsTrue() {
+		Node node = new Node();
+		node.putValue(RAW_PROGRAM_NAME, "SSP_PI_INDIV");
+		assertThat(Program.isSsp(node)).isTrue();
+	}
+
+	@Test
+	void testIsSspGroupIsTrue() {
+		Node node = new Node();
+		node.putValue(RAW_PROGRAM_NAME, "SSP_PI_GROUP");
+		assertThat(Program.isSsp(node)).isTrue();
+	}
+
+	@Test
+	void testIsSspAppEntityIsTrue() {
+		Node node = new Node();
+		node.putValue(RAW_PROGRAM_NAME, "SSP_PI_APMENTITY");
+		assertThat(Program.isSsp(node)).isTrue();
+	}
+
+	@Test
+	void testIsSspReturnsFalseForMips() {
+		Node node = new Node();
+		node.putValue(RAW_PROGRAM_NAME, "MIPS_INDIV");
+		assertThat(Program.isSsp(node)).isFalse();
+	}
+
+	@Test
+	void testIsSspReturnsFalseForNullValue() {
+		Node node = new Node();
+		node.putValue(RAW_PROGRAM_NAME, null);
+		assertThat(Program.isSsp(node)).isFalse();
+	}
+
 	@Override
 	public Class<? extends Enum<?>> getEnumType() {
 		return Program.class;

converter/src/test/java/gov/cms/qpp/conversion/validate/SspClinicalDocumentValidatorTest.java

@@ -0,0 +1,72 @@
+package gov.cms.qpp.conversion.validate;
+
+import static com.google.common.truth.Truth.assertWithMessage;
+
+import java.util.List;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import gov.cms.qpp.conversion.model.Node;
+import gov.cms.qpp.conversion.model.TemplateId;
+import gov.cms.qpp.conversion.model.error.Detail;
+import gov.cms.qpp.conversion.model.error.ProblemCode;
+import gov.cms.qpp.conversion.model.error.correspondence.DetailsErrorEquals;
+
+class SspClinicalDocumentValidatorTest {
+
+    private Node clinicalDocumentNode;
+    private Node measureSectionNode;
+
+    @BeforeEach
+    void setUp() {
+        clinicalDocumentNode = new Node(TemplateId.CLINICAL_DOCUMENT);
+        clinicalDocumentNode.putValue("programName", "SSP");
+
+        measureSectionNode = new Node(TemplateId.MEASURE_SECTION_V5);
+    }
+
+    @Test
+    void testValidCategory_NoErrors() {
+        measureSectionNode.putValue("category", "pi");
+        clinicalDocumentNode.addChildNode(measureSectionNode);
+
+        SspClinicalDocumentValidator validator = new SspClinicalDocumentValidator();
+        List<Detail> errors = validator.validateSingleNode(clinicalDocumentNode).getErrors();
+
+        assertWithMessage("There should be no errors for category 'pi'")
+                .that(errors).isEmpty();
+    }
+
+    @Test
+    void testNullCategory_ShouldError() {
+        // category is not set
+        clinicalDocumentNode.addChildNode(measureSectionNode);
+
+        SspClinicalDocumentValidator validator = new SspClinicalDocumentValidator();
+        List<Detail> errors = validator.validateSingleNode(clinicalDocumentNode).getErrors();
+
+        assertWithMessage("Must report SSP_PI_ONLY_MEASURE_CATEGORY when category is null")
+                .that(errors)
+                .comparingElementsUsing(DetailsErrorEquals.INSTANCE)
+                .containsExactly(
+                        ProblemCode.SSP_PI_ONLY_MEASURE_CATEGORY.format("SSP", "none")
+                );
+    }
+
+    @Test
+    void testInvalidCategory_ShouldError() {
+        measureSectionNode.putValue("category", "invalid");
+        clinicalDocumentNode.addChildNode(measureSectionNode);
+
+        SspClinicalDocumentValidator validator = new SspClinicalDocumentValidator();
+        List<Detail> errors = validator.validateSingleNode(clinicalDocumentNode).getErrors();
+
+        assertWithMessage("Must report SSP_PI_ONLY_MEASURE_CATEGORY when category is invalid")
+                .that(errors)
+                .comparingElementsUsing(DetailsErrorEquals.INSTANCE)
+                .containsExactly(
+                        ProblemCode.SSP_PI_ONLY_MEASURE_CATEGORY.format("SSP", "invalid")
+                );
+    }
+}