change_health 3.5.3 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 601bff416950731a5af885161eedc34e97d79a8f746e96459229a483683bd5a1
-  data.tar.gz: e66cfc8da889738869f830d3c46aa9176d08159405daa4865a083d544587da99
+  metadata.gz: 9bbc1e710e4746b0aa9a3b4b3189d512a331866898146784d8e9581b29067197
+  data.tar.gz: 348dcd9c463548cc237a1e505aacb0c66616d63e478ae404ea3a18fe335a7545
 SHA512:
-  metadata.gz: aba95ecb3b61500e430a0112b5ba126104ce37ac31a1308ac29103f28d2b2b9a33c6b1e71acc137cf2a8c2f651749534a9e16cf1e1295afcccc264f2d66bf997
-  data.tar.gz: e45adcf2fb3410c067db15503fb15b3cc053ab69111f4afec47bcdae76c5f95bd5c78c61e5c612ea20d836e9b4b5b51ba4e43eb65836ff331923e3b24e4e45dd
+  metadata.gz: 0a14286f7f3d39c38ae891c7d2094dd99df356a4169f23b3fe72daa8eaa5a7353d2aa79f8d3c12f74ceb2f73d2d63688fc463a5f746786243f978d7b70de864d
+  data.tar.gz: 064e0cab9b729afade6eb158ea093bbd15c512dea122f91561edc3f0c0f0daa5c805c995a4bd953f7fcf123d0209f8ee3b471356825f6c19453f83f6cec004a5

data/CHANGELOG.md

@@ -4,6 +4,27 @@ 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).
+
+# [4.1.0] - 2022-06-17
+
+### Added
+Report835Claim - Add another way to get `service_provider_npi`
+
+# [4.0.0] - 2022-05-26
+
+### Changed
+The assumption that only one payment would be in a report835 was wrong. Corrected that by adding in a model to hold the payment information - Report835Payment. Removed payment related info from Report835Data and Report835Claim. See README for usage
+* check_issue_or_eft_effective_date
+* check_or_eft_trace_number
+* payer_identifier
+* payment_method_code
+* report_creation_date
+* total_actual_provider_payment_amount
+
+# [3.5.4] - 2022-05-18
+
+* Used dig on `service_provider_npi` variable assigning because it produces way fewer bugs
+
 # [3.5.3] - 2022-05-18
 
 * Added new ways to assign `patient_member_id` and `service_provider_npi` for claim reports returned by insurance
@@ -352,6 +373,9 @@ Added the ability to hit professional claim submission API. For more details, se
 * Authentication
 * Configuration
 
+[4.1.0]: https://github.com/WeInfuse/change_health/compare/v4.0.0...v4.1.0
+[4.0.0]: https://github.com/WeInfuse/change_health/compare/v3.5.4...v4.0.0
+[3.5.4]: https://github.com/WeInfuse/change_health/compare/v3.5.3...v3.5.4
 [3.5.3]: https://github.com/WeInfuse/change_health/compare/v3.5.2...v3.5.3
 [3.5.2]: https://github.com/WeInfuse/change_health/compare/v3.5.1...v3.5.2
 [3.5.1]: https://github.com/WeInfuse/change_health/compare/v3.5.0...v3.5.1

data/README.md

