candidhealth 1.6.0 → 1.8.0

data/lib/candidhealth/service_lines/v_2/types/universal_service_line_update.rb

@@ -0,0 +1,307 @@
+# frozen_string_literal: true
+
+require_relative "../../../commons/types/procedure_modifier"
+require_relative "drug_identification"
+require_relative "service_line_denial_reason"
+require_relative "../../../commons/types/facility_type_code"
+require_relative "../../../commons/types/service_line_units"
+require "date"
+require_relative "test_result"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module ServiceLines
+    module V2
+      module Types
+        class UniversalServiceLineUpdate
+          # @return [String] A 4 digit code that specifies facility department or type of service arrangement
+          #  for institutional service line items (837i). This code is not required for
+          #  professional claim billing (837p).
+          attr_reader :revenue_code
+          # @return [String]
+          attr_reader :diagnosis_id_zero
+          # @return [String]
+          attr_reader :diagnosis_id_one
+          # @return [String]
+          attr_reader :diagnosis_id_two
+          # @return [String]
+          attr_reader :diagnosis_id_three
+          # @return [String]
+          attr_reader :edit_reason
+          # @return [Array<CandidApiClient::Commons::Types::ProcedureModifier>]
+          attr_reader :modifiers
+          # @return [Integer] The total amount charged for this service line, factoring in quantity. If
+          #  procedure_code is updated and this is not, the system will attempt to set it
+          #  based on chargemasters entries and the service line’s quantity. For example, if
+          #  a single unit has an entry of 100 cents and 2 units were rendered, the
+          #  charge_amount_cents will be set to 200, if there is no chargemaster entry, it
+          #  will default to the amount set in this field.
+          attr_reader :charge_amount_cents
+          # @return [CandidApiClient::ServiceLines::V2::Types::DrugIdentification]
+          attr_reader :drug_identification
+          # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason]
+          attr_reader :denial_reason
+          # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required in 837i claims. If your
+          #  organization does not intend to submit claims with a different place of service
+          #  at the service line level, this field should not be populated. 02 for
+          #  telemedicine, 11 for in-person. Full list
+          #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
+          attr_reader :place_of_service_code
+          # @return [CandidApiClient::Commons::Types::ServiceLineUnits]
+          attr_reader :units
+          # @return [String] If `procedure_code` is updated, and `charge_amount_cents` is not, then
+          #  `charge_amount_cents` will be set by the system.
+          attr_reader :procedure_code
+          # @return [String] String representation of a Decimal that can be parsed by most libraries.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
+          attr_reader :quantity
+          # @return [String] A free-form description to clarify the related data elements and their content.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
+          attr_reader :description
+          # @return [Date] date_of_service must be defined on either the encounter or the service lines but
+          #  not both.
+          attr_reader :date_of_service
+          # @return [Date]
+          attr_reader :end_date_of_service
+          # @return [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
+          #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
+          #  No more than 5 MEA-02 test results may be submitted per service line.
+          #  Updating test results utilizes PUT semantics, so the test results on the service
+          #  line will be set to whatever inputs are provided.
+          attr_reader :test_results
+          # @return [Boolean] Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500. If the value is true,
+          #  the box will be populated with “Y”. Otherwise, the box will not be populated.
+          #  This box is not used on an 837i.
+          attr_reader :has_epsdt_indicator
+          # @return [Boolean] Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500.
+          #  If the value is true, the box will be populated with "Y". Otherwise, the box
+          #  will not be populated.
+          attr_reader :has_family_planning_indicator
+          # @return [String] Maps to NTE02 loop 2400 on the EDI 837.
+          attr_reader :note
+          # @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 revenue_code [String] A 4 digit code that specifies facility department or type of service arrangement
+          #  for institutional service line items (837i). This code is not required for
+          #  professional claim billing (837p).
+          # @param diagnosis_id_zero [String]
+          # @param diagnosis_id_one [String]
+          # @param diagnosis_id_two [String]
+          # @param diagnosis_id_three [String]
+          # @param edit_reason [String]
+          # @param modifiers [Array<CandidApiClient::Commons::Types::ProcedureModifier>]
+          # @param charge_amount_cents [Integer] The total amount charged for this service line, factoring in quantity. If
+          #  procedure_code is updated and this is not, the system will attempt to set it
+          #  based on chargemasters entries and the service line’s quantity. For example, if
+          #  a single unit has an entry of 100 cents and 2 units were rendered, the
+          #  charge_amount_cents will be set to 200, if there is no chargemaster entry, it
+          #  will default to the amount set in this field.
+          # @param drug_identification [CandidApiClient::ServiceLines::V2::Types::DrugIdentification]
+          # @param denial_reason [CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason]
+          # @param place_of_service_code [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required in 837i claims. If your
+          #  organization does not intend to submit claims with a different place of service
+          #  at the service line level, this field should not be populated. 02 for
+          #  telemedicine, 11 for in-person. Full list
+          #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
+          # @param units [CandidApiClient::Commons::Types::ServiceLineUnits]
+          # @param procedure_code [String] If `procedure_code` is updated, and `charge_amount_cents` is not, then
+          #  `charge_amount_cents` will be set by the system.
+          # @param quantity [String] String representation of a Decimal that can be parsed by most libraries.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
+          # @param description [String] A free-form description to clarify the related data elements and their content.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
+          # @param date_of_service [Date] date_of_service must be defined on either the encounter or the service lines but
+          #  not both.
+          # @param end_date_of_service [Date]
+          # @param test_results [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
+          #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
+          #  No more than 5 MEA-02 test results may be submitted per service line.
+          #  Updating test results utilizes PUT semantics, so the test results on the service
+          #  line will be set to whatever inputs are provided.
+          # @param has_epsdt_indicator [Boolean] Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500. If the value is true,
+          #  the box will be populated with “Y”. Otherwise, the box will not be populated.
+          #  This box is not used on an 837i.
+          # @param has_family_planning_indicator [Boolean] Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500.
+          #  If the value is true, the box will be populated with "Y". Otherwise, the box
+          #  will not be populated.
+          # @param note [String] Maps to NTE02 loop 2400 on the EDI 837.
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineUpdate]
+          def initialize(revenue_code: OMIT, diagnosis_id_zero: OMIT, diagnosis_id_one: OMIT, diagnosis_id_two: OMIT,
+                         diagnosis_id_three: OMIT, edit_reason: OMIT, modifiers: OMIT, charge_amount_cents: OMIT, drug_identification: OMIT, denial_reason: OMIT, place_of_service_code: OMIT, units: OMIT, procedure_code: OMIT, quantity: OMIT, description: OMIT, date_of_service: OMIT, end_date_of_service: OMIT, test_results: OMIT, has_epsdt_indicator: OMIT, has_family_planning_indicator: OMIT, note: OMIT, additional_properties: nil)
+            @revenue_code = revenue_code if revenue_code != OMIT
+            @diagnosis_id_zero = diagnosis_id_zero if diagnosis_id_zero != OMIT
+            @diagnosis_id_one = diagnosis_id_one if diagnosis_id_one != OMIT
+            @diagnosis_id_two = diagnosis_id_two if diagnosis_id_two != OMIT
+            @diagnosis_id_three = diagnosis_id_three if diagnosis_id_three != OMIT
+            @edit_reason = edit_reason if edit_reason != OMIT
+            @modifiers = modifiers if modifiers != OMIT
+            @charge_amount_cents = charge_amount_cents if charge_amount_cents != OMIT
+            @drug_identification = drug_identification if drug_identification != OMIT
+            @denial_reason = denial_reason if denial_reason != OMIT
+            @place_of_service_code = place_of_service_code if place_of_service_code != OMIT
+            @units = units if units != OMIT
+            @procedure_code = procedure_code if procedure_code != OMIT
+            @quantity = quantity if quantity != OMIT
+            @description = description if description != OMIT
+            @date_of_service = date_of_service if date_of_service != OMIT
+            @end_date_of_service = end_date_of_service if end_date_of_service != OMIT
+            @test_results = test_results if test_results != OMIT
+            @has_epsdt_indicator = has_epsdt_indicator if has_epsdt_indicator != OMIT
+            @has_family_planning_indicator = has_family_planning_indicator if has_family_planning_indicator != OMIT
+            @note = note if note != OMIT
+            @additional_properties = additional_properties
+            @_field_set = {
+              "revenue_code": revenue_code,
+              "diagnosis_id_zero": diagnosis_id_zero,
+              "diagnosis_id_one": diagnosis_id_one,
+              "diagnosis_id_two": diagnosis_id_two,
+              "diagnosis_id_three": diagnosis_id_three,
+              "edit_reason": edit_reason,
+              "modifiers": modifiers,
+              "charge_amount_cents": charge_amount_cents,
+              "drug_identification": drug_identification,
+              "denial_reason": denial_reason,
+              "place_of_service_code": place_of_service_code,
+              "units": units,
+              "procedure_code": procedure_code,
+              "quantity": quantity,
+              "description": description,
+              "date_of_service": date_of_service,
+              "end_date_of_service": end_date_of_service,
+              "test_results": test_results,
+              "has_epsdt_indicator": has_epsdt_indicator,
+              "has_family_planning_indicator": has_family_planning_indicator,
+              "note": note
+            }.reject do |_k, v|
+              v == OMIT
+            end
+          end
+
+          # Deserialize a JSON object to an instance of UniversalServiceLineUpdate
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineUpdate]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            parsed_json = JSON.parse(json_object)
+            revenue_code = struct["revenue_code"]
+            diagnosis_id_zero = struct["diagnosis_id_zero"]
+            diagnosis_id_one = struct["diagnosis_id_one"]
+            diagnosis_id_two = struct["diagnosis_id_two"]
+            diagnosis_id_three = struct["diagnosis_id_three"]
+            edit_reason = struct["edit_reason"]
+            modifiers = struct["modifiers"]
+            charge_amount_cents = struct["charge_amount_cents"]
+            if parsed_json["drug_identification"].nil?
+              drug_identification = nil
+            else
+              drug_identification = parsed_json["drug_identification"].to_json
+              drug_identification = CandidApiClient::ServiceLines::V2::Types::DrugIdentification.from_json(json_object: drug_identification)
+            end
+            if parsed_json["denial_reason"].nil?
+              denial_reason = nil
+            else
+              denial_reason = parsed_json["denial_reason"].to_json
+              denial_reason = CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason.from_json(json_object: denial_reason)
+            end
+            place_of_service_code = struct["place_of_service_code"]
+            units = struct["units"]
+            procedure_code = struct["procedure_code"]
+            quantity = struct["quantity"]
+            description = struct["description"]
+            date_of_service = (Date.parse(parsed_json["date_of_service"]) unless parsed_json["date_of_service"].nil?)
+            end_date_of_service = unless parsed_json["end_date_of_service"].nil?
+                                    Date.parse(parsed_json["end_date_of_service"])
+                                  end
+            test_results = parsed_json["test_results"]&.map do |item|
+              item = item.to_json
+              CandidApiClient::ServiceLines::V2::Types::TestResult.from_json(json_object: item)
+            end
+            has_epsdt_indicator = struct["has_epsdt_indicator"]
+            has_family_planning_indicator = struct["has_family_planning_indicator"]
+            note = struct["note"]
+            new(
+              revenue_code: revenue_code,
+              diagnosis_id_zero: diagnosis_id_zero,
+              diagnosis_id_one: diagnosis_id_one,
+              diagnosis_id_two: diagnosis_id_two,
+              diagnosis_id_three: diagnosis_id_three,
+              edit_reason: edit_reason,
+              modifiers: modifiers,
+              charge_amount_cents: charge_amount_cents,
+              drug_identification: drug_identification,
+              denial_reason: denial_reason,
+              place_of_service_code: place_of_service_code,
+              units: units,
+              procedure_code: procedure_code,
+              quantity: quantity,
+              description: description,
+              date_of_service: date_of_service,
+              end_date_of_service: end_date_of_service,
+              test_results: test_results,
+              has_epsdt_indicator: has_epsdt_indicator,
+              has_family_planning_indicator: has_family_planning_indicator,
+              note: note,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of UniversalServiceLineUpdate 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.revenue_code&.is_a?(String) != false || raise("Passed value for field obj.revenue_code is not the expected type, validation failed.")
+            obj.diagnosis_id_zero&.is_a?(String) != false || raise("Passed value for field obj.diagnosis_id_zero is not the expected type, validation failed.")
+            obj.diagnosis_id_one&.is_a?(String) != false || raise("Passed value for field obj.diagnosis_id_one is not the expected type, validation failed.")
+            obj.diagnosis_id_two&.is_a?(String) != false || raise("Passed value for field obj.diagnosis_id_two is not the expected type, validation failed.")
+            obj.diagnosis_id_three&.is_a?(String) != false || raise("Passed value for field obj.diagnosis_id_three is not the expected type, validation failed.")
+            obj.edit_reason&.is_a?(String) != false || raise("Passed value for field obj.edit_reason is not the expected type, validation failed.")
+            obj.modifiers&.is_a?(Array) != false || raise("Passed value for field obj.modifiers is not the expected type, validation failed.")
+            obj.charge_amount_cents&.is_a?(Integer) != false || raise("Passed value for field obj.charge_amount_cents is not the expected type, validation failed.")
+            obj.drug_identification.nil? || CandidApiClient::ServiceLines::V2::Types::DrugIdentification.validate_raw(obj: obj.drug_identification)
+            obj.denial_reason.nil? || CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason.validate_raw(obj: obj.denial_reason)
+            obj.place_of_service_code&.is_a?(CandidApiClient::Commons::Types::FacilityTypeCode) != false || raise("Passed value for field obj.place_of_service_code is not the expected type, validation failed.")
+            obj.units&.is_a?(CandidApiClient::Commons::Types::ServiceLineUnits) != false || raise("Passed value for field obj.units is not the expected type, validation failed.")
+            obj.procedure_code&.is_a?(String) != false || raise("Passed value for field obj.procedure_code is not the expected type, validation failed.")
+            obj.quantity&.is_a?(String) != false || raise("Passed value for field obj.quantity is not the expected type, validation failed.")
+            obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+            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.end_date_of_service&.is_a?(Date) != false || raise("Passed value for field obj.end_date_of_service is not the expected type, validation failed.")
+            obj.test_results&.is_a?(Array) != false || raise("Passed value for field obj.test_results is not the expected type, validation failed.")
+            obj.has_epsdt_indicator&.is_a?(Boolean) != false || raise("Passed value for field obj.has_epsdt_indicator is not the expected type, validation failed.")
+            obj.has_family_planning_indicator&.is_a?(Boolean) != false || raise("Passed value for field obj.has_family_planning_indicator is not the expected type, validation failed.")
+            obj.note&.is_a?(String) != false || raise("Passed value for field obj.note is not the expected type, validation failed.")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/x_12/v_1/types/type_of_bill_composite.rb

@@ -16,7 +16,7 @@ module CandidApiClient
           # @return [CandidApiClient::X12::V1::Types::TypeOfFacilityCode] The FL04 Institutional type of facility code for the bill.  The second digit of
           #  the composite code.
           attr_reader :type_of_facility
-          # @return [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The second digit of the
+          # @return [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The third digit of the
           #  composite code.
           attr_reader :type_of_care
           # @return [CandidApiClient::X12::V1::Types::TypeOfBillFrequencyCode] The FL04 Institutional frequency code for the bill.  The fourth digit of the
@@ -33,7 +33,7 @@ module CandidApiClient
           # @param code [String] The composite, 4 digit code of the composite, starting with a padding code 0.
           # @param type_of_facility [CandidApiClient::X12::V1::Types::TypeOfFacilityCode] The FL04 Institutional type of facility code for the bill.  The second digit of
           #  the composite code.
-          # @param type_of_care [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The second digit of the
+          # @param type_of_care [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The third digit of the
           #  composite code.
           # @param frequency_code [CandidApiClient::X12::V1::Types::TypeOfBillFrequencyCode] The FL04 Institutional frequency code for the bill.  The fourth digit of the
           #  composite code.

data/lib/candidhealth/x_12/v_1/types/type_of_bill_composite_base.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative "type_of_facility_code"
+require_relative "type_of_care_code"
+require_relative "type_of_bill_frequency_code"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module X12
+    module V1
+      module Types
+        class TypeOfBillCompositeBase
+          # @return [CandidApiClient::X12::V1::Types::TypeOfFacilityCode] The FL04 Institutional type of facility code for the bill.  The second digit of
+          #  the composite code.
+          attr_reader :type_of_facility
+          # @return [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The third digit of the
+          #  composite code.
+          attr_reader :type_of_care
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillFrequencyCode] The FL04 Institutional frequency code for the bill.  The fourth digit of the
+          #  composite code.
+          attr_reader :frequency_code
+          # @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 type_of_facility [CandidApiClient::X12::V1::Types::TypeOfFacilityCode] The FL04 Institutional type of facility code for the bill.  The second digit of
+          #  the composite code.
+          # @param type_of_care [CandidApiClient::X12::V1::Types::TypeOfCareCode] The FL04 Institutional type of care code for the bill.  The third digit of the
+          #  composite code.
+          # @param frequency_code [CandidApiClient::X12::V1::Types::TypeOfBillFrequencyCode] The FL04 Institutional frequency code for the bill.  The fourth digit of the
+          #  composite code.
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeBase]
+          def initialize(type_of_facility:, type_of_care:, frequency_code:, additional_properties: nil)
+            @type_of_facility = type_of_facility
+            @type_of_care = type_of_care
+            @frequency_code = frequency_code
+            @additional_properties = additional_properties
+            @_field_set = {
+              "type_of_facility": type_of_facility,
+              "type_of_care": type_of_care,
+              "frequency_code": frequency_code
+            }
+          end
+
+          # Deserialize a JSON object to an instance of TypeOfBillCompositeBase
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeBase]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            type_of_facility = struct["type_of_facility"]
+            type_of_care = struct["type_of_care"]
+            frequency_code = struct["frequency_code"]
+            new(
+              type_of_facility: type_of_facility,
+              type_of_care: type_of_care,
+              frequency_code: frequency_code,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of TypeOfBillCompositeBase 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.type_of_facility.is_a?(CandidApiClient::X12::V1::Types::TypeOfFacilityCode) != false || raise("Passed value for field obj.type_of_facility is not the expected type, validation failed.")
+            obj.type_of_care.is_a?(CandidApiClient::X12::V1::Types::TypeOfCareCode) != false || raise("Passed value for field obj.type_of_care is not the expected type, validation failed.")
+            obj.frequency_code.is_a?(CandidApiClient::X12::V1::Types::TypeOfBillFrequencyCode) != false || raise("Passed value for field obj.frequency_code is not the expected type, validation failed.")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/x_12/v_1/types/type_of_bill_composite_update.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "type_of_bill_composite_base"
+
+module CandidApiClient
+  module X12
+    module V1
+      module Types
+        # A type of bill can either be seen as a compositio of structured parts, or as a
+        #  literal string.
+        #  This union represents the potential to express a type of bill either as one of
+        #  those two shapes.
+        #  Passing a string, this update will be seen as a complete 4 digit code, along
+        #  with a padding code 0, that
+        #  should match a valid composition.
+        #  Passing as a structure, the update will be seen as three parts and will be
+        #  joined together by the server
+        #  to represent a valid composition for you.
+        #  Which you use depends upon whether you are "passing through" coded information
+        #  or making a decision about its
+        #  structure explicitly.
+        class TypeOfBillCompositeUpdate
+          # @return [Object]
+          attr_reader :member
+          # @return [String]
+          attr_reader :discriminant
+
+          private_class_method :new
+          alias kind_of? is_a?
+
+          # @param member [Object]
+          # @param discriminant [String]
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeUpdate]
+          def initialize(member:, discriminant:)
+            @member = member
+            @discriminant = discriminant
+          end
+
+          # Deserialize a JSON object to an instance of TypeOfBillCompositeUpdate
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeUpdate]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            member = case struct.type
+                     when "raw_code"
+                       json_object.value
+                     when "composite_codes"
+                       CandidApiClient::X12::V1::Types::TypeOfBillCompositeBase.from_json(json_object: json_object)
+                     else
+                       json_object
+                     end
+            new(member: member, discriminant: struct.type)
+          end
+
+          # For Union Types, to_json functionality is delegated to the wrapped member.
+          #
+          # @return [String]
+          def to_json(*_args)
+            case @discriminant
+            when "raw_code"
+              { "type": @discriminant, "value": @member }.to_json
+            when "composite_codes"
+              { **@member.to_json, type: @discriminant }.to_json
+            else
+              { "type": @discriminant, value: @member }.to_json
+            end
+            @member.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:)
+            case obj.type
+            when "raw_code"
+              obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+            when "composite_codes"
+              CandidApiClient::X12::V1::Types::TypeOfBillCompositeBase.validate_raw(obj: obj)
+            else
+              raise("Passed value matched no type within the union, validation failed.")
+            end
+          end
+
+          # For Union Types, is_a? functionality is delegated to the wrapped member.
+          #
+          # @param obj [Object]
+          # @return [Boolean]
+          def is_a?(obj)
+            @member.is_a?(obj)
+          end
+
+          # @param member [String]
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeUpdate]
+          def self.raw_code(member:)
+            new(member: member, discriminant: "raw_code")
+          end
+
+          # @param member [CandidApiClient::X12::V1::Types::TypeOfBillCompositeBase]
+          # @return [CandidApiClient::X12::V1::Types::TypeOfBillCompositeUpdate]
+          def self.composite_codes(member:)
+            new(member: member, discriminant: "composite_codes")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth.rb

