candidhealth 1.16.0 → 1.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6895f5f4be310fc99a79e4a950741d7a52ab05cc8e15a1d62d7a7fea6f63a344
-  data.tar.gz: 1ffc220cda0f77fa7f57e9d7e78748d1eb1384ef0d69522c533f51086b7d99f8
+  metadata.gz: 6216b846646f6d4f67bf117597fba91822a5055020bd90b7e5fe8dd437cba1af
+  data.tar.gz: 4b8061c0931b7076543f6c629a71f7b85410c9d4b8af7f01a721428e66904dd2
 SHA512:
-  metadata.gz: ee354cd3227e7868dbda9c9a4342dbafcd75ee316cde74ecb763f33c1f8819e3d8a149f847ee45da4aab45f323d952410df06c4d06395a840be8fafe209e79b1
-  data.tar.gz: 7dff42df91a60ee25188ef4832100e616b8713514465b74056fb238ff8145f3a9cd71f23b23c29da54d598c432498da9119eee3cd6fb39b31b62c56b503263ec
+  metadata.gz: 95d0909dc1a1bcaa14953cfab64acb80c06704a412371ce0bb28be99d875a3ca0a402a833b8b2efd1c64064a1b68b785076ca86ac6e71896ece655aea2baec1a
+  data.tar.gz: ba7a7847a5bbbd6344cc846378d5d2bccd4ea7fca3817db140a55c6c7487649208360da9c8b85c72fc859598a66f1a7ca46d19611f02c3e477a5186bdd562ab4

data/lib/candid/client.rb

@@ -7,7 +7,7 @@ module Candid
       @raw_client = Candid::Internal::Http::RawClient.new(
         base_url: base_url,
         headers: {
-          "User-Agent": "candidhealth/1.16.0",
+          "User-Agent": "candidhealth/1.17.1",
           "X-Fern-Language": "Ruby"
         }
       )
@@ -118,11 +118,6 @@ module Candid
       @insurance_adjudications ||= Candid::InsuranceAdjudications::Client.new(client: @raw_client)
     end
 
-    # @return [Candid::InsurancePayments::Client]
-    def insurance_payments
-      @insurance_payments ||= Candid::InsurancePayments::Client.new(client: @raw_client)
-    end
-
     # @return [Candid::InsuranceRefunds::Client]
     def insurance_refunds
       @insurance_refunds ||= Candid::InsuranceRefunds::Client.new(client: @raw_client)

data/lib/candid/contracts/client.rb

@@ -12,6 +12,11 @@ module Candid
       def v_2
         @v_2 ||= Candid::Contracts::V2::Client.new(client: @client)
       end
+
+      # @return [Candid::V3::Client]
+      def v_3
+        @v_3 ||= Candid::Contracts::V3::Client.new(client: @client)
+      end
     end
   end
 end

data/lib/candid/contracts/v_2/client.rb

@@ -9,6 +9,8 @@ module Candid
           @client = client
         end
 
