candidhealth 0.17.1

data/lib/candidhealth/financials/types/invoice_update.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "../../commons/types/invoice_id"
+
+module CandidApiClient
+  class Financials
+    class InvoiceUpdate
+      attr_reader :member, :discriminant
+
+      private_class_method :new
+      alias kind_of? is_a?
+      # @param member [Object]
+      # @param discriminant [String]
+      # @return [Financials::InvoiceUpdate]
+      def initialize(member:, discriminant:)
+        # @type [Object]
+        @member = member
+        # @type [String]
+        @discriminant = discriminant
+      end
+
+      # Deserialize a JSON object to an instance of InvoiceUpdate
+      #
+      # @param json_object [JSON]
+      # @return [Financials::InvoiceUpdate]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        member = case struct.type
+                 when "set"
+                   json_object.value
+                 when "remove"
+                   nil
+                 else
+                   json_object
+                 end
+        new(member: member, discriminant: struct.type)
+      end
+
+      # For Union Types, to_json functionality is delegated to the wrapped member.
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        case @discriminant
+        when "set"
+          { "type": @discriminant, "value": @member }.to_json
+        when "remove"
+          { type: @discriminant }.to_json
+        else
+          { "type": @discriminant, value: @member }.to_json
+        end
+        @member.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:)
+        case obj.type
+        when "set"
+          obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+        when "remove"
+          # noop
+        else
+          raise("Passed value matched no type within the union, validation failed.")
+        end
+      end
+
+      # For Union Types, is_a? functionality is delegated to the wrapped member.
+      #
+      # @param obj [Object]
+      # @return [Boolean]
+      def is_a?(obj)
+        @member.is_a?(obj)
+      end
+
+      # @param member [Commons::INVOICE_ID]
+      # @return [Financials::InvoiceUpdate]
+      def self.set(member:)
+        new(member: member, discriminant: "set")
+      end
+
+      # @return [Financials::InvoiceUpdate]
+      def self.remove
+        new(member: nil, discriminant: "remove")
+      end
+    end
+  end
+end

data/lib/candidhealth/financials/types/note_update.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "json"
+
+module CandidApiClient
+  class Financials
+    class NoteUpdate
+      attr_reader :member, :discriminant
+
+      private_class_method :new
+      alias kind_of? is_a?
+      # @param member [Object]
+      # @param discriminant [String]
+      # @return [Financials::NoteUpdate]
+      def initialize(member:, discriminant:)
+        # @type [Object]
+        @member = member
+        # @type [String]
+        @discriminant = discriminant
+      end
+
+      # Deserialize a JSON object to an instance of NoteUpdate
+      #
+      # @param json_object [JSON]
+      # @return [Financials::NoteUpdate]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        member = case struct.type
+                 when "set"
+                   json_object.value
+                 when "remove"
+                   nil
+                 else
+                   json_object
+                 end
+        new(member: member, discriminant: struct.type)
+      end
+
+      # For Union Types, to_json functionality is delegated to the wrapped member.
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        case @discriminant
+        when "set"
+          { "type": @discriminant, "value": @member }.to_json
+        when "remove"
+          { type: @discriminant }.to_json
+        else
+          { "type": @discriminant, value: @member }.to_json
+        end
+        @member.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:)
+        case obj.type
+        when "set"
+          obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+        when "remove"
+          # noop
+        else
+          raise("Passed value matched no type within the union, validation failed.")
+        end
+      end
+
+      # For Union Types, is_a? functionality is delegated to the wrapped member.
+      #
+      # @param obj [Object]
+      # @return [Boolean]
+      def is_a?(obj)
+        @member.is_a?(obj)
+      end
+
+      # @param member [String]
+      # @return [Financials::NoteUpdate]
+      def self.set(member:)
+        new(member: member, discriminant: "set")
+      end
+
+      # @return [Financials::NoteUpdate]
+      def self.remove
+        new(member: nil, discriminant: "remove")
+      end
+    end
+  end
+end

data/lib/candidhealth/financials/types/patient_transaction_source.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  class Financials
+    class PatientTransactionSource
+      MANUAL_ENTRY = "MANUAL_ENTRY"
+      CHARGEBEE = "CHARGEBEE"
+      SQUARE = "SQUARE"
+      STRIPE = "STRIPE"
+      ELATION = "ELATION"
+      CEDAR = "CEDAR"
+      HEALTHIE = "HEALTHIE"
+    end
+  end
+end

