change_health 5.18.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad94a64e05364d0f24774fe9721a4a2ffadb08448a07348c7835e0dcd0354806
-  data.tar.gz: 050236cd7408f842f717717af0cbcaafba23cf84860bcb5cfac85f4ea2d07ff1
+  metadata.gz: d2d6ad0d50b0e805179570b1db9df8ab057f3a06488508ea0ea84141afb8eec1
+  data.tar.gz: 2d8ea569efbe4fc84f2670971674a6e58544328af5b78e1163e4c26c8d894926
 SHA512:
-  metadata.gz: d9048cdfb5921250757a618b7b9e1f44c608e7fb86344830a25ef2a83ed2fd848760e2b8bd13adb482eb264d84d3405c83fd4a25b032fdd11eb046dbb80fa652
-  data.tar.gz: 844d6a4f4a32f29db366d7975072400f95a3f18dd833c2239ca7b7e4802ec0334bf4e0d19d48f50c7231b6f8148095d71c4ad14cd02a328431cfc2a85d2f54da
+  metadata.gz: 68764a4c0968bde39f68b3f1acda7d6cd323dcb1122b71f9df754f060eea39bdba066c25c2a1cb97f566702f22b77ee1f442ab985afc3cbe6d119d7fbc34d773
+  data.tar.gz: 6a3a18c0af0b00ee2800d0d87184d518170e964bf4f9fa5795b5da37820246fdc171a1abb7b212de3a73f34beae73930e2b44a0552bbc554bdae506657bb9ab2

data/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+# [6.1.0] - 2025-01-24
+
+### Added
+
+* `Report835ServiceLine#service_date`
+* `Report835ServiceLine#service_date_begin`
+* `Report835ServiceLine#service_date_end`
+
+# [6.0.0] - 2024-11-22
+
+Previously the only field extracted from the `informationStatuses` section of the 277 report JSON was `healthCareClaimStatusCategoryCode`. This version includes the following additional fields from this section: `healthCareClaimStatusCategoryCodeValue`, `statusCode` & `statusCodeValue`.
+
+### Removed
+
+Breaking changes:
+
+* `Report277InfoClaimStatus#status_category_codes`
+* `Report277InfoClaimStatus#add_status_category_code`
+
+### Added
+
+* `ChangeHealth::Response::Claim::Report277InfoStatus` model that encapsulates the fields listed above.
+* `Report277InfoClaimStatus#info_statuses` property that stores all `Report277InfoStatus` found in the `informationStatuses` section of the 277 JSON.
+* `Report277InfoClaimStatus#add_info_status` method to add individual `Report277InfoStatus`.
+* `Report277Data#latest_info_statuses` method to return the latest `informationStatuses` in the 277 JSON. See README for usage.
+
 # [5.18.0] - 2024-08-19
 
 ### Added
@@ -748,6 +774,8 @@ Added the ability to hit professional claim submission API. For more details, se
 * Authentication
 * Configuration
 
+[6.1.0]: https://github.com/WeInfuse/change_health/compare/v6.0.0...v6.1.0
+[6.0.0]: https://github.com/WeInfuse/change_health/compare/v5.18.0...v6.0.0
 [5.18.0]: https://github.com/WeInfuse/change_health/compare/v5.17.0...v5.18.0
 [5.17.0]: https://github.com/WeInfuse/change_health/compare/v5.16.0...v5.17.0
 [5.16.0]: https://github.com/WeInfuse/change_health/compare/v5.15.0...v5.16.0

data/README.md

@@ -436,6 +436,20 @@ claim277.report_creation_date
 # Tue, 01 Dec 2020
 
 # Report 277 specific below
+statuses = claim277.latest_info_statuses
+
+statuses.first.status_category_code
+# "F1"
+
+statuses.first.status_category_code_value
+# "Finalized/Payment-The claim/line has been paid."
+
+statuses.first.status_code
+# "20"
+
+statuses.first.status_code_value
+# "Accepted for processing."
+
 claim277.latest_status_category_codes
 # ["F1"]
 

data/lib/change_health/models/claim/submission/service_line.rb

