candidhealth 1.6.0 → 1.8.0

data/lib/candidhealth/service_lines/v_2/client.rb

@@ -3,6 +3,8 @@
 require_relative "../../../requests"
 require_relative "types/service_line_create_standalone"
 require_relative "types/service_line"
+require_relative "types/universal_service_line_create_standalone"
+require_relative "types/universal_service_line_update"
 require_relative "types/service_line_update"
 require "async"
 
@@ -20,16 +22,16 @@ module CandidApiClient
         end
 
         # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineCreateStandalone, as a Hash
-        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
-        #   * :charge_amount_cents (Integer)
         #   * :diagnosis_id_zero (String)
         #   * :diagnosis_id_one (String)
         #   * :diagnosis_id_two (String)
         #   * :diagnosis_id_three (String)
+        #   * :procedure_code (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
         #   * :denial_reason (Hash)
         #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
         #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
-        #   * :procedure_code (String)
         #   * :quantity (String)
         #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
         #   * :claim_id (String)
@@ -66,7 +68,7 @@ module CandidApiClient
         # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
         # @example
         #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
-        #  api.service_lines.v_2.create(request: { procedure_code: "procedure_code", quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" })
+        #  api.service_lines.v_2.create(request: { quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", procedure_code: "procedure_code" })
         def create(request:, request_options: nil)
           response = @request_client.conn.post do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -83,15 +85,133 @@ module CandidApiClient
           CandidApiClient::ServiceLines::V2::Types::ServiceLine.from_json(json_object: response.body)
         end
 
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineCreateStandalone, as a Hash
+        #   * :diagnosis_id_zero (String)
+        #   * :diagnosis_id_one (String)
+        #   * :diagnosis_id_two (String)
+        #   * :diagnosis_id_three (String)
+        #   * :revenue_code (String)
+        #   * :procedure_code (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
+        #   * :denial_reason (Hash)
+        #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
+        #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
+        #   * :quantity (String)
+        #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
+        #   * :claim_id (String)
+        #   * :description (String)
+        #   * :date_of_service (Date)
+        #   * :end_date_of_service (Date)
+        #   * :drug_identification (Hash)
+        #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
+        #     * :national_drug_code (String)
+        #     * :national_drug_unit_count (String)
+        #     * :measurement_unit_code (CandidApiClient::ServiceLines::V2::Types::MeasurementUnitCode)
+        #     * :link_sequence_number (String)
+        #     * :pharmacy_prescription_number (String)
+        #     * :conversion_formula (String)
+        #     * :drug_description (String)
+        #   * :ordering_provider (Hash)
+        #     * :npi (String)
+        #     * :taxonomy_code (String)
+        #     * :address (Hash)
+        #       * :zip_plus_four_code (String)
+        #       * :address_1 (String)
+        #       * :address_2 (String)
+        #       * :city (String)
+        #       * :state (CandidApiClient::Commons::Types::State)
+        #       * :zip_code (String)
+        #     * :first_name (String)
+        #     * :last_name (String)
+        #     * :organization_name (String)
+        #   * :test_results (Array<CandidApiClient::ServiceLines::V2::Types::TestResult>)
+        #   * :has_epsdt_indicator (Boolean)
+        #   * :has_family_planning_indicator (Boolean)
+        #   * :note (String)
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.service_lines.v_2.create_universal(request: { quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" })
+        def create_universal(request:, request_options: nil)
+          response = @request_client.conn.post do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+            req.url "#{@request_client.get_url(environment: CandidApi,
+                                               request_options: request_options)}/api/service-lines/v2/universal"
+          end
+          CandidApiClient::ServiceLines::V2::Types::ServiceLine.from_json(json_object: response.body)
+        end
+
         # @param service_line_id [String]
-        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineUpdate, as a Hash
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineUpdate, as a Hash
+        #   * :revenue_code (String)
+        #   * :diagnosis_id_zero (String)
+        #   * :diagnosis_id_one (String)
+        #   * :diagnosis_id_two (String)
+        #   * :diagnosis_id_three (String)
         #   * :edit_reason (String)
         #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
         #   * :charge_amount_cents (Integer)