data/lib/candidhealth/financials/types/refund_reason.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  class Financials
+    class RefundReason
+      OVERCHARGED = "OVERCHARGED"
+    end
+  end
+end

data/lib/candidhealth/financials/types/refund_reason_update.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "refund_reason"
+
+module CandidApiClient
+  class Financials
+    class RefundReasonUpdate
+      attr_reader :member, :discriminant
+
+      private_class_method :new
+      alias kind_of? is_a?
+      # @param member [Object]
+      # @param discriminant [String]
+      # @return [Financials::RefundReasonUpdate]
+      def initialize(member:, discriminant:)
+        # @type [Object]
+        @member = member
+        # @type [String]
+        @discriminant = discriminant
+      end
+
+      # Deserialize a JSON object to an instance of RefundReasonUpdate
+      #
+      # @param json_object [JSON]
+      # @return [Financials::RefundReasonUpdate]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        member = case struct.type
+                 when "set"
+                   json_object.value
+                 when "remove"
+                   nil
+                 else
+                   json_object
+                 end
+        new(member: member, discriminant: struct.type)
+      end
+
+      # For Union Types, to_json functionality is delegated to the wrapped member.
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        case @discriminant
+        when "set"
+          { "type": @discriminant, "value": @member }.to_json
+        when "remove"
+          { type: @discriminant }.to_json
+        else
+          { "type": @discriminant, value: @member }.to_json
+        end
+        @member.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:)
+        case obj.type
+        when "set"
+          obj.is_a?(Financials::RefundReason) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+        when "remove"
+          # noop
+        else
+          raise("Passed value matched no type within the union, validation failed.")
+        end
+      end
+
+      # For Union Types, is_a? functionality is delegated to the wrapped member.
+      #
+      # @param obj [Object]
+      # @return [Boolean]
+      def is_a?(obj)
+        @member.is_a?(obj)
+      end
+
+      # @param member [Financials::RefundReason]
+      # @return [Financials::RefundReasonUpdate]
+      def self.set(member:)
+        new(member: member, discriminant: "set")
+      end
+
+      # @return [Financials::RefundReasonUpdate]
+      def self.remove
+        new(member: nil, discriminant: "remove")
+      end
+    end
+  end
+end

data/lib/candidhealth/financials/types/service_line_allocation_target.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative "../../commons/types/service_line_id"
+require_relative "../../commons/types/claim_id"
+require_relative "../../commons/types/encounter_id"
+require "json"
+
+module CandidApiClient
+  class Financials
+    class ServiceLineAllocationTarget
+      attr_reader :service_line_id, :claim_id, :encounter_id, :additional_properties
+
+      # @param service_line_id [Commons::SERVICE_LINE_ID]
+      # @param claim_id [Commons::CLAIM_ID]
+      # @param encounter_id [Commons::ENCOUNTER_ID]
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Financials::ServiceLineAllocationTarget]
+      def initialize(service_line_id:, claim_id:, encounter_id:, additional_properties: nil)
+        # @type [Commons::SERVICE_LINE_ID]
+        @service_line_id = service_line_id
+        # @type [Commons::CLAIM_ID]
+        @claim_id = claim_id
+        # @type [Commons::ENCOUNTER_ID]
+        @encounter_id = encounter_id
+        # @type [OpenStruct] Additional properties unmapped to the current class definition
+        @additional_properties = additional_properties
+      end
+
+      # Deserialize a JSON object to an instance of ServiceLineAllocationTarget
+      #
+      # @param json_object [JSON]
+      # @return [Financials::ServiceLineAllocationTarget]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        JSON.parse(json_object)
+        service_line_id = struct.service_line_id
+        claim_id = struct.claim_id
+        encounter_id = struct.encounter_id
+        new(service_line_id: service_line_id, claim_id: claim_id, encounter_id: encounter_id,
+            additional_properties: struct)
+      end
+
+      # Serialize an instance of ServiceLineAllocationTarget to a JSON object
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        { "service_line_id": @service_line_id, "claim_id": @claim_id, "encounter_id": @encounter_id }.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_id.is_a?(String) != false || raise("Passed value for field obj.service_line_id is not the expected type, validation failed.")
+        obj.claim_id.is_a?(String) != false || raise("Passed value for field obj.claim_id is not the expected type, validation failed.")
+        obj.encounter_id.is_a?(String) != false || raise("Passed value for field obj.encounter_id is not the expected type, validation failed.")
+      end
+    end
+  end
+end

