trizetto-api 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60c7ed11ee2e04e48734c1e3b557c9e904d2e268
-  data.tar.gz: 3b35cbee1b0e2ffb45ae3e9533ec546983f4d130
+  metadata.gz: b3d7816b2c859d5c94ed3433e86421c54a8c2fca
+  data.tar.gz: 1d932011c08b984fc4fc260cdf57165aedfc29df
 SHA512:
-  metadata.gz: 2471cf69c92ddac9b6b47d0d41c7dd8e020f7374418b9c08e2034907f783071ed052e45829c7fa3989c4ab5b6b32c1ea476d170de250868c2a7c995e602c4c91
-  data.tar.gz: 4888af1330a52c70b84535c44ae4c912866482109b5e853858390d1d156bf8236bcfd1ef3b4bc27ab5912a74d0c215daee47cd1ff644c8db253d3f24032f5df8
+  metadata.gz: d5ef664108b8e07fbe0e343a4cb840bf651f27706f15e528c70b1ce60077b65bacada2d2410c9ba49f1ae3366566a918f7d7d07291b1a33d740089e5c66dd288
+  data.tar.gz: db5f856514b0c8e4e850ba31e6b4fc5bf81ca4c97b778bedb7605f73a7c277defe46849a02d071fc70521ff952a0047841b4ff5031e79f9450ebce975720ee8e

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.2.2 (January 19, 2018) ##
+
+* The response from the DoInquiry eligiblity check now captures the raw XML and
+  can be recreated from stored XML.
+* Traces are available as part of the DoInquiry eligibility response.  Trizetto
+  adds a trace_id ("99Trizetto") and a trace_number to each request that can be
+  provided to them later as part of a support request.  The payer may also add
+  a trace which is available also.
+
 ## 0.2.1 (January 18, 2018) ##
 
 * Sets required minimum version for ruby to 2.3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trizetto-api (0.2.0)
+    trizetto-api (0.2.1)
       savon (~> 2.0)
       savon-multipart (~> 2.0)
 
@@ -43,12 +43,12 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.7.0)
     rspec-support (3.7.0)
-    savon (2.11.2)
+    savon (2.12.0)
       akami (~> 1.2)
       builder (>= 2.1.2)
       gyoku (~> 1.2)
       httpi (~> 2.3)
-      nokogiri (>= 1.4.0)
+      nokogiri (>= 1.8.1)
       nori (~> 2.4)
       wasabi (~> 3.4)
     savon-multipart (2.1.1)
@@ -67,7 +67,7 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 1.16)
-  byebug (>= 9.0)
+  byebug (~> 9.0)
   rake (~> 10.0)
   rspec (~> 3.0)
   trizetto-api!

data/README.md

@@ -8,10 +8,27 @@ Ruby wrapper for Trizetto APIs for Ruby 2.3 and above.
 
 <b>Requires Ruby 2.3 or above</b>
 
-Add this line to your application's Gemfile:
+Add this line, and maybe some others, to your application's Gemfile:
 
 ```ruby
 gem 'trizetto-api'
+
+# Savon-multipart is used in the CORE II API. savon-multipart 2.1.1 has the
+# mail gem, pinned to exactly 2.5.4.  As of Jan 18, 2018, there is an
+# unreleased version that uses ~> 2.6.  Depending on your existing gems
+# you may need to add an explicit dependency on savon-multipart if bundle
+# install fails with a mail gem dependency.
+#
+# You can savon-multipart, or use git diretly with one of the below
+#
+# savon-multipart as of Jan 18, 2018:
+# gem 'savon-multipart', git: "git@github.com:savonrb/savon-multipart.git", ref: 'd9a138b6c166cd7c30c28e8888ff19011f8ec071'
+#
+# live on the edge
+# gem 'savon-multipart', git: "git@github.com:savonrb/savon-multipart.git", branch: :master
+#
+# Your fork?
+# gem 'savon-multipart', git: "git@github.com:YOU/savon-multipart.git"
 ```
 
 And then execute:
