candidhealth 0.0.0

data/lib/candidhealth/pre_encounter/tags/v_1/types/tag_page.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative "tag"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module Tags
+      module V1
+        module Types
+          class TagPage
+            # @return [Array<CandidApiClient::PreEncounter::Tags::V1::Types::Tag>]
+            attr_reader :items
+            # @return [String]
+            attr_reader :next_page_token
+            # @return [String]
+            attr_reader :prev_page_token
+            # @return [Integer]
+            attr_reader :total
+            # @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 items [Array<CandidApiClient::PreEncounter::Tags::V1::Types::Tag>]
+            # @param next_page_token [String]
+            # @param prev_page_token [String]
+            # @param total [Integer]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::Tags::V1::Types::TagPage]
+            def initialize(items:, total:, next_page_token: OMIT, prev_page_token: OMIT, additional_properties: nil)
+              @items = items
+              @next_page_token = next_page_token if next_page_token != OMIT
+              @prev_page_token = prev_page_token if prev_page_token != OMIT
+              @total = total
+              @additional_properties = additional_properties
+              @_field_set = {
+                "items": items,
+                "next_page_token": next_page_token,
+                "prev_page_token": prev_page_token,
+                "total": total
+              }.reject do |_k, v|
+                v == OMIT
+              end
+            end
+
+            # Deserialize a JSON object to an instance of TagPage
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::Tags::V1::Types::TagPage]
+            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 |item|
+                item = item.to_json
+                CandidApiClient::PreEncounter::Tags::V1::Types::Tag.from_json(json_object: item)
+              end
+              next_page_token = struct["next_page_token"]
+              prev_page_token = struct["prev_page_token"]
+              total = struct["total"]
+              new(
+                items: items,
+                next_page_token: next_page_token,
+                prev_page_token: prev_page_token,
+                total: total,
+                additional_properties: struct
+              )
+            end
+
+            # Serialize an instance of TagPage 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.items.is_a?(Array) != false || raise("Passed value for field obj.items 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.")
+              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.total.is_a?(Integer) != false || raise("Passed value for field obj.total is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "json"
+
+module CandidApiClient
+  module Remits
+    module V1
+      module Types
+        class PayeeIdentifier
+          # @return [Object]
+          attr_reader :member
+          # @return [String]
+          attr_reader :discriminant
+
+          private_class_method :new
+          alias kind_of? is_a?
+
+          # @param member [Object]
+          # @param discriminant [String]
+          # @return [CandidApiClient::Remits::V1::Types::PayeeIdentifier]
+          def initialize(member:, discriminant:)
+            @member = member
+            @discriminant = discriminant
+          end
+
+          # Deserialize a JSON object to an instance of PayeeIdentifier
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::Remits::V1::Types::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 [String]
+          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 [String]
+          # @return [CandidApiClient::Remits::V1::Types::PayeeIdentifier]
+          def self.npi(member:)
+            new(member: member, discriminant: "npi")
+          end
+
+          # @param member [String]
+          # @return [CandidApiClient::Remits::V1::Types::PayeeIdentifier]
+          def self.tin(member:)
+            new(member: member, discriminant: "tin")
+          end
+
+          # @param member [String]
+          # @return [CandidApiClient::Remits::V1::Types::PayeeIdentifier]
+          def self.cms_plan_id(member:)
+            new(member: member, discriminant: "cms_plan_id")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/candidhealth/service_facility/client.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "types/encounter_service_facility_update"
+require_relative "types/encounter_service_facility"
+require "async"
+
+module CandidApiClient
+  class ServiceFacilityClient
+    # @return [CandidApiClient::RequestClient]
+    attr_reader :request_client
+
+    # @param request_client [CandidApiClient::RequestClient]
+    # @return [CandidApiClient::ServiceFacilityClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # @param service_facility_id [String]
+    # @param request [Hash] Request of type CandidApiClient::ServiceFacility::Types::EncounterServiceFacilityUpdate, as a Hash
+    #   * :organization_name (String)
+    #   * :npi (String)
+    #   * :address (Hash)
+    #     * :zip_plus_four_code (String)
+    #     * :address_1 (String)
+    #     * :address_2 (String)
+    #     * :city (String)
+    #     * :state (CandidApiClient::Commons::Types::State)
+    #     * :zip_code (String)
+    #   * :secondary_identification (String)
+    # @param request_options [CandidApiClient::RequestOptions]
+    # @return [CandidApiClient::ServiceFacility::Types::EncounterServiceFacility]
+    # @example
+    #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+    #  api.service_facility.update(service_facility_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", request: {  })
+    def update(service_facility_id:, request:, request_options: nil)
+      response = @request_client.conn.patch 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 || {}), **(request_options&.additional_body_parameters || {}) }.compact
+        req.url "#{@request_client.get_url(environment: CandidApi,
+                                           request_options: request_options)}/api/service_facility/v2/#{service_facility_id}"
+      end
+      CandidApiClient::ServiceFacility::Types::EncounterServiceFacility.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncServiceFacilityClient
+    # @return [CandidApiClient::AsyncRequestClient]
+    attr_reader :request_client
+
+    # @param request_client [CandidApiClient::AsyncRequestClient]
+    # @return [CandidApiClient::AsyncServiceFacilityClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # @param service_facility_id [String]
+    # @param request [Hash] Request of type CandidApiClient::ServiceFacility::Types::EncounterServiceFacilityUpdate, as a Hash
+    #   * :organization_name (String)
+    #   * :npi (String)
+    #   * :address (Hash)
+    #     * :zip_plus_four_code (String)
+    #     * :address_1 (String)
+    #     * :address_2 (String)
+    #     * :city (String)
+    #     * :state (CandidApiClient::Commons::Types::State)
+    #     * :zip_code (String)
+    #   * :secondary_identification (String)
+    # @param request_options [CandidApiClient::RequestOptions]
+    # @return [CandidApiClient::ServiceFacility::Types::EncounterServiceFacility]
+    # @example
+    #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+    #  api.service_facility.update(service_facility_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", request: {  })
+    def update(service_facility_id:, request:, request_options: nil)
+      Async do
+        response = @request_client.conn.patch 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 || {}), **(request_options&.additional_body_parameters || {}) }.compact
+          req.url "#{@request_client.get_url(environment: CandidApi,
+                                             request_options: request_options)}/api/service_facility/v2/#{service_facility_id}"
+        end
+        CandidApiClient::ServiceFacility::Types::EncounterServiceFacility.from_json(json_object: response.body)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative "../../commons/types/street_address_long_zip"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module ServiceFacility
+    module Types
+      class EncounterServiceFacility
+        # @return [String]
+        attr_reader :service_facility_id
+        # @return [String]
+        attr_reader :organization_name
+        # @return [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.
+        attr_reader :npi
+        # @return [CandidApiClient::Commons::Types::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.
+        attr_reader :address
+        # @return [String] An additional identifier for the service facility other than the facility's NPI.
+        #  Some payers may require this field.
+        #  Potential examples: state license number, provider commercial number, or
+        #  location number.
+        #  Box 32 section (b) of the CMS-1500 claim form.
+        attr_reader :secondary_identification
+        # @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 service_facility_id [String]
+        # @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 [CandidApiClient::Commons::Types::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 secondary_identification [String] An additional identifier for the service facility other than the facility's NPI.
+        #  Some payers may require this field.
+        #  Potential examples: state license number, provider commercial number, or
+        #  location number.
+        #  Box 32 section (b) of the CMS-1500 claim form.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [CandidApiClient::ServiceFacility::Types::EncounterServiceFacility]
+        def initialize(service_facility_id:, organization_name:, address:, npi: OMIT, secondary_identification: OMIT,
+                       additional_properties: nil)
+          @service_facility_id = service_facility_id
+          @organization_name = organization_name
+          @npi = npi if npi != OMIT
+          @address = address
+          @secondary_identification = secondary_identification if secondary_identification != OMIT
+          @additional_properties = additional_properties
+          @_field_set = {
+            "service_facility_id": service_facility_id,
+            "organization_name": organization_name,
+            "npi": npi,
+            "address": address,
+            "secondary_identification": secondary_identification
+          }.reject do |_k, v|
+            v == OMIT
+          end
+        end
+
+        # Deserialize a JSON object to an instance of EncounterServiceFacility
+        #
+        # @param json_object [String]
+        # @return [CandidApiClient::ServiceFacility::Types::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 = CandidApiClient::Commons::Types::StreetAddressLongZip.from_json(json_object: address)
+          end
+          secondary_identification = struct["secondary_identification"]
+          new(
+            service_facility_id: service_facility_id,
+            organization_name: organization_name,
+            npi: npi,
+            address: address,
+            secondary_identification: secondary_identification,
+            additional_properties: struct
+          )
+        end
+
+        # Serialize an instance of EncounterServiceFacility 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.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.")
+          CandidApiClient::Commons::Types::StreetAddressLongZip.validate_raw(obj: obj.address)
+          obj.secondary_identification&.is_a?(String) != false || raise("Passed value for field obj.secondary_identification is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require_relative "../../commons/types/street_address_long_zip"
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module ServiceFacility
+    module Types
+      # Encounter Service facility is typically the location a medical service was
+      #  rendered, such as a provider office or hospital.
+      #  For telehealth, service facility can represent the provider's location when the
+      #  service was delivered (e.g., home),
+      #  or the location where an in-person visit would have taken place, whichever is
+      #  easier to identify.
+      #  If the provider is in-network, service facility may be defined in payer
+      #  contracts.
+      #  Box 32 on the CMS-1500 claim form.
+      #  Note that for an in-network claim to be successfully adjudicated, the service
+      #  facility address listed on claims
+      #  must match what was provided to the payer during the credentialing process.
+      class EncounterServiceFacilityBase
+        # @return [String]
+        attr_reader :organization_name
+        # @return [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.
+        attr_reader :npi
+        # @return [CandidApiClient::Commons::Types::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.
+        attr_reader :address
+        # @return [String] An additional identifier for the service facility other than the facility's NPI.
+        #  Some payers may require this field.
+        #  Potential examples: state license number, provider commercial number, or
+        #  location number.
+        #  Box 32 section (b) of the CMS-1500 claim form.
+        attr_reader :secondary_identification
+        # @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 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 [CandidApiClient::Commons::Types::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 secondary_identification [String] An additional identifier for the service facility other than the facility's NPI.
+        #  Some payers may require this field.
+        #  Potential examples: state license number, provider commercial number, or
+        #  location number.
+        #  Box 32 section (b) of the CMS-1500 claim form.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [CandidApiClient::ServiceFacility::Types::EncounterServiceFacilityBase]
+        def initialize(organization_name:, address:, npi: OMIT, secondary_identification: OMIT,
+                       additional_properties: nil)
+          @organization_name = organization_name
+          @npi = npi if npi != OMIT
+          @address = address
+          @secondary_identification = secondary_identification if secondary_identification != OMIT
+          @additional_properties = additional_properties
+          @_field_set = {
+            "organization_name": organization_name,
+            "npi": npi,
+            "address": address,
+            "secondary_identification": secondary_identification
+          }.reject do |_k, v|
+            v == OMIT
+          end
+        end
+
+        # Deserialize a JSON object to an instance of EncounterServiceFacilityBase
+        #
+        # @param json_object [String]
+        # @return [CandidApiClient::ServiceFacility::Types::EncounterServiceFacilityBase]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          organization_name = struct["organization_name"]
+          npi = struct["npi"]
+          if parsed_json["address"].nil?
+            address = nil
+          else
+            address = parsed_json["address"].to_json
+            address = CandidApiClient::Commons::Types::StreetAddressLongZip.from_json(json_object: address)
+          end
+          secondary_identification = struct["secondary_identification"]
+          new(
+            organization_name: organization_name,
+            npi: npi,
+            address: address,
+            secondary_identification: secondary_identification,
+            additional_properties: struct
+          )
+        end
+
+        # Serialize an instance of EncounterServiceFacilityBase 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.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.")
+          CandidApiClient::Commons::Types::StreetAddressLongZip.validate_raw(obj: obj.address)
+          obj.secondary_identification&.is_a?(String) != false || raise("Passed value for field obj.secondary_identification is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end