change_healthcare 1.0.1

data/lib/change_healthcare/order.rb

@@ -0,0 +1,88 @@
+# https://cli-cert.emdeon.com/api/cert/order.html
+class ChangeHealthcare::Order < ChangeHealthcare::BaseApiObject
+  def self.attributes
+    [
+      :actalink_user_name, :age, :age_type, :anonymous_flag, :aoe_validation_failed,
+      :beacon_case_number, :bed, :bill_type, :billingcaregiver, :cached_requisition,
+      :callback_phone_area_code, :callback_phone_number, :cg_first_name, :cg_last_name,
+      :cg_middle_name, :collection_datetime, :created_by, :date, :description, :document,
+      :expected_coll_datetime, :fasting_hours, :faxback_phone_area_code, :faxback_phone_number,
+      :first_name, :guarantor, :guarantor_address_1, :guarantor_address_2, :guarantor_city,
+      :guarantor_first_name, :guarantor_home_phone, :guarantor_last_name, :guarantor_middle_name,
+      :guarantor_relationship, :guarantor_sex, :guarantor_state, :guarantor_suffix, :guarantor_zip,
+      :home_phone_area_code, :home_phone_number, :hospital_id, :hsilabel, :icd_10_cm_code,
+      :icd_9_cm_code, :icd_lab_accepts, :icd_validation_failed, :include_in_manifest,
+      :is_split, :lab, :lab_instruction, :lab_logo_location, :lab_name, :lab_reference,
+      :last_name, :master_placer_order_number, :middle_name, :nurse_unit, :order, :order_code,
+      :order_comment, :order_diag_description, :order_status, :order_type, :ordering_cg_id,
+      :orderingorganization, :organization_counter, :orig_organization_name, :originalorder,
+      :origorderingorganization, :pan_indicator, :parentorder, :patient_id, :person,
+      :person_address_1, :person_address_2, :person_city, :person_dob, :person_first_name,
+      :person_home_phone_area_code, :person_home_phone_number, :person_hsi_value,
+      :person_last_name, :person_middle_name, :person_sex, :person_ssn, :person_state,
+      :person_suffix, :person_zip, :personhsi, :phone_result_flag, :placer_order_number,
+      :prepaid_amount, :primaryorderingcaregiver, :ref_cg_fname, :ref_cg_lname, :ref_cg_mname,
+      :ref_cg_npi, :ref_cg_suffix, :ref_cg_upin, :referring_cg_id, :referringcaregiver,
+      :request_date, :room, :seconds_since_transmit, :sex, :stat_flag, :submission_date,
+      :suffix, :transmission_date, :username, :work_phone_area_code, :work_phone_ext, :work_phone_number
+    ]
+  end
+
+  attr_accessor(*self.attributes)
+
+  def self.chc_object_name
+    "order"
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/order.html#generate_order_number
+  # params = { lab: "1502191", orderingorganization: #{facility} }
+  def self.generate_order_number(params={})
+    resp = call_api(__method__.to_s, params, false)
+    response_to_list(resp)
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/order.html#search_by_order_info
+  # params = { placer_order_number: "76047", orderingorganization: #{facility} }
+  def self.search_by_order_info(params={})
+    resp = call_api(__method__.to_s, params, false)
+    response_to_list(resp)
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/order.html#get
+  # params = { order: "3004834610" }
+  def self.get(params={})
+    resp = call_api(__method__.to_s, params, false)
+    response_to_list(resp)
+  end
+
+  def self.e_order_summary_link(params)
+    base = {
+      "userid" => configuration.user_id,
+      "PW" => configuration.password,
+      "hdnBusiness" => configuration.facility,
+      "target" => "jsp/lab/order/ESummaryOrder.jsp",
+      "actionCommand" => "EOrderSummary",
+      "summary" => "true",
+      "apilogon" => "true",
+    }
+    params.merge!(base)
+
+    return "#{configuration.portal_url}?#{params.to_query}"
+  end
+
+
+  #{order_id: XXXXXXXXXXX}
+  def self.e_order_html_link(params)
+    base = {
+      "userid" => configuration.user_id,
+      "PW" => configuration.password,
+      "hdnBusiness" => configuration.facility,
+      "apiLogin" => "true",
+      "target" => "servlet/servlets.apiOrderServlet?",
+      "actionCommand" => "print",
+      "apiuserid" => configuration.user_id
+    }
+    params.merge!(base)
+    return "#{configuration.portal_url}?#{params.to_query}"
+  end
+end

