candidhealth 0.39.6 → 0.39.8

data/lib/candidhealth/fee_schedules/v_3/types/validation_error.rb

@@ -4,6 +4,7 @@ require "json"
 require_relative "overlapping_rate_entries_error"
 require_relative "../../../commons/types/entity_conflict_error_message"
 require_relative "../../../commons/types/entity_not_found_error_message"
+require_relative "payer_plan_group_does_not_match_rate_payer_error"
 
 module CandidApiClient
   module FeeSchedules
@@ -32,20 +33,24 @@ module CandidApiClient
           # @return [CandidApiClient::FeeSchedules::V3::Types::ValidationError]
           def self.from_json(json_object:)
             struct = JSON.parse(json_object, object_class: OpenStruct)
-            member = case struct.type
-                     when "overlapping_rate_entries"
-                       CandidApiClient::FeeSchedules::V3::Types::OverlappingRateEntriesError.from_json(json_object: json_object)
-                     when "version_conflict"
-                       CandidApiClient::Commons::Types::EntityConflictErrorMessage.from_json(json_object: json_object)
-                     when "organization_provider_not_found"
-                       CandidApiClient::Commons::Types::EntityNotFoundErrorMessage.from_json(json_object: json_object)
-                     when "duplicate_rate"
-                       nil
-                     when "empty_entries"
-                       nil
-                     else
-                       CandidApiClient::FeeSchedules::V3::Types::OverlappingRateEntriesError.from_json(json_object: json_object)
-                     end
+            case struct.type
+            when "overlapping_rate_entries"
+              member = CandidApiClient::FeeSchedules::V3::Types::OverlappingRateEntriesError.from_json(json_object: json_object)
+            when "version_conflict"
+              member = CandidApiClient::Commons::Types::EntityConflictErrorMessage.from_json(json_object: json_object)
+            when "organization_provider_not_found"
+              member = CandidApiClient::Commons::Types::EntityNotFoundErrorMessage.from_json(json_object: json_object)
+            when "duplicate_rate"
+              member = nil
+            when "empty_entries"
+              member = nil
+            when "payer_plan_group_not_found"
+              member = CandidApiClient::Commons::Types::EntityNotFoundErrorMessage.from_json(json_object: json_object)
+            when "payer_plan_group_does_not_match_rate_payer"
+              member = CandidApiClient::FeeSchedules::V3::Types::PayerPlanGroupDoesNotMatchRatePayerError.from_json(json_object: json_object)
+            else
+              member = CandidApiClient::FeeSchedules::V3::Types::OverlappingRateEntriesError.from_json(json_object: json_object)
+            end
             new(member: member, discriminant: struct.type)
           end
 
@@ -64,6 +69,10 @@ module CandidApiClient
               { type: @discriminant }.to_json
             when "empty_entries"
               { type: @discriminant }.to_json
+            when "payer_plan_group_not_found"
+              { **@member.to_json, type: @discriminant }.to_json
+            when "payer_plan_group_does_not_match_rate_payer"
+              { **@member.to_json, type: @discriminant }.to_json
             else
               { "type": @discriminant, value: @member }.to_json
             end
@@ -88,6 +97,10 @@ module CandidApiClient
               # noop
             when "empty_entries"
               # noop
+            when "payer_plan_group_not_found"
+              CandidApiClient::Commons::Types::EntityNotFoundErrorMessage.validate_raw(obj: obj)
+            when "payer_plan_group_does_not_match_rate_payer"
+              CandidApiClient::FeeSchedules::V3::Types::PayerPlanGroupDoesNotMatchRatePayerError.validate_raw(obj: obj)
             else
               raise("Passed value matched no type within the union, validation failed.")
             end
@@ -128,6 +141,18 @@ module CandidApiClient
           def self.empty_entries
             new(member: nil, discriminant: "empty_entries")
           end
+
+          # @param member [CandidApiClient::Commons::Types::EntityNotFoundErrorMessage]
+          # @return [CandidApiClient::FeeSchedules::V3::Types::ValidationError]
+          def self.payer_plan_group_not_found(member:)
+            new(member: member, discriminant: "payer_plan_group_not_found")
+          end
+
+          # @param member [CandidApiClient::FeeSchedules::V3::Types::PayerPlanGroupDoesNotMatchRatePayerError]
+          # @return [CandidApiClient::FeeSchedules::V3::Types::ValidationError]
+          def self.payer_plan_group_does_not_match_rate_payer(member:)
+            new(member: member, discriminant: "payer_plan_group_does_not_match_rate_payer")
+          end
         end
       end
     end

