change_health 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 962d95245a21c89b96048449a0111165eee7b3a392f00a2f1cddf8924bf98150
-  data.tar.gz: 8b0127fb08968b20213728ffdc08afc0ae33a53a5d9c620efa916c8cc82f285f
+  metadata.gz: e0ce7d0b0648eeebabb95a1d8cbd2ddd81f778f5cea329f755b8734d754821e9
+  data.tar.gz: a81b263ebb9adc652ca914effc3b14ba047b429bb6a9ddff6faa89d73f9895fa
 SHA512:
-  metadata.gz: 0e64c195c18b7fb2cbaf028141af3eab9ab2fbecfeb0750c1d706f81c9b12502d747a8a6d765228a9f731aa7c653ba6023a476677419e307089cbc15e320e93f
-  data.tar.gz: 8c598d163710ae6d9f2a4a048d4f2697beb6f308eba526f3ca449962e920065a3a128f10769d38307fa7efaff3d13df7c4c57e16333dbc593bde48a99e745749
+  metadata.gz: d34f0ac2d23fe74bcc4674ff3c223ded869869bc62668578ead46a6dce495bce00cfd3d812d06faef795d8512eb59b93a492d0eeac627710bf73d8eec589ca6b
+  data.tar.gz: 24bcddfa9679442ece9d63a2ec3092f456394bb325a863bec29b8bc376d7052d0771b193572dc58610ee5a6c9b8f4cb64b28562fffa9adb039fcf057ca3d3502

data/CHANGELOG.md

@@ -4,11 +4,60 @@ 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.1.0] - [2021-10-12]
+## [3.0.0] - 2021-12-08
+### Added
+* Report277Claim - specific to claims from 277 reports
+* Report835Claim - specific to claims from 835 reports
+* Report835ServiceAdjustment & Report835ServiceLine - helper classes for readability of claims from 835 reports
+
+### Changed
+* ReportClaim - removed 277 report unique fields
+
+#### Namespace
+| Previous | Current |
+|-|-|
+| ChangeHealth::Models::Error | ChangeHealth::Response::Error |
+| ChangeHealth::Response::Claim::ReportInfoClaimStatus | ChangeHealth::Response::Claim::Report277InfoClaimStatus|
+
+#### Methods
+| Previous | Current |
+|-|-|
+| Report277Data#payer_org_name | Report277Data#payer_name |
+| ReportClaim#latest_total_charge_amount | ReportClaim#total_charge_amount |
+| ReportClaim#payer_org_name | ReportClaim#payer_name |
+| ReportClaim#service_begin_date | ReportClaim#service_date_begin |
+| ReportClaim#service_end_date | ReportClaim#service_date_end |
+| ReportClaim#subscriber_first_name | ReportClaim#patient_first_name |
+| ReportClaim#subscriber_last_name | ReportClaim#patient_last_name |
+| ReportClaim#transaction_set_creation_date | ReportClaim#report_creation_date |
+
+
+## [2.3.0] - 2021-11-18
+### Added
+* Report277Data & Report835Data - Specific classes for 277 & 835 reports
+* ReportClaim & ReportInfoClaimStatus - only works for json 277 reports
+
+### Fixed
+* Headers can now be nil for requests
+
+## [2.2.1] - 2021-11-15
+### Added
+Custom Headers for Reports API and Professional Claims API
+* Report
+* Submission
+
+## [2.2.0] - 2021-11-04
+### 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.
 
-## [2.0.0] - [2021-10-08]
+## [2.0.0] - 2021-10-08
 ### Added
 #### Models
 * ResponseData - for responses from calling change healthcare api used by EligibilityData and SubmissionData
@@ -39,50 +88,50 @@ Added the ability to hit professional claim submission API. For more details, se
 ### Fixed
  * Eligibility#add_dependent actually works
 
-## [1.0.3] - [2021-04-26]
+## [1.0.3] - 2021-04-26
 ### Added
 - Model::Error#represents_down? - adds ability to distinguish error representing down state
 - Model::Error#retryable? - retryable when down
 - EligibilityData#recommend_retry? - recommend retry when down
 
-## [1.0.2] - [2021-04-06]
+## [1.0.2] - 2021-04-06
 ### Added
 - EligibilityData#recommend_retry? - fix a bug in the search statement
 
-## [1.0.1] - [2021-03-24]
+## [1.0.1] - 2021-03-24
 ### Added
 - EligibilityData#plan_status - adds ability to select instead of find
 - EligibilityData#inactive? active? - use new plan_status select
 
