XM Fax Integration with Epic Print Services (Cloud)

Administrator -

This procedure explains how to integrate XM Fax Cloud with Epic Print Services.

(Article initially published / modified: 2020-04-01 / 2020-04-15)

Note: This article only applies to XM Fax Cloud. For the integration with XM Fax On-Premises, please refer to the article XM Fax Integration with Epic Print Services (On-Premises) [https://support.xmediusfax.com/hc/en-us/articles/360041770511] .

Introduction

When properly configured, XM Fax integrates seamlessly with Epic EHR/EMR enabling health care professionals to send faxes using the Epic client.

Pre-Requisites

The following is required to integrate XM Fax cloud service with Epic Print Services:


  • XM Fax Cloud Enterprise account with the Epic Integration feature enabled
  • Epic Print Services configured (by Epic Technical Service)

Enabling Epic Integration on XMedius Cloud Enterprise account

The following explains how to enable Epic Integration by the administrator of XMedius Cloud Enterprise account.

Enable the Epic Integration:
  1. Open the page XM Fax > Settings.
  2. Go to General Settings > Epic Integration tab.
  3. Enable Epic Integration.
  4. Enter your Epic Integration credentials provided by your organization's Epic user security team on User Name & Password fields.
  5. By default, the Validate TLS Cerficate is selected.

Epic Print Services configuration

In order to send faxes, Epic Print Services must be configured by the Epic Technical Services.

Contact Epic Technical Services and provide the information:
Note: The Username value identifies the authentication type, access_token in this case, and should be provided to Epic Technical Services as is displayed.

XM Fax Endpoint URLs

Provide Epic Technical Services with one of the following XM Fax Endpoint URLs, depending on your location:


  • USA:
    https://faxus1.xmedius.com/faxservice/rest/epic/sendfax
  • Canada:
    https://faxca1.xmedius.ca/faxservice/rest/epic/sendfax
  • Europe:
    https://faxeu1.xmedius.eu/faxservice/rest/epic/sendfax

Creating a User Token

A unique user token is required to enable XM Fax integration with Epic Print Services.

To create a user token:

  1. Create a file named data.txt.
  2. Copy the following into the newly created file:
    {
    "permalink": "ENTERPRISE_ACCOUNT",
    "username": "USERNAME",
    "password": "PASSWORD",
    "application_type": "Epic Integration",
    "device_id": "EPIC_SERVER_ID",
    "device_name": "EPIC_SERVER_NAME"
    }
  3. Replace the values in capital letters with the values from your XM Fax Cloud Enterprise account.
    Note: "ENTERPRISE_ACCOUNT" should be replaced with your account's unique identifier. You can find this identifier if you look for emails sent by XMedius in your inbox, or in the URL of your Cloud home page. For example, if your account's home page is https://portal.xmedius.com/my_company, you will need to write
    "permalink": "my_company",
    Tip: You can replace "EPIC_SERVER_ID" and "EPIC_SERVER_NAME" with the values of your choice, as these are only meant to help you identify your system.
  4. Save and close data.txt.
  5. Open a command line and reach the location of your data.txt file.
  6. Enter one of the following commands, depending on your location:
    • USA:
      curl -X POST https://portal.xmedius.com/api/user_token -H "Content-Type: application/json" -H "Accept: application/json" -d @data.txt
    • Canada:
      curl -X POST https://portal.xmedius.ca/api/user_token -H "Content-Type: application/json" -H "Accept: application/json" -d @data.txt
    • Europe:
      curl -X POST https://portal.xmedius.eu/api/user_token -H "Content-Type: application/json" -H "Accept: application/json" -d @data.txt
    You should receive a result similar to
    {"result":true,"token":"USER|f67ce33d-4149-4319-aede-c0b24a484fa9","user_id":23570}
  7. Copy the resulting user token .
    Note: In our example, the user token would be USER|f67ce33d-4149-4319-aede-c0b24a484fa9.
  8. Destroy the file data.txt as it contains your credentials.
Have more questions? Submit a request

Comments

Powered by Zendesk