Medtrack and HL7 SFTP Export
Medtrack is a generic HL7 interface that sends ADT and DFT messages to a specified SFTP server. It was initially created to support the Medtrack billing system but will also support most other HL7 interfaces. Below is an example file and some helpful mappings to understand how QuickEMR populates the packets.
Example ADT - Patient Create/Update
- MSH|^~\&|QuickEMR|FF06|Medtrak|Medtrak|202405301646||ADT^A08|QEMR_202405301646_25490|P|2.3|||||US|||
- EVN|A08|202405301646||||
- PID|1|22775|||Washington^George^A||19700211|M|||123 Street St^Apt 213^Richmond^VA^23173|200-555-9381^PRN^test33@example.com||en^English|Single||||||||||||||
- PV1|1||FF06^QuickEMR Physical Therapy||12345678^Doctor^Tom|||||||||||||||||||||||||||||||||||||||||||||
- GT1|1|22775|Washington^George^A||123 Street St^Apt 213^Richmond^VA^23173|2005559381||1970-02-11 00:00:00|M||18|||||||||||||||||||||||||||||||||||||||||||||
- IN1|1|18338|1|Aetna PPO|987 Insurance Ave.^Miami^FL^39874||5697987989|12314534|policy name 1|||202401010000||||Washington^George^A|S|1970-02-11 00:00:00|123 Street St^Apt 213^Richmond^VA^23173|||||||||||||||||123141|||||||M||||||
Example DFT - Charges
- MSH|^~\&|QuickEMR|FF06|Medtrak|Medtrak|202406251550||DFT^P03|QEMR_202406251550_20156|P|2.3|||||US|||
- EVN|P03|202406251550||||
- PID|1|17564|||W'hite^Charles||||||||||||||||||||||||
- PV1|1||FF06^QuickEMR Physical Therapy|||||2085283613^Ortho^Jim||||||||||||||||||||||||||||||||||||||||||||
- FT1|1|26835||202406250000|202406251550|||||1|||||||||G00.2~A00.1~S00.00XA^Streptococcal meningitis~Cholera due to Vibrio cholerae 01, biovar eltor~Unspecified superficial injury of scalp, initial encounter^I10|2^Doe^John|||||97033^Iontophoresis^C4|GP~CQ~~
- FT1|1|26835||202406250000|202406251550|||||1|||||||||G00.2~A00.1~S00.00XA^Streptococcal meningitis~Cholera due to Vibrio cholerae 01, biovar eltor~Unspecified superficial injury of scalp, initial encounter^I10|2^Doe^John|||||97003^OT Evaluation^C4|GP~CQ~~
- DG1|1||G00.2^Streptococcal meningitis^I10||||||||||||||||
- DG1|1||A00.1^Cholera due to Vibrio cholerae 01, biovar eltor^I10||||||||||||||||
- DG1|1||S00.00XA^Unspecified superficial injury of scalp, initial encounter^I10||||||||||||||||
Segment Definitions
- Constant: "|"
- Constant: "^~\&"
- Constant: "QuickEMR"
- Facility Code - The code field of the facility assigned to the given case record. E.g. "ABCT001". (See screenshot MSH.4)
- Receiving Application - Configurable in billing settings. Defaults to "Medtrak" (See screenshot MSH.5-6
- Receiving Facility - Configurable in billing settings. Defaults to "Medtrak" (See screenshot MSH.5-6)
- Message Date - The date the message was generated. Formatted: YYYYMMDDHHmm. Unless otherwise specified all dates will match this format.
- Empty
- Message
- Message Type - ADT or DFT
- Message Subtype - A08 for first ADT send. A04 for subsequent ADT sends. Always P03 for DFT messages.
- Message Control ID - A unique identifier. Should be unique for each message and contains parts "QEMR_{Date:MSH7}_{case_id}". The case id is the unique identifier for a patient episode of care (case) in QuickEMR and may be seen in the URL of the case. For the URL "https://server2.quickemr.com/DEMO001V8/case?case_id=2019" the case id is "2019".
- Constant: "P"
- Constant: "2.3"
- Empty
- Empty
- Empty
- Empty
- Constant: "US"
- Character Set: Packets will usually be base ascii but may occasionally contain UTF-8 characters.
- Empty
- Empty
EVN - Event Type
- Event Type: See MSH.9.2. Will always match. EVN Header may be safely ignored but is included in case it is expected.
- Message Date: See MSH.7. Will always match.
- Empty
- Empty
- Empty
- Empty
- Constant: 1
- Patient ID - The patient code from QuickEMR. (See PID.2-3 Screenshot)
- Patient Account - The patients unique identifier in QuickEMR. (See PID.2-3 Screenshot)
- Empty
- Name
- Last Name
- First Name
- Middle Initial
- Empty
- Date of Birth - Date in the format YYYYMMDD like "20100101"
- Gender at Birth - "M" or "F"
- Empty
- Empty
- Address
- Address Line 1
- Address Line 2
- City
- State - 2 diget state code.
- Zip - 5 or 5+4 like "12345" or "12345-1234"
- Phone
- Number - 10 digits separated by dashes like "200-200-1234"
- Constant: "PRN"
- Empty
- E-Mail - An e-mail address like "test@example.com"
- Empty
- Language
- Language Code - ISO 639-1 Language code. Usually "en" occasionally "es".
- Language Description - The corresponding ISO 639-1 description. Usually "English", occasionally "Spanish".
- Marital Status
- Status ID - One of "Married", "Single", "Legally Separated", "Divorced", "Widowed", "Unknown", or "Not Applicable"
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Constant - "1"
- Empty
- Patient Location
- Empty
- Empty
- Empty
- Facility - The "Other Code" field for the facility specified on the note. (See screenshot PV1.3)
- Empty
- Empty
- Empty
- Empty
- Facility Description - The full name of the facility specified on the note. (See screenshot PV1.3)
- Empty
- Empty
- Empty
- Empty
- Referring Physician - As specified on the case.
- NPI
- Last Name
- First Name
- Empty (9-53 are empty)
GT1 - Guarantor
- Constant: 1
- Guarantor ID - An id corresponding to the source record in QuickEMR. This may be a patient record or a guarantor record depending on the users preferences.
- Guarantor Name
- Last Name
- First Name
- Middle Initial
- Empty
- Guarantor Address
- Address Line 1
- Address Line 2
- City
- State - 2 digit state code.
- Zip - 5 or 5+4
- Home Phone Number - 10 digits with no separators.
- Work Phone Number - 10 digits with no separators.
- Date of Birth - Date in format YYYYMMDD
- Gender at Birth - "M" or "F"
- Empty
- Relationship - 18: self, G8: Other
- Empty (12-55 are empty)
- Indicator - 1: Primary, 2: Secondary, 3: Tertiary. Up to 3 IN1 segments may be included but only one for each indicator.
- Policy ID - unique id for this plan.
- Payer ID - Unique ID for this insurance.
- Name - Name of the insurance company.
- Address
- Address Line 1
- Address Line 2
- City
- State - 2 digit code
- Zip - 5 or 5+4
- Insurance Contact Name
- Insurance Contact Phone Number - 10 digits no seperator
- Insurance Policy Group Number
- Insurance Policy Group Name
- Empty
- Empty
- Plan Effective Date - YYYYMMDDHHmm
- Plan Termination Date - YYYYMMDDHHmm
- Empty
- Plan Type - BC: Blue Cross, C: Champus/TriCare, F: FECA Black Lung, G: Group Health Plan, MC: Medicare, MD: Medicaid, CMD: Commercial Medicaid, MG: Medigap, WC: Workers’ Comp, O: Other
- Insureds Name
- First Name
- Last Name
- Middle Initial
- Insured Relationship - S: Self, O: Other
- Insured Date of Birth - YYYYMMDD
- Insured Address
- Address Line 1
- Address Line 2
- City
- State - 2 letter code
- Zip - 5 or 5+4
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Insurance Policy Number
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Insureds Gender - M, F
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
FT1 - Financial Transaction
- Constant - 1
- Transaction ID - The unique note (encounter) ID from within QuickEMR
- Empty
- Date of Service - YYMMDDHHmm
- Date Signed - YYMMDDHHmm
- Empty
- Empty
- Empty
- Empty
- Units - Quantity of this charge
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Empty
- Diagnosis Code - Repeating
- Code - ICD 10 code with decimal after 3 digits
- Description - Standard ICD 10 code description.
- Constant - "I10"
- Rendering Provider
- ID - The unique user id from within QuickEMR
- Last Name
- First Name
- Billing Provider
- ID - Tax ID
- Company Name
- Empty
- Empty
- Empty
- Empty
- Procedure Code
- Code - CPT4 code
- Description - User provided description
- Constant - "C4"
- Modifiers - Repeating
- Code
- Empty
- Empty
DG1 - Diagnosis Code
- Constant - 1
- Empty
- Diagnosis Code
- Code - ICD 10 Code
- Description - Standard ICD 10 Description
- Constant - I10
- Unused (4-19 are unused)
Screenshots
MSH.4
MSH.5-6
PID.2-3
PV1.3
Related Articles
QEMR Native (Self Pay Billing Management System)
**This system is for facilities that ONLY accept cash-pay patients and is not yet intended for facilities that are submitting claims to insurances** Enabling QuickEMR Native: Where to go? 1. The Quickemr Native system can be enabled by going under ...
APTA Mips API Integration
You must be using QuickEMR Version 8 to integrate with APTA. Obtain SFTP information and enter it at “Settings” => “Documentation” => “Outcomes Type” => “APTA” => “APTA Host” and save. Past data may be manually exported by visiting “Reports” => ...
FOTO Integration Part 2: Usage
Mappings QuickEMR Patient => FOTO Patient QuickEMR Case => FOTO Episode QuickEMR Note => FOTO Encounter Create a new patient or visit an existing patient not connected to FOTO. FOTO requires several fields that are optional in QuickEMR. Before ...
Making the Guarantor for Minors and Signature Assignment Required before Exporting
A few optional validation rules can be applied before exporting a note. Validation Rules: Where to go? 1. This can be found under Settings -> Validation 1. Check marking the following validation rules will require this information before a note can ...