athena_health 1.0.48 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a3db01db3800d67cecaf5fa22f8bf950464f40a5462cd7159dee81baf3ca070
-  data.tar.gz: 86e9a28cefe5c061cd6ae3ec502f802722d5fcbbc79b1dcff0382b9218753ce7
+  metadata.gz: 770807e4bf3b5d93401d26193dbb62d5a08bc1aa920c09f2912759ae1a664800
+  data.tar.gz: 118ffe8282b8e6d7883a748deda6fa2ce11c5b5cbb963b75bf75e6d76d1a220e
 SHA512:
-  metadata.gz: 1e65a0d9adc3602a19335331a2d5442158b619a4182f80870dece99e8c062e348b9ad1317bcbfb636d9bdd0750475708dd72660537409dfbc323f7fd7afabbfa
-  data.tar.gz: 634976ef4750d4ebba167e92f965593844e6e15a70c4c91275e95838563d01559cee8deb8a7c7535ed0006b3e6d48561ff24d02580d93589dcbf99e03daf89b6
+  metadata.gz: '0950f98045fcd302746921577823ddb7e3cf4deeb3c93f67ba7842d0c8bb4447eecdf02d068b77fa50a2befabe538bdde158fa7236b60a09f155ef80231f2a91'
+  data.tar.gz: 46da095cbeddb4fdd552ad7932388185166b3ad867c67bf5c07deaf02e55727c67394e141a7babfcedbdf5f2c44f1656afffcd87400e5471a886e6106a25ec21

data/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: Continuous integration
+on: push
+
+jobs:
+  verify:
+    name: Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.0.1
+
+      - name: Ruby gem cache
+        uses: actions/cache@v2
+        with:
+          path: vendor/bundle
+          key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-gems-
+      - name: Install gems
+        run: |
+          bundle install --jobs 4 --retry 3
+
+      - name: Run tests
+        env:
+          RACK_ENV: test
+        run: bundle exec rspec

data/.ruby-version

@@ -0,0 +1 @@
+3.0.1

data/README.md

@@ -4,7 +4,64 @@
 
 # AthenaHealth
 