@@ -20,6 +20,7 @@ require_relative "candidhealth/exports/client"
 require_relative "candidhealth/external_payment_account_config/client"
 require_relative "candidhealth/fee_schedules/client"
 require_relative "candidhealth/guarantor/client"
+require_relative "candidhealth/health_care_code_information/client"
 require_relative "candidhealth/import_invoice/client"
 require_relative "candidhealth/insurance_adjudications/client"
 require_relative "candidhealth/insurance_payments/client"
@@ -28,8 +29,9 @@ require_relative "candidhealth/medication_dispense/client"
 require_relative "candidhealth/non_insurance_payer_payments/client"
 require_relative "candidhealth/non_insurance_payer_refunds/client"
 require_relative "candidhealth/non_insurance_payers/client"
-require_relative "candidhealth/organization_service_facilities/client"
 require_relative "candidhealth/organization_providers/client"
+require_relative "candidhealth/organization_service_facilities/client"
+require_relative "candidhealth/patient_ar/client"
 require_relative "candidhealth/patient_payments/client"
 require_relative "candidhealth/patient_refunds/client"
 require_relative "candidhealth/payer_plan_groups/client"
@@ -76,6 +78,8 @@ module CandidApiClient
     attr_reader :fee_schedules
     # @return [CandidApiClient::Guarantor::Client]
     attr_reader :guarantor
