candidhealth 0.17.1

data/lib/candidhealth/service_lines/v_2/types/service_line_create.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require_relative "../../../commons/types/procedure_modifier"
+require_relative "../../../commons/types/decimal"
+require_relative "../../../commons/types/service_line_units"
+require_relative "drug_identification"
+require_relative "../../../commons/types/facility_type_code"
+require "json"
+
+module CandidApiClient
+  module ServiceLines
+    module V2
+      class ServiceLineCreate
+        attr_reader :modifiers, :procedure_code, :quantity, :units, :charge_amount_cents, :diagnosis_pointers,
+                    :drug_identification, :place_of_service_code, :description, :additional_properties
+
+        # @param modifiers [Array<Commons::ProcedureModifier>]
+        # @param procedure_code [String]
+        # @param quantity [Commons::DECIMAL] String representation of a Decimal that can be parsed by most libraries.
+        #   A ServiceLine quantity cannot contain more than one digit of precision.
+        #   Example: 1.1 is valid, 1.11 is not.
+        # @param units [Commons::ServiceLineUnits]
+        # @param charge_amount_cents [Integer] The total amount charged for this service line taking quantity into account. For example, if a single unit
+        #   costs 100 cents and 2 units were rendered, the charge_amount_cents should be 200. Should be greater than or
+        #   equal to 0.
+        # @param diagnosis_pointers [Array<Integer>] Indices (zero-indexed) of all the diagnoses this service line references
+        # @param drug_identification [ServiceLines::V2::DrugIdentification]
+        # @param place_of_service_code [Commons::FacilityTypeCode]
+        # @param description [String] A free-form description to clarify the related data elements and their content. Maps to SV1-01, C003-07 on the 837-P.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [ServiceLines::V2::ServiceLineCreate]
+        def initialize(procedure_code:, quantity:, units:, diagnosis_pointers:, modifiers: nil,
+                       charge_amount_cents: nil, drug_identification: nil, place_of_service_code: nil, description: nil, additional_properties: nil)
+          # @type [Array<Commons::ProcedureModifier>]
+          @modifiers = modifiers
+          # @type [String]
+          @procedure_code = procedure_code
+          # @type [Commons::DECIMAL] String representation of a Decimal that can be parsed by most libraries.
+          #   A ServiceLine quantity cannot contain more than one digit of precision.
+          #   Example: 1.1 is valid, 1.11 is not.
+          @quantity = quantity
+          # @type [Commons::ServiceLineUnits]
+          @units = units
+          # @type [Integer] The total amount charged for this service line taking quantity into account. For example, if a single unit
+          #   costs 100 cents and 2 units were rendered, the charge_amount_cents should be 200. Should be greater than or
+          #   equal to 0.
+          @charge_amount_cents = charge_amount_cents
+          # @type [Array<Integer>] Indices (zero-indexed) of all the diagnoses this service line references
+          @diagnosis_pointers = diagnosis_pointers
+          # @type [ServiceLines::V2::DrugIdentification]
+          @drug_identification = drug_identification
+          # @type [Commons::FacilityTypeCode]
+          @place_of_service_code = place_of_service_code
+          # @type [String] A free-form description to clarify the related data elements and their content. Maps to SV1-01, C003-07 on the 837-P.
+          @description = description
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of ServiceLineCreate
+        #
+        # @param json_object [JSON]
+        # @return [ServiceLines::V2::ServiceLineCreate]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          modifiers = struct.modifiers
+          procedure_code = struct.procedure_code
+          quantity = struct.quantity
+          units = struct.units
+          charge_amount_cents = struct.charge_amount_cents
+          diagnosis_pointers = struct.diagnosis_pointers
+          if parsed_json["drug_identification"].nil?
+            drug_identification = nil
+          else
+            drug_identification = parsed_json["drug_identification"].to_json
+            drug_identification = ServiceLines::V2::DrugIdentification.from_json(json_object: drug_identification)
+          end
+          place_of_service_code = struct.place_of_service_code
+          description = struct.description
+          new(modifiers: modifiers, procedure_code: procedure_code, quantity: quantity, units: units,
+              charge_amount_cents: charge_amount_cents, diagnosis_pointers: diagnosis_pointers, drug_identification: drug_identification, place_of_service_code: place_of_service_code, description: description, additional_properties: struct)
+        end
+
+        # Serialize an instance of ServiceLineCreate to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "modifiers": @modifiers,
+            "procedure_code": @procedure_code,
+            "quantity": @quantity,
+            "units": @units,
+            "charge_amount_cents": @charge_amount_cents,
+            "diagnosis_pointers": @diagnosis_pointers,
+            "drug_identification": @drug_identification,
+            "place_of_service_code": @place_of_service_code,
+            "description": @description
+          }.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.modifiers&.is_a?(Array) != false || raise("Passed value for field obj.modifiers is not the expected type, validation failed.")
+          obj.procedure_code.is_a?(String) != false || raise("Passed value for field obj.procedure_code is not the expected type, validation failed.")
+          obj.quantity.is_a?(String) != false || raise("Passed value for field obj.quantity is not the expected type, validation failed.")
+          obj.units.is_a?(Commons::ServiceLineUnits) != false || raise("Passed value for field obj.units is not the expected type, validation failed.")
+          obj.charge_amount_cents&.is_a?(Integer) != false || raise("Passed value for field obj.charge_amount_cents is not the expected type, validation failed.")
+          obj.diagnosis_pointers.is_a?(Array) != false || raise("Passed value for field obj.diagnosis_pointers is not the expected type, validation failed.")
+          obj.drug_identification.nil? || ServiceLines::V2::DrugIdentification.validate_raw(obj: obj.drug_identification)
+          obj.place_of_service_code&.is_a?(Commons::FacilityTypeCode) != false || raise("Passed value for field obj.place_of_service_code is not the expected type, validation failed.")
+          obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/service_lines/v_2/types/service_line_denial_reason.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "denial_reason_content"
+require "json"
+
+module CandidApiClient
+  module ServiceLines
+    module V2
+      # The reason a given service line was denied within a given time range.
+      # A service line may be denied for different reasons over time, but only one reason at a time.
+      class ServiceLineDenialReason
+        attr_reader :reason, :additional_properties
+
+        # @param reason [ServiceLines::V2::DenialReasonContent] Text of the denial reason
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [ServiceLines::V2::ServiceLineDenialReason]
+        def initialize(reason: nil, additional_properties: nil)
+          # @type [ServiceLines::V2::DenialReasonContent] Text of the denial reason
+          @reason = reason
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of ServiceLineDenialReason
+        #
+        # @param json_object [JSON]
+        # @return [ServiceLines::V2::ServiceLineDenialReason]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          JSON.parse(json_object)
+          reason = struct.reason
+          new(reason: reason, additional_properties: struct)
+        end
+
+        # Serialize an instance of ServiceLineDenialReason to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          { "reason": @reason }.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.reason&.is_a?(ServiceLines::V2::DenialReasonContent) != false || raise("Passed value for field obj.reason is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/service_lines/v_2/types/service_line_era_data.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require_relative "service_line_adjustment"
+require "json"
+
+module CandidApiClient
+  module ServiceLines
+    module V2
+      class ServiceLineEraData
+        attr_reader :service_line_adjustments, :remittance_advice_remark_codes, :additional_properties
+
+        # @param service_line_adjustments [Array<ServiceLines::V2::ServiceLineAdjustment>]
+        # @param remittance_advice_remark_codes [Array<String>]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [ServiceLines::V2::ServiceLineEraData]
+        def initialize(service_line_adjustments:, remittance_advice_remark_codes:, additional_properties: nil)
+          # @type [Array<ServiceLines::V2::ServiceLineAdjustment>]
+          @service_line_adjustments = service_line_adjustments
+          # @type [Array<String>]
+          @remittance_advice_remark_codes = remittance_advice_remark_codes
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of ServiceLineEraData
+        #
+        # @param json_object [JSON]
+        # @return [ServiceLines::V2::ServiceLineEraData]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          service_line_adjustments = parsed_json["service_line_adjustments"]&.map do |v|
+            v = v.to_json
+            ServiceLines::V2::ServiceLineAdjustment.from_json(json_object: v)
+          end
+          remittance_advice_remark_codes = struct.remittance_advice_remark_codes
+          new(service_line_adjustments: service_line_adjustments,
+              remittance_advice_remark_codes: remittance_advice_remark_codes, additional_properties: struct)
+        end
+
+        # Serialize an instance of ServiceLineEraData to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          {
+            "service_line_adjustments": @service_line_adjustments,
+            "remittance_advice_remark_codes": @remittance_advice_remark_codes
+          }.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.service_line_adjustments.is_a?(Array) != false || raise("Passed value for field obj.service_line_adjustments is not the expected type, validation failed.")
+          obj.remittance_advice_remark_codes.is_a?(Array) != false || raise("Passed value for field obj.remittance_advice_remark_codes is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/tags/types/tag.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "tag_id"
+require_relative "tag_color_enum"
+require "json"
+
+module CandidApiClient
+  class Tags
+    class Tag
+      attr_reader :creator_id, :tag_id, :description, :color, :additional_properties
+
+      # @param creator_id [String]
+      # @param tag_id [Tags::TAG_ID]
+      # @param description [String]
+      # @param color [Tags::TagColorEnum]
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Tags::Tag]
+      def initialize(creator_id:, tag_id:, description:, color:, additional_properties: nil)
+        # @type [String]
+        @creator_id = creator_id
+        # @type [Tags::TAG_ID]
+        @tag_id = tag_id
+        # @type [String]
+        @description = description
+        # @type [Tags::TagColorEnum]
+        @color = color
+        # @type [OpenStruct] Additional properties unmapped to the current class definition
+        @additional_properties = additional_properties
+      end
+
+      # Deserialize a JSON object to an instance of Tag
+      #
+      # @param json_object [JSON]
+      # @return [Tags::Tag]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        JSON.parse(json_object)
+        creator_id = struct.creator_id
+        tag_id = struct.tag_id
+        description = struct.description
+        color = struct.color
+        new(creator_id: creator_id, tag_id: tag_id, description: description, color: color,
+            additional_properties: struct)
+      end
+
+      # Serialize an instance of Tag to a JSON object
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        { "creator_id": @creator_id, "tag_id": @tag_id, "description": @description, "color": @color }.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.creator_id.is_a?(String) != false || raise("Passed value for field obj.creator_id is not the expected type, validation failed.")
+        obj.tag_id.is_a?(String) != false || raise("Passed value for field obj.tag_id is not the expected type, validation failed.")
+        obj.description.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+        obj.color.is_a?(Tags::TagColorEnum) != false || raise("Passed value for field obj.color is not the expected type, validation failed.")
+      end
+    end
+  end
+end

