trizetto-api 0.1.2 → 0.2.1

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

@@ -0,0 +1,50 @@
+module Trizetto
+  module Api
+    module Eligibility
+      module WebService
+
+        # The <PatientName> in either a Subscriber or Dependent
+        #
+        # <b>XML Example</b>
+        #
+        #   <patientname>
+        #     <first>Derek</first>
+        #     <middle>D</middle>
+        #     <last>Walter</last>
+        #     <patientaddress>1634 Maverick Glen</patientaddress>
+        #     <patientcity>Starkbury</patientcity>
+        #     <patientstate>IA</patientstate>
+        #     <patientzip>38592</patientzip>
+        #   </patientname>
+        #
+        # <b>Example</b>
+        #
+        #   patient = Patient.new(patientname: {first: 'Derek', last: 'Walter', patientaddress: '1634 Maverick Glen'})
+        #   patient.name.first   # => Derek
+        #   patient.name.last    # => Walter
+        #   patient.name.address # => 1634 Maverick Glen
+        #
+        class PatientName < Node
+          REQUIRED_KEYS =
+          {
+            first: '',
+            last:  '',
+          }
+
+          KEY_CLEANUP =
+          {
+            patientaddress:  :address,
+            patientaddress2: :address_2,
+            patientcity:     :city,
+            patientstate:    :state,
+            patientzip:      :zip
+          }
+
+          def initialize(raw_hash = {})
+            super(raw_hash)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+module Trizetto
+  module Api
+    module Eligibility
+      module WebService
+
+        # Rejections appear in a few places in the eligibility response.
+        # Any node that can have a rejection should prepend this module
+        #
+        # *Example*
+        #  class InfoReciever < Node
+        #    prepend Rejectable
+        #  end
+        #
+        # <b>Example XML</b>
+        #   <infosource>
+        #     <rejection>
+        #       <rejectreason>Unable to Respond at Current Time</rejectreason>
+        #       <followupaction>Resubmission Allowed</followupaction>
+        #     </rejection>
+        #   <i/nfosource>
+        #
+        # <b>Example XML</b>
+        #   <inforeceiver>
+        #     <rejection>
+        #       <rejectreason>Provider Not on File</rejectreason>
+        #       <followupaction>Please Correct and Resubmit</followupaction>
+        #     </rejection>
+        #   </inforeceiver>
+        #
+        # <b>Example XML</b>
+        #   <subscriber>
+        #     <rejection>
+        #       <rejectreason>Invalid/Missing Subscriber/Insured Name</rejectreason>
+        #       <followupaction>Please Correct and Resubmit</followupaction>
+        #     </rejection>
+        #     <rejection>
+        #       <rejectreason>Patient Birth Date Does Not Match That for the Patient on the Database</rejectreason>
+        #       <followupaction>Please Correct and Resubmit</followupaction>
+        #     </rejection>
+        #   </subscriber>
+        #
+        module Rejectable
+          def after_inititlize(hash)
+            super(hash)
+
+            # This is in an openstruct and after inititalize, :rejection in the
+            # hash will have created an accessor, so nil that out here, we're using
+            # rejections (plural) not rejection (singular)
+            self.rejection = nil
+
+            rejections_xml = hash[:rejection] || []
+            rejections_xml = [rejections_xml] if rejections_xml.is_a?(Hash)
+
+            self.rejections = rejections_xml.map do |rejection_xml|
+              Rejection.new(rejection_xml).tap {|r| r.source = self }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Trizetto
+  module Api
+    module Eligibility
+      module WebService
+
+        # A rejection in the eligibility response.
+        #
+        # <b>Example XML</b>
+        #   <rejection>
+        #     <rejectreason>Subscriber/Insured Not Found</rejectreason>
+        #     <followupaction>Please Correct and Resubmit</followupaction>
+        #   </rejection>
+        #
+        # @see Rejectable
+        class Rejection < Node
+          KEY_CLEANUP =
+          {
+            rejectreason:   :reason,
+            followupaction: :follow_up_action,
+          }
+
+          attr_accessor :source
+
+          def initialize(raw_hash = {})
+            super(raw_hash)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+module Trizetto
+  module Api
+    module Eligibility
+      module WebService
+
+        # The subscriber is who holds the insurance.  They may be the patient, or
+        # they may have dependents who are the patients.
+        class Subscriber < Patient
+          prepend Rejectable
+
+          def initialize(raw_hash = {})
+            # If we are in subscriber / depdent relationship, we get back subscribername
+            # instead of patientname (as the subscriber is _not_ the patient).  For
+            # convience, we'll transform the subscriber name into a name
+
+            clean_hash = raw_hash.dup
+            if clean_hash.has_key?(:subscribername) && !clean_hash.has_key?(:patientname) && clean_hash[:subscribername].is_a?(Hash)
+              clean_hash[:patientname] = clean_hash.delete(:subscribername)
+              clean_hash[:patientname].keys.each do |key|
+                if key.to_s =~ /^subscriber(.*)$/
+                  clean_hash[:patientname]["patient#{$1}".to_sym] = clean_hash[:patientname].delete(key)
+                end
+              end
+            end
+
+            super(clean_hash)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+module Trizetto
+  module Api
+    module Eligibility
+      module WebService
+        # Wraps a validation error returned in the SOAP response body
+        #
+        # <b>Example</b>
+        #
+        #   failure = ValidationFailure.new({affected_fields: {string: "InsuranceNum"}, message: "Please enter InsuranceNum."}`)
+        #   failure.affected_fields   # =>["InsuranceNum"]
+        #   failure.message           # => "Please enter InsuranceNum."
+        #
+        class ValidationFailure
+
+          # An array of strings indicating which fields had a validation failure.
+          #
+          # While the WSDL has this as an array, in practice, there is one field in that array
+          #
+          # <b>WSDL Reference</b>
+          #
+          #   <s:element minOccurs="0" maxOccurs="1" name="AffectedFields" type="tns:ArrayOfString" />
+          #
+          attr_accessor :affected_fields
+
+          # The validation error associated with the affected fields
+          #
+          # <b>WSDL Reference</b>
+          #
+          #   <s:element minOccurs="0" maxOccurs="1" name="Message" type="s:string" />
+          #
+          attr_accessor :message
+
+          # Initialize the Validation failure from a parsed DoInquiry response hash
+          #
+          def initialize(validation_failure_hash)
+            self.affected_fields = Array((validation_failure_hash.dig(:affected_fields) || {})[:string])
+            self.message         = validation_failure_hash[:message]
+          end
+
+          def to_h
+            {affected_fields: affected_fields, message: message}
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -4,11 +4,11 @@ module Trizetto
 
       # Ruby wrapper for the PayerList WebService
       #