-Ruby wrapper for [Athenahealth API](http://www.athenahealth.com/developer-portal).
+Ruby wrapper for [Athenahealth API](https://developer.api.athena.io/).
+
+## Updating from gem version 1 (Mashery API) to gem version 2 (https://developer.api.athena.io/ API)
+
+There is only one change needed to upgrade, and that is how you create a new client. 
+
+The new signature has 3 keywords:
+```AthenaHealth::Client.new(production:, client_id: secret:)```
+* `production:`
+  * `boolean` 
+  * default `false`
+  * this replaces the `version:` keyword
+  * indicates if you want to access the preview enviroment or the production enviroment.
+* `client_id:`
+  * `string`
+  * no default
+  * this replaces the `key:` keyword
+  * this should be your **Client ID** from the developer portal
+* `secret:`
+  * `string`
+  * no default
+  * this should be your **Secret** from the developer portal
+
+### Example
+#### Gem v1 code
+Preview: 
+```
+client = AthenaHealth::Client.new(
+  version: 'preview1',
+  key: "my_client_id",
+  secret: "my_secret"
+)
+```
+Production: 
+```
+client = AthenaHealth::Client.new(
+  version: 'v1',
+  key: "my_client_id",
+  secret: "my_secret"
+)
+```
+#### Gem v2 code
+Preview: 
+```
+client = AthenaHealth::Client.new(
+  production: false,
+  client_id: "my_client_id",
+  secret: "my_secret"
+)
+```
+Production: 
+```
+client = AthenaHealth::Client.new(
+  production: true,
+  client_id: "my_client_id",
+  secret: "my_secret"
+)
+```
 
 ## Examples
 
@@ -18,7 +75,7 @@ For some examples of how to use this library, check out [the project wiki](https
  - Ensure you have Ruby and the Bundler gem installed
  - Install the gem dependencies with `bundle`
  - Setup Environment Variables before testing new endpoints, you'll need the following:
-  - ATHENA_TEST_KEY
+  - ATHENA_TEST_CLIENT_ID
   - ATHENA_TEST_SECRET
   - ATHENA_TEST_ACCESS_TOKEN
 

data/athena_health.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'typhoeus'
   spec.add_dependency 'virtus'
 
-  spec.add_development_dependency 'bundler', '~> 1.11'
+  spec.add_development_dependency 'bundler', '~> 2.2.24'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.2'
   spec.add_development_dependency 'vcr', '~> 3.0'

data/lib/athena_health.rb

@@ -12,9 +12,14 @@ require 'athena_health/endpoints/providers'
 require 'athena_health/endpoints/insurance_packages'
 require 'athena_health/endpoints/encounters'
 require 'athena_health/endpoints/configurations'
+require 'athena_health/endpoints/subscriptions'
+require 'athena_health/endpoints/claims'
+require 'athena_health/endpoints/custom_fields'
 require 'athena_health/client'
 require 'athena_health/base_collection'
 require 'athena_health/base_model'
+require 'athena_health/custom_field'
+require 'athena_health/custom_field_data'
 require 'athena_health/practice'
 require 'athena_health/practice_collection'
 require 'athena_health/department'
@@ -73,6 +78,9 @@ require 'athena_health/user_medication_event'
 require 'athena_health/user_medication_sig'
 require 'athena_health/user_medication'
 require 'athena_health/user_medication_collection'
+require 'athena_health/subscription'
+require 'athena_health/claim/claim'
+require 'athena_health/claim/claim_collection'
 
 module AthenaHealth
 end

data/lib/athena_health/claim/claim.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'athena_health/claim/diagnosis'
+require 'athena_health/claim/payer'
+require 'athena_health/claim/procedure'
+module AthenaHealth
+  module Claim
+    class Claim < BaseModel
+      attribute :diagnoses, Array[Diagnosis]
+      attribute :primaryinsurancepayer, Payer
+      attribute :patientpayer, Payer
+      attribute :claimcreatedate, String
+      attribute :billedproviderid, Integer
+      attribute :billedservicedate, String
+      attribute :appointmentid, Integer
+      attribute :patientid, Integer
+      attribute :departmentid, Integer
+      attribute :customfields, Array[CustomFieldData]
+      attribute :reserved19, String
+      attribute :referringproviderid, Integer
+      attribute :procedures, Array[Procedure]
+      attribute :referralauthid, Integer
+      attribute :secondaryinsurancepayer, Payer
+      attribute :chargeamount, String
+      attribute :transactiondetails, Hash
+      attribute :claimid, Integer
+      attribute :transactionid, Integer
+    end
+  end
+end

data/lib/athena_health/claim/claim_collection.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Claim
+    class ClaimCollection < BaseCollection
+      attribute :claims, Array[Claim]
+    end
+  end
+end

data/lib/athena_health/claim/diagnosis.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Claim
+    class Diagnosis < BaseModel
+      attribute :diagnosisid,           Integer
+      attribute :diagnosiscategory,     String
+      attribute :diagnosisrawcode,      String
+      attribute :diagnosiscodeset,      String
+      attribute :diagnosisdescription,  String
+      attribute :deleteddiagnosis,      Boolean
+    end
+  end
+end

data/lib/athena_health/claim/payer.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Claim
+    class Payer < BaseModel
+      attribute :patientinsuranceid, Integer
+      attribute :status, String
+      attribute :chargeamount, String
+      attribute :note, String
+
+      def initialize(args)
+        self.patientinsuranceid = args['primarypatientinsuranceid'] || args['secondarypatientinsuranceid']
+        super(args)
+      end
+    end
+  end
+end

data/lib/athena_health/claim/procedure.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Claim
+    class Procedure < BaseModel
+      attribute :transactionid, Integer
+      attribute :allowableamount, String
+      attribute :procedurecategory, String
+      attribute :allowablemin, String
+      attribute :proceduredescription, String
+      attribute :chargeamount, String
+      attribute :procedurecode, String
+      attribute :allowablemax, String
+    end
+  end
+end

data/lib/athena_health/client.rb

@@ -1,9 +1,9 @@
 module AthenaHealth
   class Client
-    def initialize(version:, key:, secret:, token: nil)
+    def initialize(production: false, client_id:, secret:, token: nil)
       @api = AthenaHealth::Connection.new(
-        version: version,
-        key: key,
+        production: production,
+        client_id: client_id,
         secret: secret,
         token: token,
       )
@@ -17,5 +17,8 @@ module AthenaHealth
     include Endpoints::InsurancePackages
     include Endpoints::Encounters
     include Endpoints::Configurations
+    include Endpoints::Subscriptions
+    include Endpoints::Claims
+    include Endpoints::CustomFields
   end
 end

data/lib/athena_health/connection.rb

@@ -2,22 +2,25 @@ require 'json'
 
 module AthenaHealth
   class Connection
-    BASE_URL    = 'https://api.athenahealth.com'.freeze
-    AUTH_PATH   = { 'v1' => 'oauth', 'preview1' => 'oauthpreview', 'openpreview1' => 'oauthopenpreview' }
+    PRODUCTION_BASE_URL    = 'https://api.platform.athenahealth.com'.freeze
+    PREVIEW_BASE_URL = 'https://api.preview.platform.athenahealth.com'.freeze
+    API_VERSION = 'v1'.freeze
 
-    def initialize(version:, key:, secret:, token: nil, base_url: BASE_URL)
-      @version = version
-      @key = key
+    def initialize(client_id:, secret:, token: nil, production: )
+      @client_id = client_id
       @secret = secret
       @token = token
-      @base_url = base_url
+      @production = production
     end
 
     def authenticate
       response = Typhoeus.post(
-        "#{@base_url}/#{AUTH_PATH[@version]}/token",
-        userpwd: "#{@key}:#{@secret}",
-        body: { grant_type: 'client_credentials' }
+        "#{base_url}/oauth2/#{API_VERSION}/token",
+        userpwd: "#{@client_id}:#{@secret}",
+        body: { 
+          grant_type: 'client_credentials', 
+          scope: 'athena/service/Athenanet.MDP.*' 
+        }
       ).response_body
 
       @token = JSON.parse(response)['access_token']
@@ -27,7 +30,7 @@ module AthenaHealth
       authenticate if @token.nil?
 
       response = Typhoeus::Request.new(
-        "#{@base_url}/#{@version}/#{endpoint}",
+        "#{base_url}/#{API_VERSION}/#{endpoint}",
         method: method,
         headers: { "Authorization" => "Bearer #{@token}"},
         params: params,
@@ -61,5 +64,9 @@ module AthenaHealth
     def json_response(body)
       JSON.parse(body)
     end
+
+    def base_url
+      @base_url ||= @production ? PRODUCTION_BASE_URL : PREVIEW_BASE_URL
+    end
   end
 end

data/lib/athena_health/custom_field.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  class CustomField < BaseModel
+    attribute :ordering, String
+    attribute :name, String
+    attribute :length, String
+    attribute :type, String
+    attribute :disallowupdateyn, Boolean
+    attribute :casesensitiveyn, Boolean
+    attribute :searchableyn, Boolean
+    attribute :selectyn, Boolean
+
+    attribute :customfieldid, Integer
+    attribute :selectlist, Array[Hash]
+  end
+end

data/lib/athena_health/custom_field_data.rb

@@ -0,0 +1,7 @@
+module AthenaHealth
+  class CustomFieldData < BaseModel
+    attribute :customfieldvalue,    String
+    attribute :customfieldid, Integer
+    attribute :optionid, Integer
+  end
+end

data/lib/athena_health/department.rb

@@ -2,7 +2,7 @@ module AthenaHealth
   class Department < BaseModel
     attribute :creditcardtypes,              Array
     attribute :medicationhistoryconsent,     Boolean
-    attribute :timezoneoffset,               Fixnum
+    attribute :timezoneoffset,               Integer
     attribute :providergroupid,              Integer
     attribute :singleappointmentcontractmax, Integer
     attribute :state,                        String
@@ -18,7 +18,7 @@ module AthenaHealth
     attribute :placeofservicetypeid,         Integer
     attribute :longitude,                    Float
     attribute :clinicals,                    String
-    attribute :timezone,                     Fixnum
+    attribute :timezone,                     Integer
     attribute :patientdepartmentname,        String
     attribute :name,                         String
     attribute :placeofservicetypename,       String

data/lib/athena_health/endpoints/appointments.rb

@@ -217,26 +217,6 @@ module AthenaHealth
         InsuranceCollection.new(response)
       end
 
-      def create_appointment_subscription(practice_id:, params: {})
-        @api.call(
-          endpoint: "#{practice_id}/appointments/changed/subscription",
-          method: :post,
-          params: params
-        )
-      end
-
-      def changed_appointments(practice_id:, department_id:, params: {})
-        response = @api.call(
-          endpoint: "#{practice_id}/appointments/changed",
-          method: :get,
-          params: params.merge!(
-            departmentid: department_id
-          )
-        )
-
-        AppointmentCollection.new(response)
-      end
-
       def create_appointment_waitlist(practice_id:, params: {})
         @api.call(
           endpoint: "#{practice_id}/appointments/waitlist",

data/lib/athena_health/endpoints/claims.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Endpoints
+    module Claims
+      def find_claim(practice_id:, claim_id:, params: {})
+        response = @api.call(
+          endpoint: "#{practice_id}/claims/#{claim_id}",
+          method: :get,
+          params: params
+        )
+
+        Claim::Claim.new(response)
+      end
+    end
+  end
+end

data/lib/athena_health/endpoints/custom_fields.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Endpoints
+    module CustomFields
+      def all_custom_fields(practice_id:, params: {})
+        response = @api.call(
+          endpoint: "#{practice_id}/customfields",
+          method: :get,
+          params: params
+        )
+        response.map { |field| CustomField.new(field) }
+      end
+    end
+  end
+end

data/lib/athena_health/endpoints/encounters.rb

@@ -45,6 +45,22 @@ module AthenaHealth
           body: body
         )
       end
+
+      def create_order_group(practice_id:, patient_id:, body: {})
+        @api.call(
+          endpoint: "#{practice_id}/chart/#{patient_id}/ordergroups",
+          method: :post,
+          body: body
+        )
+      end
+
+      def create_encounter_diagnoses(practice_id:, encounter_id:, body: {})
+        @api.call(
+          endpoint: "#{practice_id}/chart/encounter/#{encounter_id}/diagnoses",
+          method: :post,
+          body: body
+        )
+      end
     end
   end
 end

data/lib/athena_health/endpoints/patients.rb

@@ -374,6 +374,14 @@ module AthenaHealth
           body: params.merge!(image: image)
         )
       end
+
+      def create_patient_case(practice_id:, patient_id:, params: {})
+        @api.call(
+          endpoint: "#{practice_id}/patients/#{patient_id}/documents/patientcase",
+          method: :post,
+          body: params
+        )
+      end
     end
   end
 end

data/lib/athena_health/endpoints/subscriptions.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module Endpoints
+    module Subscriptions
+      SUBSCRIPTION_TYPES = [
+        {
+          collection_class: 'AppointmentCollection',
+          path: 'appointments',
+          name: 'appointment',
+          plural_name: 'appointments'
+        },
+        {
+          collection_class: 'PatientCollection',
+          path: 'patients',
+          name: 'patient',
+          plural_name: 'patients'
+        },
+        {
+          collection_class: 'ProviderCollection',
+          path: 'providers',
+          name: 'provider',
+          plural_name: 'providers'
+        },
+        {
+          collection_class: 'PatientProblemCollection',
+          path: 'chart/healthhistory/problems',
+          name: 'patient_problem',
+          plural_name: 'patient_problems'
+        },
+        {
+          collection_class: 'UserAllergyCollection',
+          path: 'chart/healthhistory/allergies',
+          name: 'patient_allergy',
+          plural_name: 'patient_allergies'
+        },
+        {
+          collection_class: 'PrescriptionCollection',
+          path: 'prescriptions',
+          name: 'prescription',
+          plural_name: 'prescriptions'
+        },
+        {
+          collection_class: 'UserMedicationCollection',
+          path: 'chart/healthhistory/medication',
+          name: 'patient_medication',
+          plural_name: 'patient_medications'
+        },
+        {
+          collection_class: 'PrescriptionCollection',
+          path: 'prescriptions',
+          name: 'prescription',
+          plural_name: 'prescriptions'
+        },
+        {
+          collection_class: 'Claim::ClaimCollection',
+          path: 'claims',
+          name: 'claim',
+          plural_name: 'claims'
+        }
+      ].freeze
+
+      SUBSCRIPTION_TYPES.each do |subscription_type|
+        define_method("#{subscription_type[:name]}_subscription") do |practice_id:, params: {}|
+          response = @api.call(
+            endpoint: "#{practice_id}/#{subscription_type[:path]}/changed/subscription",
+            method: :get,
+            params: params
+          )
+
+          Subscription.new(response)
+        end
+
+        define_method("create_#{subscription_type[:name]}_subscription") do |practice_id:, params: {}|
+          @api.call(
+            endpoint: "#{practice_id}/#{subscription_type[:path]}/changed/subscription",
+            method: :post,
+            params: params
+          )
+        end
+
+        define_method("changed_#{subscription_type[:plural_name]}") do |practice_id:, department_id: nil, params: {}|
+          params[:departmentid] = department_id unless department_id.nil?
+          response = @api.call(
+            endpoint: "#{practice_id}/#{subscription_type[:path]}/changed",
+            method: :get,
+            params: params
+          )
+          Object.const_get('AthenaHealth').const_get((subscription_type[:collection_class]).to_s).new(response)
+        end
+      end
+    end
+  end
+end

data/lib/athena_health/subscription.rb

@@ -0,0 +1,14 @@
+module AthenaHealth
+  class Subscription < BaseModel
+    attribute :status,        String
+    attribute :subscriptions, Array[Hash]
+
+    def events
+      @events ||= subscriptions.map{|s| s["eventname"]}
+    end
+
+    def active?
+      @active || status === 'ACTIVE'
+    end
+  end
+end

data/lib/athena_health/version.rb

@@ -1,3 +1,3 @@
 module AthenaHealth
-  VERSION = '1.0.48'.freeze
+  VERSION = '2.0.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: athena_health
 version: !ruby/object:Gem::Version
-  version: 1.0.48
+  version: 2.0.0
 platform: ruby
 authors:
 - Mateusz Urbański
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-03-12 00:00:00.000000000 Z
+date: 2021-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: 2.2.24
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: 2.2.24
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -102,8 +102,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - ".travis.yml"
 - Gemfile
 - LICENSE.txt
@@ -124,8 +126,15 @@ files:
 - lib/athena_health/balance.rb
 - lib/athena_health/base_collection.rb
 - lib/athena_health/base_model.rb
+- lib/athena_health/claim/claim.rb
+- lib/athena_health/claim/claim_collection.rb
+- lib/athena_health/claim/diagnosis.rb
+- lib/athena_health/claim/payer.rb
+- lib/athena_health/claim/procedure.rb
 - lib/athena_health/client.rb
 - lib/athena_health/connection.rb
+- lib/athena_health/custom_field.rb
+- lib/athena_health/custom_field_data.rb
 - lib/athena_health/department.rb
 - lib/athena_health/department_collection.rb
 - lib/athena_health/document.rb
@@ -134,13 +143,16 @@ files:
 - lib/athena_health/encounter_collection.rb
 - lib/athena_health/encounter_summary.rb
 - lib/athena_health/endpoints/appointments.rb
+- lib/athena_health/endpoints/claims.rb
 - lib/athena_health/endpoints/configurations.rb
+- lib/athena_health/endpoints/custom_fields.rb
 - lib/athena_health/endpoints/departments.rb
 - lib/athena_health/endpoints/encounters.rb
 - lib/athena_health/endpoints/insurance_packages.rb
 - lib/athena_health/endpoints/patients.rb
 - lib/athena_health/endpoints/practices.rb
 - lib/athena_health/endpoints/providers.rb
+- lib/athena_health/endpoints/subscriptions.rb
 - lib/athena_health/error.rb
 - lib/athena_health/event.rb
 - lib/athena_health/facility.rb
@@ -175,6 +187,7 @@ files:
 - lib/athena_health/question_collection.rb
 - lib/athena_health/reaction.rb
 - lib/athena_health/social_history.rb
+- lib/athena_health/subscription.rb
 - lib/athena_health/template.rb
 - lib/athena_health/user_allergy.rb
 - lib/athena_health/user_allergy_collection.rb
@@ -187,7 +200,7 @@ homepage: https://github.com/zywy/athena_health
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -202,8 +215,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Ruby wrapper for Athenahealth API.
 test_files: []