candidhealth 1.14.3 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 268d3b96d7ce14f8e3840b82f54c75b1afc4bde41f18354051decfe45df5148d
-  data.tar.gz: 36241f5cddbc999ac0eba9f5dd1801e8b7dd9c3231e314c02eb35f1716a4b58f
+  metadata.gz: 853cc42ee8abf8c4143310b93223536552422f6b5df3a3985c39eb0e37426464
+  data.tar.gz: 8a38a7886555681dcc72f0a9169196a9c98d3d372cdfecd2894311fdf2a13979
 SHA512:
-  metadata.gz: 155a2fa0a4949376abeae7eba3a23eba05d7045bbe5e7750735d3f8157f16c120ba39699b70d36e57470c18128972339eed83c441cbbdd8e45d41a4f117bf01a
-  data.tar.gz: e465f77c8c2a235a285e5f0b5f1d1d660b8f7e176b948e8eb8b70e86239b8e70fc05f35c74b958efcefe7aeb283d48a4972b2b1e4b0f4450a3d7efdd65eedc4c
+  metadata.gz: 2266e660bc9202a895da85672882c61e5909d30e4ea56bdbb6132e859797ea5e345b573651d7d5c7f4a22aa6911e599931f69d1ae4d0c7ca5af23399768d6140
+  data.tar.gz: 98ed5edbe35a94a3b2bda0f88c35a8277bf017524a6738bf318c617c1fc68f8c15cc2dafb9384497a16644536e30195268c1b57eb9698df13e8097f403d6bc25

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.14.3",
+          "User-Agent": "candidhealth/1.17.0",
           "X-Fern-Language": "Ruby"
         }
       )
@@ -73,6 +73,11 @@ module Candid
       @encounters ||= Candid::Encounters::Client.new(client: @raw_client)
     end
 
+    # @return [Candid::Events::Client]
+    def events
+      @events ||= Candid::Events::Client.new(client: @raw_client)
+    end
+
     # @return [Candid::ExpectedNetworkStatus::Client]
     def expected_network_status
       @expected_network_status ||= Candid::ExpectedNetworkStatus::Client.new(client: @raw_client)
@@ -108,6 +113,11 @@ module Candid
       @import_invoice ||= Candid::ImportInvoice::Client.new(client: @raw_client)
     end
 
+    # @return [Candid::InsuranceAdjudications::Client]
+    def insurance_adjudications
+      @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)

data/lib/candid/commons/types/bad_request_error_message.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Candid
+  module Commons
+    module Types
+      class BadRequestErrorMessage < Internal::Types::Model
+        field :message, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/candid/commons/types/claim_adjustment_group_codes.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Candid
+  module Commons
+    module Types
+      module ClaimAdjustmentGroupCodes
+        extend Candid::Internal::Types::Enum
+
+        CO = "CO"
+        CR = "CR"
+        DE = "DE"
+        MA = "MA"
+        OA = "OA"
+        PI = "PI"
+        PR = "PR"
+        RR = "RR"
+        NC = "NC"
+        UNKNOWN = "UNKNOWN"
+      end
+    end
+  end
+end

data/lib/candid/commons/types/internal_error_message.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Candid
+  module Commons
+    module Types
+      class InternalErrorMessage < Internal::Types::Model
+        field :message, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/candid/commons/types/procedure_modifier.rb

@@ -417,6 +417,7 @@ module Candid
         XS = "XS"
         XU = "XU"
         XY = "XY"
+        ZZ = "ZZ"
       end
     end
   end

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