data/lib/change_healthcare/order_diagnosis.rb

@@ -0,0 +1,59 @@
+module ChangeHealthcare
+  class OrderDiagnosis < ChangeHealthcare::BaseApiObject
+    def self.attributes
+      %i[
+        name
+        op
+        date
+        clientid
+        split_code
+        orderable
+        description
+        exclusive_flag
+        cpp_count
+        expiration_date
+        orderdiagnosis
+        orderable_type
+        special_test_flag
+        ordertest
+        specimen
+        clearance
+        freq_abn
+        icd_10_cm_code
+        order_diag_description
+        has_aoe
+        order
+        icd_9_cm_code
+        placer_order_number
+        orderable_description
+        ownerid
+        created_by
+        lcp_fda_flag
+        order_code
+        sequence
+        estimated_cost
+        category
+        user_description
+      ]
+    end
+
+    attr_accessor(*attributes)
+
+    def self.chc_object_name
+      'orderdiagnosis'
+    end
+
+    # https://cli-cert.emdeon.com/api/cert/orderdiagnosis.html#get
+    # params = {orderdiagnosis: xxxxxxxxxx} or {order: xxxxxxxxxx}
+    def self.get(params)
+      # if orderdiagnosis reference is passed in use default orderdiagnosis.get call
+      if params[:orderdiagnosis].present?
+        resp = call_api(__method__.to_s, params, false)
+        response_to_list(resp)
+      # if order reference is passed in use servlet.apiOrderServlet to grab all order details and fetch orderdiagnosis info
+      elsif params[:order].present?
+        Servlet.api_order_servlet(params)['orderdiagnosis'].map { |diagnosis| new(diagnosis) }
+      end
+    end
+  end
+end

data/lib/change_healthcare/organization_lab.rb

@@ -0,0 +1,25 @@
+# https://cli-cert.emdeon.com/api/cert/organizationlab.htm
+class ChangeHealthcare::OrganizationLab < ChangeHealthcare::BaseApiObject
+  def self.attributes
+    [
+      :address_1, :address_2, :can_order_thru, :city, :clia_number,
+      :discrete_result, :enable_irbcl, :is_beacon, :is_default,
+      :lab, :lab_code, :lab_name, :organization, :organizationlab,
+      :parent_lab_code, :parent_lab_name, :parentlab, :payer_priority,
+      :sequence, :state, :transfer_id, :transmission_mode, :zip
+    ]
+  end
+
+  attr_accessor(*self.attributes)
+
+  def self.chc_object_name
+    "organizationlab"
+  end
+
+  #https://cli-cert.emdeon.com/api/cert/organizationlab.html#search_orderable_labs
+  #sample params: {can_order_thru: "Y", child_only: "Y"}
+  def self.search_orderable_labs(params={})
+    resp = call_api(__method__.to_s, params)
+    response_to_list(resp)
+  end
+end

data/lib/change_healthcare/person.rb

