candidhealth 0.17.1

data/lib/candidhealth/eligibility/v_2/client.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require "async"
+
+module CandidApiClient
+  module Eligibility
+    module V2
+      class V2Client
+        attr_reader :request_client
+
+        # @param request_client [RequestClient]
+        # @return [Eligibility::V2::V2Client]
+        def initialize(request_client:)
+          # @type [RequestClient]
+          @request_client = request_client
+        end
+
+        # This API is a wrapper around Change Healthcare's eligibility API. Below are some helpful documentation links:
+        #
+        # - [Change Healthcare - Guides: Contents of the Eligibility Request Body](https://developers.changehealthcare.com/eligibilityandclaims/docs/contents-of-the-eligibility-request-body)
+        # - [Change Healthcare - Guides: Use "Bare Minimum" Eligibility Requests](https://developers.changehealthcare.com/eligibilityandclaims/docs/use-bare-minimum-eligibility-requests)
+        # - [Change Healthcare - Guides: Contents of the Eligibility Response](https://developers.changehealthcare.com/eligibilityandclaims/docs/contents-of-the-eligibility-response)
+        # - [Change Healthcare - Guides: Eligibility JSON-to-EDI API Contents](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-json-to-edi-api-contents)
+        # - [Change Healthcare - Guides: Eligibility Error Messages](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-error-messages)
+        # - [Change Healthcare - Guides: FAQ](https://developers.changehealthcare.com/eligibilityandclaims/docs/frequently-asked-questions)
+        # - [Change Healthcare - Guides: Eligibility FAQs](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-api-requests)
+        # - [Change Healthcare - Guides: Sandbox API Values and Test Responses](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-sandbox-api-values-and-test-responses)
+        # - [Change Healthcare - Guides: Sandbox Predefined Fields and Values](https://developers.changehealthcare.com/eligibilityandclaims/docs/sandbox-predefined-fields-and-values)
+        # - [Change Healthcare - Guides: Using Test Payers in the Sandbox](https://developers.changehealthcare.com/eligibilityandclaims/docs/use-the-test-payers-in-the-sandbox-api)
+        #
+        # A schema of the response object can be found here: [Change Healthcare Docs](https://developers.changehealthcare.com/eligibilityandclaims/reference/medicaleligibility)
+        #
+        # @param request [Object]
+        # @param request_options [RequestOptions]
+        # @return [Object]
+        def submit_eligibility_check(request: nil, request_options: nil)
+          response = @request_client.conn.post("/api/eligibility/v2") 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_options&.additional_headers || {}) }.compact
+            req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          response.body
+        end
+
+        # If you'd like access to this endpoint, please reach out to support@joincandidhealth.com with the subject line "Action: Activate Availity Eligibility API Endpoint
+        #
+        # This API is a wrapper around Availity's coverages API. Below are some helpful documentation links:
+        #
+        # - [Availity - Coverages 1.0.0 API](https://developer.availity.com/partner/documentation#c_coverages_references)
+        # - [Candid Availity Eligibility Integration Guide](https://support.joincandidhealth.com/hc/en-us/articles/24218441631892--Availity-Eligibility-Integration-Guide)
+        #
+        # A schema of the response object can be found here: [Availity Docs](https://developer.availity.com/partner/product/191210/api/190898#/Coverages_100/operation/%2Fcoverages/get)
+        #
+        # - Note Availity requires a free developer account to access this documentation.
+        #
+        # @param request_options [RequestOptions]
+        # @return [Object]
+        def submit_eligibility_check_availity(request_options: nil)
+          response = @request_client.conn.get("/api/eligibility/v2/availity") 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_options&.additional_headers || {}) }.compact
+          end
+          response.body
+        end
+      end
+
+      class AsyncV2Client
+        attr_reader :request_client
+
+        # @param request_client [AsyncRequestClient]
+        # @return [Eligibility::V2::AsyncV2Client]
+        def initialize(request_client:)
+          # @type [AsyncRequestClient]
+          @request_client = request_client
+        end
+
+        # This API is a wrapper around Change Healthcare's eligibility API. Below are some helpful documentation links:
+        #
+        # - [Change Healthcare - Guides: Contents of the Eligibility Request Body](https://developers.changehealthcare.com/eligibilityandclaims/docs/contents-of-the-eligibility-request-body)
+        # - [Change Healthcare - Guides: Use "Bare Minimum" Eligibility Requests](https://developers.changehealthcare.com/eligibilityandclaims/docs/use-bare-minimum-eligibility-requests)
+        # - [Change Healthcare - Guides: Contents of the Eligibility Response](https://developers.changehealthcare.com/eligibilityandclaims/docs/contents-of-the-eligibility-response)
+        # - [Change Healthcare - Guides: Eligibility JSON-to-EDI API Contents](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-json-to-edi-api-contents)
+        # - [Change Healthcare - Guides: Eligibility Error Messages](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-error-messages)
+        # - [Change Healthcare - Guides: FAQ](https://developers.changehealthcare.com/eligibilityandclaims/docs/frequently-asked-questions)
+        # - [Change Healthcare - Guides: Eligibility FAQs](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-api-requests)
+        # - [Change Healthcare - Guides: Sandbox API Values and Test Responses](https://developers.changehealthcare.com/eligibilityandclaims/docs/eligibility-sandbox-api-values-and-test-responses)
+        # - [Change Healthcare - Guides: Sandbox Predefined Fields and Values](https://developers.changehealthcare.com/eligibilityandclaims/docs/sandbox-predefined-fields-and-values)
+        # - [Change Healthcare - Guides: Using Test Payers in the Sandbox](https://developers.changehealthcare.com/eligibilityandclaims/docs/use-the-test-payers-in-the-sandbox-api)
+        #
+        # A schema of the response object can be found here: [Change Healthcare Docs](https://developers.changehealthcare.com/eligibilityandclaims/reference/medicaleligibility)
+        #
+        # @param request [Object]
+        # @param request_options [RequestOptions]
+        # @return [Object]
+        def submit_eligibility_check(request: nil, request_options: nil)
+          Async do
+            response = @request_client.conn.post("/api/eligibility/v2") 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_options&.additional_headers || {}) }.compact
+              req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+            end
+            response.body
+          end
+        end
+
+        # If you'd like access to this endpoint, please reach out to support@joincandidhealth.com with the subject line "Action: Activate Availity Eligibility API Endpoint
+        #
+        # This API is a wrapper around Availity's coverages API. Below are some helpful documentation links:
+        #
+        # - [Availity - Coverages 1.0.0 API](https://developer.availity.com/partner/documentation#c_coverages_references)
+        # - [Candid Availity Eligibility Integration Guide](https://support.joincandidhealth.com/hc/en-us/articles/24218441631892--Availity-Eligibility-Integration-Guide)
+        #
+        # A schema of the response object can be found here: [Availity Docs](https://developer.availity.com/partner/product/191210/api/190898#/Coverages_100/operation/%2Fcoverages/get)
+        #
+        # - Note Availity requires a free developer account to access this documentation.
+        #
+        # @param request_options [RequestOptions]
+        # @return [Object]
+        def submit_eligibility_check_availity(request_options: nil)
+          Async do
+            response = @request_client.conn.get("/api/eligibility/v2/availity") 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_options&.additional_headers || {}) }.compact
+            end
+            response.body
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/billing_provider.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require_relative "../../../commons/types/street_address_long_zip"
+require "json"
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      # The billing provider is the provider or business entity submitting the claim.
+      # Billing provider may be, but is not necessarily, the same person/NPI as the rendering provider.
+      # From a payer's perspective, this represents the person or entity being reimbursed.
+      # When a contract exists with the target payer, the billing provider should be the entity contracted with the payer.
+      # In some circumstances, this will be an individual provider. In that case, submit that provider's NPI and the
+      # tax ID (TIN) that the provider gave to the payer during contracting.
+      # In other cases, the billing entity will be a medical group. If so, submit the group NPI and the group's tax ID.
+      # Box 33 on the CMS-1500 claim form.
+      class BillingProvider
+        attr_reader :address, :tax_id, :npi, :taxonomy_code, :first_name, :last_name, :organization_name,
+                    :additional_properties
+
+        # @param address [Commons::StreetAddressLongZip]
+        # @param tax_id [String] If the provider has a contract with insurance, this must be the same tax ID given to the payer on an IRS W-9 form completed during contracting.
+        # @param npi [String]
+        # @param taxonomy_code [String]
+        # @param first_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param last_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param organization_name [String] If the provider is an organization, this should be set instead of first + last name
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [EncounterProviders::V2::BillingProvider]
+        def initialize(address:, tax_id:, npi:, taxonomy_code: nil, first_name: nil, last_name: nil,
+                       organization_name: nil, additional_properties: nil)
+          # @type [Commons::StreetAddressLongZip]
+          @address = address
+          # @type [String] If the provider has a contract with insurance, this must be the same tax ID given to the payer on an IRS W-9 form completed during contracting.
+          @tax_id = tax_id
+          # @type [String]
+          @npi = npi
+          # @type [String]
+          @taxonomy_code = taxonomy_code
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @first_name = first_name
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @last_name = last_name
+          # @type [String] If the provider is an organization, this should be set instead of first + last name
+          @organization_name = organization_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of BillingProvider
+        #
+        # @param json_object [JSON]
+        # @return [EncounterProviders::V2::BillingProvider]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          if parsed_json["address"].nil?
+            address = nil
+          else
+            address = parsed_json["address"].to_json
+            address = Commons::StreetAddressLongZip.from_json(json_object: address)
+          end
+          tax_id = struct.tax_id
+          npi = struct.npi
+          taxonomy_code = struct.taxonomy_code
+          first_name = struct.first_name
+          last_name = struct.last_name
+          organization_name = struct.organization_name
+          new(address: address, tax_id: tax_id, npi: npi, taxonomy_code: taxonomy_code, first_name: first_name,
+              last_name: last_name, organization_name: organization_name, additional_properties: struct)
+        end
+
+        # Serialize an instance of BillingProvider to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "address": @address,
+            "tax_id": @tax_id,
+            "npi": @npi,
+            "taxonomy_code": @taxonomy_code,
+            "first_name": @first_name,
+            "last_name": @last_name,
+            "organization_name": @organization_name
+          }.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:)
+          Commons::StreetAddressLongZip.validate_raw(obj: obj.address)
+          obj.tax_id.is_a?(String) != false || raise("Passed value for field obj.tax_id 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.")
+          obj.taxonomy_code&.is_a?(String) != false || raise("Passed value for field obj.taxonomy_code is not the expected type, validation failed.")
+          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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/encounter_provider.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative "provider_id"
+require_relative "../../../commons/types/street_address_long_zip"
+require "json"
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      class EncounterProvider
+        attr_reader :provider_id, :address, :tax_id, :npi, :taxonomy_code, :first_name, :last_name, :organization_name,
+                    :additional_properties
+
+        # @param provider_id [EncounterProviders::V2::PROVIDER_ID]
+        # @param address [Commons::StreetAddressLongZip]
+        # @param tax_id [String]
+        # @param npi [String]
+        # @param taxonomy_code [String]
+        # @param first_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param last_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param organization_name [String] If the provider is an organization, this should be set instead of first + last name
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [EncounterProviders::V2::EncounterProvider]
+        def initialize(provider_id:, address:, npi:, tax_id: nil, taxonomy_code: nil, first_name: nil, last_name: nil,
+                       organization_name: nil, additional_properties: nil)
+          # @type [EncounterProviders::V2::PROVIDER_ID]
+          @provider_id = provider_id
+          # @type [Commons::StreetAddressLongZip]
+          @address = address
+          # @type [String]
+          @tax_id = tax_id
+          # @type [String]
+          @npi = npi
+          # @type [String]
+          @taxonomy_code = taxonomy_code
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @first_name = first_name
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @last_name = last_name
+          # @type [String] If the provider is an organization, this should be set instead of first + last name
+          @organization_name = organization_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of EncounterProvider
+        #
+        # @param json_object [JSON]
+        # @return [EncounterProviders::V2::EncounterProvider]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          provider_id = struct.provider_id
+          if parsed_json["address"].nil?
+            address = nil
+          else
+            address = parsed_json["address"].to_json
+            address = Commons::StreetAddressLongZip.from_json(json_object: address)
+          end
+          tax_id = struct.tax_id
+          npi = struct.npi
+          taxonomy_code = struct.taxonomy_code
+          first_name = struct.first_name
+          last_name = struct.last_name
+          organization_name = struct.organization_name
+          new(provider_id: provider_id, address: address, tax_id: tax_id, npi: npi, taxonomy_code: taxonomy_code,
+              first_name: first_name, last_name: last_name, organization_name: organization_name, additional_properties: struct)
+        end
+
+        # Serialize an instance of EncounterProvider to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "provider_id": @provider_id,
+            "address": @address,
+            "tax_id": @tax_id,
+            "npi": @npi,
+            "taxonomy_code": @taxonomy_code,
+            "first_name": @first_name,
+            "last_name": @last_name,
+            "organization_name": @organization_name
+          }.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.provider_id.is_a?(String) != false || raise("Passed value for field obj.provider_id is not the expected type, validation failed.")
+          Commons::StreetAddressLongZip.validate_raw(obj: obj.address)
+          obj.tax_id&.is_a?(String) != false || raise("Passed value for field obj.tax_id 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.")
+          obj.taxonomy_code&.is_a?(String) != false || raise("Passed value for field obj.taxonomy_code is not the expected type, validation failed.")
+          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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/encounter_provider_base.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "json"
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      class EncounterProviderBase
+        attr_reader :first_name, :last_name, :organization_name, :additional_properties
+
+        # @param first_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param last_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param organization_name [String] If the provider is an organization, this should be set instead of first + last name
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [EncounterProviders::V2::EncounterProviderBase]
+        def initialize(first_name: nil, last_name: nil, organization_name: nil, additional_properties: nil)
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @first_name = first_name
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @last_name = last_name
+          # @type [String] If the provider is an organization, this should be set instead of first + last name
+          @organization_name = organization_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of EncounterProviderBase
+        #
+        # @param json_object [JSON]
+        # @return [EncounterProviders::V2::EncounterProviderBase]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          JSON.parse(json_object)
+          first_name = struct.first_name
+          last_name = struct.last_name
+          organization_name = struct.organization_name
+          new(first_name: first_name, last_name: last_name, organization_name: organization_name,
+              additional_properties: struct)
+        end
+
+        # Serialize an instance of EncounterProviderBase to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          { "first_name": @first_name, "last_name": @last_name, "organization_name": @organization_name }.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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/provider_id.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      PROVIDER_ID = String
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/referring_provider.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require_relative "../../../commons/types/street_address_long_zip"
+require "json"
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      class ReferringProvider
+        attr_reader :npi, :taxonomy_code, :address, :first_name, :last_name, :organization_name, :additional_properties
+
+        # @param npi [String] A National Provider Identifier is a unique 10-digit identification
+        #   number issued to health care providers in the United States
+        # @param taxonomy_code [String]
+        # @param address [Commons::StreetAddressLongZip]
+        # @param first_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param last_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param organization_name [String] If the provider is an organization, this should be set instead of first + last name
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [EncounterProviders::V2::ReferringProvider]
+        def initialize(npi:, taxonomy_code: nil, address: nil, first_name: nil, last_name: nil, organization_name: nil,
+                       additional_properties: nil)
+          # @type [String] A National Provider Identifier is a unique 10-digit identification
+          #   number issued to health care providers in the United States
+          @npi = npi
+          # @type [String]
+          @taxonomy_code = taxonomy_code
+          # @type [Commons::StreetAddressLongZip]
+          @address = address
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @first_name = first_name
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @last_name = last_name
+          # @type [String] If the provider is an organization, this should be set instead of first + last name
+          @organization_name = organization_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of ReferringProvider
+        #
+        # @param json_object [JSON]
+        # @return [EncounterProviders::V2::ReferringProvider]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          npi = struct.npi
+          taxonomy_code = struct.taxonomy_code
+          if parsed_json["address"].nil?
+            address = nil
+          else
+            address = parsed_json["address"].to_json
+            address = Commons::StreetAddressLongZip.from_json(json_object: address)
+          end
+          first_name = struct.first_name
+          last_name = struct.last_name
+          organization_name = struct.organization_name
+          new(npi: npi, taxonomy_code: taxonomy_code, address: address, first_name: first_name, last_name: last_name,
+              organization_name: organization_name, additional_properties: struct)
+        end
+
+        # Serialize an instance of ReferringProvider to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "npi": @npi,
+            "taxonomy_code": @taxonomy_code,
+            "address": @address,
+            "first_name": @first_name,
+            "last_name": @last_name,
+            "organization_name": @organization_name
+          }.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.npi.is_a?(String) != false || raise("Passed value for field obj.npi is not the expected type, validation failed.")
+          obj.taxonomy_code&.is_a?(String) != false || raise("Passed value for field obj.taxonomy_code is not the expected type, validation failed.")
+          obj.address.nil? || Commons::StreetAddressLongZip.validate_raw(obj: obj.address)
+          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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounter_providers/v_2/types/rendering_provider.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require_relative "../../../commons/types/street_address_long_zip"
+require "json"
+
+module CandidApiClient
+  module EncounterProviders
+    module V2
+      class RenderingProvider
+        attr_reader :address, :npi, :taxonomy_code, :first_name, :last_name, :organization_name, :additional_properties
+
+        # @param address [Commons::StreetAddressLongZip]
+        # @param npi [String] A National Provider Identifier is a unique 10-digit identification
+        #   number issued to health care providers in the United States
+        # @param taxonomy_code [String]
+        # @param first_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param last_name [String] If the provider is an individual, this should be set instead of organization name
+        # @param organization_name [String] If the provider is an organization, this should be set instead of first + last name
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [EncounterProviders::V2::RenderingProvider]
+        def initialize(npi:, address: nil, taxonomy_code: nil, first_name: nil, last_name: nil, organization_name: nil,
+                       additional_properties: nil)
+          # @type [Commons::StreetAddressLongZip]
+          @address = address
+          # @type [String] A National Provider Identifier is a unique 10-digit identification
+          #   number issued to health care providers in the United States
+          @npi = npi
+          # @type [String]
+          @taxonomy_code = taxonomy_code
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @first_name = first_name
+          # @type [String] If the provider is an individual, this should be set instead of organization name
+          @last_name = last_name
+          # @type [String] If the provider is an organization, this should be set instead of first + last name
+          @organization_name = organization_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of RenderingProvider
+        #
+        # @param json_object [JSON]
+        # @return [EncounterProviders::V2::RenderingProvider]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          if parsed_json["address"].nil?
+            address = nil
+          else
+            address = parsed_json["address"].to_json
+            address = Commons::StreetAddressLongZip.from_json(json_object: address)
+          end
+          npi = struct.npi
+          taxonomy_code = struct.taxonomy_code
+          first_name = struct.first_name
+          last_name = struct.last_name
+          organization_name = struct.organization_name
+          new(address: address, npi: npi, taxonomy_code: taxonomy_code, first_name: first_name, last_name: last_name,
+              organization_name: organization_name, additional_properties: struct)
+        end
+
+        # Serialize an instance of RenderingProvider to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "address": @address,
+            "npi": @npi,
+            "taxonomy_code": @taxonomy_code,
+            "first_name": @first_name,
+            "last_name": @last_name,
+            "organization_name": @organization_name
+          }.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.address.nil? || Commons::StreetAddressLongZip.validate_raw(obj: obj.address)
+          obj.npi.is_a?(String) != false || raise("Passed value for field obj.npi is not the expected type, validation failed.")
+          obj.taxonomy_code&.is_a?(String) != false || raise("Passed value for field obj.taxonomy_code is not the expected type, validation failed.")
+          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.organization_name&.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/encounters/client.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "v_4/client"
+
+module CandidApiClient
+  module Encounters
+    class Client
+      attr_reader :v_4
+
+      # @param request_client [RequestClient]
+      # @return [Encounters::Client]
+      def initialize(request_client:)
+        @v_4 = Encounters::V4::V4Client.new(request_client: request_client)
+      end
+    end
+
+    class AsyncClient
+      attr_reader :v_4
+
+      # @param request_client [RequestClient]
+      # @return [Encounters::AsyncClient]
+      def initialize(request_client:)
+        @v_4 = Encounters::V4::AsyncV4Client.new(request_client: request_client)
+      end
+    end
+  end
+end