data/lib/candidhealth/tags/types/tag_color_enum.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  class Tags
+    class TagColorEnum
+      BLACK = "black"
+      WHITE = "white"
+      GRAY = "gray"
+      RED = "red"
+      YELLOW = "yellow"
+      GREEN = "green"
+      BLUE = "blue"
+      INDIGO = "indigo"
+      PURPLE = "purple"
+      PINK = "pink"
+    end
+  end
+end

data/lib/candidhealth/tags/types/tag_create.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative "tag_id"
+require_relative "tag_color_enum"
+require "json"
+
+module CandidApiClient
+  class Tags
+    class TagCreate
+      attr_reader :tag_id, :description, :color, :additional_properties
+
+      # @param tag_id [Tags::TAG_ID]
+      # @param description [String]
+      # @param color [Tags::TagColorEnum]
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Tags::TagCreate]
+      def initialize(tag_id:, description:, color:, additional_properties: nil)
+        # @type [Tags::TAG_ID]
+        @tag_id = tag_id
+        # @type [String]
+        @description = description
+        # @type [Tags::TagColorEnum]
+        @color = color
+        # @type [OpenStruct] Additional properties unmapped to the current class definition
+        @additional_properties = additional_properties
+      end
+
+      # Deserialize a JSON object to an instance of TagCreate
+      #
+      # @param json_object [JSON]
+      # @return [Tags::TagCreate]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        JSON.parse(json_object)
+        tag_id = struct.tag_id
+        description = struct.description
+        color = struct.color
+        new(tag_id: tag_id, description: description, color: color, additional_properties: struct)
+      end
+
+      # Serialize an instance of TagCreate to a JSON object
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        { "tag_id": @tag_id, "description": @description, "color": @color }.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.tag_id.is_a?(String) != false || raise("Passed value for field obj.tag_id is not the expected type, validation failed.")
+        obj.description.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+        obj.color.is_a?(Tags::TagColorEnum) != false || raise("Passed value for field obj.color is not the expected type, validation failed.")
+      end
+    end
+  end
+end