@@ -22,9 +39,9 @@ Or install it yourself as:
 
     $ gem install trizetto-api
 
-
 ## Usage
 
+
 ### Use the Eligibility Web Service with an XML payload to check eligibility in realtime
 
 This uses name/value pairs in a request and returns an XML docunment as a response.
@@ -32,9 +49,8 @@ This uses name/value pairs in a request and returns an XML docunment as a respon
 To simply check if the patient is covered by a health plan
 
 ```ruby
-GENERAL_HEALTH_PLAN_COVERAGE_CODE = "30"
 response = client.do_inquiry({...})
-response.active_coverage_for?(GENERAL_HEALTH_PLAN_COVERAGE_CODE)  #=> true | false
+response.active_coverage_for?("30`")  #=> true | false
 ```
 
 ```ruby
@@ -53,7 +69,7 @@ client = Trizetto::Api::Eligibility::WebService::Client.new({
 })
 
 response = client.do_inquiry({
-  'ProviderLastName': 'BLUE CROSS BLUE SHIELD OF MASSACHUSETTS',
+  'ProviderLastName': 'YOUR_COMPANY_NAME',
   'NPI':              'YOUR NPI HERE',
   'InsuredFirstName': 'Mickey',
   'InsuredLastName':  'Mouse',
@@ -72,6 +88,7 @@ response.errors.validation_failures.first.message          # => "Please enter In
 response.success?                   # => true
 response.success_code               # => "Success"
 response.transaction_id             # => "c6eb40c5584f0496be3f3a48d0ddfd"
+response.trace_number               # => "88213481"
 response.payer_name                 # => "BLUE CROSS BLUE SHIELD OF MASSACHUSETTS"
 response.active_coverage_for?("30") # => true
 

data/lib/trizetto/api/eligibility/web_service.rb

@@ -116,16 +116,15 @@ module Trizetto
           #
           # @return DoInquiryResponse
           def do_inquiry(parameters={})
-            DoInquiryResponse.new(
-              @client.call( :do_inquiry, message: { 'Inquiry': {
-                'ResponseDataType': 'Xml',
-                'Parameters': {
-                  'MyNameValue': parameters.map { |name, value|
-                     {'Name': name, 'Value': value}
-                   }
-                }
-              }})
-            )
+            savon_response = @client.call( :do_inquiry, message: { 'Inquiry': {
+              'ResponseDataType': 'Xml',
+              'Parameters': {
+                'MyNameValue': parameters.map { |name, value|
+                   {'Name': name, 'Value': value}
+                 }
+              }
+            }})
+            DoInquiryResponse.new(savon_response.body, savon_response.to_xml)
           end
 
           alias_method :check_eligibility, :do_inquiry

data/lib/trizetto/api/eligibility/web_service/do_inquiry_response.rb

@@ -64,9 +64,42 @@ module Trizetto
           # @see InfoReceiver
           attr_accessor :info_receiver
 
+          # The full XML response from Trizetto if it was provided.
+          attr_accessor :raw_xml
 
-          def initialize(response)
-            response = response.to_hash.dig(:do_inquiry_response, :do_inquiry_result) || {}
+          # Parses the SOAP response from a DoInquiry request into ruby objects
+          #
+          # *Example*
+          #
+          #    DoInquiryResponse.new({
+          #       do_inquiry_response: {
+          #         do_inquiry_result: {
+          #           success_code: "Success",
+          #           response_as_xml: "...",
+          #           extra_processing_info: { ... }
+          #         }
+          #       }
+          #    })
+          #
+          # *Example*
+          #
+          #    client = Savon.client.new(...)
+          #    savon_response = client.call( :do_inquiry, message: {...} )
+          #    DoInquiryResponse.new(savon_response.body, savon_response.to_xml)
+          #
+          # *Example*
+          #
+          #    parser = Nori.new(convert_tags_to: lambda { |tag| tag.snakecase.to_sym })
+          #    raw_xml = File.read( xml_saved_on_disk_path )
+          #    body = parser.parse(raw_xml).dig(:"soap:envelope", :"soap:body")
+          #    DoInquiryResponse.new(body, raw_xml)
+          #
+          # @param body [Hash] the body of the SOAP request.
+          # @param xml [string] the raw XML of the SOAP request including the envelope
+          def initialize(body, xml = nil)
+            self.raw_xml = xml
+
+            response = body.dig(:do_inquiry_response, :do_inquiry_result) || {}
 
             self.success_code    = response[:success_code]
             self.response_as_xml = response[:response_as_xml]
@@ -161,6 +194,22 @@ module Trizetto
               benefit.active_coverage? && benefit.service_type_codes.include?(service_type_code.to_s)
             end)
           end
+
+          # Trizetto adds a trace number to the subscriber or dependent that can
+          # be given to them later as part of a support request.  Additionally
+          # the payer may add a trace.  All the traces are available through
+          # `patient.traces`
+          #
+          # <b>Example</b>
+          #
+          #   response.trace_number               # => "81238881"
+          #   response.trace_number('99Trizetto') # => "81238881"
+          #   response.traces                     # => {"99TRIZETTO": "81238881"}
+          #
+          # @return [String] - a number that can be given to support for help with this request
+          def trace_number(trace_id="99Trizetto")
+            patient&.trace_number(trace_id)
+          end
         end
       end
     end

data/lib/trizetto/api/eligibility/web_service/node.rb

@@ -8,6 +8,8 @@ module Trizetto
         # Base class for parsed reponses in the eligibility response.
         class Node < OpenStruct
           def initialize(raw_hash = {})
+            raw_hash ||= {} # handle <Node/> tags - the hash comes through, but its nil
+
             required_keys = self.class.constants.include?(:REQUIRED_KEYS) ? self.class::REQUIRED_KEYS : {}
             clean_hash = required_keys.merge(raw_hash)
 

data/lib/trizetto/api/eligibility/web_service/patient.rb

@@ -11,15 +11,29 @@ module Trizetto
           attr_accessor :name
 
           # The benefits this patient has.
-          #
           attr_accessor :benefits
 
+          # The traces, by source (uppercased), in the response
+          #
+          # *Example*
+          #
+          #   patient.traces  # => {"99TRIZETTO" => "812341292"}
+          #
+          # *Example*
+          #
+          #   patient.trace_number("99TRIZETTO")  # => "812341292"
+          #   patient.trace_number("99Trizeeto")  # => "812341292"
+          attr_accessor :traces
+
           KEY_CLEANUP = {
             :patientid => :id
           }
 
           def initialize(raw_hash = {})
+            trace_ids, trace_numbers = Array(raw_hash.delete(:trace_id)), Array(raw_hash.delete(:trace_number))
+
             super(raw_hash)
+
             self.name = PatientName.new(raw_hash[:patientname]) if raw_hash.has_key?(:patientname)
 
             benefits_xml = raw_hash[:benefit] || []
@@ -28,6 +42,20 @@ module Trizetto
             self.benefits = benefits_xml.map do |benefit_xml|
               Benefit.new(benefit_xml)
             end
+
+            self.traces = {}
+            if trace_ids.length == trace_numbers.length
+              trace_ids.each.with_index do |id, index|
+                traces[id.upcase] = trace_numbers[index]
+              end
+            end
+          end
+
+          # Looks for a trace number by trace_id (who added the trace).
+          #
+          # @return [String]
+          def trace_number(trace_id="99Trizetto")
+            self.traces[trace_id&.upcase]
           end
         end
       end

data/lib/trizetto/api/eligibility/web_service/subscriber.rb

@@ -22,7 +22,6 @@ module Trizetto
                 end
               end
             end
-
             super(clean_hash)
           end
         end

data/lib/trizetto/api/version.rb

@@ -1,5 +1,5 @@
 module Trizetto
   module Api
-    VERSION = "0.2.1"
+    VERSION = "0.2.2"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trizetto-api
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - John Naegle
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-01-18 00:00:00.000000000 Z
+date: 2018-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler