candidhealth 0.39.6 → 0.39.8

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/eligibility_request.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require_relative "provider"
+require_relative "../../../coverages/v_1/types/member_info"
+require_relative "encounter"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          # An object representing the data for an eligibility request.
+          class EligibilityRequest
+            # @return [String] Supported payer ID values can be found
+            #  [here](https://www.stedi.com/healthcare/network).
+            attr_reader :payer_id
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Provider]
+            attr_reader :provider
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo] The primary policyholder for the insurance plan or a dependent with a unique
+            #  member ID. <Note>If a dependent has a unique member ID, include their
+            #  information here and leave dependent undefined.</Note>
+            attr_reader :subscriber
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo] <Note>If a dependent has a unique member ID, include their information as
+            #  subscriber and leave this field undefined.</Note>
+            attr_reader :dependent
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter]
+            attr_reader :encounter
+            # @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 payer_id [String] Supported payer ID values can be found
+            #  [here](https://www.stedi.com/healthcare/network).
+            # @param provider [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Provider]
+            # @param subscriber [CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo] The primary policyholder for the insurance plan or a dependent with a unique
+            #  member ID. <Note>If a dependent has a unique member ID, include their
+            #  information here and leave dependent undefined.</Note>
+            # @param dependent [CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo] <Note>If a dependent has a unique member ID, include their information as
+            #  subscriber and leave this field undefined.</Note>
+            # @param encounter [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRequest]
+            def initialize(payer_id:, provider:, subscriber:, dependent: OMIT, encounter: OMIT,
+                           additional_properties: nil)
+              @payer_id = payer_id
+              @provider = provider
+              @subscriber = subscriber
+              @dependent = dependent if dependent != OMIT
+              @encounter = encounter if encounter != OMIT
+              @additional_properties = additional_properties
+              @_field_set = {
+                "payer_id": payer_id,
+                "provider": provider,
+                "subscriber": subscriber,
+                "dependent": dependent,
+                "encounter": encounter
+              }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of EligibilityRequest
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRequest]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              parsed_json = JSON.parse(json_object)
+              payer_id = struct["payer_id"]
+              if parsed_json["provider"].nil?
+                provider = nil
+              else
+                provider = parsed_json["provider"].to_json
+                provider = CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Provider.from_json(json_object: provider)
+              end
+              if parsed_json["subscriber"].nil?
+                subscriber = nil
+              else
+                subscriber = parsed_json["subscriber"].to_json
+                subscriber = CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo.from_json(json_object: subscriber)
+              end
+              if parsed_json["dependent"].nil?
+                dependent = nil
+              else
+                dependent = parsed_json["dependent"].to_json
+                dependent = CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo.from_json(json_object: dependent)
+              end
+              if parsed_json["encounter"].nil?
+                encounter = nil
+              else
+                encounter = parsed_json["encounter"].to_json
+                encounter = CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter.from_json(json_object: encounter)
+              end
+              new(
+                payer_id: payer_id,
+                provider: provider,
+                subscriber: subscriber,
+                dependent: dependent,
+                encounter: encounter,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of EligibilityRequest 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.payer_id.is_a?(String) != false || raise("Passed value for field obj.payer_id is not the expected type, validation failed.")
+              CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Provider.validate_raw(obj: obj.provider)
+              CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo.validate_raw(obj: obj.subscriber)
+              obj.dependent.nil? || CandidApiClient::PreEncounter::Coverages::V1::Types::MemberInfo.validate_raw(obj: obj.dependent)
+              obj.encounter.nil? || CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter.validate_raw(obj: obj.encounter)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/eligibility_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "eligibility_check"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          ELIGIBILITY_RESPONSE = CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheck
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/encounter.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "date"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class Encounter
+            # @return [Date] Defaults to the current date if not provided.
+            attr_reader :date_of_service
+            # @return [Array<String>] Defaults to HealthBenefitPlanCoverage (30) if not provided.
+            #  <Note>Not all payers support multiple service type codes, so it is recommended
+            #  to only include a single code per request.</Note>
+            attr_reader :service_type_codes
+            # @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 date_of_service [Date] Defaults to the current date if not provided.
+            # @param service_type_codes [Array<String>] Defaults to HealthBenefitPlanCoverage (30) if not provided.
+            #  <Note>Not all payers support multiple service type codes, so it is recommended
+            #  to only include a single code per request.</Note>
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter]
+            def initialize(date_of_service: OMIT, service_type_codes: OMIT, additional_properties: nil)
+              @date_of_service = date_of_service if date_of_service != OMIT
+              @service_type_codes = service_type_codes if service_type_codes != OMIT
+              @additional_properties = additional_properties
+              @_field_set = {
+                "date_of_service": date_of_service,
+                "service_type_codes": service_type_codes
+              }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of Encounter
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Encounter]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              parsed_json = JSON.parse(json_object)
+              date_of_service = (Date.parse(parsed_json["date_of_service"]) unless parsed_json["date_of_service"].nil?)
+              service_type_codes = struct["service_type_codes"]
+              new(
+                date_of_service: date_of_service,
+                service_type_codes: service_type_codes,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of Encounter 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.date_of_service&.is_a?(Date) != false || raise("Passed value for field obj.date_of_service is not the expected type, validation failed.")
+              obj.service_type_codes&.is_a?(Array) != false || raise("Passed value for field obj.service_type_codes is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/individual_provider.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class IndividualProvider
+            # @return [String]
+            attr_reader :first_name
+            # @return [String]
+            attr_reader :last_name
+            # @return [String]
+            attr_reader :npi
+            # @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 first_name [String]
+            # @param last_name [String]
+            # @param npi [String]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::IndividualProvider]
+            def initialize(npi:, first_name: OMIT, last_name: OMIT, additional_properties: nil)
+              @first_name = first_name if first_name != OMIT
+              @last_name = last_name if last_name != OMIT
+              @npi = npi
+              @additional_properties = additional_properties
+              @_field_set = { "first_name": first_name, "last_name": last_name, "npi": npi }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of IndividualProvider
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::IndividualProvider]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              first_name = struct["first_name"]
+              last_name = struct["last_name"]
+              npi = struct["npi"]
+              new(
+                first_name: first_name,
+                last_name: last_name,
+                npi: npi,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of IndividualProvider 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.first_name&.is_a?(String) != false || raise("Passed value for field obj.first_name is not the expected type, validation failed.")
+              obj.last_name&.is_a?(String) != false || raise("Passed value for field obj.last_name is not the expected type, validation failed.")
+              obj.npi.is_a?(String) != false || raise("Passed value for field obj.npi is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/organization_provider.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class OrganizationProvider
+            # @return [String]
+            attr_reader :organization_name
+            # @return [String]
+            attr_reader :npi
+            # @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 organization_name [String]
+            # @param npi [String]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::OrganizationProvider]
+            def initialize(npi:, organization_name: OMIT, additional_properties: nil)
+              @organization_name = organization_name if organization_name != OMIT
+              @npi = npi
+              @additional_properties = additional_properties
+              @_field_set = { "organization_name": organization_name, "npi": npi }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of OrganizationProvider
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::OrganizationProvider]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              organization_name = struct["organization_name"]
+              npi = struct["npi"]
+              new(
+                organization_name: organization_name,
+                npi: npi,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of OrganizationProvider 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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+              obj.npi.is_a?(String) != false || raise("Passed value for field obj.npi is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/parsed_response.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require_relative "../../../coverages/v_1/types/eligibility_status"
+require_relative "../../../coverages/v_1/types/plan_metadata"
+require_relative "../../../coverages/v_1/types/coverage_benefits"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class ParsedResponse
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::EligibilityStatus]
+            attr_reader :eligibility_status
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::PlanMetadata]
+            attr_reader :plan_metadata
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::CoverageBenefits]
+            attr_reader :benefits
+            # @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 eligibility_status [CandidApiClient::PreEncounter::Coverages::V1::Types::EligibilityStatus]
+            # @param plan_metadata [CandidApiClient::PreEncounter::Coverages::V1::Types::PlanMetadata]
+            # @param benefits [CandidApiClient::PreEncounter::Coverages::V1::Types::CoverageBenefits]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::ParsedResponse]
+            def initialize(eligibility_status:, plan_metadata: OMIT, benefits: OMIT, additional_properties: nil)
+              @eligibility_status = eligibility_status
+              @plan_metadata = plan_metadata if plan_metadata != OMIT
+              @benefits = benefits if benefits != OMIT
+              @additional_properties = additional_properties
+              @_field_set = {
+                "eligibility_status": eligibility_status,
+                "plan_metadata": plan_metadata,
+                "benefits": benefits
+              }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of ParsedResponse
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::ParsedResponse]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              parsed_json = JSON.parse(json_object)
+              eligibility_status = struct["eligibility_status"]
+              if parsed_json["plan_metadata"].nil?
+                plan_metadata = nil
+              else
+                plan_metadata = parsed_json["plan_metadata"].to_json
+                plan_metadata = CandidApiClient::PreEncounter::Coverages::V1::Types::PlanMetadata.from_json(json_object: plan_metadata)
+              end
+              if parsed_json["benefits"].nil?
+                benefits = nil
+              else
+                benefits = parsed_json["benefits"].to_json
+                benefits = CandidApiClient::PreEncounter::Coverages::V1::Types::CoverageBenefits.from_json(json_object: benefits)
+              end
+              new(
+                eligibility_status: eligibility_status,
+                plan_metadata: plan_metadata,
+                benefits: benefits,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of ParsedResponse 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.eligibility_status.is_a?(CandidApiClient::PreEncounter::Coverages::V1::Types::EligibilityStatus) != false || raise("Passed value for field obj.eligibility_status is not the expected type, validation failed.")
+              obj.plan_metadata.nil? || CandidApiClient::PreEncounter::Coverages::V1::Types::PlanMetadata.validate_raw(obj: obj.plan_metadata)
+              obj.benefits.nil? || CandidApiClient::PreEncounter::Coverages::V1::Types::CoverageBenefits.validate_raw(obj: obj.benefits)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/provider.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "individual_provider"
+require_relative "organization_provider"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class Provider
+            # Deserialize a JSON object to an instance of Provider
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::Provider]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              begin
+                CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::IndividualProvider.validate_raw(obj: struct)
+                unless json_object.nil?
+                  return CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::IndividualProvider.from_json(json_object: json_object)
+                end
+
+                return nil
+              rescue StandardError
+                # noop
+              end
+              begin
+                CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::OrganizationProvider.validate_raw(obj: struct)
+                unless json_object.nil?
+                  return CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::OrganizationProvider.from_json(json_object: json_object)
+                end
+
+                return nil
+              rescue StandardError
+                # noop
+              end
+              struct
+            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:)
+              begin
+                return CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::IndividualProvider.validate_raw(obj: obj)
+              rescue StandardError
+                # noop
+              end
+              begin
+                return CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::OrganizationProvider.validate_raw(obj: obj)
+              rescue StandardError
+                # noop
+              end
+              raise("Passed value matched no type within the union, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/request_correction.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          class RequestCorrection
+            # @return [String]
+            attr_reader :property
+            # @return [String]
+            attr_reader :request_value
+            # @return [String]
+            attr_reader :corrected_value
+            # @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 property [String]
+            # @param request_value [String]
+            # @param corrected_value [String]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::RequestCorrection]
+            def initialize(property:, request_value:, corrected_value:, additional_properties: nil)
+              @property = property
+              @request_value = request_value
+              @corrected_value = corrected_value
+              @additional_properties = additional_properties
+              @_field_set = { "property": property, "request_value": request_value, "corrected_value": corrected_value }
+            end
+
+            # Deserialize a JSON object to an instance of RequestCorrection
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::RequestCorrection]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              property = struct["property"]
+              request_value = struct["request_value"]
+              corrected_value = struct["corrected_value"]
+              new(
+                property: property,
+                request_value: request_value,
+                corrected_value: corrected_value,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of RequestCorrection 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.property.is_a?(String) != false || raise("Passed value for field obj.property is not the expected type, validation failed.")
+              obj.request_value.is_a?(String) != false || raise("Passed value for field obj.request_value is not the expected type, validation failed.")
+              obj.corrected_value.is_a?(String) != false || raise("Passed value for field obj.corrected_value is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end