data/lib/candidhealth/guarantor/client.rb

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

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

@@ -0,0 +1,224 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require_relative "../../commons/types/encounter_id"
+require_relative "types/guarantor_create"
+require_relative "types/guarantor"
+require_relative "types/guarantor_id"
+require "date"
+require_relative "../../commons/types/street_address_short_zip"
+require_relative "../../commons/types/phone_number"
+require_relative "../../commons/types/email"
+require "async"
+
+module CandidApiClient
+  module Guarantor
+    module V1
+      class V1Client
+        attr_reader :request_client
+
+        # @param request_client [RequestClient]
+        # @return [Guarantor::V1::V1Client]
+        def initialize(request_client:)
+          # @type [RequestClient]
+          @request_client = request_client
+        end
+
+        # Creates a new guarantor and returns the newly created Guarantor object.
+        #
+        # @param encounter_id [Commons::ENCOUNTER_ID]
+        # @param request [Hash] Request of type Guarantor::V1::GuarantorCreate, as a Hash
+        #   * :phone_numbers (Array<Commons::PhoneNumber>)
+        #   * :phone_consent (Boolean)
+        #   * :email (Commons::EMAIL)
+        #   * :email_consent (Boolean)
+        #   * :first_name (String)
+        #   * :last_name (String)
+        #   * :external_id (String)
+        #   * :date_of_birth (Date)
+        #   * :address (Hash)
+        #     * :zip_plus_four_code (String)
+        #     * :address_1 (String)
+        #     * :address_2 (String)
+        #     * :city (String)
+        #     * :state (Commons::State)
+        #     * :zip_code (String)
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def create(encounter_id:, request:, request_options: nil)
+          response = @request_client.conn.post("/api/guarantors/v1/#{encounter_id}") 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_options&.additional_headers || {}) }.compact
+            req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          Guarantor::V1::Guarantor.from_json(json_object: response.body)
+        end
+
+        # Retrieves a guarantor by its `guarantor_id`.
+        #
+        # @param guarantor_id [Guarantor::V1::GUARANTOR_ID]
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def get(guarantor_id:, request_options: nil)
+          response = @request_client.conn.get("/api/guarantors/v1/#{guarantor_id}") 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_options&.additional_headers || {}) }.compact
+          end
+          Guarantor::V1::Guarantor.from_json(json_object: response.body)
+        end
+
+        # Updates a guarantor by its `guarantor_id`.
+        #
+        # @param guarantor_id [Guarantor::V1::GUARANTOR_ID]
+        # @param first_name [String]
+        # @param last_name [String]
+        # @param external_id [String] A unique identifier for the guarantor assigned by an external system.
+        # @param date_of_birth [Date] Date formatted as YYYY-MM-DD; eg: 2019-08-25.
+        # @param address [Hash] Request of type Commons::StreetAddressShortZip, as a Hash
+        #   * :zip_plus_four_code (String)
+        #   * :address_1 (String)
+        #   * :address_2 (String)
+        #   * :city (String)
+        #   * :state (Commons::State)
+        #   * :zip_code (String)
+        # @param phone_numbers [Array<Hash>] Request of type Array<Commons::PhoneNumber>, as a Hash
+        #   * :number (String)
+        #   * :type (Commons::PhoneNumberType)
+        # @param phone_consent [Boolean]
+        # @param email [Commons::EMAIL]
+        # @param email_consent [Boolean]
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def update(guarantor_id:, first_name: nil, last_name: nil, external_id: nil, date_of_birth: nil, address: nil,
+                   phone_numbers: nil, phone_consent: nil, email: nil, email_consent: nil, request_options: nil)
+          response = @request_client.conn.patch("/api/guarantors/v1/#{guarantor_id}") 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_options&.additional_headers || {}) }.compact
+            req.body = {
+              **(request_options&.additional_body_parameters || {}),
+              first_name: first_name,
+              last_name: last_name,
+              external_id: external_id,
+              date_of_birth: date_of_birth,
+              address: address,
+              phone_numbers: phone_numbers,
+              phone_consent: phone_consent,
+              email: email,
+              email_consent: email_consent
+            }.compact
+          end
+          Guarantor::V1::Guarantor.from_json(json_object: response.body)
+        end
+      end
+
+      class AsyncV1Client
+        attr_reader :request_client
+
+        # @param request_client [AsyncRequestClient]
+        # @return [Guarantor::V1::AsyncV1Client]
+        def initialize(request_client:)
+          # @type [AsyncRequestClient]
+          @request_client = request_client
+        end
+
+        # Creates a new guarantor and returns the newly created Guarantor object.
+        #
+        # @param encounter_id [Commons::ENCOUNTER_ID]
+        # @param request [Hash] Request of type Guarantor::V1::GuarantorCreate, as a Hash
+        #   * :phone_numbers (Array<Commons::PhoneNumber>)
+        #   * :phone_consent (Boolean)
+        #   * :email (Commons::EMAIL)
+        #   * :email_consent (Boolean)
+        #   * :first_name (String)
+        #   * :last_name (String)
+        #   * :external_id (String)
+        #   * :date_of_birth (Date)
+        #   * :address (Hash)
+        #     * :zip_plus_four_code (String)
+        #     * :address_1 (String)
+        #     * :address_2 (String)
+        #     * :city (String)
+        #     * :state (Commons::State)
+        #     * :zip_code (String)
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def create(encounter_id:, request:, request_options: nil)
+          Async do
+            response = @request_client.conn.post("/api/guarantors/v1/#{encounter_id}") 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_options&.additional_headers || {}) }.compact
+              req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+            end
+            Guarantor::V1::Guarantor.from_json(json_object: response.body)
+          end
+        end
+
+        # Retrieves a guarantor by its `guarantor_id`.
+        #
+        # @param guarantor_id [Guarantor::V1::GUARANTOR_ID]
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def get(guarantor_id:, request_options: nil)
+          Async do
+            response = @request_client.conn.get("/api/guarantors/v1/#{guarantor_id}") 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_options&.additional_headers || {}) }.compact
+            end
+            Guarantor::V1::Guarantor.from_json(json_object: response.body)
+          end
+        end
+
+        # Updates a guarantor by its `guarantor_id`.
+        #
+        # @param guarantor_id [Guarantor::V1::GUARANTOR_ID]
+        # @param first_name [String]
+        # @param last_name [String]
+        # @param external_id [String] A unique identifier for the guarantor assigned by an external system.
+        # @param date_of_birth [Date] Date formatted as YYYY-MM-DD; eg: 2019-08-25.
+        # @param address [Hash] Request of type Commons::StreetAddressShortZip, as a Hash
+        #   * :zip_plus_four_code (String)
+        #   * :address_1 (String)
+        #   * :address_2 (String)
+        #   * :city (String)
+        #   * :state (Commons::State)
+        #   * :zip_code (String)
+        # @param phone_numbers [Array<Hash>] Request of type Array<Commons::PhoneNumber>, as a Hash
+        #   * :number (String)
+        #   * :type (Commons::PhoneNumberType)
+        # @param phone_consent [Boolean]
+        # @param email [Commons::EMAIL]
+        # @param email_consent [Boolean]
+        # @param request_options [RequestOptions]
+        # @return [Guarantor::V1::Guarantor]
+        def update(guarantor_id:, first_name: nil, last_name: nil, external_id: nil, date_of_birth: nil, address: nil,
+                   phone_numbers: nil, phone_consent: nil, email: nil, email_consent: nil, request_options: nil)
+          Async do
+            response = @request_client.conn.patch("/api/guarantors/v1/#{guarantor_id}") 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_options&.additional_headers || {}) }.compact
+              req.body = {
+                **(request_options&.additional_body_parameters || {}),
+                first_name: first_name,
+                last_name: last_name,
+                external_id: external_id,
+                date_of_birth: date_of_birth,
+                address: address,
+                phone_numbers: phone_numbers,
+                phone_consent: phone_consent,
+                email: email,
+                email_consent: email_consent
+              }.compact
+            end
+            Guarantor::V1::Guarantor.from_json(json_object: response.body)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/guarantor/v_1/types/encounter_has_existing_guarantor_error_type.rb

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