candidhealth 0.17.1

data/lib/candidhealth/write_offs/v_1/client.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require_relative "../../commons/types/patient_external_id"
+require_relative "../../payers/v_3/types/payer_uuid"
+require_relative "../../commons/types/service_line_id"
+require_relative "../../commons/types/claim_id"
+require_relative "../../commons/types/provider_id"
+require_relative "types/write_off_sort_field"
+require_relative "../../commons/types/sort_direction"
+require_relative "../../commons/types/page_token"
+require_relative "../../financials/types/account_type"
+require_relative "types/write_offs_page"
+require_relative "types/write_off_id"
+require_relative "types/write_off"
+require_relative "types/write_off_create"
+require_relative "types/create_write_offs_response"
+require "async"
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class V1Client
+        attr_reader :request_client
+
+        # @param request_client [RequestClient]
+        # @return [WriteOffs::V1::V1Client]
+        def initialize(request_client:)
+          # @type [RequestClient]
+          @request_client = request_client
+        end
+
+        # Returns all write-offs satisfying the search criteria.
+        #
+        # @param limit [Integer] Defaults to 100. The value must be greater than 0 and less than 1000.
+        # @param patient_external_id [Commons::PATIENT_EXTERNAL_ID]
+        # @param payer_uuid [Payers::V3::PAYER_String]
+        # @param service_line_id [Commons::SERVICE_LINE_ID]
+        # @param claim_id [Commons::CLAIM_ID]
+        # @param billing_provider_id [Commons::PROVIDER_ID]
+        # @param sort [WriteOffs::V1::WriteOffSortField] Defaults to write_off_timestamp
+        # @param sort_direction [Commons::SortDirection] Sort direction. Defaults to descending order if not provided.
+        # @param page_token [Commons::PAGE_TOKEN]
+        # @param account_types [Financials::AccountType] Filters the returned values to include only the provided account types.
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOffsPage]
+        def get_multi(limit: nil, patient_external_id: nil, payer_uuid: nil, service_line_id: nil, claim_id: nil,
+                      billing_provider_id: nil, sort: nil, sort_direction: nil, page_token: nil, account_types: nil, request_options: nil)
+          response = @request_client.conn.get("/api/write-offs/v1") 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.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "limit": limit,
+              "patient_external_id": patient_external_id,
+              "payer_uuid": payer_uuid,
+              "service_line_id": service_line_id,
+              "claim_id": claim_id,
+              "billing_provider_id": billing_provider_id,
+              "sort": sort,
+              "sort_direction": sort_direction,
+              "page_token": page_token,
+              "account_types": account_types
+            }.compact
+          end
+          WriteOffs::V1::WriteOffsPage.from_json(json_object: response.body)
+        end
+
+        # Retrieves a previously created write off by its `write_off_id`.
+        #
+        # @param write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOff]
+        def get(write_off_id:, request_options: nil)
+          response = @request_client.conn.get("/api/write-offs/v1/#{write_off_id}") 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
+          WriteOffs::V1::WriteOff.from_json(json_object: response.body)
+        end
+
+        # Creates one or many write-offs given a specific set of allocations.
+        # The allocations can describe whether the refund is being applied toward a specific service line,
+        # claim, or billing provider.
+        #
+        # @param write_offs [Array<Hash>] Request of type Array<WriteOffs::V1::WriteOffCreate>, as a Hash
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::CreateWriteOffsResponse]
+        def create(write_offs:, request_options: nil)
+          response = @request_client.conn.post("/api/write-offs/v1") 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_options&.additional_body_parameters || {}), write_offs: write_offs }.compact
+          end
+          WriteOffs::V1::CreateWriteOffsResponse.from_json(json_object: response.body)
+        end
+
+        # Reverts a write off given a `write_off_id`.
+        #
+        # @param write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOff]
+        def revert(write_off_id:, request_options: nil)
+          response = @request_client.conn.post("/api/write-offs/v1/#{write_off_id}/revert") 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
+          WriteOffs::V1::WriteOff.from_json(json_object: response.body)
+        end
+      end
+
+      class AsyncV1Client
+        attr_reader :request_client
+
+        # @param request_client [AsyncRequestClient]
+        # @return [WriteOffs::V1::AsyncV1Client]
+        def initialize(request_client:)
+          # @type [AsyncRequestClient]
+          @request_client = request_client
+        end
+
+        # Returns all write-offs satisfying the search criteria.
+        #
+        # @param limit [Integer] Defaults to 100. The value must be greater than 0 and less than 1000.
+        # @param patient_external_id [Commons::PATIENT_EXTERNAL_ID]
+        # @param payer_uuid [Payers::V3::PAYER_String]
+        # @param service_line_id [Commons::SERVICE_LINE_ID]
+        # @param claim_id [Commons::CLAIM_ID]
+        # @param billing_provider_id [Commons::PROVIDER_ID]
+        # @param sort [WriteOffs::V1::WriteOffSortField] Defaults to write_off_timestamp
+        # @param sort_direction [Commons::SortDirection] Sort direction. Defaults to descending order if not provided.
+        # @param page_token [Commons::PAGE_TOKEN]
+        # @param account_types [Financials::AccountType] Filters the returned values to include only the provided account types.
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOffsPage]
+        def get_multi(limit: nil, patient_external_id: nil, payer_uuid: nil, service_line_id: nil, claim_id: nil,
+                      billing_provider_id: nil, sort: nil, sort_direction: nil, page_token: nil, account_types: nil, request_options: nil)
+          Async do
+            response = @request_client.conn.get("/api/write-offs/v1") 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.params = {
+                **(request_options&.additional_query_parameters || {}),
+                "limit": limit,
+                "patient_external_id": patient_external_id,
+                "payer_uuid": payer_uuid,
+                "service_line_id": service_line_id,
+                "claim_id": claim_id,
+                "billing_provider_id": billing_provider_id,
+                "sort": sort,
+                "sort_direction": sort_direction,
+                "page_token": page_token,
+                "account_types": account_types
+              }.compact
+            end
+            WriteOffs::V1::WriteOffsPage.from_json(json_object: response.body)
+          end
+        end
+
+        # Retrieves a previously created write off by its `write_off_id`.
+        #
+        # @param write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOff]
+        def get(write_off_id:, request_options: nil)
+          Async do
+            response = @request_client.conn.get("/api/write-offs/v1/#{write_off_id}") 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
+            WriteOffs::V1::WriteOff.from_json(json_object: response.body)
+          end
+        end
+
+        # Creates one or many write-offs given a specific set of allocations.
+        # The allocations can describe whether the refund is being applied toward a specific service line,
+        # claim, or billing provider.
+        #
+        # @param write_offs [Array<Hash>] Request of type Array<WriteOffs::V1::WriteOffCreate>, as a Hash
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::CreateWriteOffsResponse]
+        def create(write_offs:, request_options: nil)
+          Async do
+            response = @request_client.conn.post("/api/write-offs/v1") 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_options&.additional_body_parameters || {}), write_offs: write_offs }.compact
+            end
+            WriteOffs::V1::CreateWriteOffsResponse.from_json(json_object: response.body)
+          end
+        end
+
+        # Reverts a write off given a `write_off_id`.
+        #
+        # @param write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param request_options [RequestOptions]
+        # @return [WriteOffs::V1::WriteOff]
+        def revert(write_off_id:, request_options: nil)
+          Async do
+            response = @request_client.conn.post("/api/write-offs/v1/#{write_off_id}/revert") 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
+            WriteOffs::V1::WriteOff.from_json(json_object: response.body)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/write_offs/v_1/types/create_write_offs_response.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "write_off"
+require "json"
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class CreateWriteOffsResponse
+        attr_reader :write_offs, :additional_properties
+
+        # @param write_offs [Array<WriteOffs::V1::WriteOff>]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [WriteOffs::V1::CreateWriteOffsResponse]
+        def initialize(write_offs:, additional_properties: nil)
+          # @type [Array<WriteOffs::V1::WriteOff>]
+          @write_offs = write_offs
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of CreateWriteOffsResponse
+        #
+        # @param json_object [JSON]
+        # @return [WriteOffs::V1::CreateWriteOffsResponse]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          write_offs = parsed_json["write_offs"]&.map do |v|
+            v = v.to_json
+            WriteOffs::V1::WriteOff.from_json(json_object: v)
+          end
+          new(write_offs: write_offs, additional_properties: struct)
+        end
+
+        # Serialize an instance of CreateWriteOffsResponse to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          { "write_offs": @write_offs }.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.write_offs.is_a?(Array) != false || raise("Passed value for field obj.write_offs is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/write_offs/v_1/types/insurance_write_off.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative "write_off_id"
+require_relative "../../../payers/v_3/types/payer"
+require_relative "insurance_write_off_target"
+require "date"
+require_relative "insurance_write_off_reason"
+require "json"
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class InsuranceWriteOff
+        attr_reader :write_off_id, :payer, :write_off_target, :write_off_timestamp, :write_off_note, :write_off_reason,
+                    :reverts_write_off_id, :reverted_by_write_off_id, :amount_cents, :additional_properties
+
+        # @param write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param payer [Payers::V3::Payer]
+        # @param write_off_target [WriteOffs::V1::InsuranceWriteOffTarget]
+        # @param write_off_timestamp [DateTime]
+        # @param write_off_note [String]
+        # @param write_off_reason [WriteOffs::V1::InsuranceWriteOffReason]
+        # @param reverts_write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param reverted_by_write_off_id [WriteOffs::V1::WRITE_OFF_ID]
+        # @param amount_cents [Integer]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [WriteOffs::V1::InsuranceWriteOff]
+        def initialize(write_off_id:, payer:, write_off_target:, write_off_timestamp:, write_off_reason:,
+                       amount_cents:, write_off_note: nil, reverts_write_off_id: nil, reverted_by_write_off_id: nil, additional_properties: nil)
+          # @type [WriteOffs::V1::WRITE_OFF_ID]
+          @write_off_id = write_off_id
+          # @type [Payers::V3::Payer]
+          @payer = payer
+          # @type [WriteOffs::V1::InsuranceWriteOffTarget]
+          @write_off_target = write_off_target
+          # @type [DateTime]
+          @write_off_timestamp = write_off_timestamp
+          # @type [String]
+          @write_off_note = write_off_note
+          # @type [WriteOffs::V1::InsuranceWriteOffReason]
+          @write_off_reason = write_off_reason
+          # @type [WriteOffs::V1::WRITE_OFF_ID]
+          @reverts_write_off_id = reverts_write_off_id
+          # @type [WriteOffs::V1::WRITE_OFF_ID]
+          @reverted_by_write_off_id = reverted_by_write_off_id
+          # @type [Integer]
+          @amount_cents = amount_cents
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of InsuranceWriteOff
+        #
+        # @param json_object [JSON]
+        # @return [WriteOffs::V1::InsuranceWriteOff]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          write_off_id = struct.write_off_id
+          if parsed_json["payer"].nil?
+            payer = nil
+          else
+            payer = parsed_json["payer"].to_json
+            payer = Payers::V3::Payer.from_json(json_object: payer)
+          end
+          if parsed_json["write_off_target"].nil?
+            write_off_target = nil
+          else
+            write_off_target = parsed_json["write_off_target"].to_json
+            write_off_target = WriteOffs::V1::InsuranceWriteOffTarget.from_json(json_object: write_off_target)
+          end
+          write_off_timestamp = unless parsed_json["write_off_timestamp"].nil?
+                                  DateTime.parse(parsed_json["write_off_timestamp"])
+                                end
+          write_off_note = struct.write_off_note
+          write_off_reason = struct.write_off_reason
+          reverts_write_off_id = struct.reverts_write_off_id
+          reverted_by_write_off_id = struct.reverted_by_write_off_id
+          amount_cents = struct.amount_cents
+          new(write_off_id: write_off_id, payer: payer, write_off_target: write_off_target,
+              write_off_timestamp: write_off_timestamp, write_off_note: write_off_note, write_off_reason: write_off_reason, reverts_write_off_id: reverts_write_off_id, reverted_by_write_off_id: reverted_by_write_off_id, amount_cents: amount_cents, additional_properties: struct)
+        end
+
+        # Serialize an instance of InsuranceWriteOff to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "write_off_id": @write_off_id,
+            "payer": @payer,
+            "write_off_target": @write_off_target,
+            "write_off_timestamp": @write_off_timestamp,
+            "write_off_note": @write_off_note,
+            "write_off_reason": @write_off_reason,
+            "reverts_write_off_id": @reverts_write_off_id,
+            "reverted_by_write_off_id": @reverted_by_write_off_id,
+            "amount_cents": @amount_cents
+          }.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.write_off_id.is_a?(String) != false || raise("Passed value for field obj.write_off_id is not the expected type, validation failed.")
+          Payers::V3::Payer.validate_raw(obj: obj.payer)
+          WriteOffs::V1::InsuranceWriteOffTarget.validate_raw(obj: obj.write_off_target)
+          obj.write_off_timestamp.is_a?(DateTime) != false || raise("Passed value for field obj.write_off_timestamp is not the expected type, validation failed.")
+          obj.write_off_note&.is_a?(String) != false || raise("Passed value for field obj.write_off_note is not the expected type, validation failed.")
+          obj.write_off_reason.is_a?(WriteOffs::V1::InsuranceWriteOffReason) != false || raise("Passed value for field obj.write_off_reason is not the expected type, validation failed.")
+          obj.reverts_write_off_id&.is_a?(String) != false || raise("Passed value for field obj.reverts_write_off_id is not the expected type, validation failed.")
+          obj.reverted_by_write_off_id&.is_a?(String) != false || raise("Passed value for field obj.reverted_by_write_off_id is not the expected type, validation failed.")
+          obj.amount_cents.is_a?(Integer) != false || raise("Passed value for field obj.amount_cents is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/write_offs/v_1/types/insurance_write_off_create.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require_relative "../../../payers/v_3/types/payer_identifier"
+require_relative "insurance_write_off_target"
+require "date"
+require_relative "insurance_write_off_reason"
+require "json"
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class InsuranceWriteOffCreate
+        attr_reader :payer_identifier, :write_off_target, :write_off_timestamp, :write_off_note, :write_off_reason,
+                    :amount_cents, :additional_properties
+
+        # @param payer_identifier [Payers::V3::PayerIdentifier]
+        # @param write_off_target [WriteOffs::V1::InsuranceWriteOffTarget]
+        # @param write_off_timestamp [DateTime]
+        # @param write_off_note [String]
+        # @param write_off_reason [WriteOffs::V1::InsuranceWriteOffReason]
+        # @param amount_cents [Integer]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [WriteOffs::V1::InsuranceWriteOffCreate]
+        def initialize(payer_identifier:, write_off_target:, write_off_timestamp:, write_off_reason:, amount_cents:,
+                       write_off_note: nil, additional_properties: nil)
+          # @type [Payers::V3::PayerIdentifier]
+          @payer_identifier = payer_identifier
+          # @type [WriteOffs::V1::InsuranceWriteOffTarget]
+          @write_off_target = write_off_target
+          # @type [DateTime]
+          @write_off_timestamp = write_off_timestamp
+          # @type [String]
+          @write_off_note = write_off_note
+          # @type [WriteOffs::V1::InsuranceWriteOffReason]
+          @write_off_reason = write_off_reason
+          # @type [Integer]
+          @amount_cents = amount_cents
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of InsuranceWriteOffCreate
+        #
+        # @param json_object [JSON]
+        # @return [WriteOffs::V1::InsuranceWriteOffCreate]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          if parsed_json["payer_identifier"].nil?
+            payer_identifier = nil
+          else
+            payer_identifier = parsed_json["payer_identifier"].to_json
+            payer_identifier = Payers::V3::PayerIdentifier.from_json(json_object: payer_identifier)
+          end
+          if parsed_json["write_off_target"].nil?
+            write_off_target = nil
+          else
+            write_off_target = parsed_json["write_off_target"].to_json
+            write_off_target = WriteOffs::V1::InsuranceWriteOffTarget.from_json(json_object: write_off_target)
+          end
+          write_off_timestamp = unless parsed_json["write_off_timestamp"].nil?
+                                  DateTime.parse(parsed_json["write_off_timestamp"])
+                                end
+          write_off_note = struct.write_off_note
+          write_off_reason = struct.write_off_reason
+          amount_cents = struct.amount_cents
+          new(payer_identifier: payer_identifier, write_off_target: write_off_target,
+              write_off_timestamp: write_off_timestamp, write_off_note: write_off_note, write_off_reason: write_off_reason, amount_cents: amount_cents, additional_properties: struct)
+        end
+
+        # Serialize an instance of InsuranceWriteOffCreate to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "payer_identifier": @payer_identifier,
+            "write_off_target": @write_off_target,
+            "write_off_timestamp": @write_off_timestamp,
+            "write_off_note": @write_off_note,
+            "write_off_reason": @write_off_reason,
+            "amount_cents": @amount_cents
+          }.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:)
+          Payers::V3::PayerIdentifier.validate_raw(obj: obj.payer_identifier)
+          WriteOffs::V1::InsuranceWriteOffTarget.validate_raw(obj: obj.write_off_target)
+          obj.write_off_timestamp.is_a?(DateTime) != false || raise("Passed value for field obj.write_off_timestamp is not the expected type, validation failed.")
+          obj.write_off_note&.is_a?(String) != false || raise("Passed value for field obj.write_off_note is not the expected type, validation failed.")
+          obj.write_off_reason.is_a?(WriteOffs::V1::InsuranceWriteOffReason) != false || raise("Passed value for field obj.write_off_reason is not the expected type, validation failed.")
+          obj.amount_cents.is_a?(Integer) != false || raise("Passed value for field obj.amount_cents is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/write_offs/v_1/types/insurance_write_off_reason.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class InsuranceWriteOffReason
+        SMALL_BALANCE = "SMALL_BALANCE"
+        NO_AUTHORIZATION_REFERRAL = "NO_AUTHORIZATION_REFERRAL"
+        TIMELY_FILING = "TIMELY_FILING"
+        STALE_DATE = "STALE_DATE"
+        TIMELY_FILING_LATE_ENCOUNTER = "TIMELY_FILING_LATE_ENCOUNTER"
+        CREDENTIALING_OR_CONTRACTING = "CREDENTIALING_OR_CONTRACTING"
+        NON_COVERED_MAX_BENEFIT = "NON_COVERED_MAX_BENEFIT"
+        NOT_MEDICALLY_NECESSARY = "NOT_MEDICALLY_NECESSARY"
+        BUNDLED_OR_INCLUSIVE = "BUNDLED_OR_INCLUSIVE"
+        UNCOLLECTIBLE_OR_NON_BILLABLE = "UNCOLLECTIBLE_OR_NON_BILLABLE"
+        EFFORTS_EXHAUSTED = "EFFORTS_EXHAUSTED"
+        ADMINISTRATIVE_WRITE_OFF = "ADMINISTRATIVE_WRITE_OFF"
+        CASE_RATE_OR_CAPITATED = "CASE_RATE_OR_CAPITATED"
+        OTHER = "OTHER"
+        UNKNOWN = "UNKNOWN"
+      end
+    end
+  end
+end

data/lib/candidhealth/write_offs/v_1/types/insurance_write_off_target.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "../../../commons/types/service_line_id"
+require_relative "../../../commons/types/claim_id"
+require_relative "../../../commons/types/provider_id"
+
+module CandidApiClient
+  module WriteOffs
+    module V1
+      class InsuranceWriteOffTarget
+        attr_reader :member, :discriminant
+
+        private_class_method :new
+        alias kind_of? is_a?
+        # @param member [Object]
+        # @param discriminant [String]
+        # @return [WriteOffs::V1::InsuranceWriteOffTarget]
+        def initialize(member:, discriminant:)
+          # @type [Object]
+          @member = member
+          # @type [String]
+          @discriminant = discriminant
+        end
+
+        # Deserialize a JSON object to an instance of InsuranceWriteOffTarget
+        #
+        # @param json_object [JSON]
+        # @return [WriteOffs::V1::InsuranceWriteOffTarget]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          member = case struct.type
+                   when "service_line_id"
+                     json_object.value
+                   when "claim_id"
+                     json_object.value
+                   when "billing_provider_id"
+                     json_object.value
+                   else
+                     json_object
+                   end
+          new(member: member, discriminant: struct.type)
+        end
+
+        # For Union Types, to_json functionality is delegated to the wrapped member.
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          case @discriminant
+          when "service_line_id"
+          when "claim_id"
+          when "billing_provider_id"
+          end
+          { "type": @discriminant, "value": @member }.to_json
+          @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 "service_line_id"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          when "claim_id"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          when "billing_provider_id"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          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 [Commons::SERVICE_LINE_ID]
+        # @return [WriteOffs::V1::InsuranceWriteOffTarget]
+        def self.service_line_id(member:)
+          new(member: member, discriminant: "service_line_id")
+        end
+
+        # @param member [Commons::CLAIM_ID]
+        # @return [WriteOffs::V1::InsuranceWriteOffTarget]
+        def self.claim_id(member:)
+          new(member: member, discriminant: "claim_id")
+        end
+
+        # @param member [Commons::PROVIDER_ID]
+        # @return [WriteOffs::V1::InsuranceWriteOffTarget]
+        def self.billing_provider_id(member:)
+          new(member: member, discriminant: "billing_provider_id")
+        end
+      end
+    end
+  end
+end