@@ -0,0 +1,48 @@
+# https://cli-cert.emdeon.com/api/cert/person.html
+class ChangeHealthcare::Person < ChangeHealthcare::BaseApiObject
+  def self.attributes
+    [
+      :address_1, :address_2, :age, :age_type, :allergy_status, :bill_type,
+      :birth_date, :city, :country, :county, :date, :fav_pharm_name,
+      :favorite_pharmacy, :first_name, :formu_groupid, :formu_orgid,
+      :guarantor, :height, :home_phone_area_code, :home_phone_number,
+      :hsi_value, :hsilabel, :insurance, :is_active, :isp_address_1,
+      :isp_city, :isp_hsi_value, :isp_name, :isp_state, :isp_zip, :lab,
+      :lab_name, :label_name, :last_name, :last_name_soundex, :leadperson,
+      :middle_name, :mother_name, :mothers_maiden_name, :name_prefix,
+      :organization, :payer_identifier, :person, :person_hsi, :placer_order_number,
+      :plan_identifier, :prim_cg_fname, :prim_cg_lname, :prim_cg_mname,
+      :primarycaregiver, :providercaregiver, :record_date, :sec_insurance,
+      :sec_isp_address_1, :sec_isp_city, :sec_isp_hsi_value, :sec_isp_name,
+      :sec_isp_state, :sec_isp_zip, :sex, :soundex_flag, :ssn, :state, :status,
+      :suffix, :ter_insurance, :ter_isp_address_1, :ter_isp_city, :ter_isp_hsi_value,
+      :ter_isp_name, :ter_isp_state, :ter_isp_zip, :title, :transmission_mode, :weight,
+      :work_phone_area_code, :work_phone_ext, :work_phone_number, :zip
+    ]
+  end
+
+  attr_accessor(*self.attributes)
+
+  def self.chc_object_name
+    "person"
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/person.html#search_hsi
+  # Search by patient id
+  # params = {hsi_value: "PATIENT_ID"}
+  def self.search_hsi(params={})
+    resp = call_api(__method__.to_s, params, true)
+    response_to_list(resp)
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/person.html#put_partial
+  # Create Patient
+  # params = {birth_date: "10/27/1924", first_name: "Florence",
+  #           last_name: "Edwards", middle_name: "E", address_1: "2401 N Abram Rd 85",
+  #           city: "Mission", state: "TX", sex: "F", zip: "78572", hsi_value: "955001",
+  #           hsilabel: "7930723", home_phone_area_code: "956", home_phone_number: "5856449"}
+  def self.put_partial(params={})
+    resp = call_api(__method__.to_s, params, false)
+    response_to_list(resp)
+  end
+end

data/lib/change_healthcare/provider_caregiver.rb

@@ -0,0 +1,33 @@
+# https://cli-cert.emdeon.com/api/cert/providercaregiver.html
+class ChangeHealthcare::ProviderCaregiver < ChangeHealthcare::BaseApiObject
+  def self.attributes
+    [
+      :appuser, :reference, :caregiver, :caregiver_type,
+      :cg_birth_date, :cg_dea_number, :cg_first_name,
+      :cg_is_epcs_enabled, :cg_last_name, :cg_middle_name,
+      :cg_npi, :cg_patmsg_id, :cg_prefix, :cg_sex,:cg_ssn,
+      :cg_suffix, :cg_type, :cg_upin, :dea_number, :enable_epcs,
+      :enable_refill, :is_active, :is_erx_registered, :organization,
+      :provider, :provider_address_1, :provider_city, :provider_fed_tax_id,
+      :provider_name, :provider_npi, :provider_state, :provider_type,
+      :provider_zip, :providercaregiver, :toggle_epcs_for_approval, :update
+    ]
+  end
+
+  attr_accessor(*self.attributes)
+  def self.chc_object_name
+    "providercaregiver"
+  end
+  # https://cli-cert.emdeon.com/api/cert/providercaregiver.html#search_provcg_and_cgpref
+  def self.search_provcg_and_cgpref
+    resp = call_api(__method__.to_s)
+    response_to_list(resp)
+  end
+
+  # https://cli-cert.emdeon.com/api/cert/providercaregiver.html#put_no_update
+  # params = {caregiver: "3004219964", provider: #{facility}}
+  def self.put_no_update(params={})
+    resp = call_api(__method__.to_s, params, false)
+    response_to_list(resp)
+  end
+end

data/lib/change_healthcare/report.rb