+    # @return [CandidApiClient::HealthCareCodeInformation::Client]
+    attr_reader :health_care_code_information
     # @return [CandidApiClient::ImportInvoice::Client]
     attr_reader :import_invoice
     # @return [CandidApiClient::InsuranceAdjudications::Client]
@@ -92,10 +96,12 @@ module CandidApiClient
     attr_reader :non_insurance_payer_refunds
     # @return [CandidApiClient::NonInsurancePayers::Client]
     attr_reader :non_insurance_payers
-    # @return [CandidApiClient::OrganizationServiceFacilities::Client]
-    attr_reader :organization_service_facilities
     # @return [CandidApiClient::OrganizationProviders::Client]
     attr_reader :organization_providers
+    # @return [CandidApiClient::OrganizationServiceFacilities::Client]
+    attr_reader :organization_service_facilities
+    # @return [CandidApiClient::PatientAr::Client]
+    attr_reader :patient_ar
     # @return [CandidApiClient::PatientPayments::Client]
     attr_reader :patient_payments
     # @return [CandidApiClient::PatientRefunds::Client]
@@ -161,6 +167,7 @@ module CandidApiClient
       @external_payment_account_config = CandidApiClient::ExternalPaymentAccountConfig::Client.new(request_client: @request_client)
       @fee_schedules = CandidApiClient::FeeSchedules::Client.new(request_client: @request_client)
       @guarantor = CandidApiClient::Guarantor::Client.new(request_client: @request_client)