-## [1.0.0] - [2021-03-17]
+## [1.0.0] - 2021-03-17
 ### Added
 - Model::Error - help with error codes
 - EligibilityData#recommend_retry? - if it looks like you can retry the exact same request
 - EligibilityData#inactive? - looks for plan status 6
 
-## [0.15.0] - [2020-06-12]
+## [0.15.0] - 2020-06-12
 ### Added
 - Extensions - InNetworkMissing for plans that don't provide in network indicators.
 
 ### Fixed
 - Bug where active codes with no service codes cause exception.
 
-## [0.14.0] - [2020-05-07]
+## [0.14.0] - 2020-05-07
 ### Added
 - Extensions - mixins for common overrides
 
-## [0.13.0] - [2020-05-05]
+## [0.13.0] - 2020-05-05
 ### Changed
 - Removed `alias_method` for `where` helpers so you can override a single method
 - Added type Year to Date type 24
 - Added type Day type 7
 
-## [0.12.0] - [2020-04-30]
+## [0.12.0] - 2020-04-30
 ### Added
 - EligibilityData#errors
 - EligibilityData#errors?
 
-## [0.11.0] - [2020-04-24]
+## [0.11.0] - 2020-04-24
 ### Added
 - EligibilityData#medicare?
 - EligibilityData#plan\_id
@@ -97,7 +146,7 @@ Added the ability to hit professional claim submission API. For more details, se
 - EligibilityData initialize now checks for sub-classes of EligibilityBenefits with trading partner responds to `factory` to choose sub-class
 - EligibilityBenefits initializes `self.class` type in case it's a subclass
 
-## [0.10.0] - [2020-04-09]
+## [0.10.0] - 2020-04-09
 ### Added
 - Add Trading Partner API querying capability
 - Request::TradingPartner
@@ -105,7 +154,7 @@ Added the ability to hit professional claim submission API. For more details, se
 - Response::TradingPartnersData
 - Models::TradingPartner
 
-## [0.9.0] - [2020-04-08]
+## [0.9.0] - 2020-04-08
 ### Added
 - Added EligibilityBenefit#medicare?
 - Added EligibilityData#medicare?
@@ -114,20 +163,20 @@ Added the ability to hit professional claim submission API. For more details, se
 - EligibilityBenefit(s)#individual returns true for medicare in benefit and queries that look for 'IND'
 - EligibilityBenefit(s)#in\_network returns true for medicare in benefit and queries that look for 'Y'
 
-## [0.8.0] - [2020-04-04]
+## [0.8.0] - 2020-04-04
 ### Changed
 - Attempt to serialize all properties with 'date' in the name to ChangeHealth date format
 
-## [0.7.0] - [2020-04-03]
+## [0.7.0] - 2020-04-03
 ### Changed
 - Fixed bug in serializing date on subscriber and encounter
 
-## [0.6.0] - [2020-04-02]
+## [0.6.0] - 2020-04-02
 ### Changed
 - Added Indifferent Access to hashes
 - Fixed bug with Authentication endpoint
 
-## [0.5.0] - [2020-03-11]
+## [0.5.0] - 2020-03-11
 ### Added
 - EligibilityBenefit Deductible information
 - EligibilityBenefit benefits date information
@@ -139,17 +188,17 @@ Added the ability to hit professional claim submission API. For more details, se
 ### Changed
 - Broke EligibilityBenefit and EligibilityBenefits into separate files
 
-## [0.4.0] - [2020-03-10]
+## [0.4.0] - 2020-03-10
 ### Added
 - EligibilityBenefit(s) Employee information
 - EligibilityData plan date information
 - EligibilityData eligibility, plan and service date helpers on date info
 
-## [0.3.0] - [2020-03-09]
+## [0.3.0] - 2020-03-09
 ### Added
 - Production endpoint
 
-## [0.0.2] - [2020-03-09]
+## [0.0.2] - 2020-03-09
 ### Added
 - EligibilityData
 - EligibilityBenefit
@@ -167,6 +216,10 @@ Added the ability to hit professional claim submission API. For more details, se
 - Authentication
 - Configuration
 