@@ -243,66 +243,68 @@ From a report, you can get an array of claims
 #### Report 277
 
 ```ruby
-report_277_data = ChangeHealth::Request::Claim::Report.get_report("X3000000.AB", as_json_report: true)
+report277_data = ChangeHealth::Request::Claim::Report.get_report("X3000000.AB", as_json_report: true)
 
-report_277_data.payer_name
+report277_data.payer_name
 # "PREMERA"
 
-report_277_data.report_creation_date
+report277_data.report_creation_date
 # Tue, 01 Dec 2020
 
-claim_277 = report_277_data.claims.first
-claim_277.payer_name
+claim277 = report277_data.claims.first
+claim277.payer_name
 # "PREMERA"
 
-claim_277.report_name
+claim277.report_name
 # "X3000000.AB"
 
-claim_277.patient_first_name
+claim277.patient_first_name
 # "JOHNONE"
 
-claim_277.report_creation_date
+claim277.report_creation_date
 # Tue, 01 Dec 2020
 
 # Report 277 specific below
-claim_277.latest_status_category_codes
+claim277.latest_status_category_codes
 # ["F1"]
 
-claim_277.total_charge_amount
+claim277.total_charge_amount
 # "100"
 
-claim_277.procedure_codes
+claim277.procedure_codes
 # ["97161"]
 ```
 
 #### Report 835
 
 ```ruby
-report_835_data = ChangeHealth::Request::Claim::Report.get_report("R5000000.XY", as_json_report: true)
+report835_data = ChangeHealth::Request::Claim::Report.get_report("R5000000.XY", as_json_report: true)
 
-report_835_data.payment_method_code
+payment835 = report835_data.payments.first
+
+payment835.payment_method_code
 # "ACH"
 
-report_835_data.total_actual_provider_payment_amount
+payment835.total_actual_provider_payment_amount
 # "2563.13"
 
-claim_835 = report_835_data.claims.first
-claim_835.payer_name
+claim835 = payment835.claims.first
+claim835.payer_name
 # "NATIONAL GOVERNMENT SERVICES, INC."
 
-claim_835.patient_first_name
+claim835.patient_first_name
 # "JANE"
 
-claim_835.patient_member_id
+claim835.patient_member_id
 # "7SL5RA7XR19"
 
-claim_835.report_creation_date
+claim835.report_creation_date
 # Wed, 22 Apr 2020
 
-claim_835.procedure_codes
+claim835.procedure_codes
 # ["21210", "21026", "21208", "30580"]
 
-claim_835.service_lines.map(&:line_item_charge_amount)
+claim835.service_lines.map(&:line_item_charge_amount)
 # ["3600", "1890", "1836", "1680"]
 ```
 

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

@@ -2,15 +2,10 @@ module ChangeHealth
   module Response
     module Claim
       class Report835Claim < ReportClaim
-        property :check_issue_or_eft_effective_date, required: false
-        property :check_or_eft_trace_number, required: false
         property :claim_payment_remark_codes, required: false
         property :patient_control_number, required: false
         property :payer_claim_control_number, required: false
-        property :payer_identifier, required: false
-        property :payment_method_code, required: false
         property :service_lines, required: false
-        property :total_actual_provider_payment_amount, required: false
         property :total_charge_amount, required: false
 
         def procedure_codes

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

@@ -7,14 +7,6 @@ module ChangeHealth
           @raw['transactions']
         end
 
-        def check_or_eft_trace_number
-          transactions&.first&.dig('paymentAndRemitReassociationDetails', 'checkOrEFTTraceNumber')
-        end
-
-        def check_issue_or_eft_effective_date
-          ChangeHealth::Models::PARSE_DATE.call(transactions&.first&.dig('financialInformation', 'checkIssueOrEFTEffectiveDate'))
-        end
-
         def payer_identification
           transactions&.first&.dig('payer', 'payerIdentificationNumber')
         end
@@ -24,34 +16,41 @@ module ChangeHealth
           transactions&.first&.dig('payer')&.dig('name')
         end
 
-        def payer_identifier
-          ChangeHealth::Models::PARSE_DATE.call(transactions&.first&.dig('financialInformation', 'payerIdentifier'))
-        end
-
-        def payment_method_code
-          transactions&.first&.dig('financialInformation', 'paymentMethodCode')
-        end
-
         def report_creation_date
-          ChangeHealth::Models::PARSE_DATE.call(transactions&.first&.dig('productionDate'))
+          payments.map(&:report_creation_date).min
         end
 
-        def total_actual_provider_payment_amount
-          transactions&.first&.dig('financialInformation', 'totalActualProviderPaymentAmount')
+        def claims
+          payments.flat_map(&:claims).compact
         end
 
-        def claims
-          report_claims = []
+        def payments
+          report_payments = []
 
           transactions&.each do |transaction|
-            transaction['detailInfo']&.each do |detail_info|
-              detail_info['paymentInfo']&.each do |payment_info|
+            check_or_eft_trace_number = transaction.dig('paymentAndRemitReassociationDetails', 'checkOrEFTTraceNumber')
+            check_issue_or_eft_effective_date =
+              ChangeHealth::Models::PARSE_DATE.call(
+                transaction.dig('financialInformation', 'checkIssueOrEFTEffectiveDate')
+              )
+            payer_identifier = transaction.dig('financialInformation', 'payerIdentifier')
+            payment_method_code = transaction.dig('financialInformation', 'paymentMethodCode')
+            report_creation_date = ChangeHealth::Models::PARSE_DATE.call(transaction.dig('productionDate'))
+            total_actual_provider_payment_amount =
+              transaction.dig('financialInformation', 'totalActualProviderPaymentAmount')
+            claims = transaction['detailInfo']&.flat_map do |detail_info|
+              detail_info['paymentInfo']&.map do |payment_info|
                 patient_control_number = payment_info.dig('claimPaymentInfo', 'patientControlNumber')
                 patient_first_name = payment_info.dig('patientName', 'firstName')
                 patient_last_name = payment_info.dig('patientName', 'lastName')
