pokitdok-ruby 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9b98345c45efe8a25ddc256e9d307c345b340c20
-  data.tar.gz: f69095d7412c999eed38f5a95cbf6c11a0f9ca51
+  metadata.gz: 57cf37a5fff162bd158abbceb5d4fed977c78ad3
+  data.tar.gz: 0b10d83567181e9a7bc17054be53d70ea65a7c51
 SHA512:
-  metadata.gz: 8eb6c6ae134c48789095fd59585dbb8087faa8fd05db0715c6a11ffc7dd27ffbc8db94f90649f3ed77fc3992dfbbddc63b630b30abf73362fd1bbe379af5b0a9
-  data.tar.gz: be9f03e159860c775b92bb20314c0a2477d24dc0108cff00d8978a017712106e9311bcdb4216ef17b378bf78385532974a1bce38e8d91cb6d088d93cdcea0de1
+  metadata.gz: 24f245b5279f4e99e5e7d10c3ae490f28a9a4c1fd6ccc89b5e1ff10e81264552ae3eb29cbbd6b296d2c72c14c8a60468e40922099d808331831c0ec27adb968e
+  data.tar.gz: c96fe3cfd950cb18f80eb68ed4aafa9a9afc721cd21f675d7f9f63d8f1d0d80f752c2b9012f23d852363a6fdfa5def47ab9915faa0c00aa891e54c26c696db87

data/.travis.yml

@@ -4,5 +4,4 @@ rvm:
   - 2.0.0
   - 1.9.3
   - jruby-19mode # JRuby in 1.9 mode
-  - rbx-2.1.1
-  
+  - rbx-2.2.7

data/Gemfile

@@ -18,4 +18,5 @@ group :development do
 	gem 'guard-minitest', '~> 2.2'
 	gem 'terminal-notifier-guard', '~> 1.5'
 	gem 'guard-rubocop', '~> 1.0'
+	gem 'coveralls', require: false
 end

data/Gemfile.lock

@@ -8,6 +8,12 @@ GEM
     celluloid (0.15.2)
       timers (~> 1.1.0)
     coderay (1.1.0)
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
     crack (0.4.2)
       safe_yaml (~> 1.0.0)
     descendants_tracker (0.0.4)
@@ -58,6 +64,7 @@ GEM
     lumberjack (1.0.6)
     metaclass (0.0.4)
     method_source (0.8.2)
+    mime-types (2.3)
     mini_portile (0.6.0)
     minitest (5.3.4)
     minitest-reporters (1.0.4)
@@ -94,6 +101,8 @@ GEM
       ffi (>= 0.5.0)
     rdoc (4.1.1)
       json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
     rubocop (0.23.0)
       json (>= 1.7.7, < 2)
       parser (~> 2.1.9)
@@ -108,10 +117,13 @@ GEM
       simplecov-html (~> 0.8.0)
     simplecov-html (0.8.0)
     slop (3.5.0)
+    term-ansicolor (1.3.0)
+      tins (~> 1.0)
     terminal-notifier-guard (1.5.3)
     thor (0.19.1)
     thread_safe (0.3.4)
     timers (1.1.0)
+    tins (1.3.0)
     vcr (2.9.2)
     webmock (1.18.0)
       addressable (>= 2.3.6)
@@ -123,6 +135,7 @@ PLATFORMS
 DEPENDENCIES
   ansi (~> 1.4)
   bundler (~> 1.0)
+  coveralls
   guard (~> 2.6)
   guard-minitest (~> 2.2)
   guard-rubocop (~> 1.0)

data/Guardfile

@@ -12,7 +12,7 @@ guard :minitest do
   watch(%r{^spec/spec_helper\.rb$}) { 'spec' }
 end
 
-guard :rubocop do
-  watch(%r{.+\.rb$})
-  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
-end
+#guard :rubocop do
+  #watch('/lib/*.rb')
+  #watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+#end

data/README.md