@@ -0,0 +1,139 @@
+# Not a object on the API
+class ChangeHealthcare::Report < ChangeHealthcare::BaseApiObject
+
+
+  # params = {
+  #             "reportTypes" => "LABRES",
+  #             "EMR" => "y",
+  #             "autoPrint" => "true",
+  #             "batchDownload" => "true",
+  #             "CreationDateFrom" => "03/01/2014",
+  #             "CreationDateTo" => "03/08/2014",
+  #   }
+  # yields a hash with all the file data
+  def self.download_reports(params)
+    raise "Block needed to handle results" unless block_given?
+    r1 = RestClient.get(search_downloadable_reports(params))
+    cookies = r1.cookies
+
+    loop do
+      r2 = RestClient.get(number_of_files_to_download, cookies: cookies)
+      #cookies = r2.cookies
+
+      files_to_dowload_data = r2.body.match("<--BEGIN NUMBER OF DOCS>(?<data>.*)<--END NUMBER OF DOCS>")[:data]
+      number, error_code, report_unique_id, _ = files_to_dowload_data.split(";")
+      number = number.to_i
+
+      break if number == -1
+
+      i=0
+      while i < number do
+        r3 = RestClient.get(retrieve_document_information, cookies: cookies)
+        doc_info = r3.body
+        doc_data = r3.body.match("<--BEGIN FILE INFO>(?<data>.*)<--END FILE INFO>")[:data]
+
+        sponsor_name, report_type, receiving_client_id,
+        account_no_last_name_first_name, document_unique_id, mime_type,
+        special, request_or_service_date, sponsor_code,
+        caregiver_id, account, first_name, last_name, report_service_date,
+        practice_id, report_subject, report_status = doc_data.split(";")
+
+        r4 = RestClient.get(download_document, cookies: cookies)
+        doc_content = r4.body
+
+        yield({
+                report_unique_id: report_unique_id,
+                document_unique_id: document_unique_id,
+                last_name: last_name,
+                first_name: first_name,
+                sponsor_name: sponsor_name,
+                report_type: report_type,
+                receiving_client_id: receiving_client_id,
+                account_no_last_name_first_name: account_no_last_name_first_name,
+                mime_type: mime_type,
+                special: special,
+                request_or_service_date: request_or_service_date,
+                sponsor_code: sponsor_code,
+                caregiver_id: caregiver_id,
+                account: account,
+                report_service_date: report_service_date,
+                practice_id: practice_id,
+                report_subject: report_subject,
+                report_status: report_status,
+                doc_content: doc_content,
+                cookies: cookies
+              })
+
+      i+=1
+      end
+    end
+  end
+
+  # params = {
+  #             "reportTypes" => "LABRES",
+  #             "EMR" => "y",
+  #             "autoPrint" => "true",
+  #             "batchDownload" => "true",
+  #             "CreationDateFrom" => "03/01/2014",
+  #             "CreationDateTo" => "03/08/2014",
+  #   }
+  def self.search_downloadable_reports(params)
+    base = {
+      "userid" => configuration.user_id,
+      "PW" => configuration.password,
+      "hdnBusiness" => configuration.facility,
+      "apiLogin" => "true",
+      "target" => "jsp/lab/results/FDC.jsp",
+      "actionCommand" => "startDownload"
+    }
+    params.merge!(base)
+
+    return "#{configuration.portal_url}?#{params.to_query}"
+  end
+
+  # Needs to be chained through session to previous call
+  def self.number_of_files_to_download
+    params = {
+      "actionCommand" => "NextFile",
+      "batchDownload" => "true",
+      "fdcuserid" => configuration.user_id
+    }
+    return "#{lab_portal_url}?#{params.to_query}"
+  end
+
+  # Needs to be chained through session to previous call
+  def self.retrieve_document_information
+    params = {
+      "actionCommand" => "GetFileInfo",
+      "fdcuserid" => configuration.user_id
+    }
+    return "#{lab_portal_url}?#{params.to_query}"
+  end
+
+  # Needs to be chained through session to previous call
+  def self.download_document
+    params = {
+      "actionCommand" => "DownloadFile",
+      "fdcuserid" => configuration.user_id
+    }
+    return "#{lab_portal_url}?#{params.to_query}"
+  end
+
+
+  # Needs to be chained through session to previous call
+  def self.mark_as_downloaded
+    params = {
+      "actionCommand" => "MarkAsDownloaded",
+      "fdcuserid" => configuration.user_id
+    }
+    return "#{lab_portal_url}?#{params.to_query}"
+  end
+
+  private
+
+  def self.lab_portal_url
+    path = configuration.portal_url.dup
+    path["DxLogin"] = "lab.results.fdcServlet"
+    path
+  end
+end

