candidhealth 1.14.3 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 268d3b96d7ce14f8e3840b82f54c75b1afc4bde41f18354051decfe45df5148d
-  data.tar.gz: 36241f5cddbc999ac0eba9f5dd1801e8b7dd9c3231e314c02eb35f1716a4b58f
+  metadata.gz: 6895f5f4be310fc99a79e4a950741d7a52ab05cc8e15a1d62d7a7fea6f63a344
+  data.tar.gz: 1ffc220cda0f77fa7f57e9d7e78748d1eb1384ef0d69522c533f51086b7d99f8
 SHA512:
-  metadata.gz: 155a2fa0a4949376abeae7eba3a23eba05d7045bbe5e7750735d3f8157f16c120ba39699b70d36e57470c18128972339eed83c441cbbdd8e45d41a4f117bf01a
-  data.tar.gz: e465f77c8c2a235a285e5f0b5f1d1d660b8f7e176b948e8eb8b70e86239b8e70fc05f35c74b958efcefe7aeb283d48a4972b2b1e4b0f4450a3d7efdd65eedc4c
+  metadata.gz: ee354cd3227e7868dbda9c9a4342dbafcd75ee316cde74ecb763f33c1f8819e3d8a149f847ee45da4aab45f323d952410df06c4d06395a840be8fafe209e79b1
+  data.tar.gz: 7dff42df91a60ee25188ef4832100e616b8713514465b74056fb238ff8145f3a9cd71f23b23c29da54d598c432498da9119eee3cd6fb39b31b62c56b503263ec

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.16.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/events/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Candid
+  module Events
+    class Client
+      # @return [Candid::Events::Client]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @return [Candid::V1::Client]
+      def v_1
+        @v_1 ||= Candid::Events::V1::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/candid/events/v_1/client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Candid
+  module Events
+    module V1
+      class Client
+        # @return [Candid::Events::V1::Client]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Scans the last 30 days of events. All results are sorted by created date, descending.
+        #
+        # @return [Candid::Events::V1::Types::EventScanPage]
+        def scan(request_options: {}, **params)
+          params = Candid::Internal::Types::Utils.symbolize_keys(params)
+          _query_param_names = %i[page_token limit event_types created_before created_after]
+          _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/events/v1/",
+            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::Events::V1::Types::EventScanPage.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::Events::V1::Types::Event]
+        def get(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "GET",
+            path: "/api/events/v1/#{params[:event_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::Events::V1::Types::Event.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/events/v_1/types/event.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module Events
+    module V1
+      module Types
+        class Event < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+          field :created_at, -> { String }, optional: false, nullable: false
+          field :timestamp, -> { String }, optional: false, nullable: false
+          field :event_type, -> { String }, optional: false, nullable: false
+          field :schema_version, -> { String }, optional: false, nullable: false
+          field :payload, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/events/v_1/types/event_scan_page.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Candid
+  module Events
+    module V1
+      module Types
+        class EventScanPage < Internal::Types::Model
+          field :next_page_token, -> { String }, optional: true, nullable: false
+          field :items, lambda {
+            Internal::Types::Array[Candid::Events::V1::Types::Event]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/events/v_1/types/get_event_scan_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Candid
+  module Events
+    module V1
+      module Types
+        class GetEventScanRequest < Internal::Types::Model
+          field :page_token, -> { String }, optional: true, nullable: false
+          field :limit, -> { Integer }, optional: true, nullable: false
+          field :event_types, -> { String }, optional: true, nullable: false
+          field :created_before, -> { String }, optional: true, nullable: false
+          field :created_after, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/insurance_adjudications/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Candid
+  module InsuranceAdjudications
+    class Client
+      # @return [Candid::InsuranceAdjudications::Client]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @return [Candid::V1::Client]
+      def v_1
+        @v_1 ||= Candid::InsuranceAdjudications::V1::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/candid/insurance_adjudications/v_1/client.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Candid
+  module InsuranceAdjudications
+    module V1
+      class Client
+        # @return [Candid::InsuranceAdjudications::V1::Client]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Retrieves a previously created insurance adjudication by its `insurance_adjudication_id`.
+        #
+        # @return [Candid::InsuranceAdjudications::V1::Types::InsuranceAdjudication]
+        def get(request_options: {}, **params)
+          _request = Candid::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || Candid::Environment::PRODUCTION,
+            method: "GET",
+            path: "/api/insurance-adjudications/v1/#{params[:insurance_adjudication_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::InsuranceAdjudications::V1::Types::InsuranceAdjudication.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/insurance_adjudications/v_1/types/claim_adjudication.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Candid
+  module InsuranceAdjudications
+    module V1
+      module Types
+        class ClaimAdjudication < Internal::Types::Model
+          field :claim_id, -> { String }, optional: false, nullable: false
+          field :insurance_allowed_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :insurance_paid_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :charge_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :service_lines, lambda {
+            Internal::Types::Hash[String, Internal::Types::Array[Candid::InsuranceAdjudications::V1::Types::ServiceLineAdjudication]]
+          }, optional: false, nullable: false
+          field :payer_claim_number, -> { String }, optional: true, nullable: false
+          field :carcs, lambda {
+            Internal::Types::Array[Candid::X12::V1::Types::ClaimAdjustmentReasonCode]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/insurance_adjudications/v_1/types/insurance_adjudication.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Candid
+  module InsuranceAdjudications
+    module V1
+      module Types
+        class InsuranceAdjudication < Internal::Types::Model
+          field :insurance_adjudication_id, -> { String }, optional: false, nullable: false
+          field :payer_uuid, -> { String }, optional: false, nullable: false
+          field :post_date, -> { String }, optional: true, nullable: false
+          field :check_number, -> { String }, optional: true, nullable: false
+          field :check_date, -> { String }, optional: false, nullable: false
+          field :note, -> { String }, optional: true, nullable: false
+          field :claims, lambda {
+            Internal::Types::Hash[String, Internal::Types::Array[Candid::InsuranceAdjudications::V1::Types::ClaimAdjudication]]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/insurance_adjudications/v_1/types/service_line_adjudication.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Candid
+  module InsuranceAdjudications
+    module V1
+      module Types
+        class ServiceLineAdjudication < Internal::Types::Model
+          field :service_line_adjudication_id, -> { String }, optional: false, nullable: false
+          field :denial_reason, lambda {
+            Candid::ServiceLines::V2::Types::DenialReasonContent
+          }, optional: true, nullable: false
+          field :insurance_allowed_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :insurance_paid_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :deductible_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :coinsurance_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :copay_amount_cents, -> { Integer }, optional: true, nullable: false
+          field :carcs, lambda {
+            Internal::Types::Array[Candid::X12::V1::Types::ClaimAdjustmentReasonCode]
+          }, optional: false, nullable: false
+          field :rarcs, lambda {
+            Internal::Types::Array[Candid::X12::V1::Types::RemittanceAdviceRemarkCode]
+          }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/patient_ar/v_1/client.rb

@@ -9,8 +9,6 @@ module Candid
           @client = client
         end
 
-        # NOTE: This service is in-development and can only be used by select partners. Please contact Candid Health to request access.
-        #
         # Retrieve a list of inventory records based on the provided filters. Each inventory record provides the latest invoiceable status of the associated claim.
         # The response is paginated, and the `page_token` can be used to retrieve subsequent pages. Initial requests should not include `page_token`.
         #
@@ -41,8 +39,6 @@ module Candid
           end
         end
 
-        # NOTE: This service is in-development and can only be used by select partners. Please contact Candid Health to request access.
-        #
         # Provides detailed itemization of invoice data for a specific claim.
         #
         # @return [Candid::PatientAr::V1::Types::InvoiceItemizationResponse]

data/lib/candid/patient_payments/v_4/types/card_payment_method.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Candid
+  module PatientPayments
+    module V4
+      module Types
+        class CardPaymentMethod < Internal::Types::Model; end
+      end
+    end
+  end
+end

data/lib/candid/patient_payments/v_4/types/cash_payment_method.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Candid
+  module PatientPayments
+    module V4
+      module Types
+        class CashPaymentMethod < Internal::Types::Model; end
+      end
+    end
+  end
+end

data/lib/candid/patient_payments/v_4/types/check_payment_method.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Candid
+  module PatientPayments
+    module V4
+      module Types
+        class CheckPaymentMethod < Internal::Types::Model
+          field :check_number, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/patient_payments/v_4/types/patient_payment.rb

@@ -19,6 +19,9 @@ module Candid
             Internal::Types::Array[Candid::Financials::Types::Allocation]
           }, optional: false, nullable: false
           field :invoice, -> { String }, optional: true, nullable: false
+          field :payment_method_detail, lambda {
+            Candid::PatientPayments::V4::Types::PaymentMethodDetail
+          }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/patient_payments/v_4/types/payment_method.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Candid
+  module PatientPayments
+    module V4
+      module Types
+        class PaymentMethod < Internal::Types::Model
+          extend Candid::Internal::Types::Union
+
+          discriminant :type
+
+          member -> { Candid::PatientPayments::V4::Types::CashPaymentMethod }, key: "CASH"
+          member -> { Candid::PatientPayments::V4::Types::CheckPaymentMethod }, key: "CHECK"
+          member -> { Candid::PatientPayments::V4::Types::CardPaymentMethod }, key: "CARD"
+        end
+      end
+    end
+  end
+end

data/lib/candid/patient_payments/v_4/types/payment_method_detail.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Candid
+  module PatientPayments
+    module V4
+      module Types
+        class PaymentMethodDetail < Internal::Types::Model
+          field :payment_method, lambda {
+            Candid::PatientPayments::V4::Types::PaymentMethod
+          }, optional: false, nullable: false
+          field :collected_at_address, lambda {
+            Candid::Commons::Types::StreetAddressShortZip
+          }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/candid/pre_encounter/eligibility_checks/v_1/types/eligibility_request.rb

@@ -21,6 +21,8 @@ module Candid
             field :encounter, lambda {
               Candid::PreEncounter::EligibilityChecks::V1::Types::Encounter
             }, optional: true, nullable: false
+            field :get_existing_check_initiated_after, -> { String }, optional: true, nullable: false
+            field :source, -> { String }, optional: true, nullable: false
           end
         end
       end

data/lib/candid/service_lines/v_2/types/service_line.rb

@@ -68,6 +68,7 @@ module Candid
           field :has_epsdt_indicator, -> { Internal::Types::Boolean }, optional: true, nullable: false
           field :has_family_planning_indicator, -> { Internal::Types::Boolean }, optional: true, nullable: false
           field :note, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/service_lines/v_2/types/service_line_create_base_base.rb

@@ -27,6 +27,7 @@ module Candid
             Internal::Types::Array[Candid::ServiceLines::V2::Types::TestResult]
           }, optional: true, nullable: false
           field :note, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/service_lines/v_2/types/service_line_create_optional.rb

@@ -30,6 +30,7 @@ module Candid
           }, optional: true, nullable: false
           field :note, -> { String }, optional: true, nullable: false
           field :revenue_code, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/service_lines/v_2/types/service_line_create_standalone.rb

@@ -9,6 +9,7 @@ module Candid
           field :diagnosis_id_one, -> { String }, optional: true, nullable: false
           field :diagnosis_id_two, -> { String }, optional: true, nullable: false
           field :diagnosis_id_three, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/service_lines/v_2/types/service_line_update_base.rb

@@ -29,6 +29,7 @@ module Candid
           field :has_epsdt_indicator, -> { Internal::Types::Boolean }, optional: true, nullable: false
           field :has_family_planning_indicator, -> { Internal::Types::Boolean }, optional: true, nullable: false
           field :note, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/service_lines/v_2/types/universal_service_line_create_standalone.rb

@@ -11,6 +11,7 @@ module Candid
           field :diagnosis_id_three, -> { String }, optional: true, nullable: false
           field :revenue_code, -> { String }, optional: true, nullable: false
           field :procedure_code, -> { String }, optional: true, nullable: false
+          field :prior_authorization_number, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/candid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Candid
-  VERSION = "1.14.3"
+  VERSION = "1.16.0"
 end