candidhealth 1.14.6 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ef4d7666c56ae058023d80f367bd7e91b20c3b6c9f9f9bd25a55aa7faed24e1
-  data.tar.gz: 3cdd1bda02275355102d545f608c763a94deb91ab0414777c52c2c02e901713c
+  metadata.gz: 6895f5f4be310fc99a79e4a950741d7a52ab05cc8e15a1d62d7a7fea6f63a344
+  data.tar.gz: 1ffc220cda0f77fa7f57e9d7e78748d1eb1384ef0d69522c533f51086b7d99f8
 SHA512:
-  metadata.gz: a970b5025f0d75505f4ba69b1c50dd892d0f6d0d239683feaf7af864ed187812d06d6904473c8a89cd42a7aeb80b049467ea34f15abef65546ec9cc556354690
-  data.tar.gz: 40035920c0ce0b2f31c5ea734a2b87b994265e549447ef9edf9f5f8312ac34c09c9ff846e2e52b675ec356a81d787030ada9caaeb669d8aeb5b27aaa623e52f4
+  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.6",
+          "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)

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/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/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/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/version.rb

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

data/lib/candid.rb

@@ -381,6 +381,8 @@ require_relative "candid/encounters/v_4/types/schema_instance_validation_error"
 require_relative "candid/encounters/v_4/types/schema_instance_validation_failure"
 require_relative "candid/encounters/v_4/types/payer_plan_group_payer_does_not_match_insurance_card_error"
 require_relative "candid/encounters/v_4/types/encounter_rendering_or_attending_provider_required_error"
+require_relative "candid/events/v_1/types/event"
+require_relative "candid/events/v_1/types/event_scan_page"
 require_relative "candid/expected_network_status/v_1/types/expected_network_status"
 require_relative "candid/expected_network_status/v_1/types/expected_network_status_response"
 require_relative "candid/expected_network_status/v_2/types/line_of_business"
@@ -706,6 +708,8 @@ require_relative "candid/commons/types/http_service_unavailable_error_message"
 require_relative "candid/commons/types/request_validation_error"
 require_relative "candid/commons/types/updates_disabled_due_to_external_system_integration_error_message"
 require_relative "candid/commons/types/organization_not_authorized_error_message"
+require_relative "candid/commons/types/bad_request_error_message"
+require_relative "candid/commons/types/internal_error_message"
 require_relative "candid/diagnoses/types/diagnosis_not_found_error"
 require_relative "candid/diagnoses/types/service_lines_must_have_at_least_one_diagnosis_error"
 require_relative "candid/diagnoses/types/disallow_multiple_primary_diagnosis_error"
@@ -766,6 +770,9 @@ require_relative "candid/encounter_supplemental_information/v_1/client"
 require_relative "candid/encounters/client"
 require_relative "candid/encounters/v_4/client"
 require_relative "candid/encounters/v_4/types/get_all_encounters_request"
+require_relative "candid/events/client"
+require_relative "candid/events/v_1/client"
+require_relative "candid/events/v_1/types/get_event_scan_request"
 require_relative "candid/expected_network_status/client"
 require_relative "candid/expected_network_status/v_1/client"
 require_relative "candid/expected_network_status/v_1/types/expected_network_status_request"

data/reference.md

@@ -4477,6 +4477,133 @@ client.encounters.v_4.update({});
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Events V1
+<details><summary><code>client.events.v_1.scan() -> Candid::Events::V1::Types::EventScanPage</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Scans the last 30 days of events. All results are sorted by created date, descending.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.events.v_1.scan();
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**page_token:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**limit:** `Integer` — Number of events to return. Minimum value is 1, maximum is 100. Defaults to 10.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**event_types:** `String` — Event types to filter on. Defaults to showing all event types.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**created_before:** `String` — Filters for only events created before this time (inclusive).
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**created_after:** `String` — Filters for only events created after this time (inclusive).
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.events.v_1.get(event_id) -> Candid::Events::V1::Types::Event</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.events.v_1.get();
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**event_id:** `String` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -8668,8 +8795,6 @@ client.organization_service_facilities.v_2.delete();
 <dl>
 <dd>
 
-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`.
 </dd>
@@ -8741,8 +8866,6 @@ client.patient_ar.v_1.list_inventory();
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: candidhealth
 version: !ruby/object:Gem::Version
-  version: 1.14.6
+  version: 1.16.0
 platform: ruby
 authors:
 - Candid
@@ -68,6 +68,7 @@ files:
 - lib/candid/clinical_trials/v_1/types/clinical_trial.rb
 - lib/candid/clinical_trials/v_1/types/clinical_trial_phase.rb
 - lib/candid/clinical_trials/v_1/types/mutable_clinical_trial.rb
+- lib/candid/commons/types/bad_request_error_message.rb
 - lib/candid/commons/types/billing_provider_commercial_license_type.rb
 - lib/candid/commons/types/claim_adjustment_group_codes.rb
 - lib/candid/commons/types/claim_submission_payer_responsibility_type.rb
@@ -82,6 +83,7 @@ files:
 - lib/candid/commons/types/http_service_unavailable_error_message.rb
 - lib/candid/commons/types/insurance_type_code.rb
 - lib/candid/commons/types/intended_submission_medium.rb
+- lib/candid/commons/types/internal_error_message.rb
 - lib/candid/commons/types/network_type.rb
 - lib/candid/commons/types/next_responsible_party.rb
 - lib/candid/commons/types/organization_not_authorized_error_message.rb
@@ -281,6 +283,11 @@ files:
 - lib/candid/errors/response_error.rb
 - lib/candid/errors/server_error.rb
 - lib/candid/errors/timeout_error.rb
+- lib/candid/events/client.rb
+- lib/candid/events/v_1/client.rb
+- lib/candid/events/v_1/types/event.rb
+- lib/candid/events/v_1/types/event_scan_page.rb
+- lib/candid/events/v_1/types/get_event_scan_request.rb
 - lib/candid/expected_network_status/client.rb
 - lib/candid/expected_network_status/v_1/client.rb
 - lib/candid/expected_network_status/v_1/types/expected_network_status.rb