+      @health_care_code_information = CandidApiClient::HealthCareCodeInformation::Client.new(request_client: @request_client)
       @import_invoice = CandidApiClient::ImportInvoice::Client.new(request_client: @request_client)
       @insurance_adjudications = CandidApiClient::InsuranceAdjudications::Client.new(request_client: @request_client)
       @insurance_payments = CandidApiClient::InsurancePayments::Client.new(request_client: @request_client)
@@ -169,8 +176,9 @@ module CandidApiClient
       @non_insurance_payer_payments = CandidApiClient::NonInsurancePayerPayments::Client.new(request_client: @request_client)
       @non_insurance_payer_refunds = CandidApiClient::NonInsurancePayerRefunds::Client.new(request_client: @request_client)
       @non_insurance_payers = CandidApiClient::NonInsurancePayers::Client.new(request_client: @request_client)
-      @organization_service_facilities = CandidApiClient::OrganizationServiceFacilities::Client.new(request_client: @request_client)
       @organization_providers = CandidApiClient::OrganizationProviders::Client.new(request_client: @request_client)
+      @organization_service_facilities = CandidApiClient::OrganizationServiceFacilities::Client.new(request_client: @request_client)
+      @patient_ar = CandidApiClient::PatientAr::Client.new(request_client: @request_client)
       @patient_payments = CandidApiClient::PatientPayments::Client.new(request_client: @request_client)
       @patient_refunds = CandidApiClient::PatientRefunds::Client.new(request_client: @request_client)
       @payer_plan_groups = CandidApiClient::PayerPlanGroups::Client.new(request_client: @request_client)
