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

Release 2026 Feb 06

ANNOUNCEMENTS

IMPORTANT: UAPI - GPF Prescriber Form Changes

• Updated GPF Prescriber Form (V6) will go into effect 1/1/2026
• Current GPF Prescriber Form (V5) will be valid until 3/31/2026
• Existing GPF questionnaires will remain as is, unless they are listed in the Removed table below. You should continue to include existing questionnaires in the FHIR bundle if they were required on the old form.
• The Patient Foundation is now requiring that insurance cards be sent to them. Since we do not accept files on our APIs, you have the following options to send the insurance cards (front/back) to Genentech:
  • Fax to the Patient Foundation (833) 999-4363
  • HCPs who are registered for MPS (My Patient Solution portal) can do the following:
    • HCPs can send a Secure Email via MPS and attach patient insurance card
    • Effective 3/9/2026, HCPs can upload copies of their insurance cards in MPS
  • Your own internal fax Solution
• All questionnaires updated to reflect the GPF changes and can be accessed via postman:
  • test environment: https://test-us-e1.apis.roche.com/…
  • stage environment: https://stage-us-e1.apis.roche.com/…

REMOVED

ADDITIONS

EXCLUDED - Questionnaires to be excluded from FHIR bundle

The following GPF questions will not be required to be answered as Genentech will automatically populate on your behalf:

OTHER GPF Update Information

• Under Step 4, if "Shipment to" = Prescriber, Practice or Site of Treatment, then the Treatment Site info should be provided.
  
• "Shipment to" is dependent on product. Options for each product can be found in product tables in the Implementation Guide > Business Rules > AS-GPF Enrollment - Products Specifics or the in questionnaire for each product.
  
• If Shipment to = "Site of Treatment" (linkID: 'Ship-to"), then it's assumed that linkID: "pos" = Hospital Outpatient or Infusion Center
  
• If Shipment to = "Site of Treatment", then the following should be included in the FHIR bundle
  

(1) Include linkId: "site-of-treatment-2" questionnaire in bundle.

    {
            "linkId" : "site-of-treatment-2",
            "text" : "Third-party Site of Treatment",
            "answer" : [
              {
                "valueReference" : {
                  "reference" : "urn:uuid:45cf0b29-8c1d-4882-91e1-00bc28c06a52", <----- The uuid of the Organization resource for the SOT
                  "type" : "Organization"
                }
              }
            ]
          },

(2) Include an Organization resource for the Site of Treatment where Organization.type.coding.code = other (partial sample below).
Example of SOT organization resource

{
  "resourceType" : "Organization",
  "id" : "45cf0b29-8c1d-4882-91e1-00bc28c06a52",
  "meta" : {
    "profile" : [
      "🔗", "https://fhir.developer.gene.com/StructureDefinition/uapi-organization"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : ""
  },
  "identifier" : [
    {
      "use" : "usual",
      "system" : "http://SOT.com",
      "value" : "SOT-001",
      "assigner" : {
        "display" : "Florida Hospital Orlando Infusion Center"
      }
    }
  ],
  "type" : [
    {
      "coding" : [
        {
          "system" : "http://terminology.hl7.org/CodeSystem/organization-type",
          "code" : "other",
          "display" : "Site of Treatment"
        }
      ],
      "text" : "Site of Treatment"
    }
  ],
  "name" : "FLORIDA HOSPITAL ORLANDO INFUSION CNTR"}

COPAY - Lunsumio and Lunsumio Velo

Questionnaires for Copay enrollments can be accessed by requesting Lunsumio Velo Copay questionnaire definitions from the Genentech FHIR Server.

URL to Copay Questionnaire endpoint (test): https://test-us-e1.apis.roche.com/pharma-cmg-copay-exp-test/v1/questionnaire?name=Copay Lunsumio Velo
URL to Copay Questionnaire endpoint (stage): https://stage-us-e1.apis.roche.com/pharma-cmg-copay-exp-stage/v1/questionnaire?name=Copay Lunsumio Velo
URL to Copay Questionnaire endpoint (prod): https://prod-us-e1.apis.roche.com/pharma-cmg-copay-exp-prod/v1/questionnaire?name=Copay Lunsumio Velo

Lunsumio Velo - BrandIds

Refer to brandIds table on Copay Value Set page

Lunsumio Velo - FDA Indications (ICD10)

FDA approved indications (ICD10 codes) can be found on the Access Solutions website for Lunsumio Velo

Lunsumio & Lunsumio Velo Questionnaire Updates