Imagicle Epic Integration for Digital Fax allows users to send faxes and be notified about relevant outcome directly from the Epic ecosystem.
Thanks to end-to-end encryption, data transfer between Epic and Imagicle is entirely secure, ensuring compliance with HIPAA and GDPR and managing Protected Health Information (PHI) in a reliable and electronic format. Fax operations are streamlined through a secure data exchange protected by role-based access, central document storage, and easy data retrieval. When attaching a document, you can choose from various formats, including pdf, doc(x), xls(x), rtf, bmp, jpg, jpeg, gif, and tiff.
Sending a fax is as easy as printing a file: the Epic Print Server (EPS) processes the outbound fax and delivers it to the Imagicle Digital Fax server to be queued for sending. When the fax has been sent, relevant outcome is returned from the Imagicle Digital Fax server to EPS's one. If a fax fails after EPS delivers it to the fax server, EPS will return a failed status.
Imagicle EPIC Integration Module can be installed in the Imagicle UCX Suite virtual/actual server.
Please download the software package from here.
Access to Imagicle server via RDP. If you are leveraging an Imagicle UCX Cloud Suite, please contact Imagicle Support for more details.
To install the application:
SC CREATE ImagicleEpicToFaxGateway displayname= “Imagicle Epic-to-Fax Gateway” start= auto binpath= “C:\FaxGateway\FaxGateway.exe"
Open "Services" Control Panel and verify new "FaxGateway" service is running.
Inside C:\FaxGateway\data folder, you can find a file named "config.json". It includes configuration information according to Epic customer’s host and credentials. See below a typical sample:
config.json { { "faxGW":{ "host": "dev.telisca.cloud", "port": 8944, "credentials": { "user": "Imagicle", "password": "XXXXXXXXXX" } }, "imagicleFax": { "host": "51.103.74.94", "port": 443, “allowProxyUser”:true, "credentials": { "user": "faxtest", "password": " XXXXXXXXXX " }, "checkCertificate":false }, "epic": { "epicClientId": "b18224dd-6497-4325-88c5-ba87d2ac4b84", "credentials": { "user": "emp$IMAGICLE", "password": " XXXXXXXXXX " } }, "bodyModelFile": “faxbody.txt”, "logLevel": "method", “logDataPath”=”..\\StoneVoiceAS\\Var\\log”, “userField”: “epicUserID” }
The following fields must be amended, depending on your EPIC/Imagicle environment:
"bodyModelFile" parameter in config.json points to a text file, included in the same C:\FaxGateway\data folder and named faxbody.txt. It defines the template of the fax body, including several dynamic variables mapped to Epic metadata received in the send fax request. See below a typical sample:
Sender name: %SenderName% Sender company: %SenderCompany% Sender fax: %SenderFax% Patient CSN: %PatientCSN% Patient Name: %PatientName% Patient MRN : %PatientMRN% Patient ZIP code: %PatientZIPCode% Patient Date of Birth: %PatientDateofBirth%
Here is the list of dynamic metadata fields you can retrieve from EPIC and include in the fax body template. Do not forget to prepend and append "%" symbol to variable name:
SenderName SendingUser CoverSheetNotes EpicUserID EpicUserName UserAccount UserDomain PatientCSN PatientName DateTimeSent NoteID NoteType PatientMRN PatientIDType PatientZIPCode IsAdHocCommunication RecipientINI RecipientID RecipientIDType DocumentOrigin PatientLegalSex PatientDateOfBirth PatientEnterpriseNumber CoverPage RecipientName RecipientFirstName RecipientLastName RecipientTitle RecipientCompany RecipientPhone RecipientEmail RecipientBillingCode RecipientSubBillingCode RecipientAccount RecipientAddressWhole RecipientStreet RecipientCity RecipientIZIPCode RecipientState RecipeintCityState RecipientCounty RecipientCountry SenderName SenderFirstName SenderLastName SenderTitle SenderDepartment SenderLocation SenderCompany SenderDepartmentPhone SenderDepartmentFax SenderServiceArea SenderPhone SenderEmail SenderFax SenderAddressWhole SenderStreet SenderCity SenderZIPCode SenderState SenderCityState SenderCounty SenderCountry
Note: When config.json is updated, it is reloaded immediately. However, if faxGW/port is changed, "FaxGateway" service must be restarted.