change_health 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 962d95245a21c89b96048449a0111165eee7b3a392f00a2f1cddf8924bf98150
-  data.tar.gz: 8b0127fb08968b20213728ffdc08afc0ae33a53a5d9c620efa916c8cc82f285f
+  metadata.gz: 8a1ce76c1da3af060d7c36a7a3f22c9e9bb1920b2db4f0f2cb9060ec777c1854
+  data.tar.gz: 2e4553b586e4bf8b13db083f423853708132a0686dac5ec27beea6223e740a0d
 SHA512:
-  metadata.gz: 0e64c195c18b7fb2cbaf028141af3eab9ab2fbecfeb0750c1d706f81c9b12502d747a8a6d765228a9f731aa7c653ba6023a476677419e307089cbc15e320e93f
-  data.tar.gz: 8c598d163710ae6d9f2a4a048d4f2697beb6f308eba526f3ca449962e920065a3a128f10769d38307fa7efaff3d13df7c4c57e16333dbc593bde48a99e745749
+  metadata.gz: c15e9b053bdbfbfca3700a3d95971517aa0c07654267cc704ce4d210cc264d6d1f9aab08ccad3c165a59b3d8d56fc82bf4be5c69f6c2155c1127fa4ee5fed5ea
+  data.tar.gz: 5a83d9c160bef86e5a296fea12335cc56cbac2959e1841e3f9382cee6b902586138be8e8e61328c0d3579afec5f904fa4712a9ccf8e8e7c89613e15ae663f668

data/CHANGELOG.md

@@ -4,6 +4,13 @@ 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).
 
