candidhealth 0.17.1

data/lib/candidhealth/payers/v_3/types/payer.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require_relative "payer_uuid"
+require "json"
+
+module CandidApiClient
+  module Payers
+    module V3
+      class Payer
+        attr_reader :payer_uuid, :payer_id, :payer_name, :additional_properties
+
+        # @param payer_uuid [Payers::V3::PAYER_String] Auto-generated ID set on creation.
+        # @param payer_id [String] The primary national payer ID of the payer.
+        # @param payer_name [String] The primary display name of the payer.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Payers::V3::Payer]
+        def initialize(payer_uuid:, payer_id:, payer_name:, additional_properties: nil)
+          # @type [Payers::V3::PAYER_String] Auto-generated ID set on creation.
+          @payer_uuid = payer_uuid
+          # @type [String] The primary national payer ID of the payer.
+          @payer_id = payer_id
+          # @type [String] The primary display name of the payer.
+          @payer_name = payer_name
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of Payer
+        #
+        # @param json_object [JSON]
+        # @return [Payers::V3::Payer]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          JSON.parse(json_object)
+          payer_uuid = struct.payer_uuid
+          payer_id = struct.payer_id
+          payer_name = struct.payer_name
+          new(payer_uuid: payer_uuid, payer_id: payer_id, payer_name: payer_name, additional_properties: struct)
+        end
+
+        # Serialize an instance of Payer to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          { "payer_uuid": @payer_uuid, "payer_id": @payer_id, "payer_name": @payer_name }.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.payer_uuid.is_a?(String) != false || raise("Passed value for field obj.payer_uuid is not the expected type, validation failed.")
+          obj.payer_id.is_a?(String) != false || raise("Passed value for field obj.payer_id is not the expected type, validation failed.")
+          obj.payer_name.is_a?(String) != false || raise("Passed value for field obj.payer_name is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/payers/v_3/types/payer_id.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Payers
+    module V3
+      PAYER_ID = String
+    end
+  end
+end

data/lib/candidhealth/payers/v_3/types/payer_identifier.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "payer_info"
+require_relative "payer_uuid"
+
+module CandidApiClient
+  module Payers
+    module V3
+      class PayerIdentifier
+        attr_reader :member, :discriminant
+
+        private_class_method :new
+        alias kind_of? is_a?
+        # @param member [Object]
+        # @param discriminant [String]
+        # @return [Payers::V3::PayerIdentifier]
+        def initialize(member:, discriminant:)
+          # @type [Object]
+          @member = member
+          # @type [String]
+          @discriminant = discriminant
+        end
+
+        # Deserialize a JSON object to an instance of PayerIdentifier
+        #
+        # @param json_object [JSON]
+        # @return [Payers::V3::PayerIdentifier]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          member = case struct.type
+                   when "payer_info"
+                     Payers::V3::PayerInfo.from_json(json_object: json_object)
+                   when "payer_uuid"
+                     json_object.value
+                   else
+                     Payers::V3::PayerInfo.from_json(json_object: 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 "payer_info"
+            { **@member.to_json, type: @discriminant }.to_json
+          when "payer_uuid"
+            { "type": @discriminant, "value": @member }.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 "payer_info"
+            Payers::V3::PayerInfo.validate_raw(obj: obj)
+          when "payer_uuid"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          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 [Payers::V3::PayerInfo]
+        # @return [Payers::V3::PayerIdentifier]
+        def self.payer_info(member:)
+          new(member: member, discriminant: "payer_info")
+        end
+
+        # @param member [Payers::V3::PAYER_String]
+        # @return [Payers::V3::PayerIdentifier]
+        def self.payer_uuid(member:)
+          new(member: member, discriminant: "payer_uuid")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/payers/v_3/types/payer_info.rb

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

data/lib/candidhealth/payers/v_3/types/payer_name.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Payers
+    module V3
+      PAYER_NAME = String
+    end
+  end
+end

data/lib/candidhealth/payers/v_3/types/payer_page.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "payer"
+require_relative "../../../commons/types/page_token"
+require "json"
+
+module CandidApiClient
+  module Payers
+    module V3
+      class PayerPage
+        attr_reader :items, :prev_page_token, :next_page_token, :additional_properties
+
+        # @param items [Array<Payers::V3::Payer>]
+        # @param prev_page_token [Commons::PAGE_TOKEN]
+        # @param next_page_token [Commons::PAGE_TOKEN]
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Payers::V3::PayerPage]
+        def initialize(items:, prev_page_token: nil, next_page_token: nil, additional_properties: nil)
+          # @type [Array<Payers::V3::Payer>]
+          @items = items
+          # @type [Commons::PAGE_TOKEN]
+          @prev_page_token = prev_page_token
+          # @type [Commons::PAGE_TOKEN]
+          @next_page_token = next_page_token
+          # @type [OpenStruct] Additional properties unmapped to the current class definition
+          @additional_properties = additional_properties
+        end
+
+        # Deserialize a JSON object to an instance of PayerPage
+        #
+        # @param json_object [JSON]
+        # @return [Payers::V3::PayerPage]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          items = parsed_json["items"]&.map do |v|
+            v = v.to_json
+            Payers::V3::Payer.from_json(json_object: v)
+          end
+          prev_page_token = struct.prev_page_token
+          next_page_token = struct.next_page_token
+          new(items: items, prev_page_token: prev_page_token, next_page_token: next_page_token,
+              additional_properties: struct)
+        end
+
+        # Serialize an instance of PayerPage to a JSON object
+        #
+        # @return [JSON]
+        def to_json(*_args)
+          { "items": @items, "prev_page_token": @prev_page_token, "next_page_token": @next_page_token }.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.items.is_a?(Array) != false || raise("Passed value for field obj.items is not the expected type, validation failed.")
+          obj.prev_page_token&.is_a?(String) != false || raise("Passed value for field obj.prev_page_token is not the expected type, validation failed.")
+          obj.next_page_token&.is_a?(String) != false || raise("Passed value for field obj.next_page_token is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/payers/v_3/types/payer_uuid.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CandidApiClient
+  module Payers
+    module V3
+      PAYER_String = String
+    end
+  end
+end

data/lib/candidhealth/remits/v_1/types/payee.rb

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

data/lib/candidhealth/remits/v_1/types/payee_identifier.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "../../../commons/types/npi"
+require_relative "../../../commons/types/tax_id"
+
+module CandidApiClient
+  module Remits
+    module V1
+      class PayeeIdentifier
+        attr_reader :member, :discriminant
+
+        private_class_method :new
+        alias kind_of? is_a?
+        # @param member [Object]
+        # @param discriminant [String]
+        # @return [Remits::V1::PayeeIdentifier]
+        def initialize(member:, discriminant:)
+          # @type [Object]
+          @member = member
+          # @type [String]
+          @discriminant = discriminant
+        end
+
+        # Deserialize a JSON object to an instance of PayeeIdentifier
+        #
+        # @param json_object [JSON]
+        # @return [Remits::V1::PayeeIdentifier]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          member = case struct.type
+                   when "npi"
+                     json_object.value
+                   when "tin"
+                     json_object.value
+                   when "cms_plan_id"
+                     json_object.value
+                   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 "npi"
+          when "tin"
+          when "cms_plan_id"
+          end
+          { "type": @discriminant, "value": @member }.to_json
+          @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 "npi"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          when "tin"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          when "cms_plan_id"
+            obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+          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::NPI]
+        # @return [Remits::V1::PayeeIdentifier]
+        def self.npi(member:)
+          new(member: member, discriminant: "npi")
+        end
+
+        # @param member [Commons::TAX_ID]
+        # @return [Remits::V1::PayeeIdentifier]
+        def self.tin(member:)
+          new(member: member, discriminant: "tin")
+        end
+
+        # @param member [String]
+        # @return [Remits::V1::PayeeIdentifier]
+        def self.cms_plan_id(member:)
+          new(member: member, discriminant: "cms_plan_id")
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/service_facility/client.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "types/service_facility_id"
+require_relative "../commons/types/street_address_long_zip"
+require_relative "types/encounter_service_facility"
+require "async"
+
+module CandidApiClient
+  class ServiceFacilityClient
+    attr_reader :request_client
+
+    # @param request_client [RequestClient]
+    # @return [ServiceFacilityClient]
+    def initialize(request_client:)
+      # @type [RequestClient]
+      @request_client = request_client
+    end
+
+    # @param service_facility_id [ServiceFacility::SERVICE_FACILITY_ID]
+    # @param organization_name [String]
+    # @param npi [String] An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI.
+    #   Box 32 section (a) of the CMS-1500 claim form.
+    # @param address [Hash] zip_plus_four_code is required for service facility address. When the zip_plus_four_code is not available use "9998" as per CMS documentation.Request of type Commons::StreetAddressLongZip, as a 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 [ServiceFacility::EncounterServiceFacility]
+    def update(service_facility_id:, organization_name: nil, npi: nil, address: nil, request_options: nil)
+      response = @request_client.conn.patch("/api/service_facility/v2/#{service_facility_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 || {}),
+          organization_name: organization_name,
+          npi: npi,
+          address: address
+        }.compact
+      end
+      ServiceFacility::EncounterServiceFacility.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncServiceFacilityClient
+    attr_reader :request_client
+
+    # @param request_client [AsyncRequestClient]
+    # @return [AsyncServiceFacilityClient]
+    def initialize(request_client:)
+      # @type [AsyncRequestClient]
+      @request_client = request_client
+    end
+
+    # @param service_facility_id [ServiceFacility::SERVICE_FACILITY_ID]
+    # @param organization_name [String]
+    # @param npi [String] An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI.
+    #   Box 32 section (a) of the CMS-1500 claim form.
+    # @param address [Hash] zip_plus_four_code is required for service facility address. When the zip_plus_four_code is not available use "9998" as per CMS documentation.Request of type Commons::StreetAddressLongZip, as a 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 [ServiceFacility::EncounterServiceFacility]
+    def update(service_facility_id:, organization_name: nil, npi: nil, address: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.patch("/api/service_facility/v2/#{service_facility_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 || {}),
+            organization_name: organization_name,
+            npi: npi,
+            address: address
+          }.compact
+        end
+        ServiceFacility::EncounterServiceFacility.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/candidhealth/service_facility/types/encounter_service_facility.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative "service_facility_id"
+require_relative "../../commons/types/street_address_long_zip"
+require "json"
+
+module CandidApiClient
+  class ServiceFacility
+    class EncounterServiceFacility
+      attr_reader :service_facility_id, :organization_name, :npi, :address, :additional_properties
+
+      # @param service_facility_id [ServiceFacility::SERVICE_FACILITY_ID]
+      # @param organization_name [String]
+      # @param npi [String] An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI.
+      #   Box 32 section (a) of the CMS-1500 claim form.
+      # @param address [Commons::StreetAddressLongZip] zip_plus_four_code is required for service facility address. When the zip_plus_four_code is not available use "9998" as per CMS documentation.
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [ServiceFacility::EncounterServiceFacility]
+      def initialize(service_facility_id:, organization_name:, address:, npi: nil, additional_properties: nil)
+        # @type [ServiceFacility::SERVICE_FACILITY_ID]
+        @service_facility_id = service_facility_id
+        # @type [String]
+        @organization_name = organization_name
+        # @type [String] An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI.
+        #   Box 32 section (a) of the CMS-1500 claim form.
+        @npi = npi
+        # @type [Commons::StreetAddressLongZip] zip_plus_four_code is required for service facility address. When the zip_plus_four_code is not available use "9998" as per CMS documentation.
+        @address = address
+        # @type [OpenStruct] Additional properties unmapped to the current class definition
+        @additional_properties = additional_properties
+      end
+
+      # Deserialize a JSON object to an instance of EncounterServiceFacility
+      #
+      # @param json_object [JSON]
+      # @return [ServiceFacility::EncounterServiceFacility]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        parsed_json = JSON.parse(json_object)
+        service_facility_id = struct.service_facility_id
+        organization_name = struct.organization_name
+        npi = struct.npi
+        if parsed_json["address"].nil?
+          address = nil
+        else
+          address = parsed_json["address"].to_json
+          address = Commons::StreetAddressLongZip.from_json(json_object: address)
+        end
+        new(service_facility_id: service_facility_id, organization_name: organization_name, npi: npi, address: address,
+            additional_properties: struct)
+      end
+
+      # Serialize an instance of EncounterServiceFacility to a JSON object
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        {
+          "service_facility_id": @service_facility_id,
+          "organization_name": @organization_name,
+          "npi": @npi,
+          "address": @address
+        }.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_facility_id.is_a?(String) != false || raise("Passed value for field obj.service_facility_id is not the expected type, validation failed.")
+        obj.organization_name.is_a?(String) != false || raise("Passed value for field obj.organization_name is not the expected type, validation failed.")
+        obj.npi&.is_a?(String) != false || raise("Passed value for field obj.npi is not the expected type, validation failed.")
+        Commons::StreetAddressLongZip.validate_raw(obj: obj.address)
+      end
+    end
+  end
+end