@@ -218,6 +226,8 @@ module CandidApiClient
     attr_reader :fee_schedules
     # @return [CandidApiClient::Guarantor::AsyncClient]
     attr_reader :guarantor
+    # @return [CandidApiClient::HealthCareCodeInformation::AsyncClient]
+    attr_reader :health_care_code_information
     # @return [CandidApiClient::ImportInvoice::AsyncClient]
     attr_reader :import_invoice
     # @return [CandidApiClient::InsuranceAdjudications::AsyncClient]
@@ -234,10 +244,12 @@ module CandidApiClient
     attr_reader :non_insurance_payer_refunds
     # @return [CandidApiClient::NonInsurancePayers::AsyncClient]
     attr_reader :non_insurance_payers
-    # @return [CandidApiClient::OrganizationServiceFacilities::AsyncClient]
-    attr_reader :organization_service_facilities
     # @return [CandidApiClient::OrganizationProviders::AsyncClient]
     attr_reader :organization_providers
+    # @return [CandidApiClient::OrganizationServiceFacilities::AsyncClient]
+    attr_reader :organization_service_facilities
+    # @return [CandidApiClient::PatientAr::AsyncClient]
+    attr_reader :patient_ar
     # @return [CandidApiClient::PatientPayments::AsyncClient]
     attr_reader :patient_payments
     # @return [CandidApiClient::PatientRefunds::AsyncClient]
