Universal API Implementation Guide
1.1.20 - ci-build
Universal API Implementation Guide - Local Development build (v1.1.20) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
The Patient Foundation (GPF) enrollment process will now include the existing status value "Inconclusive" as a potential eligibility status for GPF enrollment outcomes. Previously, this value was not passed. Please refer to the Status Update Mapping - Status Query Response table for detailed implementation guidance.
The following Access Solutions/GPF questionnaires was removed:
| Available in Test Environment |
Product | linkId | Prescriber Form Version valid until: |
Comments |
|---|---|---|---|---|
| Yes | Evrysdi | "linkId": "therapy-gap" | Evrysdi Start Form (Prescriber Form) updated to v8 |
| Available in Test Environment |
Product | Description | Comments |
|---|---|---|---|
| Yes | All products | Addition of "Inconclusive" value for GPF Eligibility Status | This is an existing value that was not previously passed to external partners. The Status Query Response will include the same information that is received when GPF elgibility status is 'approved' or 'denied'. Refer to the Status Update Mapping - Status Query Response table. |
Example of GPF 'inconclusive' Eligibility Status in Status Query Response
{
"extension": [
{
"url": "http://test.gene.com/fhir/uapi/StructureDefinition/gpf-shipment-method",
"valueString": "Upfront"
},
{
"url": "http://test.gene.com/fhir/uapi/StructureDefinition/Outcome",
"valueString": "Inconclusive"
}
],
"identifier": [
{
"use": "old",
"system": "http://test.gene.com/fhir/uapi/enrollment/bundle-enrollment-id",
"value": "770a4598-8289-483c-8485-e0ccda8f33de"
},
{
"use": "official",
"system": "https://genentech-pps.my.salesforce.com/Case",
"value": "06884351"
}
| Available in Test Environment |
Product | linkId | Prescriber Form Version valid until: |
Comments |
|---|---|---|---|---|
| Yes | Evrysdi | "linkId": "newborn-policyholder" | Evrysdi Start Form (Prescriber Form) updated to v8 |
linkId: newborn-policyholder
{
"linkId": "evrysdi-newborn-policyholder",
"text": "If the patient is a newborn, is the insurance policyholder attesting that the newborn has been or will be added to the insurance(s) listed within the timeframe required by the insurance policy?",
"type": "choice",
"enableWhen": [
{
"question": "applied-for-bipa",
"operator": "=",
"answerBoolean": true
},
{
"question": "applied-for-starter",
"operator": "=",
"answerBoolean": true
}
],
"enableBehavior": "any",
"required": false,
"repeats": false,
"answerOption": [
{
"valueString": "Yes"
},
{
"valueString": "No"
}
Questionnaire validation error messages coming from Copay administrator references non-FHIR keys. Questionnaire validation error messages were translated so that linkIds are included in error message.
| OLD Questionnaire Error Validation Message from Copay Administrator |
Reference linkId | NEW Updated Error Questionnaire Validation Message with FHIR linkId |
|---|---|---|
| The expected response for the survey must include 'Yes' for the consent. | consent-to-enroll | The expected response for the survey must include 'Yes' for linkId: "consent-to-enroll" |
| The expected response for the survey must include 'Yes' for the ageCheck18 | 18-years-or-older | The expected response for the survey must include 'Yes' for linkId: "18-years-or-older" |
| The expected response for the survey must include 'Yes' for the commericalInsuranceCheck | commercial-private-insurance | The expected response for the survey must include 'Yes' for linkId: "commercial-private-insurance" |
| The expected response for the survey must include 'No' for the governmentInsuranceCheck and/or medicare red white and blue card 'Yes' | federal-state-funded-insurance medicare |
The expected response for the survey must include 'No' for linkId: "federal-state-funded-insurance" and/or linkId: "have-medicare-card" is 'Yes' |
| The expected response for the survey cannot be null for stateCheck | residence-state | The expected response for the survey cannot be null for linkId: "residence-state" |
| The expected response for the survey must include 'No' for the patientAssistanceCheck | receiving-medication-from-gpf | The expected response for the survey must include 'No' for linkId: "receiving-medication-from gpf" |
| The expected response for the survey must include 'No' for the patientOutofPocketCheck. | receiving-assistance-from-charitable-organization | The expected response for the survey must include 'No' for linkId: "receiving-assistance-from-charitable-organization" |
| The expected response for the survey must include 'Agree' for the disclosureCheck | agree-to-genentech-privacy-policy | The expected response for the survey must include 'Agree' for linkId: "agree-to-genentech-privacy-policy" |
| The expected response for the survey must include 'Agree' for the patientAgreement | agree-to-copay-program-terms | The expected response for the survey must include 'Agree' for linkId: "agree-to-copay-program-terms" |
| The expected response for the survey cannot inlcude 'None of the Above' or 'Unsure' or 'Not sure' or 'No' for the indicationCheck. | [product]-fda-approved-indications | This update is applicable for all products. This message occurs when user selects 'none of the above, unsure, No, or Not sure' for any of the products. For example: If linkId: "ocrevus-fda-approved-indications" is in the bundle, then the translated message will be: The expected response for the survey cannot inlcude 'None of the Above' or 'Unsure' or 'Not sure' or 'No' for linkId: "ocrevus-fda-approved-indications" |