-                patient_member_id = payment_info.dig('patientName', 'memberId') || payment_info.dig('subscriber', 'memberId')
+                patient_member_id =
+                  payment_info.dig('patientName', 'memberId') ||
+                  payment_info.dig('subscriber', 'memberId')
                 payer_claim_control_number = payment_info.dig('claimPaymentInfo', 'payerClaimControlNumber')
-                service_provider_npi = payment_info.dig('renderingProvider', 'npi') || detail_info['providerSummaryInformation']['providerIdentifier']
+                service_provider_npi =
+                  payment_info.dig('renderingProvider', 'npi') ||
+                  detail_info.dig('providerSummaryInformation', 'providerIdentifier') ||
+                  transaction.dig('payee', 'npi')
                 total_charge_amount = payment_info.dig('claimPaymentInfo', 'totalClaimChargeAmount')
 
                 claim_payment_remark_codes = []
@@ -114,9 +113,7 @@ module ChangeHealth
                   )
                 end
 
-                report_claims << Report835Claim.new(
-                  check_issue_or_eft_effective_date: check_issue_or_eft_effective_date,
-                  check_or_eft_trace_number: check_or_eft_trace_number,
+                Report835Claim.new(
                   claim_payment_remark_codes: claim_payment_remark_codes,
                   patient_control_number: patient_control_number,
                   patient_first_name: patient_first_name,
@@ -124,23 +121,31 @@ module ChangeHealth
                   patient_member_id: patient_member_id,
                   payer_claim_control_number: payer_claim_control_number,
                   payer_identification: payer_identification,
-                  payer_identifier: payer_identifier,
                   payer_name: payer_name,
-                  payment_method_code: payment_method_code,
                   report_creation_date: report_creation_date,
                   report_name: report_name,
                   service_date_begin: service_date_begin,
                   service_date_end: service_date_end,
                   service_lines: service_lines,
                   service_provider_npi: service_provider_npi,
-                  total_actual_provider_payment_amount: total_actual_provider_payment_amount,
                   total_charge_amount: total_charge_amount
                 )
               end
             end
+            report_payments << Report835Payment.new(
+              check_issue_or_eft_effective_date: check_issue_or_eft_effective_date,
+              check_or_eft_trace_number: check_or_eft_trace_number,
+              claims: claims,
+              payer_identifier: payer_identifier,
+              payer_name: payer_name,
+              payment_method_code: payment_method_code,
+              report_creation_date: report_creation_date,
+              report_name: report_name,
+              total_actual_provider_payment_amount: total_actual_provider_payment_amount
+            )
           end
 
-          report_claims
+          report_payments
         end
       end
     end

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

@@ -0,0 +1,17 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report835Payment < Hashie::Trash
+        property :check_issue_or_eft_effective_date, required: false
+        property :check_or_eft_trace_number, required: false
+        property :claims, required: false
+        property :payer_identifier, required: false
+        property :payer_name, required: false
+        property :payment_method_code, required: false
+        property :report_creation_date, required: false
+        property :report_name, required: false
+        property :total_actual_provider_payment_amount, required: false
+      end
+    end
+  end
+end

data/lib/change_health/version.rb

@@ -1,3 +1,3 @@
 module ChangeHealth
-  VERSION = '3.5.3'.freeze
+  VERSION = '4.1.0'.freeze
 end

data/lib/change_health.rb

@@ -33,6 +33,7 @@ require 'change_health/response/claim/report/report_277_claim'
 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'
+require 'change_health/response/claim/report/report_835_payment'
 require 'change_health/response/claim/report/report_835_service_adjustment'
 require 'change_health/response/claim/report/report_835_service_line'
 require 'change_health/response/eligibility/eligibility_benefit'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: change_health
 version: !ruby/object:Gem::Version
-  version: 3.5.3
+  version: 4.1.0
 platform: ruby
 authors:
 - Mike Crockett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-05-18 00:00:00.000000000 Z
+date: 2022-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -169,6 +169,7 @@ files:
 - 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
+- lib/change_health/response/claim/report/report_835_payment.rb
 - lib/change_health/response/claim/report/report_835_service_adjustment.rb
 - lib/change_health/response/claim/report/report_835_service_line.rb
 - lib/change_health/response/claim/report/report_claim.rb