pokitdok-ruby 0.2.3

data/pokitdok-ruby.gemspec

@@ -0,0 +1,114 @@
+# Generated by jeweler
+# 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
+
+Gem::Specification.new do |s|
+  s.name = "pokitdok-ruby"
+  s.version = "0.2.3"
+
+  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.description = "Gem for easy access to the PokitDok Platform APIs."
+  s.email = "john.riney@pokitdok.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "lib/pokitdok.rb",
+    "pokitdok-ruby.gemspec",
+    "spec/fixtures/claim.json",
+    "spec/fixtures/enrollment.json",
+    "spec/fixtures/sample.270",
+    "spec/pokitdok_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/vcr_setup.rb",
+    "vcr_cassettes/activities.yml",
+    "vcr_cassettes/auth.yml",
+    "vcr_cassettes/claims.yml",
+    "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"
+  ]
+  s.homepage = "http://github.com/pokitdok/pokitdok-ruby"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.2.2"
+  s.summary = "Gem for easy access to the PokitDok Platform APIs"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<oauth2>, ["~> 0.9"])
+      s.add_runtime_dependency(%q<multipart-post>, ["~> 2.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<minitest>, ["~> 5.3"])
+      s.add_development_dependency(%q<mocha>, ["~> 1.0"])
+      s.add_development_dependency(%q<simplecov>, ["~> 0.8"])
+      s.add_development_dependency(%q<rubocop>, ["~> 0.20"])
+      s.add_development_dependency(%q<rdoc>, ["~> 4.1"])
+      s.add_development_dependency(%q<jeweler>, ["~> 2.0"])
+      s.add_development_dependency(%q<ansi>, ["~> 1.4"])
+      s.add_development_dependency(%q<minitest-reporters>, ["~> 1.0"])
+      s.add_development_dependency(%q<vcr>, ["~> 2.9"])
+      s.add_development_dependency(%q<webmock>, ["~> 1.17"])
+      s.add_development_dependency(%q<guard>, ["~> 2.6"])
+      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"])
+    else
+      s.add_dependency(%q<oauth2>, ["~> 0.9"])
+      s.add_dependency(%q<multipart-post>, ["~> 2.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<minitest>, ["~> 5.3"])
+      s.add_dependency(%q<mocha>, ["~> 1.0"])
+      s.add_dependency(%q<simplecov>, ["~> 0.8"])
+      s.add_dependency(%q<rubocop>, ["~> 0.20"])
+      s.add_dependency(%q<rdoc>, ["~> 4.1"])
+      s.add_dependency(%q<jeweler>, ["~> 2.0"])
+      s.add_dependency(%q<ansi>, ["~> 1.4"])
+      s.add_dependency(%q<minitest-reporters>, ["~> 1.0"])
+      s.add_dependency(%q<vcr>, ["~> 2.9"])
+      s.add_dependency(%q<webmock>, ["~> 1.17"])
+      s.add_dependency(%q<guard>, ["~> 2.6"])
+      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"])
+    end
+  else
+    s.add_dependency(%q<oauth2>, ["~> 0.9"])
+    s.add_dependency(%q<multipart-post>, ["~> 2.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<minitest>, ["~> 5.3"])
+    s.add_dependency(%q<mocha>, ["~> 1.0"])
+    s.add_dependency(%q<simplecov>, ["~> 0.8"])
+    s.add_dependency(%q<rubocop>, ["~> 0.20"])
+    s.add_dependency(%q<rdoc>, ["~> 4.1"])
+    s.add_dependency(%q<jeweler>, ["~> 2.0"])
+    s.add_dependency(%q<ansi>, ["~> 1.4"])
+    s.add_dependency(%q<minitest-reporters>, ["~> 1.0"])
+    s.add_dependency(%q<vcr>, ["~> 2.9"])
+    s.add_dependency(%q<webmock>, ["~> 1.17"])
+    s.add_dependency(%q<guard>, ["~> 2.6"])
+    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"])
+  end
+end
+

data/spec/fixtures/claim.json

@@ -0,0 +1,116 @@
+{
+    "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"
+}

data/spec/fixtures/enrollment.json

@@ -0,0 +1,81 @@
+{
+    "action": "Change", 
+    "client_id": "x12parse", 
+    "correlation_id": "123456789",
+    "deleted": false, 
+    "dependents": [], 
+    "insert_dt": "Wed Mar 26 22:18:47 2014", 
+    "payer": {
+        "tax_id": "654456654"
+    }, 
+    "purpose": "Original", 
+    "reference_number": "12456", 
+    "sponsor": {
+        "tax_id": "999888777"
+    }, 
+    "subscriber": {
+        "address": {
+            "city": "CAMP HILL", 
+            "county": "CUMBERLAND", 
+            "line": "100 MARKET ST", 
+            "line2": "APT 3G", 
+            "postal_code": "17011", 
+            "state": "PA"
+        }, 
+        "benefit_status": "Active", 
+        "benefits": [
+            {
+                "begin_date": "Sat Jun  1 00:00:00 1996", 
+                "benefit_type": "Health", 
+                "coordination_of_benefits": [
+                    {
+                        "group_or_policy_number": "890111", 
+                        "payer_responsibility": "Primary", 
+                        "status": "Unknown"
+                    }
+                ], 
+                "late_enrollment": false, 
+                "maintenance_type": "Addition"
+            }, 
+            {
+                "begin_date": "Sat Jun  1 00:00:00 1996", 
+                "benefit_type": "Dental", 
+                "late_enrollment": false, 
+                "maintenance_type": "Addition"
+            }, 
+            {
+                "begin_date": "Sat Jun  1 00:00:00 1996", 
+                "benefit_type": "Vision", 
+                "late_enrollment": false, 
+                "maintenance_type": "Addition"
+            }
+        ], 
+        "birth_date": "Fri Aug 16 00:00:00 1940", 
+        "contacts": [
+            {
+                "communication_number2": "7172341240", 
+                "communication_type2": "Work Phone Number", 
+                "primary_communication_number": "7172343334", 
+                "primary_communication_type": "Home Phone Number"
+            }
+        ], 
+        "eligibility_begin_date": "Thu May 23 00:00:00 1996", 
+        "employment_status": "Full-time", 
+        "first_name": "JOHN", 
+        "gender": "Male", 
+        "group_or_policy_number": "123456001", 
+        "handicapped": false, 
+        "last_name": "DOE", 
+        "maintenance_reason": "Active", 
+        "maintenance_type": "Addition", 
+        "member_id": "123456789", 
+        "middle_name": "P", 
+        "relationship": "Self", 
+        "ssn": "123456789", 
+        "subscriber_number": "123456789", 
+        "substance_abuse": false, 
+        "tobacco_use": false
+    }, 
+    "trading_partner_id": "MOCKPAYER", 
+    "update_dt": "Wed Mar 26 22:18:47 2014"
+}

data/spec/fixtures/sample.270

@@ -0,0 +1,131 @@
+ISA*00*          *00*          *30*SENDER         *30*RECEIVER       *140305*1953*^*00501*000000905*0*T*:~
+GS*HS*SENDER_ID*RECEIVER_ID*20140305*1953*CONTROL_ID*X*005010X279A1~
+ST*270*0001*005010X279A1~
+BHT*0022*13*813785794*20140305*1953~
+HL*1**20*1~
+NM1*PR*2*MOCKPAYER*****PI*MOCKPAYER~
+HL*2*1*21*1~
+NM1*1P*2*Wuckert Inc*****XX*581603684~
+HL*3*2*22*0~
+TRN*1*181399807*9324422845~
+NM1*IL*1*Tromp*Jerod****MI*545943979~
+DMG*D8*19960507~
+DTP*291*D8*20140305~
+EQ*30~
+HL*4*2*22*0~
+TRN*1*611822238*9324422845~
+NM1*IL*1*Walker*Hassan****MI*773415451~
+DMG*D8*19960613~
+DTP*291*D8*20140305~
+EQ*30~
+HL*5*2*22*0~
+TRN*1*530994264*9324422845~
+NM1*IL*1*Johns*Cathrine****MI*505837362~
+DMG*D8*19881001~
+DTP*291*D8*20140305~
+EQ*30~
+HL*6*2*22*0~
+TRN*1*145769779*9324422845~
+NM1*IL*1*Durgan*Stephon****MI*204791243~
+DMG*D8*19830509~
+DTP*291*D8*20140305~
+EQ*30~
+HL*7*2*22*0~
+TRN*1*853276515*9324422845~
+NM1*IL*1*Erdman*Bartholome****MI*994176438~
+DMG*D8*19930513~
+DTP*291*D8*20140305~
+EQ*30~
+HL*8*2*22*0~
+TRN*1*392506326*9324422845~
+NM1*IL*1*Padberg*Kaci****MI*331914222~
+DMG*D8*19920730~
+DTP*291*D8*20140305~
+EQ*30~
+HL*9*2*22*0~
+TRN*1*669106647*9324422845~
+NM1*IL*1*Donnelly*Kyleigh****MI*461763996~
+DMG*D8*19890712~
+DTP*291*D8*20140305~
+EQ*30~
+HL*10*2*22*0~
+TRN*1*915888295*9324422845~
+NM1*IL*1*Monahan*Jimmie****MI*315531994~
+DMG*D8*19950414~
+DTP*291*D8*20140305~
+EQ*30~
+HL*11*2*22*0~
+TRN*1*924598474*9324422845~
+NM1*IL*1*Bednar*Markus****MI*674957204~
+DMG*D8*19780109~
+DTP*291*D8*20140305~
+EQ*30~
+HL*12*2*22*0~
+TRN*1*218563674*9324422845~
+NM1*IL*1*McCullough*Leland****MI*789318226~
+DMG*D8*19800202~
+DTP*291*D8*20140305~
+EQ*30~
+HL*13*2*22*0~
+TRN*1*764225581*9324422845~
+NM1*IL*1*Macejkovic*Norwood****MI*605486216~
+DMG*D8*19890726~
+DTP*291*D8*20140305~
+EQ*30~
+HL*14*2*22*0~
+TRN*1*843675248*9324422845~
+NM1*IL*1*Ortiz*Keyon****MI*178470414~
+DMG*D8*19920126~
+DTP*291*D8*20140305~
+EQ*30~
+HL*15*2*22*0~
+TRN*1*575530276*9324422845~
+NM1*IL*1*Doyle*Olin****MI*727454392~
+DMG*D8*19890922~
+DTP*291*D8*20140305~
+EQ*30~
+HL*16*2*22*0~
+TRN*1*583253119*9324422845~
+NM1*IL*1*Doyle*Greg****MI*302952193~
+DMG*D8*19890228~
+DTP*291*D8*20140305~
+EQ*30~
+HL*17*2*22*0~
+TRN*1*494693024*9324422845~
+NM1*IL*1*Brekke*Nathanial****MI*228065686~
+DMG*D8*19910131~
+DTP*291*D8*20140305~
+EQ*30~
+HL*18*2*22*0~
+TRN*1*654387679*9324422845~
+NM1*IL*1*Herzog*Jayme****MI*653618078~
+DMG*D8*19871017~
+DTP*291*D8*20140305~
+EQ*30~
+HL*19*2*22*0~
+TRN*1*864981376*9324422845~
+NM1*IL*1*Ebert*Heaven****MI*548879156~
+DMG*D8*19930416~
+DTP*291*D8*20140305~
+EQ*30~
+HL*20*2*22*0~
+TRN*1*618055454*9324422845~
+NM1*IL*1*Cummerata*Hector****MI*688306042~
+DMG*D8*19780613~
+DTP*291*D8*20140305~
+EQ*30~
+HL*21*2*22*0~
+TRN*1*608414882*9324422845~
+NM1*IL*1*Kerluke*Enola****MI*687416329~
+DMG*D8*19960902~
+DTP*291*D8*20140305~
+EQ*30~
+HL*22*2*22*0~
+TRN*1*568364627*9324422845~
+NM1*IL*1*Wehner*Alyce****MI*728313788~
+DMG*D8*19701130~
+DTP*291*D8*20140305~
+EQ*30~
+SE*127*0001~
+GE*1*CONTROL_ID~
+IEA*1*000000905~

data/spec/pokitdok_spec.rb

@@ -0,0 +1,168 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+CLIENT_ID = '4nhMZTpLxBxmiocveVb5'
+CLIENT_SECRET = 'HUIpG9fFf9Qku9mh0lO50SPSDiju3D9Cjx17oeCN'
+POKITDOK_TEST_URL = 'http://localhost:5002/api/v3'
+
+def check_meta_and_data(result)
+  refute_empty result['meta']
+  refute_empty result['data']
+end
+
+describe PokitDok do
+  describe 'Authenticated functions' do
+    before do
+      PokitDok::PokitDok.any_instance.stubs(:api_url)
+        .returns(POKITDOK_TEST_URL)
+      VCR.use_cassette 'auth' do
+        @pokitdok = PokitDok::PokitDok.new(CLIENT_ID, CLIENT_SECRET)
+      end
+    end
+
+    it 'should instantiate with a client id and client secret' do
+      refute_nil(@pokitdok, 'New PokitDok was nil.')
+    end
+
+    it 'should authenticate on a new connection' do
+      refute_nil @pokitdok.client
+    end
+
+    it 'should refresh the connection if it expires' do
+      skip 'Not implemented'
+    end
+
+    describe 'Activities endpoint' do
+      it 'should expose the activities endpoint' do
+        VCR.use_cassette 'activities' do
+          @activities = @pokitdok.activities
+        end
+
+        check_meta_and_data @activities
+        refute_empty @activities['data']
+      end
+    end
+
+    describe 'Cash Prices endpoint' do
+      it 'is unimplemented' do
+        proc { @pokitdok.cash_prices }.must_raise(NotImplementedError)
+      end
+    end
+
+    describe 'Claims endpoint' do
+      it 'should expose the claims endpoint' do
+        query = JSON.parse(IO.read('spec/fixtures/claim.json'))
+        VCR.use_cassette 'claims' do
+          @claim = @pokitdok.claims(query)
+        end
+
+        check_meta_and_data @claim
+        refute_empty @claim['data']
+        @claim['data']['units_of_work'].must_equal 1
+        assert_nil @claim['errors']
+      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']
+        }
+
+        VCR.use_cassette 'eligibility' do
+          @eligibility = @pokitdok.eligibility(@eligibility_query)
+        end
+
+        check_meta_and_data @eligibility
+        refute_nil @eligibility['data']
+        assert_nil @eligibility['data']['errors']
+      end
+    end
+
+    describe 'Enrollment endpoint' do
+      it 'should expose the enrollment endpoint' do
+        query = JSON.parse(IO.read('spec/fixtures/enrollment.json'))
+
+        VCR.use_cassette 'enrollment' do
+          @enrollment = @pokitdok.enrollment(query)
+        end
+
+        check_meta_and_data @enrollment
+        @enrollment['data']['units_of_work'].must_equal 1
+        assert_nil @enrollment['data']['errors']
+      end
+    end
+
+    describe 'Files endpoint' do
+      it 'should expose the files endpoint' do
+        VCR.use_cassette 'files' do
+          @response = @pokitdok.files('MOCKPAYER',
+                                      'spec/fixtures/sample.270')
+        end
+
+        check_meta_and_data @response
+        refute_nil @response
+        # TODO: should get back an activity id
+      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
+          @payers = @pokitdok.payers(state: 'CA')
+        end
+
+        check_meta_and_data @payers
+        refute_nil @payers['data']
+        @payers['data'].size.must_equal 36
+      end
+    end
+
+    describe 'Providers endpoint' do
+      it 'should expose the providers endpoint' do
+        query = { state: 'CA' }
+
+        VCR.use_cassette 'providers' do
+          @providers = @pokitdok.providers(query)
+        end
+
+        check_meta_and_data @providers
+        refute_nil @providers['data']
+        @providers['data'].size.must_equal 20
+      end
+    end
+  end
+end