data/lib/candidhealth/organization_providers/v_2/types/license_type.rb

@@ -96,6 +96,10 @@ module CandidApiClient
           PLMHP = "PLMHP"
           PCMSW = "PCMSW"
           LMHP = "LMHP"
+          OTRL = "OTR/L"
+          RPA = "RPA"
+          COTA = "COTA"
+          CRNP = "CRNP"
         end
       end
     end

data/lib/candidhealth/pre_encounter/appointments/v_1/client.rb

@@ -3,6 +3,8 @@
 require_relative "../../../../requests"
 require_relative "types/mutable_appointment"
 require_relative "types/appointment"
+require_relative "../../common/types/sort_direction"
+require_relative "types/visits_page"
 require "json"
 require "date"
 require "async"
@@ -47,6 +49,7 @@ module CandidApiClient
           #       * :start (Date)
           #       * :end_ (Date)
           #     * :canonical_id (String)
+          #     * :fax (String)
           #   * :estimated_copay_cents (Integer)
           #   * :estimated_patient_responsibility_cents (Integer)
           #   * :patient_deposit_cents (Integer)
@@ -59,7 +62,7 @@ module CandidApiClient
           # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Appointment]
           # @example
           #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
-          #  api.pre_encounter.appointments.v_1.create(request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE })
+          #  api.pre_encounter.appointments.v_1.create(request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string", fax: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE })
           def create(request:, request_options: nil)
             response = @request_client.conn.post do |req|
               req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -76,6 +79,49 @@ module CandidApiClient
             CandidApiClient::PreEncounter::Appointments::V1::Types::Appointment.from_json(json_object: response.body)
           end
 
+          # Gets all Visits within a given time range. The return list is ordered by
+          #  start_time ascending.
+          #
+          # @param page_token [String]
+          # @param limit [Integer]
+          # @param sort_field [String] Defaults to appointment.start_time.
+          # @param sort_direction [CandidApiClient::PreEncounter::Common::Types::SortDirection] Defaults to ascending.
+          # @param filters [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.appointments.v_1.get_visits(
+          #    page_token: "string",
+          #    limit: 1,
+          #    sort_field: "string",
+          #    sort_direction: ASC,
+          #    filters: "string"
+          #  )
+          def get_visits(page_token: nil, limit: nil, sort_field: nil, sort_direction: nil, filters: nil,
+                         request_options: nil)
+            response = @request_client.conn.get do |req|
+              req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+              req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.params = {
+                **(request_options&.additional_query_parameters || {}),
+                "page_token": page_token,
+                "limit": limit,
+                "sort_field": sort_field,
+                "sort_direction": sort_direction,
+                "filters": filters
+              }.compact
+              req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                 request_options: request_options)}/appointments/v1/visits"
+            end
+            CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage.from_json(json_object: response.body)
+          end
+
           # Gets an appointment.
           #
           # @param id [String]
@@ -155,6 +201,7 @@ module CandidApiClient
           #       * :start (Date)
           #       * :end_ (Date)
           #     * :canonical_id (String)
+          #     * :fax (String)
           #   * :estimated_copay_cents (Integer)
           #   * :estimated_patient_responsibility_cents (Integer)
           #   * :patient_deposit_cents (Integer)
@@ -170,7 +217,7 @@ module CandidApiClient
           #  api.pre_encounter.appointments.v_1.update(
           #    id: "string",
           #    version: "string",
-          #    request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE }
+          #    request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string", fax: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE }
           #  )
           def update(id:, version:, request:, request_options: nil)
             response = @request_client.conn.put do |req|
@@ -280,6 +327,7 @@ module CandidApiClient
           #       * :start (Date)
           #       * :end_ (Date)
           #     * :canonical_id (String)
+          #     * :fax (String)
           #   * :estimated_copay_cents (Integer)
           #   * :estimated_patient_responsibility_cents (Integer)
           #   * :patient_deposit_cents (Integer)
@@ -292,7 +340,7 @@ module CandidApiClient
           # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Appointment]
           # @example
           #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