+[3.0.0]: https://github.com/WeInfuse/change_health/compare/v2.3.0...v3.0.0
+[2.3.0]: https://github.com/WeInfuse/change_health/compare/v2.2.1...v2.3.0
+[2.2.1]: https://github.com/WeInfuse/change_health/compare/v2.2.0...v2.2.1
+[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

@@ -1,9 +1,17 @@
 [![CircleCI](https://circleci.com/gh/WeInfuse/change_health.svg?style=svg)](https://circleci.com/gh/WeInfuse/change_health)
 
-# Change Health
+```
+   ____ _                              _   _            _ _   _     
+  / ___| |__   __ _ _ __   __ _  ___  | | | | ___  __ _| | |_| |__  
+ | |   | '_ \ / _` | '_ \ / _` |/ _ \ | |_| |/ _ \/ _` | | __| '_ \ 
+ | |___| | | | (_| | | | | (_| |  __/ |  _  |  __/ (_| | | |_| | | |
+  \____|_| |_|\__,_|_| |_|\__, |\___| |_| |_|\___|\__,_|_|\__|_| |_|
+                          |___/                                     
+```
+
 Ruby API wrapper for [Change Health](https://developers.changehealthcare.com/api)
 
-## Installation
+# Installation
 
 Add this line to your application's Gemfile:
 
@@ -19,13 +27,13 @@ Or install it yourself as:
 
     $ gem install change_health
 
-## Usage
+# Usage
 
-### Setup
+## Setup
 
 Make sure you're [configured](#configuration)!
 
-### Eligibility
+## Eligibility
 [Change Healthcare Eligibility Guide](https://developers.changehealthcare.com/eligibilityandclaims/docs)
 ```ruby
 ChangeHealth::Request::Eligibility.ping # Test your connection
@@ -39,7 +47,7 @@ edata = ChangeHealth::Request::Eligibility.new(tradingPartnerServiceId: '000050'
 edata.raw # Raw Hash of JSON response
 ```
 
-#### Benefit(s) objects
+### Benefit(s) objects
 Benefits extends Array and provides a query-like interface.
 
 Benefit extends Hash and provides helpers for single-benefit.
@@ -58,7 +66,7 @@ edata.benefits.where(name: 'Co-Payment', code: 'B', benefitAmount: '30) # Generi
 edata.benefits.find_by(name: 'Co-Payment', code: 'B', benefitAmount: '30) # Generic 'find_by' api returns first object found
 ```
 
-#### Response
+### Response
 
 Response is EligibilityData object
 
@@ -67,29 +75,29 @@ edata.response
 #<HTTParty::Response:0x7fa354c1fbe8>
 
 edata.response.ok?
-true
+# true
 
 edata.individual_oop_remaining(service_code: '30')
-1344.88
+# 1344.88
 
 edata.raw == edata.response.parsed_response
-true
+# true
 ```
 
-### Trading Partners
+## Trading Partners
 ```ruby
 # Query trading partners using a wildcard search
 # Returns Array of ChangeHealth::Models::TradingPartner Objects
 trading_partners = ChangeHealth::Request::TradingPartner.query("Aetna")
 
 trading_partners.first.name
-"Aetna"
+# "Aetna"
 
 trading_partners.first.service_id
-"ABC123"
+# "ABC123"
 ```
 
-### Claim Submission
+## Claim Submission
 [Change Healthcare Claim Submission Guide](https://developers.changehealthcare.com/eligibilityandclaims/docs/professional-claims-v3-getting-started)
 ```ruby
 ChangeHealth::Request::Claim::Submission.ping # Test your connection
@@ -174,6 +182,12 @@ claim_information = ChangeHealth::Models::Claim::ClaimInformation.new(
   service_lines: [service_line1, service_line2]
 )
 
+professional_headers = {
+  submitter_id: '111000',
+  biller_id: '000111',
+  username: '222333hey',
+  password: 'builder1'
+}
 
 claim_submission = ChangeHealth::Request::Claim::Submission.new(
   trading_partner_service_id: "9496",
@@ -181,29 +195,127 @@ claim_submission = ChangeHealth::Request::Claim::Submission.new(
   receiver: receiver,
   subscriber: subscriber,
   providers: [provider],
-  claim_information: claim_information
+  claim_information: claim_information,
+  headers: professional_headers
 )
 
 claim_submission_data = claim_submission.submission
+
+validation = claim_submission.validation
+```
+
+## Claim Reports
+[Change Healthcare Claim Responses and Reports Guide](https://developers.changehealthcare.com/eligibilityandclaims/docs/claims-responses-and-reports-getting-started)
+
+### Get Reports
+```ruby
+ChangeHealth::Request::Claim::Report.ping # Test your connection
+
+report_headers = {
+  username: '111000john',
+  password: 'WeInfuse1'
+}
+
+report_list = ChangeHealth::Request::Claim::Report.report_list(headers: report_headers)
+
+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"]
+
+report0_edi = ChangeHealth::Request::Claim::Report.get_report(report_list.report_names.first, as_json_report: false)
+# Report in edi format
+
+report0_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, headers: report_headers)}
+# 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, headers: report_headers)}
+# all reports in edi format
+```
+
+### Inspect Reports
+Currently only works for json 277 reports and json 835 reports. Not for EDI reports
+
+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)
+
+report_277_data.payer_name
+# "PREMERA"
+
+report_277_data.report_creation_date
+# Tue, 01 Dec 2020
+
+claim_277 = report_277_data.claims.first
+claim_277.payer_name
+# "PREMERA"
+
+claim_277.patient_first_name
+# "JOHNONE"
+
+claim_277.report_creation_date
+# Tue, 01 Dec 2020
+
+# Report 277 specific below
+claim_277.latest_status_category_codes
+# ["F1"]
+
+claim_277.total_charge_amount
+# "100"
+
+claim_277.procedure_codes
+# ["97161"]
+```
+
+#### Report 835
+
+```ruby
+report_835_data = ChangeHealth::Request::Claim::Report.get_report("R5000000.XY", as_json_report: true)
+
+report_835_data.payment_method_code
+# "ACH"
+
+report_835_data.total_actual_provider_payment_amount
+# "2563.13"
+
+claim_835 = report_835_data.claims.first
+claim_835.payer_name
+# "NATIONAL GOVERNMENT SERVICES, INC."
+
+claim_835.patient_first_name
+# "JANE"
+
+claim_835.report_creation_date
+# Wed, 22 Apr 2020
+
+claim_835.procedure_codes
+# ["21210", "21026", "21208", "30580"]
+
+claim_835.service_lines.map(&:line_item_charge_amount)
+# ["3600", "1890", "1836", "1680"]
 ```
 
-### Configuration
+## Configuration
 
 ```ruby
 ChangeHealth.configure do |c|
   c.client_id     = ENV['CHANGE_HEALTH_CLIENT_ID']
   c.client_secret = ENV['CHANGE_HEALTH_SECRET']
-  c.grant_type    = 'bob' # Defaults to client_credentials
-  c.api_endpoint  = 'http://hello.com' # Defaults to Change Health Sandbox endpoint
+  c.grant_type    = 'client_credentials' # Defaults to client_credentials
+  c.api_endpoint  = 'https://sandbox.apigw.changehealthcare.com' # Defaults to Change Health Sandbox endpoint
 end
 ```
 
-## Development
+# Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+# Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/WeInfuse/change\_health.

data/lib/change_health/connection.rb

@@ -13,11 +13,12 @@ module ChangeHealth
 
     format :json
 
-    def request(endpoint: , query: nil, body: nil, headers: {}, auth: true, verb: :post)
+    def request(endpoint:, query: nil, body: nil, headers: {}, auth: true, verb: :post)
       body    = body.to_json if body.is_a?(Hash)
+      headers = {} if headers.nil?
       headers = auth_header.merge(headers) if auth
 
-      self.class.send("#{verb}", endpoint, query: query, body: body, headers: headers)
+      self.class.send(verb.to_s, endpoint, query: query, body: body, headers: headers)
     end
 
     private
@@ -25,7 +26,7 @@ module ChangeHealth
     def auth_header
       @auth ||= Authentication.new
 
-      return @auth.authenticate.access_header
+      @auth.authenticate.access_header
     end
   end
 end

data/lib/change_health/request/report.rb

@@ -0,0 +1,60 @@
+module ChangeHealth
+  module Request
+    module Claim
+      class Report
+        ENDPOINT = '/medicalnetwork/reports/v2'.freeze
+        HEALTH_CHECK_ENDPOINT = ENDPOINT + '/healthcheck'.freeze
+
+        def self.report_list(headers: nil)
+          final_headers = ChangeHealth::Request::Claim::Report.report_headers(headers)
+          ChangeHealth::Response::Claim::ReportListData.new(response: ChangeHealth::Connection.new.request(endpoint: ENDPOINT, verb: :get, headers: final_headers))
+        end
+
+        def self.get_report(report_name, as_json_report: true, headers: nil)
+          return if report_name.nil? || report_name.empty?
+          final_headers =  ChangeHealth::Request::Claim::Report.report_headers(headers)
+
+          report_type = ChangeHealth::Response::Claim::ReportData.report_type(report_name)
+          return if report_type.nil?
+
+          individual_report_endpoint = ENDPOINT + '/' + report_name
+
+          # https://developers.changehealthcare.com/eligibilityandclaims/docs/what-file-types-does-this-api-get-from-the-mailbox
+          individual_report_endpoint += '/' + report_type if as_json_report
+
+          response = ChangeHealth::Connection.new.request(endpoint: individual_report_endpoint, verb: :get, headers: final_headers)
+          if ChangeHealth::Response::Claim::ReportData.is_277?(report_name)
+            ChangeHealth::Response::Claim::Report277Data
+              .new(report_name,
+                   as_json_report,
+                   response: response)
+          else
+            ChangeHealth::Response::Claim::Report835Data
+              .new(report_name,
+                   as_json_report,
+                   response: response)
+          end
+        end
+
+        def self.health_check
+          ChangeHealth::Connection.new.request(endpoint: HEALTH_CHECK_ENDPOINT, verb: :get)
+        end
+
+        def self.ping
+          self.health_check
+        end
+
+        def self.report_headers(headers)
+          if headers
+            extra_headers = {}
+            extra_headers["X-CHC-Reports-Username"] = headers[:username]
+            extra_headers["X-CHC-Reports-Password"] = headers[:password]
+            extra_headers
+          else
+            nil
+          end
+        end
+      end
+    end
+  end
+end

data/lib/change_health/request/submission.rb

@@ -2,9 +2,11 @@ module ChangeHealth
   module Request
     module Claim
       class Submission < Hashie::Trash
+        
         ENDPOINT = '/medicalnetwork/professionalclaims/v3'.freeze
         HEALTH_CHECK_ENDPOINT = ENDPOINT + '/healthcheck'.freeze
         SUBMISSION_ENDPOINT = ENDPOINT + '/submission'.freeze
+        VALIDATION_ENDPOINT = ENDPOINT + '/validation'.freeze
 
         property :claimInformation, from: :claim_information, required: false
         property :controlNumber, from: :control_number, required: true, default: ChangeHealth::Models::CONTROL_NUMBER
@@ -12,6 +14,7 @@ module ChangeHealth
         property :receiver, required: false
         property :submitter, required: false
         property :subscriber, required: false
+        property :headers, required: false
         # Need one or the other, trading partner id or trading partner service id
         property :tradingPartnerId, from: :trading_partner_id, required: false
         property :tradingPartnerServiceId, from: :trading_partner_service_id, required: false
@@ -22,7 +25,11 @@ module ChangeHealth
         end
 
         def submission
-          ChangeHealth::Response::Claim::SubmissionData.new(response: ChangeHealth::Connection.new.request(endpoint: SUBMISSION_ENDPOINT, body: self.to_h))
+          ChangeHealth::Response::Claim::SubmissionData.new(response: ChangeHealth::Connection.new.request(endpoint: SUBMISSION_ENDPOINT, body: self.to_h, headers: professional_headers))
+        end
+
+        def validation
+          ChangeHealth::Response::Claim::SubmissionData.new(response: ChangeHealth::Connection.new.request(endpoint: VALIDATION_ENDPOINT, body: self.to_h, headers: professional_headers))
         end
 
         def self.health_check
@@ -32,6 +39,19 @@ module ChangeHealth
         def self.ping
           self.health_check
         end
+
+        def professional_headers
+          if self[:headers]
+            extra_headers = {}
+            extra_headers["X-CHC-ClaimSubmission-SubmitterId"] = self[:headers][:submitter_id]
+            extra_headers["X-CHC-ClaimSubmission-BillerId"] = self[:headers][:biller_id]
+            extra_headers["X-CHC-ClaimSubmission-Username"] = self[:headers][:username]
+            extra_headers["X-CHC-ClaimSubmission-Pwd"] = self[:headers][:password]
+            extra_headers
+          else
+            nil
+          end
+        end
       end
     end
   end

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

@@ -0,0 +1,40 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report277Claim < ReportClaim
+        property :info_claim_statuses, required: false
+        property :procedure_codes, required: false
+
+        def add_info_claim_status(info_claim_status)
+          self[:info_claim_statuses] ||= []
+          self[:info_claim_statuses] << info_claim_status
+        end
+
+        def add_procedure_code(procedure_code)
+          self[:procedure_codes] ||= []
+          self[:procedure_codes] << procedure_code
+        end
+
+        def latest_status_category_codes
+          latest_info_claim_status&.status_category_codes
+        end
+
+        def total_charge_amount
+          latest_info_claim_status&.total_charge_amount
+        end
+
+        def latest_status_info_effective_date
+          latest_info_claim_status&.status_information_effective_date
+        end
+
+        def latest_info_claim_status
+          info_claim_statuses&.select do |info|
+            !info.status_information_effective_date.nil? &&
+              info.status_information_effective_date.is_a?(Date) &&
+              info.status_information_effective_date <= Date.today
+          end&.max_by(&:status_information_effective_date)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,84 @@
+module ChangeHealth
+  module Response
+    module Claim
+      # Methods only return meaningful data for json reports
+      class Report277Data < ChangeHealth::Response::Claim::ReportData
+        def transactions
+          @raw['transactions']
+        end
+
+        # Only one payer per report
+        def payer_name
+          transactions&.first&.dig('payers')&.first&.dig('organizationName')
+        end
+
+        def report_creation_date
+          ChangeHealth::Models::PARSE_DATE.call(transactions&.first&.dig('transactionSetCreationDate'))
+        end
+
+        def claims
+          report_claims = []
+
+          transactions&.each do |transaction|
+            report_creation_date = ChangeHealth::Models::PARSE_DATE.call(transaction['transactionSetCreationDate'])
+            transaction['payers']&.each do |payer|
+              payer_identification = payer['payerIdentification']
+              payer_name = payer['organizationName']
+              payer['claimStatusTransactions']&.each do |claim_status_txn|
+                claim_status_txn['claimStatusDetails']&.each do |claim_status_detail|
+                  service_provider_npi = claim_status_detail.dig('serviceProvider', 'npi')
+                  claim_status_detail['patientClaimStatusDetails']&.each do |patient_claim_status_detail|
+                    patient_first_name = patient_claim_status_detail.dig('subscriber', 'firstName')
+                    patient_last_name = patient_claim_status_detail.dig('subscriber', 'lastName')
+                    patient_claim_status_detail['claims']&.each do |claim|
+                      procedure_codes = []
+                      claim['serviceLines']&.each do |service_line|
+                        procedure_codes << service_line.dig('service', 'procedureCode')
+                      end
+                      claim_status = claim['claimStatus']
+                      next if claim_status.nil?
+
+                      service_date_begin = ChangeHealth::Models::PARSE_DATE.call(claim_status['claimServiceBeginDate'] || claim_status['claimServiceDate'])
+                      service_date_end = ChangeHealth::Models::PARSE_DATE.call(claim_status['claimServiceEndDate'] || claim_status['claimServiceDate'])
+
+                      info_claim_statuses = []
+                      claim_status['informationClaimStatuses']&.each do |info_claim_status|
+                        status_information_effective_date = ChangeHealth::Models::PARSE_DATE.call(info_claim_status['statusInformationEffectiveDate'])
+                        total_charge_amount = info_claim_status['totalClaimChargeAmount']
+
+                        status_category_codes = []
+                        info_claim_status['informationStatuses']&.each do |info_status|
+                          status_category_codes << info_status['healthCareClaimStatusCategoryCode']
+                        end
+
+                        info_claim_statuses << Report277InfoClaimStatus.new(
+                          status_category_codes: status_category_codes,
+                          total_charge_amount: total_charge_amount,
+                          status_information_effective_date: status_information_effective_date
+                        )
+                      end
+                      report_claims << Report277Claim.new(
+                        info_claim_statuses: info_claim_statuses,
+                        patient_first_name: patient_first_name,
+                        patient_last_name: patient_last_name,
+                        payer_identification: payer_identification,
+                        payer_name: payer_name,
+                        procedure_codes: procedure_codes,
+                        report_creation_date: report_creation_date,
+                        service_date_begin: service_date_begin,
+                        service_date_end: service_date_end,
+                        service_provider_npi: service_provider_npi
+                      )
+                    end
+                  end
+                end
+              end
+            end
+          end
+
+          report_claims
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report277InfoClaimStatus < Hashie::Trash
+        property :status_category_codes, 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
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report835Claim < ReportClaim
+        property :payer_claim_control_number, 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
+          service_lines&.map(&:adjudicated_procedure_code)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,116 @@
+module ChangeHealth
+  module Response
+    module Claim
+      # Methods only return meaningful data for json reports
+      class Report835Data < ChangeHealth::Response::Claim::ReportData
+        def transactions
+          @raw['transactions']
+        end
+
+        # Only one payer per report
+        def payer_name
+          transactions&.first&.dig('payer')&.dig('name')
+        end
+
+        def payment_method_code
+          transactions&.first&.dig('financialInformation', 'paymentMethodCode')
+        end
+
+        def report_creation_date
+          ChangeHealth::Models::PARSE_DATE.call(transactions&.first&.dig('productionDate'))
+        end
+
+        def total_actual_provider_payment_amount
+          transactions&.first&.dig('financialInformation', 'totalActualProviderPaymentAmount')
+        end
+
+        def claims
+          report_claims = []
+
+          transactions&.each do |transaction|
+            payment_method_code = transaction.dig('financialInformation', 'paymentMethodCode')
+            payer_name = transaction.dig('payer', 'name')
+            payer_identification = transaction.dig('payer', 'payerIdentificationNumber')
+            report_creation_date = ChangeHealth::Models::PARSE_DATE.call(transaction['productionDate'])
+            total_actual_provider_payment_amount = transaction.dig('financialInformation',
+                                                                   'totalActualProviderPaymentAmount')
+
+            transaction['detailInfo']&.each do |detail_info|
+              detail_info['paymentInfo']&.each do |payment_info|
+                patient_first_name = payment_info.dig('patientName', 'firstName')
+                patient_last_name = payment_info.dig('patientName', 'lastName')
+                service_provider_npi = payment_info.dig('renderingProvider', 'npi')
+                total_charge_amount = payment_info.dig('claimPaymentInfo', 'totalClaimChargeAmount')
+                payer_claim_control_number = payment_info.dig('claimPaymentInfo', 'payerClaimControlNumber')
+
+                service_date_begin = nil
+                service_date_end = nil
+                service_lines = []
+                payment_info['serviceLines']&.each do |service_line|
+                  service_line_date = ChangeHealth::Models::PARSE_DATE.call(service_line['serviceDate'])
+                  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
+
+                  adjudicated_procedure_code = service_line.dig('servicePaymentInformation', 'adjudicatedProcedureCode')
+                  allowed_actual = service_line.dig('serviceSupplementalAmounts', 'allowedActual')
+                  line_item_charge_amount = service_line.dig('servicePaymentInformation', 'lineItemChargeAmount')
+                  line_item_provider_payment_amount = service_line.dig('servicePaymentInformation',
+                                                                       'lineItemProviderPaymentAmount')
+
+                  service_adjustments = []
+                  service_line['serviceAdjustments']&.each do |service_adjustment|
+                    adjustments = {}
+                    # - 2 b/c group code & value, / 2 b/c come in pairs
+                    num_adjustments = (service_adjustment.keys.size - 2) / 2
+                    (1..num_adjustments).each do |index|
+                      adjustment_reason = service_adjustment["adjustmentReasonCode#{index}"]
+                      adjustment_amount = service_adjustment["adjustmentAmount#{index}"]
+                      adjustments[adjustment_reason] = adjustment_amount
+                    end
+
+                    claim_adjustment_group_code = service_adjustment['claimAdjustmentGroupCode']
+
+                    service_adjustments << Report835ServiceAdjustment.new(
+                      adjustments: adjustments,
+                      claim_adjustment_group_code: claim_adjustment_group_code
+                    )
+                  end
+
+                  service_lines << Report835ServiceLine.new(
+                    adjudicated_procedure_code: adjudicated_procedure_code,
+                    allowed_actual: allowed_actual,
+                    line_item_charge_amount: line_item_charge_amount,
+                    line_item_provider_payment_amount: line_item_provider_payment_amount,
+                    service_adjustments: service_adjustments
+                  )
+                end
+
+                report_claims << Report835Claim.new(
+                  patient_first_name: patient_first_name,
+                  patient_last_name: patient_last_name,
+                  payer_claim_control_number: payer_claim_control_number,
+                  payer_identification: payer_identification,
+                  payer_name: payer_name,
+                  payment_method_code: payment_method_code,
+                  report_creation_date: report_creation_date,
+                  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
+          end
+
+          report_claims
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report835ServiceAdjustment < Hashie::Trash
+        property :adjustments, required: false
+        property :claim_adjustment_group_code, required: false
+
+        def add_adjustment(adjustment)
+          self[:adjustments] ||= []
+          self[:adjustments] << adjustment
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class Report835ServiceLine < Hashie::Trash
+        property :adjudicated_procedure_code, required: false
+        property :allowed_actual, required: false
+        property :line_item_charge_amount, required: false
+        property :line_item_provider_payment_amount, required: false
+        property :service_adjustments, required: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module ChangeHealth
+  module Response
+    module Claim
+      class ReportClaim < Hashie::Trash
+        property :patient_first_name, required: false
+        property :patient_last_name, required: false
+        property :payer_identification, required: false
+        property :payer_name, required: false
+        property :report_creation_date, required: false
+        property :service_date_begin, required: false
+        property :service_date_end, required: false
+        property :service_provider_npi, required: false
+      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/{models → response}/error.rb

@@ -1,12 +1,12 @@
 module ChangeHealth
-  module Models
+  module Response
     class Error
       attr_reader :data
 
       SIMPLE_RETRY_CODES = %w[
-            42
-            80
-          ].freeze
+        42
+        80
+      ].freeze
 
       NO_RESUBMIT_MESSAGES = [
         'resubmission not allowed',
@@ -39,7 +39,9 @@ module ChangeHealth
 
       def retryable?
         represents_down? ||
-          (code? && SIMPLE_RETRY_CODES.include?(code) && followupAction? && NO_RESUBMIT_MESSAGES.none? {|msg| followupAction.downcase.include?(msg) })
+          (code? && SIMPLE_RETRY_CODES.include?(code) && followupAction? && NO_RESUBMIT_MESSAGES.none? do |msg|
+             followupAction.downcase.include?(msg)
+           end)
       end
 
       %w[field description code followupAction location].each do |method_name|
@@ -47,7 +49,7 @@ module ChangeHealth
           false == send(method_name).nil?
         end
 
-        define_method("#{method_name}") do
+        define_method(method_name.to_s) do
           @data[method_name]
         end
       end

data/lib/change_health/response/response_data.rb

@@ -16,13 +16,13 @@ module ChangeHealth
       end
 
       def errors?
-        self.errors.is_a?(Array) && false == self.errors.empty?
+        errors.is_a?(Array) && false == errors.empty?
       end
 
       def errors
         errors = @raw.dig('errors') || []
 
-        errors.flatten.map {|error| ChangeHealth::Models::Error.new(error) }
+        errors.flatten.map { |error| ChangeHealth::Response::Error.new(error) }
       end
 
       def recommend_retry?
@@ -34,7 +34,7 @@ module ChangeHealth
 
         return false if error_codes.empty?
 
-        return error_codes.all?(&:retryable?)
+        error_codes.all?(&:retryable?)
       end
     end
   end

data/lib/change_health/version.rb

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

data/lib/change_health.rb

@@ -5,7 +5,6 @@ require 'change_health/authentication'
 require 'change_health/change_health_exception'
 require 'change_health/connection'
 require 'change_health/extensions'
-require 'change_health/models/error'
 require 'change_health/models/model'
 require 'change_health/models/claim/submission/claim_information'
 require 'change_health/models/claim/submission/provider'
@@ -18,9 +17,21 @@ 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/error'
 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/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_claim_status'
+require 'change_health/response/claim/report/report_835_claim'
+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'
 require 'change_health/response/eligibility/eligibility_benefits'
 require 'change_health/response/eligibility/eligibility_data'
@@ -42,11 +53,11 @@ module ChangeHealth
     end
 
     def api_endpoint
-      return Connection.base_uri
+      Connection.base_uri
     end
 
     def to_h
-      return {
+      {
         client_id: @client_id,
         client_secret: @client_secret,
         grant_type: @grant_type,
@@ -60,7 +71,7 @@ module ChangeHealth
       self.grant_type    = h[:grant_type]
       self.api_endpoint  = h[:api_endpoint]
 
-      return self
+      self
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: change_health
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Mike Crockett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-12 00:00:00.000000000 Z
+date: 2021-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -155,16 +155,27 @@ files:
 - lib/change_health/models/eligibility/encounter.rb
 - lib/change_health/models/eligibility/provider.rb
 - lib/change_health/models/eligibility/subscriber.rb
-- lib/change_health/models/error.rb
 - 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_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_835_claim.rb
+- lib/change_health/response/claim/report/report_835_data.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
+- 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
 - lib/change_health/response/eligibility/eligibility_data.rb
+- lib/change_health/response/error.rb
 - lib/change_health/response/response_data.rb
 - lib/change_health/response/trading_partner/trading_partner_data.rb
 - lib/change_health/response/trading_partner/trading_partners_data.rb