Cerner Oracle Health SMART on FHIR Patient Retrieval

arazzo: 1.0.1
info:
  title: Cerner Oracle Health SMART on FHIR Patient Retrieval
  summary: Discover server capabilities, locate a patient, then pull the patient's conditions, encounters, and procedures.
  description: >-
    The canonical SMART on FHIR read flow against the Cerner / Oracle Health FHIR
    R4 API. The CapabilityStatement is fetched first (the SMART App Launch
    conformance step), the patient is located by identifier or name, and the US
    Core clinical context is retrieved: Conditions (problem list), Encounters, and
    Procedures. Every step inlines its request so the flow can be read and executed
    without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-2800.20
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-2800.20
      capability_name: Patient Registration Management
      spec: cerner-patient-api-openapi.yml
      confidence: 0.72
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: capabilityApi
  url: ../openapi/cerner-capability-api-openapi.yml
  type: openapi
- name: conditionApi
  url: ../openapi/cerner-condition-api-openapi.yml
  type: openapi
- name: encounterApi
  url: ../openapi/cerner-encounter-api-openapi.yml
  type: openapi
- name: patientApi
  url: ../openapi/cerner-patient-api-openapi.yml
  type: openapi
- name: procedureApi
  url: ../openapi/cerner-procedure-api-openapi.yml
  type: openapi
workflows:
- workflowId: smart-patient-data-retrieval
  summary: Retrieve a patient's conditions, encounters, and procedures after capability discovery.
  description: >-
    Reads the CapabilityStatement, finds the patient, then pulls Conditions,
    Encounters, and Procedures for that patient.
  inputs:
    type: object
    required:
    - name
    properties:
      name:
        type: string
        description: Patient name to search on.
      identifier:
        type: string
        description: Optional business identifier (system|value) to disambiguate the patient match.
  steps:
  - stepId: discoverCapabilities
    description: Fetch the FHIR CapabilityStatement to confirm supported resources and SMART launch endpoints.
    operationId: getCapabilityStatement
    successCriteria:
    - condition: $statusCode == 200
  - stepId: findPatient
    description: Locate the patient by name (and identifier when supplied).
    operationId: searchPatient
    parameters:
    - name: name
      in: query
      value: $inputs.name
    - name: identifier
      in: query
      value: $inputs.identifier
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      patientId: $response.body#/entry/0/resource/id
  - stepId: getConditions
    description: Retrieve the patient's Conditions (problem list).
    operationId: searchCondition
    parameters:
    - name: patient
      in: query
      value: $steps.findPatient.outputs.patientId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      conditions: $response.body
  - stepId: getEncounters
    description: Retrieve the patient's Encounters.
    operationId: searchEncounter
    parameters:
    - name: patient
      in: query
      value: $steps.findPatient.outputs.patientId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      encounters: $response.body
  - stepId: getProcedures
    description: Retrieve the patient's Procedures.
    operationId: searchProcedure
    parameters:
    - name: patient
      in: query
      value: $steps.findPatient.outputs.patientId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      procedures: $response.body
  outputs:
    patientId: $steps.findPatient.outputs.patientId
    conditions: $steps.getConditions.outputs.conditions
    encounters: $steps.getEncounters.outputs.encounters
    procedures: $steps.getProcedures.outputs.procedures