-          #  api.pre_encounter.appointments.v_1.create(request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE })
+          #  api.pre_encounter.appointments.v_1.create(request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string", fax: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE })
           def create(request:, request_options: nil)
             Async do
               response = @request_client.conn.post do |req|
@@ -311,6 +359,51 @@ module CandidApiClient
             end
           end
 
+          # Gets all Visits within a given time range. The return list is ordered by
+          #  start_time ascending.
+          #
+          # @param page_token [String]
+          # @param limit [Integer]
+          # @param sort_field [String] Defaults to appointment.start_time.
+          # @param sort_direction [CandidApiClient::PreEncounter::Common::Types::SortDirection] Defaults to ascending.
+          # @param filters [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.appointments.v_1.get_visits(
+          #    page_token: "string",
+          #    limit: 1,
+          #    sort_field: "string",
+          #    sort_direction: ASC,
+          #    filters: "string"
+          #  )
+          def get_visits(page_token: nil, limit: nil, sort_field: nil, sort_direction: nil, filters: nil,
+                         request_options: nil)
+            Async do
+              response = @request_client.conn.get do |req|
+                req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+                req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+                req.headers = {
+              **(req.headers || {}),
+              **@request_client.get_headers,
+              **(request_options&.additional_headers || {})
+                }.compact
+                req.params = {
+                  **(request_options&.additional_query_parameters || {}),
+                  "page_token": page_token,
+                  "limit": limit,
+                  "sort_field": sort_field,
+                  "sort_direction": sort_direction,
+                  "filters": filters
+                }.compact
+                req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                   request_options: request_options)}/appointments/v1/visits"
+              end
+              CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage.from_json(json_object: response.body)
+            end
+          end
+
           # Gets an appointment.
           #
           # @param id [String]
@@ -394,6 +487,7 @@ module CandidApiClient
           #       * :start (Date)
           #       * :end_ (Date)
           #     * :canonical_id (String)
+          #     * :fax (String)
           #   * :estimated_copay_cents (Integer)
           #   * :estimated_patient_responsibility_cents (Integer)
           #   * :patient_deposit_cents (Integer)
@@ -409,7 +503,7 @@ module CandidApiClient
           #  api.pre_encounter.appointments.v_1.update(
           #    id: "string",
           #    version: "string",
-          #    request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE }
+          #    request: { patient_id: "string", start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), status: PENDING, service_duration: 1, services: [{ universal_service_identifier: MD_VISIT, start_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z) }], placer_appointment_id: "string", attending_doctor: { name: { family: "string", given: ["string"], use: USUAL, period: {  } }, type: PRIMARY, npi: "string", telecoms: [{ value: "string", use: HOME }], addresses: , period: {  }, canonical_id: "string", fax: "string" }, estimated_copay_cents: 1, estimated_patient_responsibility_cents: 1, patient_deposit_cents: 1, checked_in_timestamp: DateTime.parse(2024-01-15T09:30:00.000Z), notes: "string", location_resource_id: "string", automated_eligibility_check_complete: true, work_queue: EMERGENT_ISSUE }
           #  )
           def update(id:, version:, request:, request_options: nil)
             Async do

data/lib/candidhealth/pre_encounter/appointments/v_1/types/appointment.rb

@@ -70,7 +70,7 @@ module CandidApiClient
             attr_reader :automated_eligibility_check_complete
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentWorkQueue] The work queue that the appointment belongs to. It is not recommended to change
             #  this value manually via API. If status is NOT_READY, work_queue must be set. If
-            #  status is READY or CHECKED_IN, work_queue must be null.
+            #  status is READY, work_queue must be null.
             attr_reader :work_queue
             # @return [OpenStruct] Additional properties unmapped to the current class definition
             attr_reader :additional_properties
@@ -115,7 +115,7 @@ module CandidApiClient
             #  appointment.
             # @param work_queue [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentWorkQueue] The work queue that the appointment belongs to. It is not recommended to change
             #  this value manually via API. If status is NOT_READY, work_queue must be set. If
-            #  status is READY or CHECKED_IN, work_queue must be null.
+            #  status is READY, work_queue must be null.
             # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Appointment]
             def initialize(id:, organization_id:, deactivated:, version:, updated_at:, updating_user_id:, patient_id:,

data/lib/candidhealth/pre_encounter/appointments/v_1/types/mutable_appointment.rb

@@ -56,7 +56,7 @@ module CandidApiClient
             attr_reader :automated_eligibility_check_complete
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentWorkQueue] The work queue that the appointment belongs to. It is not recommended to change
             #  this value manually via API. If status is NOT_READY, work_queue must be set. If