data/lib/candidhealth/tags/types/tag_id.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  class Tags
+    TAG_ID = String
+  end
+end

data/lib/candidhealth/tasks/client.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "v_3/client"
+
+module CandidApiClient
+  module Tasks
+    class Client
+      attr_reader :v_3
+
+      # @param request_client [RequestClient]
+      # @return [Tasks::Client]
+      def initialize(request_client:)
+        @v_3 = Tasks::V3::V3Client.new(request_client: request_client)
+      end
+    end
+
+    class AsyncClient
+      attr_reader :v_3
+
+      # @param request_client [RequestClient]
+      # @return [Tasks::AsyncClient]
+      def initialize(request_client:)
+        @v_3 = Tasks::V3::AsyncV3Client.new(request_client: request_client)
+      end
+    end
+  end
+end

data/lib/candidhealth/tasks/commons/types/task_category.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Tasks
+    class Commons
+      class TaskCategory
+        OTHER = "other"
+        PROVIDER_CREDENTIALING = "provider_credentialing"
+        AUTHORIZATION_REQUIRED = "authorization_required"
+        INACTIVE_COVERAGE = "inactive_coverage"
+        UNKNOWN_ELIGIBILITY_OR_PATIENT_NOT_FOUND = "unknown_eligibility_or_patient_not_found"
+        INCORRECT_MEMBER_ID = "incorrect_member_id"
+        DOCUMENTATION_ADDENDUM_REQUEST = "documentation_addendum_request"
+        COORDINATION_OF_BENEFITS = "coordination_of_benefits"
+        MISSING_OR_INCORRECT_GENDER = "missing_or_incorrect_gender"
+        INCORRECT_DATE_OF_BIRTH = "incorrect_date_of_birth"
+        INCORRECT_PAYER = "incorrect_payer"
+        INCORRECT_NAME = "incorrect_name"
+        INVALID_DIAGNOSIS_CODE = "invalid_diagnosis_code"
+        NON_COVERED_DIAGNOSIS_CODES = "non_covered_diagnosis_codes"
+        INFORMATION_REQUESTED_FROM_PATIENT = "information_requested_from_patient"
+        INCORRECT_RENDERING_PROVIDER_INFO = "incorrect_rendering_provider_info"
+        MISSING_OR_INCORRECT_MODIFIER = "missing_or_incorrect_modifier"
+        CODING_FREQUENCY_ERROR = "coding_frequency_error"
+        INCORRECT_PATIENT_ADDRESS = "incorrect_patient_address"
+        MULTIPLE_EM_CLAIMS = "multiple_em_claims"
+        MISSING_OR_INCORRECT_CHARGE_AMOUNT = "missing_or_incorrect_charge_amount"
+        MEDICAL_RECORDS_REQUEST = "medical_records_request"
+        PROVIDER_ENROLLMENT_OR_CONTRACTING = "provider_enrollment_or_contracting"
+        MISSING_OR_INCORRECT_GROUP_NUMBER = "missing_or_incorrect_group_number"
+        MISSING_DIAGNOSIS_CODES = "missing_diagnosis_codes"
+        MISSING_PATIENT_AUTHORIZATION = "missing_patient_authorization"
+        INCORRECT_BILLING_PROVIDER_INFO = "incorrect_billing_provider_info"
+        INCORRECT_PROCEDURE_CODE = "incorrect_procedure_code"
+        INCORRECT_QUANTITY = "incorrect_quantity"
+        INCORRECT_PLACE_OF_SERVICE_CODE = "incorrect_place_of_service_code"
+        INCORRECT_SERVICE_FACILITY_INFO = "incorrect_service_facility_info"
+        INCORRECT_DATE_OF_SERVICE = "incorrect_date_of_service"
+        MISSING_OR_INCORRECT_NDC = "missing_or_incorrect_ndc"
+        PATIENT_COLLECTIONS = "patient_collections"
+        SUBMIT_TO_SECONDARY = "submit_to_secondary"
+        TRANSIENT_SERVER_ERROR = "transient_server_error"
+        MISSING_REMITTANCE_ENROLLMENT = "missing_remittance_enrollment"
+        MISSING_CLAIMS_ENROLLMENT = "missing_claims_enrollment"
+        HELD_BY_CUSTOMER = "held_by_customer"
+        PENDING_MANUAL_REMIT_POSTING = "pending_manual_remit_posting"
+      end
+    end
+  end
+end