data/lib/change_healthcare/servlet.rb

@@ -0,0 +1,50 @@
+# https://cli-cert.emdeon.com/api/Change%20Healthcare%20Clinical%20Exchange%20Channel%20Partner%20API%20v2.4.pdf
+
+module ChangeHealthcare
+  class Servlet < ChangeHealthcare::BaseApiObject
+    def self.chc_object_name
+      'servlets'
+    end
+
+    def self.api_order_servlet(params)
+      resp = call_api(__method__.to_s.camelize(:lower), params)
+      data_nodes = resp.xml.root.children.map { |node| Hash.from_xml(node.to_s)['OBJECT'] }
+      data_nodes.each_with_object({}) do |node, hsh|
+        hsh[node['name']] ||= []
+        hsh[node['name']] << node
+      end
+    end
+
+    class << self
+      private
+
+      def call_api(name, params = {})
+        formatted_params = base_api_params.merge(params)
+        response = RestClient.get(url(name, formatted_params), cookies: login.cookies)
+        ChangeHealthcare::XmlResponse.new(response)
+      end
+
+      def base_api_params
+        {
+          apiuserid: configuration.user_id,
+          actionCommand: 'xml'
+        }
+      end
+
+      def login
+        params = {
+          userid: configuration.user_id,
+          PW: configuration.password,
+          hdnBusiness: configuration.facility,
+          apiLogin: true,
+          actionCommand: 'xml'
+        }
+        RestClient.get("#{configuration.portal_url}?#{params.to_query}")
+      end
+
+      def url(name, params)
+        "#{configuration.base_api_url}/#{chc_object_name}.#{name}?#{params.to_query}"
+      end
+    end
+  end
+end

data/lib/change_healthcare/version.rb

@@ -0,0 +1,3 @@
+module ChangeHealthcare
+  VERSION = '1.0.1'.freeze
+end

data/lib/change_healthcare/xml_response.rb

@@ -0,0 +1,13 @@
+module ChangeHealthcare
+  class XmlResponse
+    attr_reader :xml, :response
+    def initialize(response)
+      @response = response
+      @xml = Nokogiri::XML(response.body)
+    end
+
+    def method_missing(m, *args, &block)
+      response.send(m, *args, &block)
+    end
+  end
+end

data/lib/change_healthcare.rb

@@ -0,0 +1,45 @@
+require "rest_client"
+require "nokogiri"
+
+require "active_support"
+require 'active_support/core_ext'
+require "singleton"
+
+require "change_healthcare/version"
+require "change_healthcare/error"
+require "change_healthcare/api_client"
+require "change_healthcare/base_api_object"
+require "change_healthcare/xml_response"
+require "change_healthcare/caregiver"
+require "change_healthcare/hsi_label"
+require "change_healthcare/lab_system_code"
+require "change_healthcare/organization_lab"
+require "change_healthcare/provider_caregiver"
+require "change_healthcare/client_id"
+require "change_healthcare/lab_config"
+require "change_healthcare/order"
+require "change_healthcare/person"
+require "change_healthcare/object_doc"
+require "change_healthcare/report"
+require "change_healthcare/clinical_report"
+require "change_healthcare/servlet"
+require "change_healthcare/order_diagnosis"
+
+
+module ChangeHealthcare
+  class Error < StandardError; end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+    configuration
+  end
+
+  class Configuration
+    attr_accessor :base_url, :base_api_url, :portal_url, :user_id, :password, :facility
+  end
+end