candidhealth 0.0.0

data/lib/candidhealth/era/types/era.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module Era
+    module Types
+      class Era
+        # @return [String]
+        attr_reader :era_id
+        # @return [String]
+        attr_reader :check_number
+        # @return [String]
+        attr_reader :check_date
+        # @return [OpenStruct] Additional properties unmapped to the current class definition
+        attr_reader :additional_properties
+        # @return [Object]
+        attr_reader :_field_set
+        protected :_field_set
+
+        OMIT = Object.new
+
+        # @param era_id [String]
+        # @param check_number [String]
+        # @param check_date [String]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [CandidApiClient::Era::Types::Era]
+        def initialize(era_id:, check_number:, check_date:, additional_properties: nil)
+          @era_id = era_id
+          @check_number = check_number
+          @check_date = check_date
+          @additional_properties = additional_properties
+          @_field_set = { "era_id": era_id, "check_number": check_number, "check_date": check_date }
+        end
+
+        # Deserialize a JSON object to an instance of Era
+        #
+        # @param json_object [String]
+        # @return [CandidApiClient::Era::Types::Era]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          era_id = struct["era_id"]
+          check_number = struct["check_number"]
+          check_date = struct["check_date"]
+          new(
+            era_id: era_id,
+            check_number: check_number,
+            check_date: check_date,
+            additional_properties: struct
+          )
+        end
+
+        # Serialize an instance of Era to a JSON object
+        #
+        # @return [String]
+        def to_json(*_args)
+          @_field_set&.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.era_id.is_a?(String) != false || raise("Passed value for field obj.era_id is not the expected type, validation failed.")
+          obj.check_number.is_a?(String) != false || raise("Passed value for field obj.check_number is not the expected type, validation failed.")
+          obj.check_date.is_a?(String) != false || raise("Passed value for field obj.check_date is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/era/types/era_base.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module Era
+    module Types
+      class EraBase
+        # @return [String]
+        attr_reader :check_number
+        # @return [String]
+        attr_reader :check_date
+        # @return [OpenStruct] Additional properties unmapped to the current class definition
+        attr_reader :additional_properties
+        # @return [Object]
+        attr_reader :_field_set
+        protected :_field_set
+
+        OMIT = Object.new
+
+        # @param check_number [String]
+        # @param check_date [String]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [CandidApiClient::Era::Types::EraBase]
+        def initialize(check_number:, check_date:, additional_properties: nil)
+          @check_number = check_number
+          @check_date = check_date
+          @additional_properties = additional_properties
+          @_field_set = { "check_number": check_number, "check_date": check_date }
+        end
+
+        # Deserialize a JSON object to an instance of EraBase
+        #
+        # @param json_object [String]
+        # @return [CandidApiClient::Era::Types::EraBase]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          check_number = struct["check_number"]
+          check_date = struct["check_date"]
+          new(
+            check_number: check_number,
+            check_date: check_date,
+            additional_properties: struct
+          )
+        end
+
+        # Serialize an instance of EraBase to a JSON object
+        #
+        # @return [String]
+        def to_json(*_args)
+          @_field_set&.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.check_number.is_a?(String) != false || raise("Passed value for field obj.check_number is not the expected type, validation failed.")
+          obj.check_date.is_a?(String) != false || raise("Passed value for field obj.check_date is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/era/types/era_not_fully_processed_error_message.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module Era
+    module Types
+      class EraNotFullyProcessedErrorMessage
+        # @return [String]
+        attr_reader :claim_id
+        # @return [String]
+        attr_reader :message
+        # @return [OpenStruct] Additional properties unmapped to the current class definition
+        attr_reader :additional_properties
+        # @return [Object]
+        attr_reader :_field_set
+        protected :_field_set
+
+        OMIT = Object.new
+
+        # @param claim_id [String]
+        # @param message [String]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [CandidApiClient::Era::Types::EraNotFullyProcessedErrorMessage]
+        def initialize(claim_id:, message:, additional_properties: nil)
+          @claim_id = claim_id
+          @message = message
+          @additional_properties = additional_properties
+          @_field_set = { "claim_id": claim_id, "message": message }
+        end
+
+        # Deserialize a JSON object to an instance of EraNotFullyProcessedErrorMessage
+        #
+        # @param json_object [String]
+        # @return [CandidApiClient::Era::Types::EraNotFullyProcessedErrorMessage]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          claim_id = struct["claim_id"]
+          message = struct["message"]
+          new(
+            claim_id: claim_id,
+            message: message,
+            additional_properties: struct
+          )
+        end
+
+        # Serialize an instance of EraNotFullyProcessedErrorMessage to a JSON object
+        #
+        # @return [String]
+        def to_json(*_args)
+          @_field_set&.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.claim_id.is_a?(String) != false || raise("Passed value for field obj.claim_id is not the expected type, validation failed.")
+          obj.message.is_a?(String) != false || raise("Passed value for field obj.message is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/era_commons/types/claim_status_code_create.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module EraCommons
+    module Types
+      # See https://www.stedi.com/edi/x12/element/1029
+      class ClaimStatusCodeCreate
+        PROCESSED_AS_PRIMARY = "1"
+        PROCESSED_AS_SECONDARY = "2"
+        PROCESSED_AS_TERTIARY = "3"
+        DENIED = "4"
+        PROCESSED_AS_PRIMARY_FORWARDED = "19"
+        PROCESSED_AS_SECONDARY_FORWARDED = "20"
+        PROCESSED_AS_TERTIARY_FORWARDED = "21"
+        REVERSAL_OF_PREVIOUS_PAYMENT = "22"
+        NOT_OUR_CLAIM_FORWARDED = "23"
+      end
+    end
+  end
+end

data/lib/candidhealth/expected_network_status/client.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "v_1/client"
+require_relative "v_2/client"
+
+module CandidApiClient
+  module ExpectedNetworkStatus
+    class Client
+      # @return [CandidApiClient::ExpectedNetworkStatus::V1::V1Client]
+      attr_reader :v_1
+      # @return [CandidApiClient::ExpectedNetworkStatus::V2::V2Client]
+      attr_reader :v_2
+
+      # @param request_client [CandidApiClient::RequestClient]
+      # @return [CandidApiClient::ExpectedNetworkStatus::Client]
+      def initialize(request_client:)
+        @v_1 = CandidApiClient::ExpectedNetworkStatus::V1::V1Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::ExpectedNetworkStatus::V2::V2Client.new(request_client: request_client)
+      end
+    end
+
+    class AsyncClient
+      # @return [CandidApiClient::ExpectedNetworkStatus::V1::AsyncV1Client]
+      attr_reader :v_1
+      # @return [CandidApiClient::ExpectedNetworkStatus::V2::AsyncV2Client]
+      attr_reader :v_2
+
+      # @param request_client [CandidApiClient::AsyncRequestClient]
+      # @return [CandidApiClient::ExpectedNetworkStatus::AsyncClient]
+      def initialize(request_client:)
+        @v_1 = CandidApiClient::ExpectedNetworkStatus::V1::AsyncV1Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::ExpectedNetworkStatus::V2::AsyncV2Client.new(request_client: request_client)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require_relative "../../commons/types/insurance_type_code"
+require_relative "../../commons/types/state"
+require_relative "types/expected_network_status_response"
+require "async"
+
+module CandidApiClient
+  module ExpectedNetworkStatus
+    module V1
+      class V1Client
+        # @return [CandidApiClient::RequestClient]
+        attr_reader :request_client
+
+        # @param request_client [CandidApiClient::RequestClient]
+        # @return [CandidApiClient::ExpectedNetworkStatus::V1::V1Client]
+        def initialize(request_client:)
+          @request_client = request_client
+        end
+
+        # Computes the expected network status given the provided information.
+        #
+        # @param external_patient_id [String]
+        # @param subscriber_payer_id [String]
+        # @param subscriber_payer_name [String]
+        # @param subscriber_insurance_type [CandidApiClient::Commons::Types::InsuranceTypeCode]
+        # @param subscriber_plan_name [String] The descriptive name of the insurance plan selected by the subscriber, often
+        #  indicating coverage specifics or tier.
+        # @param billing_provider_npi [String] The National Provider Identifier (NPI) of the healthcare provider responsible
+        #  for billing. A unique 10-digit identification number.
+        # @param billing_provider_tin [String] Follow the 9-digit format of the Taxpayer Identification Number (TIN).
+        # @param rendering_provider_npi [String] The National Provider Identifier (NPI) of the healthcare provider who delivered
+        #  the services. A unique 10-digit identification number.
+        # @param contracted_state [CandidApiClient::Commons::Types::State] The state in which the healthcare provider has a contractual agreement with the
+        #  insurance payer.
+        # @param date_of_service [String] Date formatted as YYYY-MM-DD; eg: 2019-08-25.
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.expected_network_status.v_1.compute(
+        #    subscriber_payer_id: "subscriber_payer_id",
+        #    subscriber_payer_name: "subscriber_payer_name",
+        #    billing_provider_npi: "billing_provider_npi",
+        #    billing_provider_tin: "billing_provider_tin",
+        #    rendering_provider_npi: "rendering_provider_npi",
+        #    contracted_state: AA,
+        #    date_of_service: "date_of_service"
+        #  )
+        def compute(subscriber_payer_id:, subscriber_payer_name:, billing_provider_npi:, billing_provider_tin:, rendering_provider_npi:, contracted_state:, date_of_service:, external_patient_id: nil,
+                    subscriber_insurance_type: nil, subscriber_plan_name: nil, request_options: nil)
+          response = @request_client.conn.post 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_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            req.body = {
+              **(request_options&.additional_body_parameters || {}),
+              external_patient_id: external_patient_id,
+              subscriber_payer_id: subscriber_payer_id,
+              subscriber_payer_name: subscriber_payer_name,
+              subscriber_insurance_type: subscriber_insurance_type,
+              subscriber_plan_name: subscriber_plan_name,
+              billing_provider_npi: billing_provider_npi,
+              billing_provider_tin: billing_provider_tin,
+              rendering_provider_npi: rendering_provider_npi,
+              contracted_state: contracted_state,
+              date_of_service: date_of_service
+            }.compact
+            req.url "#{@request_client.get_url(environment: CandidApi,
+                                               request_options: request_options)}/api/expected-network-status/v1"
+          end
+          CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse.from_json(json_object: response.body)
+        end
+      end
+
+      class AsyncV1Client
+        # @return [CandidApiClient::AsyncRequestClient]
+        attr_reader :request_client
+
+        # @param request_client [CandidApiClient::AsyncRequestClient]
+        # @return [CandidApiClient::ExpectedNetworkStatus::V1::AsyncV1Client]
+        def initialize(request_client:)
+          @request_client = request_client
+        end
+
+        # Computes the expected network status given the provided information.
+        #
+        # @param external_patient_id [String]
+        # @param subscriber_payer_id [String]
+        # @param subscriber_payer_name [String]
+        # @param subscriber_insurance_type [CandidApiClient::Commons::Types::InsuranceTypeCode]
+        # @param subscriber_plan_name [String] The descriptive name of the insurance plan selected by the subscriber, often
+        #  indicating coverage specifics or tier.
+        # @param billing_provider_npi [String] The National Provider Identifier (NPI) of the healthcare provider responsible
+        #  for billing. A unique 10-digit identification number.
+        # @param billing_provider_tin [String] Follow the 9-digit format of the Taxpayer Identification Number (TIN).
+        # @param rendering_provider_npi [String] The National Provider Identifier (NPI) of the healthcare provider who delivered
+        #  the services. A unique 10-digit identification number.
+        # @param contracted_state [CandidApiClient::Commons::Types::State] The state in which the healthcare provider has a contractual agreement with the
+        #  insurance payer.
+        # @param date_of_service [String] Date formatted as YYYY-MM-DD; eg: 2019-08-25.
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.expected_network_status.v_1.compute(
+        #    subscriber_payer_id: "subscriber_payer_id",
+        #    subscriber_payer_name: "subscriber_payer_name",
+        #    billing_provider_npi: "billing_provider_npi",
+        #    billing_provider_tin: "billing_provider_tin",
+        #    rendering_provider_npi: "rendering_provider_npi",
+        #    contracted_state: AA,
+        #    date_of_service: "date_of_service"
+        #  )
+        def compute(subscriber_payer_id:, subscriber_payer_name:, billing_provider_npi:, billing_provider_tin:, rendering_provider_npi:, contracted_state:, date_of_service:, external_patient_id: nil,
+                    subscriber_insurance_type: nil, subscriber_plan_name: nil, request_options: nil)
+          Async do
+            response = @request_client.conn.post 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_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.body = {
+                **(request_options&.additional_body_parameters || {}),
+                external_patient_id: external_patient_id,
+                subscriber_payer_id: subscriber_payer_id,
+                subscriber_payer_name: subscriber_payer_name,
+                subscriber_insurance_type: subscriber_insurance_type,
+                subscriber_plan_name: subscriber_plan_name,
+                billing_provider_npi: billing_provider_npi,
+                billing_provider_tin: billing_provider_tin,
+                rendering_provider_npi: rendering_provider_npi,
+                contracted_state: contracted_state,
+                date_of_service: date_of_service
+              }.compact
+              req.url "#{@request_client.get_url(environment: CandidApi,
+                                                 request_options: request_options)}/api/expected-network-status/v1"
+            end
+            CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse.from_json(json_object: response.body)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/expected_network_status/v_1/types/expected_network_status.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module ExpectedNetworkStatus
+    module V1
+      module Types
+        class ExpectedNetworkStatus
+          IN_NETWORK = "in_network"
+          OUT_OF_NETWORK = "out_of_network"
+          UNKNOWN = "unknown"
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/expected_network_status/v_1/types/expected_network_status_response.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "expected_network_status"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module ExpectedNetworkStatus
+    module V1
+      module Types
+        class ExpectedNetworkStatusResponse
+          # @return [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatus] The anticipated classification of a healthcare provider within the insurance
+          #  plan's network.
+          attr_reader :expected_network_status
+          # @return [String]
+          attr_reader :explanation
+          # @return [String]
+          attr_reader :contract_id
+          # @return [OpenStruct] Additional properties unmapped to the current class definition
+          attr_reader :additional_properties
+          # @return [Object]
+          attr_reader :_field_set
+          protected :_field_set
+
+          OMIT = Object.new
+
+          # @param expected_network_status [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatus] The anticipated classification of a healthcare provider within the insurance
+          #  plan's network.
+          # @param explanation [String]
+          # @param contract_id [String]
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse]
+          def initialize(expected_network_status:, explanation:, contract_id: OMIT, additional_properties: nil)
+            @expected_network_status = expected_network_status
+            @explanation = explanation
+            @contract_id = contract_id if contract_id != OMIT
+            @additional_properties = additional_properties
+            @_field_set = {
+              "expected_network_status": expected_network_status,
+              "explanation": explanation,
+              "contract_id": contract_id
+            }.reject do |_k, v|
+              v == OMIT
+            end
+          end
+
+          # Deserialize a JSON object to an instance of ExpectedNetworkStatusResponse
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatusResponse]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            expected_network_status = struct["expected_network_status"]
+            explanation = struct["explanation"]
+            contract_id = struct["contract_id"]
+            new(
+              expected_network_status: expected_network_status,
+              explanation: explanation,
+              contract_id: contract_id,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of ExpectedNetworkStatusResponse to a JSON object
+          #
+          # @return [String]
+          def to_json(*_args)
+            @_field_set&.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.expected_network_status.is_a?(CandidApiClient::ExpectedNetworkStatus::V1::Types::ExpectedNetworkStatus) != false || raise("Passed value for field obj.expected_network_status is not the expected type, validation failed.")
+            obj.explanation.is_a?(String) != false || raise("Passed value for field obj.explanation is not the expected type, validation failed.")
+            obj.contract_id&.is_a?(String) != false || raise("Passed value for field obj.contract_id is not the expected type, validation failed.")
+          end
+        end
+      end
+    end
+  end
+end