eligible 1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/CONTRIBUTORS

@@ -0,0 +1 @@
+Andy Brett <andy@andybrett.com>

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in eligible.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Eligible
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,126 @@
+# Eligible
+
+Ruby bindings for the [Eligible API](https://eligibleapi.com/rest-api-v1)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'eligible'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself with:
+
+    $ gem install eligible
+
+## Usage
+
+### Setup
+    require eligible
+    Eligible.api_key = YOUR_KEY
+
+### Retrieve Plan object and query it
+    params = {
+      :payer_name => "Aetna",
+      :payer_id   => "000001",
+      :service_provider_last_name => "Last",
+      :service_provider_first_name => "First",
+      :service_provider_NPI => "1928384219",
+      :subscriber_id => "W120923801",
+      :subscriber_last_name => "Austen",
+      :subscriber_first_name => "Jane",
+      :subscriber_dob => "1955-12-14"
+    }
+
+    plan = Eligible::Plan.get(params)
+    plan.all      # returns all fields on the plan, per the plan/all endpoint
+    plan.status   # returns status fields on the plan, per the plan/status endpoint
+    ## Etc.: plan.deductible, plan.dates, plan.balance, plan.stop_loss 
+
+### Retrieve Service object and query it
+    params = {
+      :payer_name => "Aetna",
+      :payer_id   => "000001",
+      :service_provider_last_name => "Last",
+      :service_provider_first_name => "First",
+      :service_provider_NPI => "1928384219",
+      :subscriber_id => "W120923801",
+      :subscriber_last_name => "Austen",
+      :subscriber_first_name => "Jane",
+      :subscriber_dob => "1955-12-14"
+    }
+
+    service = Eligible::Service.get(params)
+    service.all     # returns all fields for the service, per service/all
+    service.visits  # returns the visits for the service, per service/visits
+    ## Etc.: service.copayment, service.coinsurance, service.deductible
+
+### Retrieve Demographic object and query it
+    params = {
+      :payer_name => "Aetna",
+      :payer_id   => "000001",
+      :service_provider_last_name => "Last",
+      :service_provider_first_name => "First",
+      :service_provider_NPI => "1928384219",
+      :subscriber_id => "W120923801",
+      :subscriber_last_name => "Austen",
+      :subscriber_first_name => "Jane",
+      :subscriber_dob => "1955-12-14"
+    }
+
+    demographic = Eligible::Demographic.get(params)
+    demographic.all # returns all fields for the demographic, per demographic/all
+    demographic.zip # returns the patient's zip code, per demographic/zip
+    ## Etc.: demographic.employer, demographic.address, demographic.dob
+
+### Retrieve Claim object
+
+    params = {
+      :payer_name => "Aetna",
+      :payer_id => "000001",
+      :information_receiver_organization_name => "Organization",
+      :information_receiver_last_name => "Last",
+      :information_receiver_first_name => "First",
+      :information_receiver_etin => "1386332",
+      :service_provider_organization_name => "Marshall Group",
+      :service_provider_last_name => "Last",
+      :service_provider_first_name => "First",
+      :service_provider_npi => "1928384219",
+      :service_provider_tax_id => "1386332",
+      :subscriber_id => "W120923801",
+      :subscriber_last_name => "Last", 
+      :subscriber_first_name => "First",
+      :subscriber_dob => "1955-12-14",
+      :dependent_last_name => "Last",
+      :dependent_first_name => "First",
+      :dependent_dob => "1975-12-14",
+      :dependent_gender => "M",
+      :trace_number => "12345",
+      :claim_control_number => "67890",
+      :claim_charge_amount => "45.00",
+      :claim_start_date => "2013-01-05",
+      :claim_end_date => "2013-01-05"
+    }    
+    
+    claim = Eligible::Claim.get(params)
+    claim.status # Returns in real time the status (paid, not paid, rejected, denied, etc) of claim specified.
+
+## Tests
+
+You can run tests with 
+
+    rake test
+
+If you do send a pull request, please add passing tests for the new feature/fix.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Run tests (see above)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request

data/Rakefile

@@ -0,0 +1,4 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new(:test)

data/eligible.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'eligible/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "eligible"
+  gem.version       = Eligible::VERSION
+  gem.authors       = ["Andy Brett"]
+  gem.email         = ["andy@andybrett.com"]
+  gem.description   = 'Eligible is a developer-friendly way to process health care eligibility checks. Learn more at https://eligibleapi.com'
+  gem.summary       = 'Ruby wrapper for the Eligible API'
+  gem.homepage      = "https://eligibleapi.com/"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($/)
+  # gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.test_files    = `git ls-files -- test/*`.split("\n")
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency('mocha')
+  gem.add_development_dependency('shoulda')
+  gem.add_development_dependency('test-unit')
+  gem.add_development_dependency('rake')
+
+  gem.add_dependency('rest-client', '~> 1.4')
+  gem.add_dependency('multi_json', '>= 1.0.4', '< 2')
+end

data/lib/eligible.rb

@@ -0,0 +1,215 @@
+require 'cgi'
+require 'set'
+require 'rubygems'
+require 'openssl'
+
+gem 'rest-client', '~> 1.4'
+require 'rest_client'
+require 'multi_json'
+
+require 'eligible/version'
+require 'eligible/util'
+require 'eligible/json'
+require 'eligible/eligible_object'
+require 'eligible/api_resource'
+require 'eligible/plan'
+require 'eligible/service'
+require 'eligible/demographic'
+require 'eligible/claim'
+
+# Errors
+require 'eligible/errors/eligible_error'
+require 'eligible/errors/api_connection_error'
+require 'eligible/errors/authentication_error'
+require 'eligible/errors/api_error'
+
+module Eligible
+  @@api_key  = nil
+  @@api_base = "https://v1.eligibleapi.net"
+  @@api_version = 1
+
+  def self.api_url(url='')
+    @@api_base + url
+  end
+
+  def self.api_key
+    @@api_key
+  end
+
+  def self.api_key=(api_key)
+    @@api_key = api_key
+  end
+
+  def self.api_version=(version)
+    @@api_version = version
+  end
+
+  def self.api_version
+    @@api_version
+  end  
+
+  def self.request(method, url, api_key, params={}, headers={})
+    api_key ||= @@api_key
+    raise AuthenticationError.new('No API key provided. (HINT: set your API key using "Eligible.api_key = <API-KEY>".') unless api_key
+
+    # if !verify_ssl_certs
+    #   unless @no_verify
+    #     $stderr.puts "WARNING: Running without SSL cert verification.  Execute 'Eligible.verify_ssl_certs = true' to enable verification."
+    #     @no_verify = true
+    #   end
+    #   ssl_opts = { :verify_ssl => false }
+    # elsif !Util.file_readable(@@ssl_bundle_path)
+    #   unless @no_bundle
+    #     $stderr.puts "WARNING: Running without SSL cert verification because #{@@ssl_bundle_path} isn't readable"
+    #     @no_bundle = true
+    #   end
+    #   ssl_opts = { :verify_ssl => false }
+    # else
+    #   ssl_opts = {
+    #     :verify_ssl => OpenSSL::SSL::VERIFY_PEER,
+    #     :ssl_ca_file => @@ssl_bundle_path
+    #   }
+    # end
+    uname = (@@uname ||= RUBY_PLATFORM =~ /linux|darwin/i ? `uname -a 2>/dev/null`.strip : nil)
+    lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
+    ua = {
+      :bindings_version => Eligible::VERSION,
+      :lang => 'ruby',
+      :lang_version => lang_version,
+      :platform => RUBY_PLATFORM,
+      :publisher => 'eligible',
+      :uname => uname
+    }
+
+    # params = Util.objects_to_ids(params)
+    url = self.api_url(url)
+    case method.to_s.downcase.to_sym
+    when :get, :head, :delete
+      # Make params into GET parameters
+      url += "?api_key=#{api_key}"
+      if params && params.count > 0
+        query_string = Util.flatten_params(params).collect{|key, value| "#{key}=#{Util.url_encode(value)}"}.join('&')
+        url += "&#{query_string}"
+      end
+      payload = nil
+    else
+      payload = Util.flatten_params(params).collect{|(key, value)| "#{key}=#{Util.url_encode(value)}"}.join('&')
+    end
+
+    begin
+      headers = { :x_eligible_client_user_agent => Eligible::JSON.dump(ua) }.merge(headers)
+    rescue => e
+      headers = {
+        :x_eligible_client_raw_user_agent => ua.inspect,
+        :error => "#{e} (#{e.class})"
+      }.merge(headers)
+    end
+
+    headers = {
+      :user_agent => "Eligible/v1 RubyBindings/#{Eligible::VERSION}",
+      :authorization => "Bearer #{api_key}",
+      :content_type => 'application/x-www-form-urlencoded'
+    }.merge(headers)
+
+    if self.api_version
+      headers[:eligible_version] = self.api_version
+    end
+
+    opts = {
+      :method => method,
+      :url => url,
+      :headers => headers,
+      :open_timeout => 30,
+      :payload => payload,
+      :timeout => 80
+    }#.merge(ssl_opts)
+    
+    begin
+      response = execute_request(opts)
+    rescue SocketError => e
+      self.handle_restclient_error(e)
+    rescue NoMethodError => e
+      # Work around RestClient bug
+      if e.message =~ /\WRequestFailed\W/
+        e = APIConnectionError.new('Unexpected HTTP response code')
+        self.handle_restclient_error(e)
+      else
+        raise
+      end
+    rescue RestClient::ExceptionWithResponse => e
+      if rcode = e.http_code and rbody = e.http_body
+        self.handle_api_error(rcode, rbody)
+      else
+        self.handle_restclient_error(e)
+      end
+    rescue RestClient::Exception, Errno::ECONNREFUSED => e
+      self.handle_restclient_error(e)
+    end
+
+    rbody = response.body
+    rcode = response.code
+    begin
+      # Would use :symbolize_names => true, but apparently there is
+      # some library out there that makes symbolize_names not work.
+      resp = Eligible::JSON.load(rbody)
+    rescue MultiJson::DecodeError
+      raise APIError.new("Invalid response object from API: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
+    end
+
+    resp = Util.symbolize_names(resp)
+    [resp, api_key]
+  end
+
+  private
+
+  def self.execute_request(opts)
+    RestClient::Request.execute(opts)
+  end
+
+  def self.handle_api_error(rcode, rbody)
+    begin
+      error_obj = Eligible::JSON.load(rbody)
+      error_obj = Util.symbolize_names(error_obj)
+      error = error_obj[:error] or raise EligibleError.new # escape from parsing
+    rescue MultiJson::DecodeError, EligibleError
+      raise APIError.new("Invalid response object from API: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
+    end
+
+    case rcode
+    when 400, 404 then
+      raise invalid_request_error(error, rcode, rbody, error_obj)
+    when 401
+      raise authentication_error(error, rcode, rbody, error_obj)
+    else
+      raise api_error(error, rcode, rbody, error_obj)
+    end
+  end
+
+  def self.invalid_request_error(error, rcode, rbody, error_obj)
+    InvalidRequestError.new(error[0][:message], error[:param], rcode, rbody, error_obj)
+  end
+
+  def self.authentication_error(error, rcode, rbody, error_obj)
+    AuthenticationError.new(error[0][:message], rcode, rbody, error_obj)
+  end
+
+  def self.api_error(error, rcode, rbody, error_obj)
+    APIError.new(error[0][:message], rcode, rbody, error_obj)
+  end
+
+  def self.handle_restclient_error(e)
+    case e
+    when RestClient::ServerBrokeConnection, RestClient::RequestTimeout
+      message = "Could not connect to Eligible (#{@@api_base}).  Please check your internet connection and try again."
+    when RestClient::SSLCertificateNotVerified
+      message = "Could not verify Eligible's SSL certificate."
+    when SocketError
+      message = "Unexpected error communicating when trying to connect to Eligible."
+    else
+      message = "Unexpected error communicating with Eligible. If this problem persists, let us know at support@eligible.com."
+    end
+    message += "\n\n(Network error: #{e.message})"
+    raise APIConnectionError.new(message)
+  end
+
+end

data/lib/eligible/api_resource.rb

@@ -0,0 +1,14 @@
+module Eligible
+  class APIResource < EligibleObject
+    def self.class_name
+      self.name.split('::')[-1]
+    end
+
+    def self.url()
+      if self == APIResource
+        raise NotImplementedError.new('APIResource is an abstract class.  You should perform actions on its subclasses (Plan, Service, etc.)')
+      end
+      "/#{CGI.escape(class_name.downcase)}/all.json"
+    end
+  end
+end

data/lib/eligible/claim.rb

@@ -0,0 +1,12 @@
+module Eligible
+  class Claim < APIResource
+    def self.get(params, api_key=nil)
+      response, api_key = Eligible.request(:get, url, api_key, params)
+      Util.convert_to_eligible_object(response, api_key)
+    end
+
+    def status
+      error ? nil : to_hash
+    end
+  end
+end