@@ -303,6 +315,7 @@ module CandidApiClient
       @external_payment_account_config = CandidApiClient::ExternalPaymentAccountConfig::AsyncClient.new(request_client: @async_request_client)
       @fee_schedules = CandidApiClient::FeeSchedules::AsyncClient.new(request_client: @async_request_client)
       @guarantor = CandidApiClient::Guarantor::AsyncClient.new(request_client: @async_request_client)
+      @health_care_code_information = CandidApiClient::HealthCareCodeInformation::AsyncClient.new(request_client: @async_request_client)
       @import_invoice = CandidApiClient::ImportInvoice::AsyncClient.new(request_client: @async_request_client)
       @insurance_adjudications = CandidApiClient::InsuranceAdjudications::AsyncClient.new(request_client: @async_request_client)
       @insurance_payments = CandidApiClient::InsurancePayments::AsyncClient.new(request_client: @async_request_client)
@@ -311,8 +324,9 @@ module CandidApiClient
       @non_insurance_payer_payments = CandidApiClient::NonInsurancePayerPayments::AsyncClient.new(request_client: @async_request_client)
       @non_insurance_payer_refunds = CandidApiClient::NonInsurancePayerRefunds::AsyncClient.new(request_client: @async_request_client)
       @non_insurance_payers = CandidApiClient::NonInsurancePayers::AsyncClient.new(request_client: @async_request_client)