@@ -10,7 +10,7 @@ module ChangeHealth
         property :professionalService, from: :professional_service
         property :renderingProvider, from: :rendering_provider
         property :serviceDate, from: :service_date
-        property :serviceDateEnd, from: :service_date_end, required: false
+        property :serviceDateEnd, from: :service_date_end
       end
     end
   end

data/lib/change_health/response/claim/report/report_277_claim.rb

@@ -19,8 +19,12 @@ module ChangeHealth
           self[:procedure_codes] << procedure_code
         end
 
+        def latest_info_statuses
+          latest_info_claim_status&.info_statuses
+        end
+
         def latest_status_category_codes
-          latest_info_claim_status&.status_category_codes
+          latest_info_statuses&.map(&:status_category_code)
         end
 
         def total_charge_amount

data/lib/change_health/response/claim/report/report_277_data.rb

@@ -54,14 +54,19 @@ module ChangeHealth
                         status_information_effective_date = ChangeHealth::Models::PARSE_DATE.call(info_claim_status['statusInformationEffectiveDate'])
                         total_charge_amount = info_claim_status['totalClaimChargeAmount']
 
-                        status_category_codes = []
+                        info_statuses = []
                         info_claim_status['informationStatuses']&.each do |info_status|
-                          status_category_codes << info_status['healthCareClaimStatusCategoryCode']
+                          info_statuses << Report277InfoStatus.new(
+                            status_category_code: info_status['healthCareClaimStatusCategoryCode'],
+                            status_category_code_value: info_status['healthCareClaimStatusCategoryCodeValue'],
+                            status_code: info_status['statusCode'],
+                            status_code_value: info_status['statusCodeValue']
+                          )
                         end
 
                         info_claim_statuses << Report277InfoClaimStatus.new(
                           message: message,
-                          status_category_codes: status_category_codes,
+                          info_statuses: info_statuses,
                           total_charge_amount: total_charge_amount,
                           status_information_effective_date: status_information_effective_date
                         )

data/lib/change_health/response/claim/report/report_277_info_claim_status.rb

@@ -3,13 +3,13 @@ module ChangeHealth
     module Claim
       class Report277InfoClaimStatus < Hashie::Trash
         property :message, required: false
-        property :status_category_codes, required: false
+        property :info_statuses, required: false
         property :total_charge_amount, required: false
         property :status_information_effective_date, required: false
 
-        def add_status_category_code(status_category_code)
-          self[:status_category_codes] ||= []
-          self[:status_category_codes] << status_category_code
+        def add_info_status(info_status)
+          self[:info_statuses] ||= []
+          self[:info_statuses] << info_status
         end
       end
     end

data/lib/change_health/response/claim/report/report_277_info_status.rb

@@ -0,0 +1,12 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report277InfoStatus < Hashie::Trash
+        property :status_category_code, required: false
+        property :status_category_code_value, required: false
+        property :status_code, required: false
+        property :status_code_value, required: false
+      end
+    end
+  end
+end

data/lib/change_health/response/claim/report/report_835_data.rb

@@ -93,15 +93,18 @@ module ChangeHealth
                 service_date_begin = nil
                 service_date_end = nil
                 service_lines = payment_info['serviceLines']&.map do |service_line|
-                  service_line_date = ChangeHealth::Models::PARSE_DATE.call(service_line['serviceDate'])
-                  unless service_line_date.nil?
-                    if service_date_begin.nil? || service_line_date < service_date_begin
-                      service_date_begin = service_line_date
-                    end
-                    if service_date_end.nil? || service_date_end < service_line_date
-                      service_date_end = service_line_date
-                    end
-                  end
+                  service_line_date_parsed = ChangeHealth::Models::PARSE_DATE.call(service_line['serviceDate'])
+                  service_line_date_begin_parsed = ChangeHealth::Models::PARSE_DATE.call(service_line['serviceStartDate'])
+                  service_line_date_end_parsed = ChangeHealth::Models::PARSE_DATE.call(service_line['serviceEndDate'])
+
+                  all_dates = [service_line_date_parsed, service_line_date_begin_parsed, service_line_date_end_parsed]
+
+                  service_line_date_begin = all_dates.compact.min
+                  service_line_date = service_line_date_begin
+                  service_line_date_end = all_dates.compact.max
+
+                  service_date_begin = [service_date_begin, service_line_date_begin].compact.min
+                  service_date_end = [service_date_end, service_line_date_end].compact.max
 
                   adjudicated_procedure_code = service_line.dig('servicePaymentInformation', 'adjudicatedProcedureCode')
                   allowed_actual = service_line.dig('serviceSupplementalAmounts', 'allowedActual')
