trizetto-api 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6df121190be3fbb4983fc36e4864672f63e6d8c5
-  data.tar.gz: f88c0595014114ef36f32ea4557bfc69914e9463
+  metadata.gz: e4fbff1ea29b8ff7be9a59a73684fbf34b4c4418
+  data.tar.gz: 6697e7baa4a73b991efb4462f880466ae5fbc858
 SHA512:
-  metadata.gz: 68a2927c711b81b8be339e1778275150a0b1021350eeee765401221468a01f590362368e821f9766a0ee5cf0355f6bc6154f30ae22e8895f0a7c169085239b05
-  data.tar.gz: 663f796bee4042a478ca13e5db2b3080ff28f390219253725ff88841a591b132b597ff808875c411756eb00a8a55d62097f910b7497e9b5ba7471cdd328b08cd
+  metadata.gz: eedcb3a711f90fdf8a1be47b85de37f4df7c4adcc55aba3ac3a387a362262f48da504bd7ad8144226789c8ed63afe155fff8cbd77af575a75ef953bb8e76807b
+  data.tar.gz: e9a45666b41c6cfd81f5b673f2aec1504021273a14db19b0e18cb3d682526c9899f18efe895b9062a2492b11d73bb08b2abd018fb98a89cf5a2c51a06a32682a

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.1.2 (January 12, 2018) ##
+
+* Have the non-COR II Eligiblity check return an XML document.  YAY! We can
+  parse and understand XML without having to understand X12.
+
 ## 0.1.1 (January 11, 2018) ##
 
 * Initial implementation of 5 Trizetto API endpoints: Eligibility check with

data/README.md

@@ -20,24 +20,11 @@ Or install it yourself as:
 
 ## Usage
 
-### Use the CORE2 API with an X12 payload to check eligibility in realtime
-
-```ruby
-
-require 'trizetto/api'
-
-Trizetto::Api.configure do |config|
-  config.username = 'Not the real username'
-  config.password = 'Super Top Secret'
-end
-
-
-client = Trizetto::Api::Eligibility::Core2.new
-client.check_eligibility(payload: x12_message)
-```
-
 ### 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.
+You can force this API to return an X12 document if you like pain.
+
 ```ruby
 require 'trizetto/api'
 
@@ -60,9 +47,33 @@ response = client.do_inquiry({
   'InsuredDob':       '19281118',
   'GediPayerId':      'N4222',
 })
+
+puts response.to_hash[:do_inquiry_response][:do_inquiry_result][:success_code]
+
+source = response.to_hash[:do_inquiry_response][:do_inquiry_result][:response_as_xml]
+puts Nokogiri::XML(source).to_xml
 ```
 
 
+### Use the CORE2 API with an X12 payload to check eligibility in realtime
+
+This returns an X12/271 response.  You will need to understand how to build
+X12/270 requests and parse X12/271 responses.
+
+```ruby
+
+require 'trizetto/api'
+
+Trizetto::Api.configure do |config|
+  config.username = 'Not the real username'
+  config.password = 'Super Top Secret'
+end
+
+
+client = Trizetto::Api::Eligibility::Core2.new
+client.check_eligibility(payload: x12_message)
+```
+
 ### Ping the Payer List endpoint to see if it is up
 
 ```ruby
@@ -84,6 +95,8 @@ response = client.ping
 
 ### Fetch the Payer List
 
+This API times out or errors out on the Trizetto server.  But you may get it to work.
+
 ```ruby
 require 'trizetto/api'
 

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

@@ -58,28 +58,6 @@ module Trizetto
 
         # TODO: Understand the X12 format and allow options to be passed in, then generate the X12 message
         #
-        # Required Field:
-        #   +ProviderLastName+   - Provider Last Name/Organization Name
-        #   +NPI+                - National Provider Identifier
-        #
-        # Situational Fields:
-        #
-        #   +ProviderFirstName+  - Provider First Name
-        #   +InsuredFirstName+   - Subscriber First Name
-        #   +InsuredLastName+    - Subscriber Last Name
-        #   +InsuranceNum+       - Subscriber Id
-        #   +InsuredDob+         - Subscriber DOB
-        #   +InsuredGender+      - Subscriber Gender
-        #   +DependentFirstName+ - Dependent First Name
-        #   +DependentLastName+  - Dependent Last Name
-        #   +DependentDob+       - Dependent DOB
-        #   +DependentGender+    - Dependent Gender
-        #
-        # Note: Some payers require additional information than those listed above. Please refer to the
-        # companion guide for the additional parameters required by few payers. A valid inquiry submitted
-        # to those payers must also account for the additional payer specific parameters. “InsuranceNum,” in
-        # particular, is not a required field for all transactions, but is required by almost all payers.
-        #
         def check_eligibility(options = {})
         @client.call(:real_time_transaction, message: {
           'PayloadType': 'X12_270_Request_005010X279A1',

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

@@ -30,11 +30,36 @@ module Trizetto
           }))
         end
 
+        # Required Field:
+        #   +GediPayerId+        - The Gateway EDI specific payer identifier
+        #   +ProviderLastName+   - Provider Last Name/Organization Name
+        #   +NPI+                - National Provider Identifier
+        #
+        # Situational Fields:
+        #
+        #   +ProviderFirstName+  - Provider First Name
+        #   +InsuredFirstName+   - Subscriber First Name
+        #   +InsuredLastName+    - Subscriber Last Name
+        #   +InsuranceNum+       - Subscriber Id
+        #   +InsuredDob+         - Subscriber DOB
+        #   +InsuredGender+      - Subscriber Gender
+        #   +DependentFirstName+ - Dependent First Name
+        #   +DependentLastName+  - Dependent Last Name
+        #   +DependentDob+       - Dependent DOB
+        #   +DependentGender+    - Dependent Gender
+        #
+        # Note: Some payers require additional information than those listed above. Please refer to the
+        # companion guide for the additional parameters required by few payers. A valid inquiry submitted
+        # to those payers must also account for the additional payer specific parameters. “InsuranceNum,” in
+        # particular, is not a required field for all transactions, but is required by almost all payers.
+        #
         # See Also:
         #
         # - Service Description: https://services.gatewayedi.com/eligibility/service.asmx?op=DoInquiry
         def do_inquiry(parameters={})
-          @client.call(:do_inquiry, message: { 'Inquiry': {'Parameters': {
+          @client.call(:do_inquiry, message: { 'Inquiry': {
+            'ResponseDataType': 'Xml',
+            'Parameters': {
             'MyNameValue': parameters.map do |name, value|
                 {'Name': name, 'Value': value}
               end

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

@@ -29,6 +29,20 @@ module Trizetto
         # Retrieves all Gateway EDI recognized payers along with their supported transaction types and
         # servicing states and links to their enrollment documentation, if it exists.
         #
+        # The service provides the following information for each payer
+        # Type – HCFA or UB.
+        # - Payer ID – The Gateway EDI payer identification number.
+        # - Payer Name – The payer name.
+        # - Nation Wide – Yes or No.
+        # - Servicing States – List of supported states.
+        # - Supported Transactions – List of supported transactions.
+        # -- Description – A description of the available transactions. Transaction include Claims, Real-time Claim Status, Remittance Advice, Real-time Eligibility, and Electronic COB.
+        # -- Enrollment Required – Yes or No.
+        # -- Enrollment Agreement – A http link to the enrollment documentation.
+        # -- Authorization Required – Yes or No.
+        # - 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
         def payer_list
           @client.call(:get_xml_payer_list, message: {})

data/lib/trizetto/api/version.rb

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

metadata

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