data/lib/candidhealth/tasks/commons/types/task_status.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Tasks
+    class Commons
+      class TaskStatus
+        FINISHED = "finished"
+        ADDRESSED_BY_PROVIDER_GROUP = "addressed_by_provider_group"
+        SENT_TO_PROVIDER_GROUP = "sent_to_provider_group"
+        OPEN_TASK = "open"
+        BLOCKED = "blocked"
+        WAITING_FOR_REVIEW = "waiting_for_review"
+        IN_PROGRESS = "in_progress"
+      end
+    end
+  end
+end

data/lib/candidhealth/tasks/commons/types/task_type.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Tasks
+    class Commons
+      class TaskType
+        CUSTOMER_DATA_REQUEST = "CUSTOMER_DATA_REQUEST"
+        CLAIM_SUBMISSION_RUN_VALIDATIONS_FAILURE = "CLAIM_SUBMISSION_RUN_VALIDATIONS_FAILURE"
+        CLAIM_SUBMISSION_SUBMIT_CLAIM_FAILURE = "CLAIM_SUBMISSION_SUBMIT_CLAIM_FAILURE"
+        CLAIM_SUBMISSION_TRANSFORM_FAILURE = "CLAIM_SUBMISSION_TRANSFORM_FAILURE"
+        CODE_CLAIM = "CODE_CLAIM"
+        CODE_CLAIM_REVIEW = "CODE_CLAIM_REVIEW"
+        ELIGIBILITY = "ELIGIBILITY"
+        CLAIM_FOLLOW_UP = "CLAIM_FOLLOW_UP"
+        REJECTION_RESOLUTION = "REJECTION_RESOLUTION"
+        PAYER_CONFIGURATION_ERROR = "PAYER_CONFIGURATION_ERROR"
+        DENIAL_RESOLUTION = "DENIAL_RESOLUTION"
+        MISSING_ENROLLMENT = "MISSING_ENROLLMENT"
+      end
+    end
+  end
+end