-            #  status is READY or CHECKED_IN, work_queue must be null.
+            #  status is READY, work_queue must be null.
             attr_reader :work_queue
             # @return [OpenStruct] Additional properties unmapped to the current class definition
             attr_reader :additional_properties
@@ -93,7 +93,7 @@ module CandidApiClient
             #  appointment.
             # @param work_queue [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentWorkQueue] The work queue that the appointment belongs to. It is not recommended to change
             #  this value manually via API. If status is NOT_READY, work_queue must be set. If
-            #  status is READY or CHECKED_IN, work_queue must be null.
+            #  status is READY, work_queue must be null.
             # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::MutableAppointment]
             def initialize(patient_id:, start_timestamp:, service_duration:, services:, status: OMIT,

data/lib/candidhealth/pre_encounter/appointments/v_1/types/visit.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require_relative "../../../patients/v_1/types/mutable_patient_with_mrn"
+require "date"
+require_relative "appointment_status"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module Appointments
+      module V1
+        module Types
+          # A visit is a collection of appointments that occur on the same day.
+          class Visit
+            # @return [String]
+            attr_reader :patient_id
+            # @return [CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn]
+            attr_reader :patient
+            # @return [DateTime]
+            attr_reader :start_time
+            # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus]
+            attr_reader :status
+            # @return [OpenStruct] Additional properties unmapped to the current class definition
+            attr_reader :additional_properties
+            # @return [Object]
+            attr_reader :_field_set
+            protected :_field_set
+
+            OMIT = Object.new
+
+            # @param patient_id [String]
+            # @param patient [CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn]
+            # @param start_time [DateTime]
+            # @param status [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Visit]
+            def initialize(patient_id:, patient:, start_time:, status:, additional_properties: nil)
+              @patient_id = patient_id
+              @patient = patient
+              @start_time = start_time
+              @status = status
+              @additional_properties = additional_properties
+              @_field_set = { "patient_id": patient_id, "patient": patient, "start_time": start_time, "status": status }
+            end
+
+            # Deserialize a JSON object to an instance of Visit
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Visit]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              parsed_json = JSON.parse(json_object)
+              patient_id = struct["patient_id"]
+              if parsed_json["patient"].nil?
+                patient = nil
+              else
+                patient = parsed_json["patient"].to_json
+                patient = CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn.from_json(json_object: patient)
+              end
+              start_time = (DateTime.parse(parsed_json["start_time"]) unless parsed_json["start_time"].nil?)
+              status = struct["status"]
+              new(
+                patient_id: patient_id,
+                patient: patient,
+                start_time: start_time,
+                status: status,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of Visit to a JSON object
+            #
+            # @return [String]
+            def to_json(*_args)
+              @_field_set&.to_json
+            end
+
+            # Leveraged for Union-type generation, validate_raw attempts to parse the given
+            #  hash and check each fields type against the current object's property
+            #  definitions.
+            #
+            # @param obj [Object]
+            # @return [Void]
+            def self.validate_raw(obj:)
+              obj.patient_id.is_a?(String) != false || raise("Passed value for field obj.patient_id is not the expected type, validation failed.")
+              CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn.validate_raw(obj: obj.patient)
+              obj.start_time.is_a?(DateTime) != false || raise("Passed value for field obj.start_time is not the expected type, validation failed.")
+              obj.status.is_a?(CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/appointments/v_1/types/visits_page.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative "visit"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module Appointments
+      module V1
+        module Types
+          class VisitsPage
+            # @return [Array<CandidApiClient::PreEncounter::Appointments::V1::Types::Visit>]
+            attr_reader :items
+            # @return [String]
+            attr_reader :next_page_token
+            # @return [String]
+            attr_reader :prev_page_token
+            # @return [Integer]
+            attr_reader :total
+            # @return [OpenStruct] Additional properties unmapped to the current class definition
+            attr_reader :additional_properties
+            # @return [Object]
+            attr_reader :_field_set
+            protected :_field_set
+
+            OMIT = Object.new
+
+            # @param items [Array<CandidApiClient::PreEncounter::Appointments::V1::Types::Visit>]
+            # @param next_page_token [String]
+            # @param prev_page_token [String]
+            # @param total [Integer]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage]
+            def initialize(items:, total:, next_page_token: OMIT, prev_page_token: OMIT, additional_properties: nil)
+              @items = items
+              @next_page_token = next_page_token if next_page_token != OMIT
+              @prev_page_token = prev_page_token if prev_page_token != OMIT
+              @total = total
+              @additional_properties = additional_properties
+              @_field_set = {
+                "items": items,
+                "next_page_token": next_page_token,
+                "prev_page_token": prev_page_token,
+                "total": total
+              }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of VisitsPage
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::VisitsPage]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              parsed_json = JSON.parse(json_object)
+              items = parsed_json["items"]&.map do |item|
+                item = item.to_json
+                CandidApiClient::PreEncounter::Appointments::V1::Types::Visit.from_json(json_object: item)
+              end
+              next_page_token = struct["next_page_token"]
+              prev_page_token = struct["prev_page_token"]
+              total = struct["total"]
+              new(
+                items: items,
+                next_page_token: next_page_token,
+                prev_page_token: prev_page_token,
+                total: total,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of VisitsPage to a JSON object
+            #
+            # @return [String]
+            def to_json(*_args)
+              @_field_set&.to_json
+            end
+
+            # Leveraged for Union-type generation, validate_raw attempts to parse the given
+            #  hash and check each fields type against the current object's property
+            #  definitions.
+            #
+            # @param obj [Object]
+            # @return [Void]
+            def self.validate_raw(obj:)
+              obj.items.is_a?(Array) != false || raise("Passed value for field obj.items is not the expected type, validation failed.")
+              obj.next_page_token&.is_a?(String) != false || raise("Passed value for field obj.next_page_token is not the expected type, validation failed.")
+              obj.prev_page_token&.is_a?(String) != false || raise("Passed value for field obj.prev_page_token is not the expected type, validation failed.")
+              obj.total.is_a?(Integer) != false || raise("Passed value for field obj.total is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/common/types/external_identifier.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative "period"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module Common
+      module Types
+        # An external identifier for a patient
+        class ExternalIdentifier
+          # @return [String]
+          attr_reader :value
+          # @return [String]
+          attr_reader :system
+          # @return [CandidApiClient::PreEncounter::Common::Types::Period]
+          attr_reader :period
+          # @return [OpenStruct] Additional properties unmapped to the current class definition
+          attr_reader :additional_properties
+          # @return [Object]
+          attr_reader :_field_set
+          protected :_field_set
+
+          OMIT = Object.new
+
+          # @param value [String]
+          # @param system [String]
+          # @param period [CandidApiClient::PreEncounter::Common::Types::Period]
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::PreEncounter::Common::Types::ExternalIdentifier]
+          def initialize(value:, system:, period: OMIT, additional_properties: nil)
+            @value = value
+            @system = system
+            @period = period if period != OMIT
+            @additional_properties = additional_properties
+            @_field_set = { "value": value, "system": system, "period": period }.reject do |_k, v|
+              v == OMIT
+            end
+          end
+
+          # Deserialize a JSON object to an instance of ExternalIdentifier
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::PreEncounter::Common::Types::ExternalIdentifier]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            parsed_json = JSON.parse(json_object)
+            value = struct["value"]
+            system = struct["system"]
+            if parsed_json["period"].nil?
+              period = nil
+            else
+              period = parsed_json["period"].to_json
+              period = CandidApiClient::PreEncounter::Common::Types::Period.from_json(json_object: period)
+            end
+            new(
+              value: value,
+              system: system,
+              period: period,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of ExternalIdentifier to a JSON object
+          #
+          # @return [String]
+          def to_json(*_args)
+            @_field_set&.to_json
+          end
+
+          # Leveraged for Union-type generation, validate_raw attempts to parse the given
+          #  hash and check each fields type against the current object's property
+          #  definitions.
+          #
+          # @param obj [Object]
+          # @return [Void]
+          def self.validate_raw(obj:)
+            obj.value.is_a?(String) != false || raise("Passed value for field obj.value is not the expected type, validation failed.")
+            obj.system.is_a?(String) != false || raise("Passed value for field obj.system is not the expected type, validation failed.")
+            obj.period.nil? || CandidApiClient::PreEncounter::Common::Types::Period.validate_raw(obj: obj.period)
+          end
+        end
+      end
+    end
+  end
+end