-      # See Also:
+      # <b>References</b>
       #
-      # - Service Documentation: https://mytools.gatewayedi.com/Help/documents/Eligibility/WS%20PayerList%20Vendor%20Toolkit.pdf
-      # - WSDL: https://services.gatewayedi.com/PayerList/PayerList.asmx?WSDL
-      # - Service Description: https://services.gatewayedi.com/PayerList/PayerList.asmx
+      # - {https://mytools.gatewayedi.com/Help/documents/Eligibility/WS%20PayerList%20Vendor%20Toolkit.pdf Service Documentation}
+      # - {https://services.gatewayedi.com/PayerList/PayerList.asmx?WSDL WSDL}
+      # - {https://services.gatewayedi.com/PayerList/PayerList.asmx Service Description}
       class WebService < Trizetto::Api::WebService
 
         def initialize(options = {})
@@ -20,8 +20,8 @@ module Trizetto
 
         # Tests to see if the service is up
         #
-        # See Also:
-        # - Service Description https://services.gatewayedi.com/PayerList/PayerList.asmx?op=Ping
+        # <b>References</b>
+        # - {https://services.gatewayedi.com/PayerList/PayerList.asmx?op=Ping Service Description }
         def ping
           @client.call(:ping, message: {})
         end
@@ -30,7 +30,7 @@ module Trizetto
         # servicing states and links to their enrollment documentation, if it exists.
         #
         # The service provides the following information for each payer
-        # Type – HCFA or UB.
+        # - Type – HCFA or UB.
         # - Payer ID – The Gateway EDI payer identification number.
         # - Payer Name – The payer name.
         # - Nation Wide – Yes or No.
@@ -43,7 +43,9 @@ module Trizetto
         # - Provider ID Required – Yes or No.
         # - NPI Enabled – Yes or No.
         # - Last Date Modified – Last date that payer information was modified.
-        # Note: You probably need to set a long timeout to make this call
+        #
+        # <b>Note</b>: You probably need to set a long timeout to make this call
+        # <b>Note</b>: I've never got this request to complete
         def payer_list
           @client.call(:get_xml_payer_list, message: {})
         end

data/lib/trizetto/api/version.rb

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

data/trizetto-api.gemspec

@@ -24,7 +24,11 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.16"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "byebug", "~> 9.0"
 
   spec.add_dependency "savon", "~> 2.0"
   spec.add_dependency "savon-multipart", "~> 2.0"
+
+  # Hash#dig is usedbu
+  spec.required_ruby_version = '>= 2.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trizetto-api
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - John Naegle
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-01-12 00:00:00.000000000 Z
+date: 2018-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
 - !ruby/object:Gem::Dependency
   name: savon
   requirement: !ruby/object:Gem::Requirement
@@ -90,6 +104,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- ".yardopts"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -106,6 +121,20 @@ files:
 - lib/trizetto/api/eligibility/core2.wsdl
 - lib/trizetto/api/eligibility/web_service.rb
 - lib/trizetto/api/eligibility/web_service.wsdl
+- lib/trizetto/api/eligibility/web_service/benefit.rb
+- lib/trizetto/api/eligibility/web_service/benefit_entity.rb
+- lib/trizetto/api/eligibility/web_service/dependent.rb
+- lib/trizetto/api/eligibility/web_service/do_inquiry_response.rb
+- lib/trizetto/api/eligibility/web_service/extra_processing_info.rb
+- lib/trizetto/api/eligibility/web_service/info_reciever.rb
+- lib/trizetto/api/eligibility/web_service/info_source.rb
+- lib/trizetto/api/eligibility/web_service/node.rb
+- lib/trizetto/api/eligibility/web_service/patient.rb
+- lib/trizetto/api/eligibility/web_service/patient_name.rb
+- lib/trizetto/api/eligibility/web_service/rejectable.rb
+- lib/trizetto/api/eligibility/web_service/rejection.rb
+- lib/trizetto/api/eligibility/web_service/subscriber.rb
+- lib/trizetto/api/eligibility/web_service/validation_failure.rb
 - lib/trizetto/api/payer_list/web_service.rb
 - lib/trizetto/api/payer_list/web_service.wsdl
 - lib/trizetto/api/version.rb
@@ -123,7 +152,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="