@@ -1,5 +1,7 @@
 [![Build Status](https://travis-ci.org/pokitdok/pokitdok-ruby.svg?branch=master)](https://travis-ci.org/pokitdok/pokitdok-ruby)
 [![Gem Version](https://badge.fury.io/rb/pokitdok-ruby.svg)](http://badge.fury.io/rb/pokitdok-ruby)
+[![Dependency Freshness](https://www.versioneye.com/user/projects/538e498b46c4739edd0000ee/badge.svg)](https://www.versioneye.com/user/projects/538e498b46c4739edd0000ee)
+
 
 pokitdok-ruby
 =============
@@ -37,16 +39,20 @@ pd.providers(zipcode: '29307', radius: '10mi')
 pd.providers(zipcode: '29307', radius: '10mi', specialty: 'RHEUMATOLOGY')
 
 # Eligibility
-params = {
-  trading_partner_id: 'MOCKPAYER',
-  member_id: 'W34237875729',
-  provider_id: '1467560003',
-  provider_name: 'AYA-AY',
-  provider_first_name: 'JEROME',
-  provider_type: 'Person',
-  member_name: 'JOHN DOE',
-  member_birth_date: '05-21-1975',
-  service_types: ['Health Benefit Plan Coverage']
+@eligibility_query = {
+  member: {
+      birth_date: '1970-01-01',
+      first_name: 'Jane',
+      last_name: 'Doe',
+      id: 'W000000000'
+  },
+  provider: {
+      first_name: 'JEROME',
+      last_name: 'AYA-AY',
+      npi: '1467560003'
+  },
+  service_types: ['health_benefit_plan_coverage'],
+  trading_partner_id: 'MOCKPAYER'
 }
 
 pd.eligibility(params)
@@ -65,12 +71,23 @@ pd.files('trading_partner_id', 'path/to/a_file.edi')
               
 ```
 
-## Supported Ruby Versions
-This library aims to support and is tested against these Ruby versions:
+This version of pokitdok-ruby supports, and defaults to using, the new
+PokitDok v4 API. If you'd like to continue using the previous v3 API,
+you can pass a third parameter to PokitDok::Pokitdok.new, like this:
+
+```
+@pd = PokitDok::PokitDok.new('my_client_id', 'my_client_secret', 'v3')
+```
 
-* Ruby 1.9.3-p545
-* Ruby 2.0.0-p451
-* Ruby 2.1.1
+## Supported Ruby Versions
+This library aims to support and is tested against these Ruby versions, 
+using travis-ci:
+
+* 2.1.1
+* 2.0.0
+* 1.9.3
+* JRuby in 1.9 mode
+* Rubinius 2.2.7
 
 You may have luck with other interpreters - let us know how it goes.
 

data/Rakefile

@@ -31,6 +31,9 @@ Rake::TestTask.new(:spec) do |spec|
   spec.verbose = true
 end
 
+require 'coveralls'
+Coveralls.wear!
+
 desc 'Code coverage detail'
 task :simplecov do
   ENV['COVERAGE'] = 'true'

data/VERSION

@@ -1 +1 @@
-0.2.3
+0.3.0

data/lib/pokitdok.rb

@@ -21,6 +21,8 @@ module PokitDok
 
     attr_reader :client # :nodoc:
     attr_reader :token  # :nodoc:
+    attr_reader :api_url
+    attr_reader :version
 
     # Connect to the PokitDok API with the specified Client ID and Client
     # Secret.
@@ -29,22 +31,24 @@ module PokitDok
     #
     # +client_secret+ your client secret, provided by PokitDok
     #
-    def initialize(client_id, client_secret)
+    def initialize(client_id, client_secret, version='v4')
       @client_id = client_id
       @client_secret = client_secret
+      @version = version
+
+      @api_url = "#{url_base}/api/#{version}"
 
       @client = OAuth2::Client.new(@client_id, @client_secret,
-                                   site: api_url, token_url: '/oauth2/token')
+                                   site: @api_url, token_url: '/oauth2/token')
       refresh_token
     end
 
-    # Returns the URL used to communicate with the PokitDok API.
-    def api_url
-      POKITDOK_URL_BASE + '/api/v3'
+    def url_base
+      POKITDOK_URL_BASE
     end
 
     def user_agent
-      "pokitdok-ruby 0.2.1 #{RUBY_DESCRIPTION}"
+      "pokitdok-ruby 0.4 #{RUBY_DESCRIPTION}"
     end
 
     # returns a standard set of headers to be passed along with all requests
@@ -62,16 +66,18 @@ module PokitDok
 
     # Invokes the activities endpoint, with an optional Hash of parameters.
     def activities(params = {})
-      response = @token.get('activities',
+      response = @token.get('activities/',
                             headers: headers,
                             params: params)
       JSON.parse(response.body)
     end
 
     # Invokes the cash prices endpoint, with an optional Hash of parameters.
-    def cash_prices(_params = {})
-      fail NotImplementedError, "The PokitDok API does not currently support
-        this endpoint."
+    def cash_prices(params = {})
+      response = @token.get('price/cash/',
+                             headers: headers,
+                             params: params)
+      JSON.parse(response.body)
     end
 
     # Invokes the claims endpoint, with an optional Hash of parameters.
@@ -84,18 +90,6 @@ module PokitDok
       JSON.parse(response.body)
     end
 
-    # Invokes the claims status endpoint, with an optional Hash of parameters.
-    def claim_status(_params = {})
-      fail NotImplementedError, 'The PokitDok API does not currently support
-        this endpoint.'
-    end
-
-    # Invokes the deductible endpoint, with an optional Hash of parameters.
-    def deductible(_params = {})
-      fail NotImplementedError, 'The PokitDok API does not currently support
-        this endpoint.'
-    end
-
     # Invokes the eligibility endpoint, with an optional Hash of parameters.
     def eligibility(params = {})
       response = @token.post('eligibility/',
@@ -124,7 +118,7 @@ module PokitDok
     # +filename+ the path to the file to transmit
     #
     def files(trading_partner_id, filename)
-      url = URI.parse(api_url + '/files/')
+      url = URI.parse(@api_url + '/files/')
 
       File.open(filename) do |f|
         req = Net::HTTP::Post::Multipart.new url.path,
@@ -141,15 +135,6 @@ module PokitDok
       JSON.parse(@response.body)
     end
 
-    # Invokes the insurance prices endpoint, with an optional Hash of
-    # parameters.
-    def insurance_prices(params = {})
-      response = @token.get('prices/insurance',
-                            headers: headers,
-                            params: params)
-      JSON.parse(response.body)
-    end
-
     # Invokes the payers endpoint, with an optional Hash of parameters.
     def payers(params = {})
       response = @token.get('payers', headers: headers, params: params)

data/pokitdok-ruby.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: pokitdok-ruby 0.2.3 ruby lib
+# stub: pokitdok-ruby 0.3.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "pokitdok-ruby"
-  s.version = "0.2.3"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["John Riney"]
-  s.date = "2014-06-03"
+  s.date = "2014-06-06"
   s.description = "Gem for easy access to the PokitDok Platform APIs."
   s.email = "john.riney@pokitdok.com"
   s.extra_rdoc_files = [
@@ -42,7 +42,6 @@ Gem::Specification.new do |s|
     "vcr_cassettes/eligibility.yml",
     "vcr_cassettes/enrollment.yml",
     "vcr_cassettes/files.yml",
-    "vcr_cassettes/insurance_prices.yml",
     "vcr_cassettes/payers.yml",
     "vcr_cassettes/providers.yml"
   ]
@@ -72,6 +71,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<guard-minitest>, ["~> 2.2"])
       s.add_development_dependency(%q<terminal-notifier-guard>, ["~> 1.5"])
       s.add_development_dependency(%q<guard-rubocop>, ["~> 1.0"])
+      s.add_development_dependency(%q<coveralls>, [">= 0"])
     else
       s.add_dependency(%q<oauth2>, ["~> 0.9"])
       s.add_dependency(%q<multipart-post>, ["~> 2.0"])
@@ -90,6 +90,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<guard-minitest>, ["~> 2.2"])
       s.add_dependency(%q<terminal-notifier-guard>, ["~> 1.5"])
       s.add_dependency(%q<guard-rubocop>, ["~> 1.0"])
+      s.add_dependency(%q<coveralls>, [">= 0"])
     end
   else
     s.add_dependency(%q<oauth2>, ["~> 0.9"])
@@ -109,6 +110,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<guard-minitest>, ["~> 2.2"])
     s.add_dependency(%q<terminal-notifier-guard>, ["~> 1.5"])
     s.add_dependency(%q<guard-rubocop>, ["~> 1.0"])
+    s.add_dependency(%q<coveralls>, [">= 0"])
   end
 end
 

data/spec/fixtures/claim.json

@@ -1,116 +1,46 @@
 {
-    "app_transaction_id": "00000000001", 
-    "billing_provider": {
-        "address_line_1": "418 FARMS DR", 
-        "city": "BURLINGTON", 
-        "entity_identifier": "Billing Provider", 
-        "entity_type": "Non-Person", 
-        "id_code": "1730240128", 
-        "id_type": "NPI", 
-        "last_org_name": "KATIE BRADFORD", 
-        "postal_code": "018033744", 
-        "provider_code": "Billing", 
-        "provider_id_code": "133V00000X", 
-        "provider_id_type": "Provider Taxonomy Code", 
-        "ref": [
-            {
-                "id_code": "587654321", 
-                "id_type": "Employee Identification Number"
-            }
-        ], 
-        "state": "MA"
-    }, 
-    "claim": {
-        "assignment_code": "Assigned", 
-        "benefit_assignment_code": "Yes", 
-        "claim_frequency_code": "1", 
-        "claim_total_amount": {
-            "amount": "40.0", 
-            "currency": "USD"
-        }, 
-        "dates": [
-            {
-                "date_qualifier": "Onset of Symptom or Illness", 
-                "date_value": "04/15/2014"
-            }
-        ], 
-        "facility_code_qualifier": "B", 
-        "facility_code_value": "11", 
-        "health_care_codes": [
-            {
-                "health_care_code_1": "BK:0340", 
-                "health_care_code_2": "BF:V7389"
-            }
-        ], 
-        "information_release_code": "Informed Consent", 
-        "patient_control_number": "26462967", 
-        "provider_signature_on_file": "Y", 
-        "ref": [
-            {
-                "id_code": "1234567890", 
-                "id_type": "Claim Number"
-            }
-        ], 
-        "service_lines": [
-            {
-                "dates": [
-                    {
-                        "date_qualifier": "Service Date", 
-                        "date_value": "04/16/2014"
-                    }
-                ], 
-                "medical_charge_amount": {
-                    "amount": "40.0", 
-                    "currency": "USD"
-                }, 
-                "medical_diagnosis_code": "1", 
-                "medical_procedure_identifier": "HC:99213", 
-                "medical_service_quantity": "1.0", 
-                "medical_service_unit": "Unit"
-            }
-        ]
-    }, 
-    "payer": {
-        "entity_identifier": "Payer", 
-        "entity_type": "Non-Person", 
-        "id_code": "HPHC", 
-        "id_type": "Payor Identification", 
-        "last_org_name": "HARVARD PILGRIM HEALTH CARE"
-    }, 
-    "receiver": {
-        "entity_identifier": "Receiver", 
-        "entity_type": "Non-Person", 
-        "id_code": "HPHC", 
-        "id_type": "ETIN", 
-        "last_org_name": "HPHC"
-    }, 
-    "submitter": {
-        "entity_identifier": "Submitter", 
-        "entity_type": "Non-Person", 
-        "id_code": "123456789", 
-        "id_type": "ETIN", 
-        "last_org_name": "ACME, INC."
-    }, 
-    "subscriber": {
-        "address_line_1": "123 MAIN ST", 
-        "birth_date": "Sat May  1 00:00:00 1943", 
-        "city": "BURLINGTON", 
-        "claim_filing_code": "Health Maintenance Organization", 
-        "entity_identifier": "Subscriber", 
-        "entity_type": "Person", 
-        "first_name": "TED", 
-        "gender_code": "Male", 
-        "group_number": "12312-A", 
-        "id_code": "HP123456700", 
-        "id_type": "Member ID", 
-        "is_patient": true, 
-        "last_org_name": "SMITH", 
-        "payer_responsibility": "Primary", 
-        "postal_code": "01803", 
-        "relationship_code": "Self", 
-        "state": "MA"
-    }, 
-    "trading_partner_id": "MOCKPAYER", 
-    "transaction_purpose_code": "Original", 
-    "transaction_type": "Reporting"
+  "transaction_code": "chargeable",
+  "trading_partner_id": "MOCKPAYER",
+  "billing_provider": {
+    "taxonomy_code": "207Q00000X",
+    "first_name": "Jerome",
+    "last_name": "Aya-Ay",
+    "npi": "1467560003",
+    "address": {
+      "address_lines": ["8311 WARREN H ABERNATHY HWY"],
+      "city": "SPARTANBURG",
+      "state": "SC",
+      "zipcode": "29301"
+    },
+    "tax_id": "123456789"
+  },
+  "subscriber": {
+    "first_name": "Jane",
+    "last_name": "Doe",
+    "member_id": "W000000000",
+    "address": {
+      "address_lines": ["123 N MAIN ST"],
+      "city": "SPARTANBURG",
+      "state": "SC",
+      "zipcode": "29301"
+    },
+    "birth_date": "1970-01-01",
+    "gender": "female"
+  },
+  "claim": {
+    "total_charge_amount": 60.0,
+    "service_lines": [
+      {
+        "procedure_code": "99213",
+        "charge_amount": 60.0,
+        "unit_count": 1.0,
+        "diagnosis_codes": ["487.1"],
+        "service_date": "2014-06-01"
+      }
+    ]
+  },
+  "payer": {
+    "organization_name": "Acme Ins Co",
+    "plan_id": "1234567890"
+  }
 }

data/spec/pokitdok_spec.rb

@@ -4,7 +4,7 @@ require 'spec_helper'
 
 CLIENT_ID = '4nhMZTpLxBxmiocveVb5'
 CLIENT_SECRET = 'HUIpG9fFf9Qku9mh0lO50SPSDiju3D9Cjx17oeCN'
-POKITDOK_TEST_URL = 'http://localhost:5002/api/v3'
+POKITDOK_TEST_URL = 'http://localhost:5002'
 
 def check_meta_and_data(result)
   refute_empty result['meta']
@@ -14,13 +14,22 @@ end
 describe PokitDok do
   describe 'Authenticated functions' do
     before do
-      PokitDok::PokitDok.any_instance.stubs(:api_url)
-        .returns(POKITDOK_TEST_URL)
+      PokitDok::PokitDok.any_instance.stubs(:url_base).returns(POKITDOK_TEST_URL)
+
       VCR.use_cassette 'auth' do
         @pokitdok = PokitDok::PokitDok.new(CLIENT_ID, CLIENT_SECRET)
       end
     end
 
+    it 'should default to the v4 api specification' do
+      @pokitdok.api_url.must_equal 'http://localhost:5002/api/v4'
+    end
+
+    it 'should revert to the v3 api specification if requested' do
+      @pokitdok3 = PokitDok::PokitDok.new(CLIENT_ID, CLIENT_SECRET, 'v3')
+      @pokitdok3.api_url.must_equal 'http://localhost:5002/api/v3'
+    end
+
     it 'should instantiate with a client id and client secret' do
       refute_nil(@pokitdok, 'New PokitDok was nil.')
     end
@@ -45,8 +54,16 @@ describe PokitDok do
     end
 
     describe 'Cash Prices endpoint' do
-      it 'is unimplemented' do
-        proc { @pokitdok.cash_prices }.must_raise(NotImplementedError)
+      it 'should expose the cash prices endpoint' do
+        skip 'in development'
+        query = { cpt_code: '12345', zip_code: '75201' }
+
+        VCR.use_cassette 'cash_prices' do
+          @prices = @pokitdok.cash_prices query
+        end
+
+        check_meta_and_data @prices
+        refute_empty @prices['data']
       end
     end
 
@@ -64,30 +81,22 @@ describe PokitDok do
       end
     end
 
-    describe 'Claims Status endpoint' do
-      it 'is unimplemented' do
-        proc { @pokitdok.claim_status }.must_raise(NotImplementedError)
-      end
-    end
-
-    describe 'Deductible endpoint' do
-      it 'is unimplemented' do
-        proc { @pokitdok.deductible }.must_raise(NotImplementedError)
-      end
-    end
-
     describe 'Eligibility endpoint' do
       it 'should expose the eligibility endpoint' do
         @eligibility_query = {
-          trading_partner_id: 'MOCKPAYER',
-          member_id: 'W34237875729',
-          provider_id: '1467560003',
-          provider_name: 'AYA-AY',
-          provider_first_name: 'JEROME',
-          provider_type: 'Person',
-          member_name: 'JOHN DOE',
-          member_birth_date: '05-21-1975',
-          service_types: ['Health Benefit Plan Coverage']
+          member: {
+              birth_date: '1970-01-01',
+              first_name: 'Jane',
+              last_name: 'Doe',
+              id: 'W000000000'
+          },
+          provider: {
+              first_name: 'JEROME',
+              last_name: 'AYA-AY',
+              npi: '1467560003'
+          },
+          service_types: ['health_benefit_plan_coverage'],
+          trading_partner_id: 'MOCKPAYER'
         }
 
         VCR.use_cassette 'eligibility' do
@@ -127,18 +136,6 @@ describe PokitDok do
       end
     end
 
-    describe 'Insurance Prices endpoint' do
-      it 'should expose the insurance prices endpoint' do
-        VCR.use_cassette 'insurance_prices' do
-          @prices = @pokitdok.insurance_prices(zip_code: '54321',
-                                               cpt_code: '12345')
-        end
-
-        check_meta_and_data @prices
-        refute_empty @prices['data']
-      end
-    end
-
     describe 'Payers endpoint' do
       it 'should expose the payers endpoint' do
         VCR.use_cassette 'payers' do