+        #   * :drug_identification (Hash)
+        #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
+        #     * :national_drug_code (String)
+        #     * :national_drug_unit_count (String)
+        #     * :measurement_unit_code (CandidApiClient::ServiceLines::V2::Types::MeasurementUnitCode)
+        #     * :link_sequence_number (String)
+        #     * :pharmacy_prescription_number (String)
+        #     * :conversion_formula (String)
+        #     * :drug_description (String)
+        #   * :denial_reason (Hash)
+        #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
+        #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
+        #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
+        #   * :procedure_code (String)
+        #   * :quantity (String)
+        #   * :description (String)
+        #   * :date_of_service (Date)
+        #   * :end_date_of_service (Date)
+        #   * :test_results (Array<CandidApiClient::ServiceLines::V2::Types::TestResult>)
+        #   * :has_epsdt_indicator (Boolean)
+        #   * :has_family_planning_indicator (Boolean)
+        #   * :note (String)
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.service_lines.v_2.update_universal(service_line_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", request: {  })
+        def update_universal(service_line_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-lines/v2/#{service_line_id}/universal"
+          end
+          CandidApiClient::ServiceLines::V2::Types::ServiceLine.from_json(json_object: response.body)
+        end
+
+        # @param service_line_id [String]
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineUpdate, as a Hash
         #   * :diagnosis_id_zero (String)
         #   * :diagnosis_id_one (String)
         #   * :diagnosis_id_two (String)
         #   * :diagnosis_id_three (String)
+        #   * :edit_reason (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
         #   * :drug_identification (Hash)
         #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
         #     * :national_drug_code (String)
@@ -167,16 +287,16 @@ module CandidApiClient
         end
 
         # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineCreateStandalone, as a Hash
-        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
-        #   * :charge_amount_cents (Integer)
         #   * :diagnosis_id_zero (String)
         #   * :diagnosis_id_one (String)
         #   * :diagnosis_id_two (String)
         #   * :diagnosis_id_three (String)
+        #   * :procedure_code (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
         #   * :denial_reason (Hash)
         #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
         #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
-        #   * :procedure_code (String)
         #   * :quantity (String)
         #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
         #   * :claim_id (String)
@@ -213,7 +333,7 @@ module CandidApiClient
         # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
         # @example
         #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
-        #  api.service_lines.v_2.create(request: { procedure_code: "procedure_code", quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" })
+        #  api.service_lines.v_2.create(request: { quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", procedure_code: "procedure_code" })
         def create(request:, request_options: nil)
           Async do
             response = @request_client.conn.post do |req|
@@ -232,15 +352,137 @@ module CandidApiClient
           end
         end
 
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineCreateStandalone, as a Hash
+        #   * :diagnosis_id_zero (String)
+        #   * :diagnosis_id_one (String)
+        #   * :diagnosis_id_two (String)
+        #   * :diagnosis_id_three (String)
+        #   * :revenue_code (String)
+        #   * :procedure_code (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
+        #   * :denial_reason (Hash)
+        #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
+        #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
+        #   * :quantity (String)
+        #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
+        #   * :claim_id (String)
+        #   * :description (String)
+        #   * :date_of_service (Date)
+        #   * :end_date_of_service (Date)
+        #   * :drug_identification (Hash)
+        #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
+        #     * :national_drug_code (String)
+        #     * :national_drug_unit_count (String)
+        #     * :measurement_unit_code (CandidApiClient::ServiceLines::V2::Types::MeasurementUnitCode)
+        #     * :link_sequence_number (String)
+        #     * :pharmacy_prescription_number (String)
+        #     * :conversion_formula (String)
+        #     * :drug_description (String)
+        #   * :ordering_provider (Hash)
+        #     * :npi (String)
+        #     * :taxonomy_code (String)
+        #     * :address (Hash)
+        #       * :zip_plus_four_code (String)
+        #       * :address_1 (String)
+        #       * :address_2 (String)
+        #       * :city (String)
+        #       * :state (CandidApiClient::Commons::Types::State)
+        #       * :zip_code (String)
+        #     * :first_name (String)
+        #     * :last_name (String)
+        #     * :organization_name (String)
+        #   * :test_results (Array<CandidApiClient::ServiceLines::V2::Types::TestResult>)
+        #   * :has_epsdt_indicator (Boolean)
+        #   * :has_family_planning_indicator (Boolean)
+        #   * :note (String)
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.service_lines.v_2.create_universal(request: { quantity: "quantity", units: MJ, claim_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" })
+        def create_universal(request:, request_options: nil)
+          Async do
+            response = @request_client.conn.post do |req|
+              req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+              req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+              req.url "#{@request_client.get_url(environment: CandidApi,
+                                                 request_options: request_options)}/api/service-lines/v2/universal"
+            end
+            CandidApiClient::ServiceLines::V2::Types::ServiceLine.from_json(json_object: response.body)
+          end
+        end
+
         # @param service_line_id [String]
-        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineUpdate, as a Hash
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::UniversalServiceLineUpdate, as a Hash
+        #   * :revenue_code (String)
+        #   * :diagnosis_id_zero (String)
+        #   * :diagnosis_id_one (String)
+        #   * :diagnosis_id_two (String)
+        #   * :diagnosis_id_three (String)
         #   * :edit_reason (String)
         #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
         #   * :charge_amount_cents (Integer)
+        #   * :drug_identification (Hash)
+        #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
+        #     * :national_drug_code (String)
+        #     * :national_drug_unit_count (String)
+        #     * :measurement_unit_code (CandidApiClient::ServiceLines::V2::Types::MeasurementUnitCode)
+        #     * :link_sequence_number (String)
+        #     * :pharmacy_prescription_number (String)
+        #     * :conversion_formula (String)
+        #     * :drug_description (String)
+        #   * :denial_reason (Hash)
+        #     * :reason (CandidApiClient::ServiceLines::V2::Types::DenialReasonContent)
+        #   * :place_of_service_code (CandidApiClient::Commons::Types::FacilityTypeCode)
+        #   * :units (CandidApiClient::Commons::Types::ServiceLineUnits)
+        #   * :procedure_code (String)
+        #   * :quantity (String)
+        #   * :description (String)
+        #   * :date_of_service (Date)
+        #   * :end_date_of_service (Date)
+        #   * :test_results (Array<CandidApiClient::ServiceLines::V2::Types::TestResult>)
+        #   * :has_epsdt_indicator (Boolean)
+        #   * :has_family_planning_indicator (Boolean)
+        #   * :note (String)
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLine]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.service_lines.v_2.update_universal(service_line_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", request: {  })
+        def update_universal(service_line_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-lines/v2/#{service_line_id}/universal"
+            end
+            CandidApiClient::ServiceLines::V2::Types::ServiceLine.from_json(json_object: response.body)
+          end
+        end
+
+        # @param service_line_id [String]
+        # @param request [Hash] Request of type CandidApiClient::ServiceLines::V2::Types::ServiceLineUpdate, as a Hash
         #   * :diagnosis_id_zero (String)
         #   * :diagnosis_id_one (String)
         #   * :diagnosis_id_two (String)
         #   * :diagnosis_id_three (String)
+        #   * :edit_reason (String)
+        #   * :modifiers (Array<CandidApiClient::Commons::Types::ProcedureModifier>)
+        #   * :charge_amount_cents (Integer)
         #   * :drug_identification (Hash)
         #     * :service_id_qualifier (CandidApiClient::ServiceLines::V2::Types::ServiceIdQualifier)
         #     * :national_drug_code (String)

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

@@ -69,7 +69,10 @@ module CandidApiClient
           attr_reader :related_invoice_info
           # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason]
           attr_reader :denial_reason
-          # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. 02 for telemedicine, 11 for in-person. Full list
+          # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required in 837i claims. If your
+          #  organization does not intend to submit claims with a different place of service
+          #  at the service line level, this field should not be populated. 02 for
+          #  telemedicine, 11 for in-person. Full list
           #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
           attr_reader :place_of_service_code
           # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. 02 for telemedicine, 11 for in-person. Full list
@@ -81,11 +84,16 @@ module CandidApiClient
           attr_reader :procedure_code
           # @return [CandidApiClient::EncounterProviders::V2::Types::EncounterProvider]
           attr_reader :ordering_provider
-          # @return [String]
+          # @return [String] A 4 digit code that specifies facility department or type of service arrangement
+          #  for institutional service line items (837i). This code is not required for
+          #  professional claim billing (837p).
           attr_reader :revenue_code
           # @return [String] 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.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
           attr_reader :quantity
           # @return [CandidApiClient::Commons::Types::ServiceLineUnits]
           attr_reader :units
@@ -96,7 +104,7 @@ module CandidApiClient
           #  will be empty.
           attr_reader :date_of_service_range
           # @return [String] A free-form description to clarify the related data elements and their content.
-          #  Maps to SV1-01, C003-07 on the 837-P.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
           attr_reader :description
           # @return [Date]
           attr_reader :date_of_service
@@ -104,6 +112,7 @@ module CandidApiClient
           attr_reader :end_date_of_service
           # @return [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
           #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
           #  No more than 5 MEA-02 test results may be submitted per service line.
           attr_reader :test_results
           # @return [Boolean] Maps to SV1-11 on the 837-P and Box 24H on the CMS-1500.
@@ -148,28 +157,37 @@ module CandidApiClient
           # @param related_invoices [Array<CandidApiClient::Invoices::Types::Invoice>]
           # @param related_invoice_info [Array<CandidApiClient::Invoices::V2::Types::InvoiceInfo>]
           # @param denial_reason [CandidApiClient::ServiceLines::V2::Types::ServiceLineDenialReason]
-          # @param place_of_service_code [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. 02 for telemedicine, 11 for in-person. Full list
+          # @param place_of_service_code [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required in 837i claims. If your
+          #  organization does not intend to submit claims with a different place of service
+          #  at the service line level, this field should not be populated. 02 for
+          #  telemedicine, 11 for in-person. Full list
           #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
           # @param place_of_service_code_as_submitted [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. 02 for telemedicine, 11 for in-person. Full list
           #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
           # @param service_line_id [String]
           # @param procedure_code [String]
           # @param ordering_provider [CandidApiClient::EncounterProviders::V2::Types::EncounterProvider]
-          # @param revenue_code [String]
+          # @param revenue_code [String] A 4 digit code that specifies facility department or type of service arrangement
+          #  for institutional service line items (837i). This code is not required for
+          #  professional claim billing (837p).
           # @param quantity [String] 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.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
           # @param units [CandidApiClient::Commons::Types::ServiceLineUnits]
           # @param claim_id [String]
           # @param date_of_service_range [CandidApiClient::Commons::Types::DateRangeOptionalEnd] A range of dates of service for this service line. If the service line is for a
           #  single date, the end date
           #  will be empty.
           # @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.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
           # @param date_of_service [Date]
           # @param end_date_of_service [Date]
           # @param test_results [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
           #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
           #  No more than 5 MEA-02 test results may be submitted per service line.
           # @param has_epsdt_indicator [Boolean] Maps to SV1-11 on the 837-P and Box 24H on the CMS-1500.
           #  If the value is true, the box will be populated with "Y". Otherwise, the box

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

@@ -15,6 +15,10 @@ module CandidApiClient
     module V2
       module Types
         class ServiceLineCreate
+          # @return [Array<Integer>] Indices (zero-indexed) of all the diagnoses this service line references
+          attr_reader :diagnosis_pointers
+          # @return [String]
+          attr_reader :procedure_code
           # @return [Array<CandidApiClient::Commons::Types::ProcedureModifier>]
           attr_reader :modifiers
           # @return [Boolean] Maps to SV1-11 on the 837-P and Box 24H on the CMS-1500.
@@ -25,31 +29,32 @@ module CandidApiClient
           #  If the value is true, the box will be populated with "Y". Otherwise, the box
           #  will not be populated.
           attr_reader :has_family_planning_indicator
-          # @return [String]
-          attr_reader :procedure_code
           # @return [String] 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.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
           attr_reader :quantity
           # @return [CandidApiClient::Commons::Types::ServiceLineUnits]
           attr_reader :units
-          # @return [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.
+          # @return [Integer] The total amount charged for this service line, factoring in quantity. If
+          #  procedure_code is updated and this is not, the system will attempt to set it
+          #  based on chargemasters entries and the service line’s quantity. For example, if
+          #  a single unit has an entry of 100 cents and 2 units were rendered, the
+          #  charge_amount_cents will be set to 200, if there is no chargemaster entry, it
+          #  will default to the amount set in this field.
           attr_reader :charge_amount_cents
-          # @return [Array<Integer>] Indices (zero-indexed) of all the diagnoses this service line references
-          attr_reader :diagnosis_pointers
           # @return [CandidApiClient::ServiceLines::V2::Types::DrugIdentification]
           attr_reader :drug_identification
-          # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. If your organization does not intend to submit claims with
-          #  a different place of service at the service line level, this field should not be
-          #  populated. 02 for telemedicine, 11 for in-person. Full list
+          # @return [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required for institutional
+          #  claims. If your organization does not intend to submit claims with a different
+          #  place of service at the service line level, this field should not be populated.
+          #  02 for telemedicine, 11 for in-person. Full list
           #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
           attr_reader :place_of_service_code
           # @return [String] A free-form description to clarify the related data elements and their content.
-          #  Maps to SV1-01, C003-07 on the 837-P.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
           attr_reader :description
           # @return [Date]
           attr_reader :date_of_service
@@ -61,6 +66,7 @@ module CandidApiClient
           attr_reader :ordering_provider
           # @return [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
           #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
           #  No more than 5 MEA-02 test results may be submitted per service line.
           attr_reader :test_results
           # @return [String] Maps to NTE02 loop 2400 on the EDI 837.
@@ -73,6 +79,8 @@ module CandidApiClient
 
           OMIT = Object.new
 
+          # @param diagnosis_pointers [Array<Integer>] Indices (zero-indexed) of all the diagnoses this service line references
+          # @param procedure_code [String]
           # @param modifiers [Array<CandidApiClient::Commons::Types::ProcedureModifier>]
           # @param has_epsdt_indicator [Boolean] Maps to SV1-11 on the 837-P and Box 24H on the CMS-1500.
           #  If the value is true, the box will be populated with "Y". Otherwise, the box
@@ -80,24 +88,27 @@ module CandidApiClient
           # @param has_family_planning_indicator [Boolean] Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500.
           #  If the value is true, the box will be populated with "Y". Otherwise, the box
           #  will not be populated.
-          # @param procedure_code [String]
           # @param quantity [String] 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.
+          #  For professional claims, a ServiceLine quantity cannot contain more than one
+          #  digit of precision
+          #  (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine
+          #  quantity cannot contain
+          #  more than three decimal digits of precision.
           # @param units [CandidApiClient::Commons::Types::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 charge_amount_cents [Integer] The total amount charged for this service line, factoring in quantity. If
+          #  procedure_code is updated and this is not, the system will attempt to set it
+          #  based on chargemasters entries and the service line’s quantity. For example, if
+          #  a single unit has an entry of 100 cents and 2 units were rendered, the
+          #  charge_amount_cents will be set to 200, if there is no chargemaster entry, it
+          #  will default to the amount set in this field.
           # @param drug_identification [CandidApiClient::ServiceLines::V2::Types::DrugIdentification]
-          # @param place_of_service_code [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. If your organization does not intend to submit claims with
-          #  a different place of service at the service line level, this field should not be
-          #  populated. 02 for telemedicine, 11 for in-person. Full list
+          # @param place_of_service_code [CandidApiClient::Commons::Types::FacilityTypeCode] 837p Loop2300, SV105. This enum is not used or required for institutional
+          #  claims. If your organization does not intend to submit claims with a different
+          #  place of service at the service line level, this field should not be populated.
+          #  02 for telemedicine, 11 for in-person. Full list
           #  //www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set).
           # @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.
+          #  Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.
           # @param date_of_service [Date]
           # @param end_date_of_service [Date]
           # @param ordering_provider [CandidApiClient::EncounterProviders::V2::Types::OrderingProvider] Required when the service or supply was ordered by a provider who is different
@@ -105,20 +116,21 @@ module CandidApiClient
           #  If not required by this implementation guide, do not send.
           # @param test_results [Array<CandidApiClient::ServiceLines::V2::Types::TestResult>] Contains a list of test results. Test result types may map to MEA-02 on the
           #  837-P (ex: Hemoglobin, Hematocrit).
+          #  This is unused by 837-i and ignored for institutional service lines.
           #  No more than 5 MEA-02 test results may be submitted per service line.
           # @param note [String] Maps to NTE02 loop 2400 on the EDI 837.
           # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
           # @return [CandidApiClient::ServiceLines::V2::Types::ServiceLineCreate]
-          def initialize(procedure_code:, quantity:, units:, diagnosis_pointers:, modifiers: OMIT,
-                         has_epsdt_indicator: OMIT, has_family_planning_indicator: OMIT, charge_amount_cents: OMIT, drug_identification: OMIT, place_of_service_code: OMIT, description: OMIT, date_of_service: OMIT, end_date_of_service: OMIT, ordering_provider: OMIT, test_results: OMIT, note: OMIT, additional_properties: nil)
+          def initialize(diagnosis_pointers:, procedure_code:, quantity:, units:, modifiers: OMIT, has_epsdt_indicator: OMIT,
+                         has_family_planning_indicator: OMIT, charge_amount_cents: OMIT, drug_identification: OMIT, place_of_service_code: OMIT, description: OMIT, date_of_service: OMIT, end_date_of_service: OMIT, ordering_provider: OMIT, test_results: OMIT, note: OMIT, additional_properties: nil)
+            @diagnosis_pointers = diagnosis_pointers
+            @procedure_code = procedure_code
             @modifiers = modifiers if modifiers != OMIT
             @has_epsdt_indicator = has_epsdt_indicator if has_epsdt_indicator != OMIT
             @has_family_planning_indicator = has_family_planning_indicator if has_family_planning_indicator != OMIT
-            @procedure_code = procedure_code
             @quantity = quantity
             @units = units
             @charge_amount_cents = charge_amount_cents if charge_amount_cents != OMIT
-            @diagnosis_pointers = diagnosis_pointers
             @drug_identification = drug_identification if drug_identification != OMIT
             @place_of_service_code = place_of_service_code if place_of_service_code != OMIT
             @description = description if description != OMIT
@@ -129,14 +141,14 @@ module CandidApiClient
             @note = note if note != OMIT
             @additional_properties = additional_properties
             @_field_set = {
+              "diagnosis_pointers": diagnosis_pointers,
+              "procedure_code": procedure_code,
               "modifiers": modifiers,
               "has_epsdt_indicator": has_epsdt_indicator,
               "has_family_planning_indicator": has_family_planning_indicator,
-              "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,
@@ -157,14 +169,14 @@ module CandidApiClient
           def self.from_json(json_object:)
             struct = JSON.parse(json_object, object_class: OpenStruct)
             parsed_json = JSON.parse(json_object)
+            diagnosis_pointers = struct["diagnosis_pointers"]
+            procedure_code = struct["procedure_code"]
             modifiers = struct["modifiers"]
             has_epsdt_indicator = struct["has_epsdt_indicator"]
             has_family_planning_indicator = struct["has_family_planning_indicator"]
-            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
@@ -189,14 +201,14 @@ module CandidApiClient
             end
             note = struct["note"]
             new(
+              diagnosis_pointers: diagnosis_pointers,
+              procedure_code: procedure_code,
               modifiers: modifiers,
               has_epsdt_indicator: has_epsdt_indicator,
               has_family_planning_indicator: has_family_planning_indicator,
-              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,
@@ -223,14 +235,14 @@ module CandidApiClient
           # @param obj [Object]
           # @return [Void]
           def self.validate_raw(obj:)
+            obj.diagnosis_pointers.is_a?(Array) != false || raise("Passed value for field obj.diagnosis_pointers 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.modifiers&.is_a?(Array) != false || raise("Passed value for field obj.modifiers is not the expected type, validation failed.")
             obj.has_epsdt_indicator&.is_a?(Boolean) != false || raise("Passed value for field obj.has_epsdt_indicator is not the expected type, validation failed.")
             obj.has_family_planning_indicator&.is_a?(Boolean) != false || raise("Passed value for field obj.has_family_planning_indicator 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?(CandidApiClient::Commons::Types::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? || CandidApiClient::ServiceLines::V2::Types::DrugIdentification.validate_raw(obj: obj.drug_identification)
             obj.place_of_service_code&.is_a?(CandidApiClient::Commons::Types::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.")