@@ -125,15 +128,21 @@ module ChangeHealth
                   Report835ServiceLine.new(
                     adjudicated_procedure_code: adjudicated_procedure_code,
                     allowed_actual: allowed_actual,
+                    health_care_check_remark_codes: health_care_check_remark_codes,
                     line_item_charge_amount: line_item_charge_amount,
                     line_item_provider_payment_amount: line_item_provider_payment_amount,
                     service_adjustments: service_adjustments,
-                    health_care_check_remark_codes: health_care_check_remark_codes
+                    service_date: service_line_date,
+                    service_date_begin: service_line_date_begin,
+                    service_date_end: service_line_date_end
                   )
                 end
 
-                if service_date_begin.nil? && service_date_end.nil?
+                if service_date_begin.nil?
                   service_date_begin = ChangeHealth::Models::PARSE_DATE.call(payment_info['claimStatementPeriodStart'])
+                end
+
+                if service_date_end.nil?
                   service_date_end = ChangeHealth::Models::PARSE_DATE.call(payment_info['claimStatementPeriodEnd'])
                 end
 

data/lib/change_health/response/claim/report/report_835_service_line.rb

@@ -2,12 +2,15 @@ module ChangeHealth
   module Response
     module Claim
       class Report835ServiceLine < Hashie::Trash
-        property :adjudicated_procedure_code, required: false
-        property :allowed_actual, required: false
-        property :health_care_check_remark_codes, required: false
-        property :line_item_charge_amount, required: false
-        property :line_item_provider_payment_amount, required: false
-        property :service_adjustments, required: false
+        property :adjudicated_procedure_code
+        property :allowed_actual
+        property :health_care_check_remark_codes
+        property :line_item_charge_amount
+        property :line_item_provider_payment_amount
+        property :service_adjustments
+        property :service_date
+        property :service_date_begin
+        property :service_date_end
 
         def create_group_adjustments(service_adjustments)
           adjustment_array = service_adjustments[:adjustments].map do |key, value|

data/lib/change_health/version.rb

@@ -1,3 +1,3 @@
 module ChangeHealth
-  VERSION = '5.18.0'.freeze
+  VERSION = '6.1.0'.freeze
 end

data/lib/change_health.rb

@@ -46,6 +46,7 @@ require 'change_health/response/claim/report/report_277_data'
 require 'change_health/response/claim/report/report_835_data'
 require 'change_health/response/claim/report/report_claim'
 require 'change_health/response/claim/report/report_277_claim'
+require 'change_health/response/claim/report/report_277_info_status'
 require 'change_health/response/claim/report/report_277_info_claim_status'
 require 'change_health/response/claim/report/report_835_claim'
 require 'change_health/response/claim/report/report_835_health_care_check_remark_code'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: change_health
 version: !ruby/object:Gem::Version
-  version: 5.18.0
+  version: 6.1.0
 platform: ruby
 authors:
 - Mike Crockett
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-09-19 00:00:00.000000000 Z
+date: 2025-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -128,7 +128,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: 
+description:
 email:
 - mike.crockett@weinfuse.com
 executables: []
@@ -182,6 +182,7 @@ files:
 - lib/change_health/response/claim/report/report_277_claim.rb
 - lib/change_health/response/claim/report/report_277_data.rb
 - lib/change_health/response/claim/report/report_277_info_claim_status.rb
+- lib/change_health/response/claim/report/report_277_info_status.rb
 - lib/change_health/response/claim/report/report_835_claim.rb
 - lib/change_health/response/claim/report/report_835_data.rb
 - lib/change_health/response/claim/report/report_835_health_care_check_remark_code.rb
@@ -206,7 +207,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -222,7 +223,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Ruby wrapper for the ChangeHealth API
 test_files: []