-      @organization_service_facilities = CandidApiClient::OrganizationServiceFacilities::AsyncClient.new(request_client: @async_request_client)
       @organization_providers = CandidApiClient::OrganizationProviders::AsyncClient.new(request_client: @async_request_client)
+      @organization_service_facilities = CandidApiClient::OrganizationServiceFacilities::AsyncClient.new(request_client: @async_request_client)
+      @patient_ar = CandidApiClient::PatientAr::AsyncClient.new(request_client: @async_request_client)
       @patient_payments = CandidApiClient::PatientPayments::AsyncClient.new(request_client: @async_request_client)
       @patient_refunds = CandidApiClient::PatientRefunds::AsyncClient.new(request_client: @async_request_client)
       @payer_plan_groups = CandidApiClient::PayerPlanGroups::AsyncClient.new(request_client: @async_request_client)

data/lib/requests.rb

@@ -45,7 +45,7 @@ module CandidApiClient
 
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "candidhealth", "X-Fern-SDK-Version": "1.6.0" }
+      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "candidhealth", "X-Fern-SDK-Version": "1.8.0" }
       headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless token.nil?
       headers
     end
@@ -90,7 +90,7 @@ module CandidApiClient
 
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "candidhealth", "X-Fern-SDK-Version": "1.6.0" }
+      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "candidhealth", "X-Fern-SDK-Version": "1.8.0" }
       headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless token.nil?
       headers
     end