+## [2.2.0] - [2021-11-04-21]
+### Added
+Ability to hit [Claim Responses and Reports](https://developers.changehealthcare.com/eligibilityandclaims/docs/claims-responses-and-reports-getting-started)
+* Report
+* ReportListData
+* ReportData
+
 ## [2.1.0] - [2021-10-12]
 ### Changed
 Model#to_h enhanced to change empty values AKA "" to nil. Reason: If a field is empty, Change Healthcare responds with an error - `Invalid value. Item must not be blank value.`. If the empty field is optional, Change Healthcare will accept the field as nil without error. If the empty field is required, Change Healthcare will return an error if the value is empty or nil.
@@ -167,6 +174,7 @@ Added the ability to hit professional claim submission API. For more details, se
 - Authentication
 - Configuration
 
+[2.2.0]: https://github.com/WeInfuse/change_health/compare/v2.1.0...v2.2.0
 [2.1.0]: https://github.com/WeInfuse/change_health/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/WeInfuse/change_health/compare/v1.0.3...v2.0.0
 [1.0.3]: https://github.com/WeInfuse/change_health/compare/v1.0.2...v1.0.3

data/README.md

@@ -83,10 +83,10 @@ true
 trading_partners = ChangeHealth::Request::TradingPartner.query("Aetna")
 
 trading_partners.first.name
-"Aetna"
+# "Aetna"
 
 trading_partners.first.service_id
-"ABC123"
+# "ABC123"
 ```
 
 ### Claim Submission
@@ -187,6 +187,29 @@ claim_submission = ChangeHealth::Request::Claim::Submission.new(
 claim_submission_data = claim_submission.submission
 ```
 
+### Claim Reports
+[Change Healthcare Claim Responses and Reports Guide](https://developers.changehealthcare.com/eligibilityandclaims/docs/claims-responses-and-reports-getting-started)
+```ruby
+ChangeHealth::Request::Claim::Report.ping # Test your connection
+
+report_list = ChangeHealth::Request::Claim::Report.report_list
+
+report_list.report_names
+# ["X3000000.XX", "R5000000.XY", "R5000000.XX", "X3000000.AB", "X3000000.AC", "X3000000.ZZ", "R5000000.XZ", "R5000000.YZ", "R5000000.WA", "R5000000.WB", "R5000000.WC"]
+
+report1_edi = ChangeHealth::Request::Claim::Report.get_report(report_list.report_names.first, as_json_report: false)
+# Report in edi format
+
+report1_json = ChangeHealth::Request::Claim::Report.get_report(report_list.report_names.first, as_json_report: true)
+# Report in json format
+
+reports_json = report_list.report_names.map {|report_name| ChangeHealth::Request::Claim::Report.get_report(report_name)}
+# all reports in json format
+
+reports_edi = report_list.report_names.map {|report_name| ChangeHealth::Request::Claim::Report.get_report(report_name, as_json_report: false)}
+# all reports in edi format
+```
+
 ### Configuration
 
 ```ruby

data/lib/change_health/models/error.rb

@@ -1,4 +1,5 @@
 module ChangeHealth
+  # TODO: This should be the response module/folder... next major release
   module Models
     class Error
       attr_reader :data

data/lib/change_health/request/report.rb

@@ -0,0 +1,39 @@
+module ChangeHealth
+  module Request
+    module Claim
+      class Report
+        ENDPOINT = '/medicalnetwork/reports/v2'.freeze
+        HEALTH_CHECK_ENDPOINT = ENDPOINT + '/healthcheck'.freeze
+
+        def self.report_list
+          ChangeHealth::Response::Claim::ReportListData.new(response: ChangeHealth::Connection.new.request(endpoint: ENDPOINT, verb: :get))
+        end
+
+        def self.get_report(report_name, as_json_report: true)
+          return if report_name.nil? || report_name.empty?
+
+          individual_report_endpoint = ENDPOINT + '/' + report_name
+          if as_json_report
+            # https://developers.changehealthcare.com/eligibilityandclaims/docs/what-file-types-does-this-api-get-from-the-mailbox
+            report_type = ChangeHealth::Response::Claim::ReportData.report_type(report_name)
+            return if report_type.nil?
+
+            individual_report_endpoint += '/' + report_type
+          end
+
+          ChangeHealth::Response::Claim::ReportData.new(report_name,
+                                                        as_json_report,
+                                                        response: ChangeHealth::Connection.new.request(endpoint: individual_report_endpoint, verb: :get))
+        end
+
+        def self.health_check
+          ChangeHealth::Connection.new.request(endpoint: HEALTH_CHECK_ENDPOINT, verb: :get)
+        end
+
+        def self.ping
+          self.health_check
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class ReportData < ChangeHealth::Response::ResponseData
+        attr_reader :report_name, :json
+        alias_method :json?, :json
+
+        def initialize(report_name, json, data: nil, response: nil)
+          super(data: data, response: response)
+          @report_name = report_name
+          @json = json
+        end
+
+        def edi?
+          !@json
+        end
+
+        def report_type
+          self.class.report_type(@report_name)
+        end
+
+        def self.report_type(report_name)
+          return '277' if is_277?(report_name)
+          return '835' if is_835?(report_name)
+        end
+
+        def is_277?
+          self.class.is_277?(@report_name)
+        end
+
+        def self.is_277?(report_name)
+          report_name.start_with?('X3')
+        end
+
+        def is_835?
+          self.class.is_835?(@report_name)
+        end
+
+        def self.is_835?(report_name)
+          report_name.start_with?('R5')
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class ReportListData < ChangeHealth::Response::ResponseData
+
+        def report_names
+          @raw.dig('reports')
+        end
+        
+      end
+    end
+  end
+end

data/lib/change_health/version.rb

@@ -1,3 +1,3 @@
 module ChangeHealth
-  VERSION = '2.1.0'.freeze
+  VERSION = '2.2.0'.freeze
 end

data/lib/change_health.rb

@@ -18,9 +18,12 @@ require 'change_health/models/eligibility/subscriber'
 require 'change_health/models/trading_partner/trading_partner'
 require 'change_health/request/eligibility'
 require 'change_health/request/submission'
+require 'change_health/request/report'
 require 'change_health/request/trading_partner'
 require 'change_health/response/response_data'
 require 'change_health/response/claim/submission/submission_data'
+require 'change_health/response/claim/report/report_list_data'
+require 'change_health/response/claim/report/report_data'
 require 'change_health/response/eligibility/eligibility_benefit'
 require 'change_health/response/eligibility/eligibility_benefits'
 require 'change_health/response/eligibility/eligibility_data'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: change_health
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Mike Crockett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-12 00:00:00.000000000 Z
+date: 2021-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -159,8 +159,11 @@ files:
 - lib/change_health/models/model.rb
 - lib/change_health/models/trading_partner/trading_partner.rb
 - lib/change_health/request/eligibility.rb
+- lib/change_health/request/report.rb
 - lib/change_health/request/submission.rb
 - lib/change_health/request/trading_partner.rb
+- lib/change_health/response/claim/report/report_data.rb
+- lib/change_health/response/claim/report/report_list_data.rb
 - lib/change_health/response/claim/submission/submission_data.rb
 - lib/change_health/response/eligibility/eligibility_benefit.rb
 - lib/change_health/response/eligibility/eligibility_benefits.rb