+        # This API provides access to Professional Contracts. For Professional and Institutional Contracts use Contracts V3.
+        #
         # @return [Candid::Contracts::V2::Types::ContractWithProviders]
         def get(request_options: {}, **params)
           _request = Candid::Internal::JSON::Request.new(
@@ -30,6 +32,8 @@ module Candid
           end
         end
 
+        # This API provides access to Professional Contracts. For Professional and Institutional Contracts use Contracts V3.
+        #
         # @return [Candid::Contracts::V2::Types::ContractsPage]
         def get_multi(request_options: {}, **params)
           params = Candid::Internal::Types::Utils.symbolize_keys(params)

data/lib/candid/contracts/v_3/client.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      class Client
+        # @return [Candid::Contracts::V3::Client]
+        def initialize(client:)
+          @client = client
+        end
+
+        # @return [Candid::Contracts::V3::Types::ContractWithProvidersUnion]
+        def get(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "GET",
+            path: "/api/contracts/v3/#{params[:contract_id]}"
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractWithProvidersUnion.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+
+        # @return [Candid::Contracts::V3::Types::ContractsPage]
+        def get_multi(request_options: {}, **params)
+          params = Candid::Internal::Types::Utils.symbolize_keys(params)
+          _query_param_names = %i[page_token limit type contracting_provider_id rendering_provider_ids payer_names
+                                  states contract_status sort sort_direction]
+          _query = params.slice(*_query_param_names)
+          params.except(*_query_param_names)
+
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "GET",
+            path: "/api/contracts/v3",
+            query: _query
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractsPage.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+
+        # Creates a new contract within the user's current organization
+        #
+        # @return [Candid::Contracts::V3::Types::ContractWithProvidersUnion]
+        def create(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "POST",
+            path: "/api/contracts/v3",
+            body: Candid::Contracts::V3::Types::ContractCreateUnion.new(params).to_h
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractWithProvidersUnion.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+
+        # @return [untyped]
+        def delete(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "DELETE",
+            path: "/api/contracts/v3/#{params[:contract_id]}"
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          return if code.between?(200, 299)
+
+          error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(_response.body, code: code)
+        end
+
+        # @return [Candid::Contracts::V3::Types::ContractWithProvidersUnion]
+        def update(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "PATCH",
+            path: "/api/contracts/v3/#{params[:contract_id]}",
+            body: Candid::Contracts::V3::Types::ContractUpdateUnion.new(params).to_h
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractWithProvidersUnion.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+
+        # @return [Candid::Contracts::V3::Types::ContractServiceFacility]
+        def create_contract_service_facility(request_options: {}, **params)
+          _path_param_names = ["contract_id"]
+
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "POST",
+            path: "/api/contracts/v3/#{params[:contract_id]}/service-facilities",
+            body: params.except(*_path_param_names)
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractServiceFacility.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+
+        # @return [Candid::Contracts::V3::Types::ContractServiceFacility]
+        def update_contract_service_facility(request_options: {}, **params)
+          _path_param_names = %w[contract_id contract_service_facility_id]
+
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "PATCH",
+            path: "/api/contracts/v3/#{params[:contract_id]}/service-facilities/#{params[:contract_service_facility_id]}",
+            body: params.except(*_path_param_names)
+          )
+          begin
+            _response = @client.send(_request)
+          rescue Net::HTTPRequestTimeout
+            raise Candid::Errors::TimeoutError
+          end
+          code = _response.code.to_i
+          if code.between?(200, 299)
+            Candid::Contracts::V3::Types::ContractServiceFacility.load(_response.body)
+          else
+            error_class = Candid::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(_response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class Contract < Internal::Types::Model
+          field :contract_id, -> { String }, optional: false, nullable: false
+          field :contracting_provider, lambda {
+            Candid::OrganizationProviders::V2::Types::OrganizationProvider
+          }, optional: false, nullable: false
+          field :provider_count, -> { Integer }, optional: false, nullable: false
+          field :payer, -> { Candid::Payers::V3::Types::Payer }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_base.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractBase < Internal::Types::Model
+          field :effective_date, -> { String }, optional: false, nullable: false
+          field :expiration_date, -> { String }, optional: true, nullable: false
+          field :regions, -> { Candid::Commons::Types::Regions }, optional: false, nullable: false
+          field :contract_status, -> { Candid::Contracts::V2::Types::ContractStatus }, optional: true, nullable: false
+          field :authorized_signatory, lambda {
+            Candid::Contracts::V2::Types::AuthorizedSignatory
+          }, optional: true, nullable: false
+          field :commercial_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: false, nullable: false
+          field :medicare_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: false, nullable: false
+          field :medicaid_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_create.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractCreate < Internal::Types::Model
+          field :contract_type, -> { Candid::Contracts::V3::Types::ContractType }, optional: false, nullable: false
+          field :contracting_provider_id, -> { String }, optional: false, nullable: false
+          field :payer_uuid, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_create_union.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractCreateUnion < Internal::Types::Model
+          extend Candid::Internal::Types::Union
+
+          discriminant :type
+
+          member -> { Candid::Contracts::V3::Types::ProfessionalContractCreate }, key: "PROFESSIONAL"
+          member -> { Candid::Contracts::V3::Types::InstitutionalContractCreate }, key: "INSTITUTIONAL"
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_service_facility.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractServiceFacility < Internal::Types::Model
+          field :contract_id, -> { String }, optional: false, nullable: false
+          field :contract_service_facility_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_service_facility_base.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractServiceFacilityBase < Internal::Types::Model
+          field :service_facility_id, -> { String }, optional: false, nullable: false
+          field :provider_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_service_facility_create.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractServiceFacilityCreate < Internal::Types::Model
+          field :contract_id, -> { String }, optional: false, nullable: false
+          field :service_facility_id, -> { String }, optional: false, nullable: false
+          field :provider_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_service_facility_update.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractServiceFacilityUpdate < Internal::Types::Model
+          field :contract_id, -> { String }, optional: false, nullable: false
+          field :contract_service_facility_id, -> { String }, optional: false, nullable: false
+          field :service_facility_id, -> { String }, optional: true, nullable: false
+          field :provider_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        module ContractType
+          extend Candid::Internal::Types::Enum
+
+          PROFESSIONAL = "professional"
+          INSTITUTIONAL = "institutional"
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_union.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractUnion < Internal::Types::Model
+          extend Candid::Internal::Types::Union
+
+          discriminant :type
+
+          member -> { Candid::Contracts::V3::Types::Contract }, key: "PROFESSIONAL"
+          member -> { Candid::Contracts::V3::Types::Contract }, key: "INSTITUTIONAL"
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_update.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractUpdate < Internal::Types::Model
+          field :effective_date, -> { String }, optional: true, nullable: false
+          field :expiration_date, -> { Candid::Contracts::V2::Types::DateUpdate }, optional: true, nullable: false
+          field :regions, -> { Candid::Contracts::V2::Types::RegionsUpdate }, optional: true, nullable: false
+          field :contract_status, -> { Candid::Contracts::V2::Types::ContractStatus }, optional: true, nullable: false
+          field :authorized_signatory, lambda {
+            Candid::Contracts::V2::Types::AuthorizedSignatoryUpdate
+          }, optional: true, nullable: false
+          field :commercial_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: true, nullable: false
+          field :medicare_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: true, nullable: false
+          field :medicaid_insurance_types, lambda {
+            Candid::Contracts::V2::Types::InsuranceTypes
+          }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_update_union.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractUpdateUnion < Internal::Types::Model
+          extend Candid::Internal::Types::Union
+
+          discriminant :type
+
+          member -> { Candid::Contracts::V3::Types::ProfessionalContractUpdate }, key: "PROFESSIONAL"
+          member -> { Candid::Contracts::V3::Types::InstitutionalContractUpdate }, key: "INSTITUTIONAL"
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contract_with_providers_union.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractWithProvidersUnion < Internal::Types::Model
+          extend Candid::Internal::Types::Union
+
+          discriminant :type
+
+          member -> { Candid::Contracts::V3::Types::ProfessionalContract }, key: "PROFESSIONAL"
+          member -> { Candid::Contracts::V3::Types::InstitutionalContract }, key: "INSTITUTIONAL"
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/contracts_page.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ContractsPage < Internal::Types::Model
+          field :items, lambda {
+            Internal::Types::Array[Candid::Contracts::V3::Types::ContractUnion]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/get_multi_contracts_request.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class GetMultiContractsRequest < Internal::Types::Model
+          field :page_token, -> { String }, optional: true, nullable: false
+          field :limit, -> { Integer }, optional: true, nullable: false
+          field :type, -> { Candid::Contracts::V3::Types::ContractType }, optional: true, nullable: false
+          field :contracting_provider_id, -> { String }, optional: true, nullable: false
+          field :rendering_provider_ids, -> { String }, optional: true, nullable: false
+          field :payer_names, -> { String }, optional: true, nullable: false
+          field :states, -> { Candid::Commons::Types::State }, optional: true, nullable: false
+          field :contract_status, -> { Candid::Contracts::V2::Types::ContractStatus }, optional: true, nullable: false
+          field :sort, -> { Candid::Contracts::V2::Types::ContractSortField }, optional: true, nullable: false
+          field :sort_direction, -> { Candid::Commons::Types::SortDirection }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/institutional_contract.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class InstitutionalContract < Internal::Types::Model
+          field :contract_service_facilities, lambda {
+            Internal::Types::Array[Candid::Contracts::V3::Types::ContractServiceFacility]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/institutional_contract_create.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class InstitutionalContractCreate < Internal::Types::Model
+          field :contract_service_facilities, lambda {
+            Internal::Types::Array[Candid::Contracts::V3::Types::ContractServiceFacilityBase]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/institutional_contract_update.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class InstitutionalContractUpdate < Internal::Types::Model
+          field :contract_service_facility_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/professional_contract.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ProfessionalContract < Internal::Types::Model
+          field :rendering_provider_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/professional_contract_create.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ProfessionalContractCreate < Internal::Types::Model
+          field :rendering_provider_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/contracts/v_3/types/professional_contract_update.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Candid
+  module Contracts
+    module V3
+      module Types
+        class ProfessionalContractUpdate < Internal::Types::Model
+          field :rendering_provider_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

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

@@ -20,6 +20,9 @@ module Candid
           field :provider_commercial_license_type, lambda {
             Candid::Commons::Types::BillingProviderCommercialLicenseType
           }, optional: true, nullable: false
+          field :secondary_identification, lambda {
+            Candid::EncounterProviders::V2::Types::ProviderSecondaryIdentification
+          }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/encounter_providers/v_2/types/billing_provider_update.rb

@@ -20,6 +20,9 @@ module Candid
           field :provider_commercial_license_type, lambda {
             Candid::Commons::Types::BillingProviderCommercialLicenseType
           }, optional: true, nullable: false
+          field :secondary_identification, lambda {
+            Candid::EncounterProviders::V2::Types::ProviderSecondaryIdentification
+          }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/encounter_providers/v_2/types/billing_provider_update_with_optional_address.rb

@@ -21,6 +21,9 @@ module Candid
           field :provider_commercial_license_type, lambda {
             Candid::Commons::Types::BillingProviderCommercialLicenseType
           }, optional: true, nullable: false
+          field :secondary_identification, lambda {
+            Candid::EncounterProviders::V2::Types::ProviderSecondaryIdentification
+          }, optional: true, nullable: false
         end
       end
     end