Smart EMR - Complete Documentation
Welcome to Smart EMR
Smart EMR is a simple, secure Electronic Medical Records system built specifically for private practice clinics. It helps you:
- Manage patient files and demographics
- Schedule and track appointments
- Write clinical notes automatically using AI (the AI4Docs.AI Clinical Documentation Assistant)
- Print prescriptions, medical reports, referral letters, and lab/imaging orders as PDF files
- Track your clinic's income and generate financial reports
- Control exactly what each staff member can see and do
Smart EMR main navigation — access all features from the bottom menu
Installing AppSheet on Your Devices
Smart EMR runs on a platform called AppSheet (made by Google). Think of AppSheet as the "container" that runs your EMR. You need to install it on every device where you (or your staff) will use Smart EMR.
On iPhone or iPad
- Open the App Store (the blue icon with a white "A" on your home screen)
- Tap the Search tab at the bottom of the App Store screen
- Type AppSheet in the search bar and tap Search
- Find the app called "AppSheet" by Google (it has a purple/blue icon)
- Tap Get (or the cloud download icon if you previously downloaded it) to install it
- Once installed, open the AppSheet app
- Tap Sign In and sign in with your Gmail address — this must be the same Gmail address you used when you subscribed to AI4Docs.AI CDA (at clinic.ai4docs.ai). Using a different email will not work
On Android Phone or Tablet
- Open the Google Play Store (the colorful triangle icon on your home screen)
- Tap the search bar at the top of the screen
- Type AppSheet and tap the search icon
- Find the app called "AppSheet" by Google
- Tap Install and wait for the download to finish
- Once installed, open the AppSheet app
- Sign in with your Gmail address — this must be the same Gmail address you used when you subscribed to AI4Docs.AI CDA (at clinic.ai4docs.ai). Using a different email will not work
On a Computer (Windows or Mac)
You do not need to install anything on a computer. Smart EMR runs in your web browser.
First time (getting the app): When you subscribe to AI4Docs.AI CDA and open the Settings page, you will find a "Get Smart EMR" link. Clicking this link opens AppSheet in your browser and creates your personal copy of Smart EMR. After the copy is created, you will see your app open in the browser.
Every time after that:
- Open your web browser (Google Chrome is recommended)
- Go to www.appsheet.com
- Click Sign In at the top right corner
- Sign in with the same Gmail address you used when subscribing to AI4Docs.AI CDA
- You will see your Smart EMR app listed. Click on it to open it
- Tip: Bookmark this page in your browser so you can find it easily next time
Step 1: Add Yourself as the Administrator
When you first open Smart EMR, it has a fake placeholder user (SETUP_REQUIRED@clinic.com). You need to add yourself as the real administrator, then remove the placeholder.
Part A: Add Your Admin Account
- Open Smart EMR on your computer or tablet
- Look at the top left corner of the screen. You will see a small icon with three horizontal lines (this is called the hamburger menu or side menu). Tap or click on it
- A side panel slides open. You will see the word Setup with a gear icon next to it. Tap on Setup
- The Setup screen opens. At the top of this screen, you will see several tabs. Tap the tab called USERS
- Tap the Add button (+ icon) to create a new user
- Fill in the following:
- Email: Your real Gmail address. This must be:
- The same Gmail address you use to sign into the AppSheet app
- The same Gmail address you used to subscribe to AI4Docs.AI CDA at clinic.ai4docs.ai
- All three must be the same email. If they are different, the AI integration will not work
- Name: Your full name (for example: "Dr. Ahmed Mohamed")
- Roles: Check the box next to Admin. The Admin role gives you full control of the entire system — you can see and do everything
- Active: Set to Yes
- Email: Your real Gmail address. This must be:
- Tap Save
Part B: Remove the Placeholder User
- You are now the Admin. Go back to the USERS tab
- Tap on the entry with the email
SETUP_REQUIRED@clinic.comto open it - Tap Delete to remove this placeholder user
- Confirm the deletion when prompted
- On a phone or tablet: Place your finger at the top of the screen and pull downward (like pulling down a curtain). This refreshes the app
- On a computer: Look at the top right corner of the screen. You will see a circular arrows icon that looks like a refresh button. Click it
- This is called "Sync." You will need to do this frequently in Smart EMR. The app does NOT refresh automatically — you must always sync manually after performing any action
The hamburger menu — tap to access Setup, Help, and other options
Step 2: Connect the AI (CDA Integration)
This step connects your Smart EMR to the AI4Docs.AI Clinical Documentation Assistant (CDA). This is what allows the AI to write your clinical notes automatically. You need two things: your API Key and your CDA email address.
Part A: Get Your API Key from the CDA App
- On your computer browser, go to clinic.ai4docs.ai
- Sign in with your AI4Docs.AI account
- After signing in, look for the Settings icon (it looks like a gear) and tap it
- Scroll down until you see the section titled EMR Integration
- You will see your API Key displayed. It looks something like this:
emr_a1b2c3d4-e5f6-7890-abcd-ef1234567890 - Tap the Copy button next to the key to copy it to your clipboard
- Keep this browser tab open (you will need the email address too)
CDA Settings — EMR Integration section showing your API Key
Part B: Enter the API Key and Email into Smart EMR
- Go back to your Smart EMR app
- Tap the hamburger menu (three horizontal lines at the top left)
- Tap Setup (gear icon)
- Tap the Edit Integration Settings tab at the top of the Setup screen (you may need to swipe the tabs to the left to find it)
- You will see two fields: API_Key and Doctor_Email
- Tap the Edit button (pencil icon)
- In the API_Key field: paste the API key you copied from the CDA app in Part A
- In the Doctor_Email field: type the exact same email address that you use to sign into the CDA app at clinic.ai4docs.ai. This email must match your CDA account exactly. If you type a different email, the AI will not be able to send notes back to your EMR
- Tap Save
Smart EMR Setup — Edit Integration Settings with API Key and Doctor Email fields
Part C: Add the Integration Script & Authorize Google Permissions (One Time Only)
Your Smart EMR uses a background program (called "Apps Script") that automatically communicates between the app and the AI. The script code does not copy automatically when you install Smart EMR, so you need to add it manually and then give Google permission to run it. You only need to do this once — after that, it works forever.
Step C1: Add the Apps Script Code
- Open Google Drive on your computer. Go to drive.google.com in your browser and sign in with your Gmail account
- Find the folder where your Smart EMR data lives. It is usually at: My Drive > AppSheet > data > SmartEMR-XXXXX (the folder name starts with SmartEMR followed by numbers)
- Inside that folder, find the Google Sheets file called Visits (it has a green spreadsheet icon). Double-click on it to open the spreadsheet
- Once the spreadsheet is open, look at the menu bar at the very top of the screen. You will see a row of words: File, Edit, View, Insert, Format, Data, Extensions, Tools, Help
- Click on the word Extensions in this menu bar
- A dropdown menu appears. Click on Apps Script
- A new browser tab will open. This is the Apps Script editor. You will see an almost empty file called
Code.gswith a placeholder function. Select all the text in this file (Ctrl+A on Windows, Cmd+A on Mac) and delete it - Open the shared Apps Script file from this link: ai4docs.ai/smart-emr/templates (the same page where you copied your template files). Copy the entire script code from there
- Paste the copied code into the empty Apps Script editor (Ctrl+V on Windows, Cmd+V on Mac)
- Click the floppy disk icon (Save) at the top, or press Ctrl+S / Cmd+S to save
Step C2: Run the Setup & Authorize
- Look near the top of the Apps Script page. You will see a small dropdown menu (it might show a name like
myFunction). Click on this dropdown arrow to open it - From the list that appears, select
setupIntegration - Now look right next to this dropdown. You will see a small button that looks like a play button (a triangle pointing to the right). This is the Run button. Click it
- A popup window will appear saying "Authorization required" or "This project requires your permission." Click the button that says Review Permissions
- Google will ask you to choose which Google account to use. Click on the same Gmail account you use for Smart EMR
- You may see a scary-looking warning that says "Google hasn't verified this app." This is completely normal and safe — this is YOUR OWN script running in YOUR OWN Google account. It is not a third-party app. Click the small text at the bottom left that says "Advanced"
- After clicking Advanced, you will see a new link that says "Go to [project name] (unsafe)". Click on it. Despite the word "unsafe," this is perfectly fine — Google shows this message for all custom scripts
- A permission screen appears listing what the script needs access to (your spreadsheets, your Drive, etc.). Click Allow
- Wait a few seconds. You should see a message appear on the screen (in the "Execution log" area at the bottom) that says: "CDA Integration Active!"
Google Apps Script editor — select setupIntegration from the function dropdown and click Run
Google permission warning — click Advanced, then "Go to [project name]" to continue
To verify everything is working:
- On the same Apps Script page, click the function dropdown again (the same one from step 8) and change it to
checkStatus - Click the Run button again
- Look at the execution log at the bottom. You should see: "ACTIVE!"
Step 3: Create Your Doctor Profile
Your profile information appears on every printed document — prescriptions, medical reports, referral letters, and lab orders. Fill this in carefully.
- Tap the hamburger menu at the top left > tap Setup
- Tap the Profile tab at the top of the Setup screen
- Tap the Add button (the + icon)
- Fill in the following fields:
| Field | What to Enter | Example |
|---|---|---|
| Name | Your full name as you want it printed on documents | Dr. Ahmed Mohamed |
| Title | Your professional title | Prof. Dr. / Dr. / Consultant |
| Specialty | Your medical specialty | Urology / Cardiology / Pediatrics |
| Institution | Your hospital or clinic name (optional) | Cairo University Hospital |
| LicenseNumber | Your medical syndicate or license number (optional) | 12345 |
| Logo | Tap this field to upload your clinic logo image from your phone gallery or computer files | (your clinic logo image) |
| Signature | Tap to upload a signature image, or use the built-in drawing tool to draw your signature on screen | (your signature) |
Doctor Profile form — fill in your name, title, specialty, logo, and signature
Setting Up Print Mode (Read This Carefully)
Scroll down in the Profile form. You will find two important settings:
PrintMode_Rx (controls how your printed prescriptions look):
- Choose "Full Letterhead" if you print prescriptions on blank white paper (plain paper with nothing printed on it). When you choose this, the app will automatically add your clinic logo at the top, your name and credentials, the patient information, the prescription content, and your clinic address at the bottom. Everything the patient needs to see is printed by the app onto the blank paper.
- Choose "Content Only" if you print prescriptions on your own custom pre-printed prescription paper — the kind that already has your clinic name, logo, and address printed on it by a printing shop. When you choose this, the app will ONLY print the patient name, date, diagnosis, and medication list. It will NOT print your logo or clinic details because those are already on the paper.
PrintMode_Orders (controls how your printed lab/imaging orders look):
- Same choice as above. Choose "Full Letterhead" if you use blank paper, or "Content Only" if your order paper already has your clinic branding printed on it.
Print Mode comparison — Full Letterhead (left) vs Content Only (right)
- Tap Save
Step 4: Add Your Clinic Locations
If you work at more than one location (for example, a private clinic on Mondays and a hospital on Wednesdays), you need to tell the app about each location. Even if you work at only one place, you still need to add it here — otherwise the app will not know your clinic's address and phone number for printed documents.
- Tap the hamburger menu at the top left > tap Setup
- Tap the Manage Workplaces tab at the top
- Tap the Add button (+ icon)
- Fill in:
| Field | What to Enter | Example |
|---|---|---|
| Name | The name of this clinic or hospital | Dr. Ahmed Clinic - Maadi |
| Type | Choose one: Clinic, Center, or Hospital | Clinic |
| Address | The full street address of this location | 15 Road 9, Maadi, Cairo |
| Phone | The clinic's phone number | 02-2345-6789 |
| The clinic's email address (optional) | info@drahmed.com | |
| ShowInFooter | See explanation below | Yes or No |
What does ShowInFooter mean?
When you print a document (a medical report, a referral letter, a prescription on plain paper, or lab orders on plain paper), the bottom of the document (the "footer") shows your clinic's contact information — the clinic name, address, and phone number.
- Set ShowInFooter to Yes if you want this clinic's details to appear at the bottom of your printed documents
- Set ShowInFooter to No if you do NOT want this location shown in the footer
If you work at only one location, set it to Yes.
If you work at multiple locations and want ALL of them listed in the document footer, set ShowInFooter to Yes for each one. If you only want certain locations to appear, set the others to No.
- Tap Save
- Repeat steps 3-5 for every location where you see patients
Step 5: Set Your Service Prices
This step lets the app automatically fill in the consultation fee when you create a visit. If you skip this, you can always type the fee manually each time.
- Tap the hamburger menu > tap Setup
- Tap the Manage Prices tab at the top
- Tap the Add button (+ icon)
- Fill in:
| Field | What to Enter | Example |
|---|---|---|
| Category | Choose one: Consultation, Follow-up, Procedure, Surgery, or Investigation | Consultation |
| ServiceName | A name for this service | First Visit |
| DefaultFee | The price you charge for this service | 500 |
| WorkplaceID | If this price is ONLY for one specific clinic, tap and select that clinic from the list. If you charge the same price at all your clinics, leave this field completely empty — the app will treat it as a "Global" price that applies everywhere | (leave empty for same price everywhere) |
- Tap Save
- Repeat for all your services (e.g., Follow-up, Ultrasound, Minor Procedure, etc.)
Step 6: Install Print Templates
Smart EMR uses Google Docs template files to generate your printed prescriptions, reports, referral letters, and lab orders. These template files are not copied automatically when you copy the app — you need to install them manually. This only takes a few minutes.
Copy the template files to your Google Drive:
- Open ai4docs.ai/smart-emr/templates — this page contains a link to a shared Google Drive folder with all 6 template files
- Open the shared folder link
- Select all 6 files > Right-click > Make a copy
- The copies will appear in your My Drive (they will be named "Copy of ..." at first)
Move the templates to the correct folder:
- Open Google Drive on your computer (drive.google.com)
- Navigate to the folder where your Smart EMR data lives: My Drive > AppSheet > data > SmartEMR-XXXXX (you will see a Google Sheet called Visits inside)
- Inside this folder, click + New > New folder and name it exactly: Templates (capital T)
- Move all 6 copied template files into the Templates folder
- IMPORTANT: Rename each file to remove the "Copy of " prefix. The file names must be exactly as shown below — even one extra space or character will prevent printing from working
The 6 template files (exact names required):
| File Name (must be exact) | What It Is Used For | Paper Size |
|---|---|---|
Medical_Report_Template | Printing full medical reports | A4 (full page) |
Referral_Letter_Template | Printing referral letters to other doctors | A4 (full page) |
Rx_Full_Template | Printing prescriptions on blank paper | A5 (half page) |
Rx_Content_Template | Printing prescriptions on pre-printed paper | A5 (half page) |
Orders_Full_Template | Printing lab/imaging orders on blank paper | A5 (half page) |
Orders_Content_Template | Printing lab/imaging orders on pre-printed paper | A5 (half page) |
Your Google Drive folder should look like this:
My Drive/
AppSheet/
data/
SmartEMR-XXXXX/
Visits (the green spreadsheet icon - this is your database)
Templates/ (folder you created with 6 files)
Medical_Report_Template
Referral_Letter_Template
Rx_Full_Template
Rx_Content_Template
Orders_Full_Template
Orders_Content_Template
Step 7: Add Your Staff Members
If you are a solo doctor with no staff, you can skip this step for now and come back to it later.
Adding a staff member has TWO parts: (1) adding them in the Users table, and (2) inviting them through AppSheet sharing. Both are required.
Part A: Add Staff in the Users Table
- Tap the hamburger menu > tap Setup
- Tap the USERS tab at the top
- Tap the Add button (+ icon)
- Fill in:
- Email: Your staff member's Gmail address. This must be the exact Gmail address they will use to sign into the AppSheet app on their phone or computer. If they use a different email, they will not be able to see any data
- Name: Their full name (e.g., "Sara Ahmed")
- Roles: Check the box(es) that match their job. See the "Understanding Roles" section below to know which role to choose
- Active: Make sure this is set to Yes
- Tap Save
- Repeat for every staff member
Part B: Invite Staff Through AppSheet Sharing
Adding someone to the Users table alone is NOT enough. You must also invite them through AppSheet's sharing system. This step must be done on a computer:
- Open your Smart EMR app in the AppSheet Editor on your computer (go to www.appsheet.com, sign in, and click on your app)
- In the top right corner of the AppSheet editor, click the Share icon (it looks like a person with a + sign, or it may say "Share")
- In the Email Address field, type the Gmail address of the staff member you want to invite
- Set their permission to "Use app" (this means they can use the app but cannot change the app's design or code)
- Make sure the checkbox "Notify users" is checked — this sends them an email with instructions on how to install and open the app
- Click Add or Send
- Repeat for each staff member
What Staff Members Do After Receiving the Invitation
Your staff will receive an email from AppSheet with a link. Here is what they need to do:
On an Android phone:
- Tap the link in the invitation email
- They will be asked to install the AppSheet app from the Google Play Store (if they do not already have it)
- After installing, open AppSheet and sign in with the same Gmail address you used when inviting them
- Your Smart EMR app will appear in their app list
- To add a shortcut to their home screen: in the app, tap the hamburger menu and look for "Add Shortcut"
On an iPhone or iPad:
- Tap the link in the invitation email (in Safari browser)
- They will be directed to install the AppSheet app from the Apple App Store
- After installing, open AppSheet and sign in with the same Gmail address you used when inviting them
- Your Smart EMR app will appear in their app list
On a computer:
- Click the link in the invitation email
- The app opens in the web browser. No installation needed
- They can bookmark the page for easy access next time
User Management — add staff and assign roles from Setup > Users
The 7 Roles Explained
Each role controls exactly what that person can see and do in the app. The Admin role has full access to everything — if you are the clinic owner with the Admin role, you do not need any additional roles.
Admin
For the clinic owner or manager only. An Admin can see and do absolutely everything: view all patient data, clinical notes, financial records, change settings, add or remove users, and delete records. Only give this role to 1-2 people you fully trust.
Assistant
For doctors and physicians who are NOT the clinic owner. An Assistant can view patients, create visits, write clinical notes, view prescriptions, use the AI assistant, and print documents. Cannot see visit fees, payment status, or financial reports, and cannot change settings or manage users.
Secretary
For your receptionist or front desk staff. A Secretary can add new patients, edit patient information (like fixing a phone number or correcting a name), and create, edit, or delete appointments. Cannot see clinical notes, prescriptions, lab orders, or any financial data.
Accountant
For whoever handles billing. An Accountant can see visit fees, mark visits as paid, choose payment method (cash, card, bank transfer), and view financial reports. Cannot see clinical notes, prescriptions, or lab orders.
Nurse
For nurses and medical assistants. A Nurse can view patient records, read clinical notes, see prescriptions and lab orders (but cannot edit any of these), and book appointments. Cannot see financial data and cannot edit or delete clinical information.
Pharmacist
For pharmacists, typically in specialized centers like oncology clinics. A Pharmacist can view patient names, allergies, prescriptions, and diagnosis. Cannot see full clinical notes, lab orders, or financial data, and cannot edit prescriptions.
Lab_Tech
For laboratory technicians or radiology staff. A Lab_Tech can view the list of lab orders and imaging requests. Cannot see prescriptions, clinical notes, or financial data.
When One Person Does Multiple Jobs
In small clinics, one person often wears multiple hats. You can give any user more than one role by checking multiple boxes. When someone has multiple roles, they get the combined permissions of all their roles. Here are common examples:
Open her user record in Setup > Users and check BOTH the Secretary box AND the Accountant box. Now she can book appointments (from the Secretary role) AND also mark visits as paid and see financial data (from the Accountant role). She still cannot see clinical notes because neither Secretary nor Accountant roles allow that.
By default, a Secretary cannot see prescriptions. Check both the Secretary box AND the Pharmacist box. Now she can book appointments AND view prescriptions (but she still cannot edit prescriptions or see full clinical notes).
Give them the Assistant role only. They can see patients, create visits, write clinical notes, and use the AI — but they cannot see how much money the clinic makes or change any settings.
Give them Assistant AND Accountant roles. Now they can do clinical work AND see financial data.
Complete Permissions Table
This table shows exactly what each role can and cannot do:
| What Can They Do? | Admin | Assistant | Secretary | Accountant | Nurse | Pharmacist | Lab_Tech |
|---|---|---|---|---|---|---|---|
| View patient names | Yes | Yes | Yes | Yes* | Yes | Yes* | Yes* |
| Add new patients | Yes | Yes | Yes | No | No | No | No |
| Edit patient info | Yes | Yes | Yes | No | No | No | No |
| Delete patients | Yes | No | No | No | No | No | No |
| Create visits | Yes | Yes | No | No | No | No | No |
| Edit clinical notes | Yes | Yes | No | No | No | No | No |
| View clinical notes | Yes | Yes | No | No | Yes | No | No |
| View prescriptions | Yes | Yes | No | No | Yes | Yes | No |
| View lab orders | Yes | Yes | No | No | Yes | No | Yes |
| Print prescriptions | Yes | Yes | No | No | No | Yes | No |
| Print lab orders | Yes | Yes | No | No | No | No | Yes |
| Print reports/referrals | Yes | Yes | No | No | No | No | No |
| Create appointments | Yes | Yes | Yes | No | Yes | No | No |
| Delete appointments | Yes | No | Yes | No | No | No | No |
| View/edit visit fees | Yes | No | No | Yes | No | No | No |
| Mark visits as paid | Yes | No | No | Yes | No | No | No |
| View financial reports | Yes | No | No | Yes | No | No | No |
| Export financial data | Yes | No | No | Yes | No | No | No |
| View price list | Yes | Yes | Yes | Yes | No | No | No |
| Edit price list | Yes | No | No | No | No | No | No |
| Manage users | Yes | No | No | No | No | No | No |
| Change settings | Yes | No | No | No | No | No | No |
Privacy_Mode from Off to On. Privacy Mode is OFF by default (suitable for Egyptian and Middle Eastern clinics).
Adding a New Patient
- Tap Patients in the bottom menu
- Tap the Add button (the + icon, usually at the bottom right corner of the screen)
- Fill in the patient's information:
- FullName — Their complete name
- DateOfBirth — Tap the field to open a date picker and select their birth date
- Gender — Male or Female
- Phone — Their phone number (this enables the Call and WhatsApp buttons on their file)
- Email — Their email address (optional)
- Tap Save
The patient is now in your system permanently. You can find them anytime in the Patients list.
Add Patient form — enter the patient's basic information
Booking an Appointment
- Tap Patients in the bottom menu and find the patient. Tap on their name to open their file
- Look for the Book Appointment action button (it has a calendar icon). Tap it
- Fill in:
- Start — The date and time of the appointment
- End — When the appointment ends
- Type — Choose one: New Consultation, Follow-up, Procedure, Emergency, or WhatsApp
- Visit Site — Select which of your workplaces (clinics/hospitals) this appointment is at
- Tap Save
The appointment now appears in the Calendar and in Today's Schedule on the day of the appointment.
Appointment booking — set date, time, type, and clinic location
Patient Check-In
- Tap Today's Schedule in the bottom menu
- In Today's Queue, find the patient. Their status shows "Scheduled"
- Tap the Check-In button next to their name
- Their status changes to "Checked-In" so you know they are in the waiting room
AI Clinical Notes — Complete Workflow
Important: Set Up CDA Settings First (One Time)
Before you use the AI for the first time, you need to configure the CDA app settings. Open the CDA app at clinic.ai4docs.ai, sign in, and look for the Settings icon (gear).
A. Set Your Language Preferences (Settings → General Tab)
- Open Settings (gear) and go to the General tab
- Set the Primary Language (e.g., English) — this controls the language of the clinical note output (the medical documentation)
- Set the Patient Instructions Language (e.g., Arabic) — this controls the language of prescription instructions and investigation preparation instructions that your patients will read
CDA Settings — set Primary Language and Patient Instructions Language
B. Enable EMR Export Options (Settings → EMR Export Options)
- In the same Settings, find the section called EMR Export Options
- Make sure both of these checkboxes are checked:
- Include Prescription — check this box so that medications are included when the note is sent to Smart EMR (if this is not checked, the "Print Prescription" button will have nothing to print)
- Include Orders/Investigations — check this box so that lab tests and imaging orders are included (if this is not checked, the "Print Orders" button will have nothing to print)
- Save the settings
You only need to do this once. The settings will be remembered.
CDA Settings — enable Include Prescription and Include Orders checkboxes
Starting the Visit
- Tap Today's Schedule in the bottom menu. Find the checked-in patient in Today's Queue
- Tap the Start Visit button next to their name
- A form will open with three tabs at the top: Administrative, Clinical Notes, and Images & Docs
Filling in the Administrative Tab
- You are now on the Administrative tab (the first tab). You will see:
- Visit Date — Already filled with today's date
- Right below the Visit Date, you will see an instruction line that says: "Click Start CDA to start AI Documentation (after saving) and then click Open CDA"
- Below this instruction, there are two options: Ready and Start CDA
- This step is critical: Tap on "Start CDA" to select it. This tells the app to create an AI session for this patient
- Below this, select your Visit Site (which clinic you are at today)
- Fill in any other fields on this tab as needed (Service Type, etc.)
Visit form — select "Start CDA" to create an AI session for this patient
Saving the Visit
- Tap Next at the bottom to go to the Clinical Notes tab
- Skip the Clinical Notes tab completely — do NOT type anything here. The AI will fill in these fields automatically later
- Tap Next at the bottom to go to the Images & Docs tab
- If you have photos or documents to attach to this visit, add them here. If not, skip this tab
- Tap Save at the bottom of the screen
Opening the AI Assistant
- After saving, you will be back on the visit detail screen. Look for a button that says "Open CDA"
- If you do not see the "Open CDA" button: You need to sync. Pull down on the screen with your finger (on phone/tablet) or tap the refresh icon at the top right. Try syncing 2-3 times with a few seconds between each one. The button will appear after syncing
- Tap "Open CDA". The AI4Docs.AI Clinical Documentation Assistant will open in a new browser tab or window
After saving, the "Open CDA" button appears — tap it to launch the AI assistant
Using the AI to Create Your Clinical Note
- In the CDA app, speak or type your clinical note. Talk naturally as if you are dictating to a colleague. The AI will understand and organize everything
- When you are finished, the AI will generate a formatted clinical note
- Pay attention to the "Send to EMR" button. This is critical:
- Green button = The AI session is still active, the note is NOT ready yet
- Blue button = The note has been auto-saved and is READY to be sent to Smart EMR
- Do NOT go back to Smart EMR until the button is BLUE
The Send to EMR button — wait for BLUE before switching back to Smart EMR
Fetching the Note Back into Smart EMR
- Once the "Send to EMR" button is BLUE, switch back to your Smart EMR app (switch browser tabs or reopen the app on your phone)
- Sync the app: pull down on the screen (phone/tablet) or tap the refresh icon at the top right
- Look for the "Fetch Note" button on the visit record. Tap it
- If you do not see the "Fetch Note" button: Sync again. Pull down on the screen or tap the refresh icon. Sometimes you need to sync 2-3 times. The button appears only after the app refreshes and detects that a CDA session exists
- After tapping "Fetch Note", wait about 5-10 seconds
- Sync one more time (pull down or tap the refresh icon)
- Your AI-generated clinical note will now appear in the visit record, automatically organized into sections: Chief Complaint, History of Present Illness, Examination, Diagnosis, Prescription, and Orders
Tap "Fetch Note" to pull the AI-generated note into your visit record
Clinical notes automatically filled by the AI — organized into sections
Always Reset After Fetching
- After the note is fetched successfully, tap the "Reset CDA" button. This clears the AI session and prepares the system for your next patient. Always do this after every visit, even if the fetch was successful. This keeps things clean and prevents confusion on your next visit.
Always tap "Reset CDA" after a successful fetch to prepare for the next patient
Alternative Method: If the AI Integration Is Not Working
If for any reason the Fetch Note process does not work (the button does not appear, or the note does not come through), you can manually copy the note:
- In the CDA app, after generating your note, look for the "MD" button (this copies the note in a format that Smart EMR can read)
- Tap the "MD" button. The note is now copied to your clipboard
- Go back to Smart EMR, open the visit, tap Edit
- Go to the Clinical Notes tab
- Tap on the ClinicalNotes field and paste the note (long-press and tap Paste, or Ctrl+V on a computer)
- Tap Save
This is a manual workaround. The automatic Fetch Note method is preferred when it works.
The MD button in CDA — tap to copy the note for manual pasting into Smart EMR
Printing Documents
After a visit has clinical notes, you can print professional PDF documents.
Available Documents
| Document | Button Name | Paper Size | When Is It Available? | Who Can Print? |
|---|---|---|---|---|
| Prescription | Print Prescription | A5 (half page) | When the note includes medications (you must have "Include Prescription" checked in CDA Export Options) | Admin, Assistant, Pharmacist |
| Lab/Imaging Orders | Print Orders | A5 (half page) | When the note includes lab tests or imaging requests (you must have "Include Orders/Investigations" checked in CDA Export Options) | Admin, Assistant, Lab_Tech |
| Medical Report | Print Medical Report | A4 (full page) | When clinical notes exist in the visit | Admin, Assistant |
| Referral Letter | Print Referral Letter | A4 (full page) | When clinical notes exist in the visit | Admin, Assistant |
How to Print (Step by Step)
- Open the visit record (tap on the visit from the patient's file or from Today's Schedule)
- Find the print button you need (for example, "Print Prescription") and tap it
- The app will ask for confirmation. Tap Yes
- Now you must wait and sync. The app is creating a PDF file in the background. This takes a few seconds
- Sync the app: pull down on the screen (phone/tablet) or tap the refresh icon at the top right
- After syncing, a new button will appear. For example, if you tapped "Print Prescription," you will now see a button called "View Prescription"
- If the "View" button does not appear yet: The PDF is still being generated. Wait 5-10 more seconds and sync again. You may need to sync 2-3 times. Be patient — the PDF needs a moment to be created
- Tap the "View" button (e.g., "View Prescription"). The PDF will open in your browser or PDF viewer
- From there you can print it on your printer, share it via WhatsApp, email it, or save it to your files
- Tap Print Prescription → wait → sync → tap View Prescription
- Tap Print Orders → wait → sync → tap View Orders
- Tap Print Medical Report → wait → sync → tap View Medical Report
- Tap Print Referral Letter → wait → sync → tap View Referral Letter
Print workflow — tap Print Prescription, wait, sync, then tap View Prescription
Reminder About Print Modes
Your prescriptions and orders will look different depending on the PrintMode setting in your Profile (Step 3):
- "Full Letterhead" prints everything on the page: your logo, clinic name, doctor credentials at the top, the prescription/order content in the middle, and your clinic address at the bottom. Use this with blank white paper.
- "Content Only" prints ONLY the patient name, date, and content (medications or orders). No logo, no header, no footer. Use this with your own custom pre-printed paper that already has your clinic branding on it.
To change your print mode: go to the hamburger menu > Setup > Profile > tap on your profile > tap Edit > scroll down to PrintMode_Rx and PrintMode_Orders > change the setting > Save.
Managing Payments
- Open any visit record
- The VisitFee field automatically shows the fee based on the service you selected (from your Price List). You can also type a different amount manually
- After the patient pays, tap the "Mark Paid" button
- The payment status immediately changes to "Paid"
- To record how they paid, edit the visit and set the Payment Type: Cash, Credit Card, or Bank Transfer
Financial Reports
- Tap Finance in the bottom menu (only visible to Admin and Accountant roles)
- The Report Controls screen appears. You can filter by:
- Start Date and End Date — define the time period
- Group By — choose how to group the report results. Options:
- Category (default) — groups by service type (Consultation, Follow-up, Surgery, etc.)
- Visit Site — groups by specific workplace name (e.g., Cairo Clinic, Maadi Center)
- Workplace Type — groups by type of workplace (Clinic, Center, or Hospital)
- Payment Status — groups by Paid, Pending, Partial, or Waived
- Payment Type — groups by Cash, Credit Card, or Bank Transfer
- Patient Type — groups by Private Case, Hospital Case, or Contracted Case
- Category — filter by service type (Consultation, Follow-up, Procedure, Surgery, Investigation)
- Workplace Type — filter by type of workplace (Clinic, Center, or Hospital)
- Visit Site — filter by a specific clinic or hospital
- Payment Status — filter by Paid, Pending, Partial, or Waived
- Patient Type — filter by Private Case, Hospital Case, or Contracted Case
- Payment Type — filter by Cash, Credit Card, or Bank Transfer
- You can combine multiple filters or leave them empty to see everything
- Each group shows its subtotal, and the Total Revenue at the top updates automatically based on all your active filters
- To download the data as an Excel/CSV file: scroll down to the Report Results section and tap the Export button. A CSV file will download to your device which you can open in Microsoft Excel or Google Sheets
Finance dashboard — filter and group your revenue data
Frequently Asked Questions
We have a dedicated FAQ page with answers to common questions about setup, AI notes, syncing, printing, finance reports, and more.
➔ Visit the Smart EMR FAQQuick Reference
| I want to... | Where do I go? |
|---|---|
| Add a new patient | Patients (bottom menu) > tap the + button |
| Book an appointment | Open the patient's file > tap Book Appointment |
| Check in a patient who arrived | Today's Schedule (bottom menu) > tap Check-In |
| Start a visit and use AI | Today's Schedule > tap Start Visit > select Start CDA > Save > Open CDA |
| Fetch the AI note | Visit record > sync > tap Fetch Note > wait > sync again |
| Print a prescription | Visit record > tap Print Prescription > wait > sync > tap View Prescription |
| Print a medical report | Visit record > tap Print Medical Report > wait > sync > tap View Medical Report |
| Print lab/imaging orders | Visit record > tap Print Orders > wait > sync > tap View Orders |
| Print a referral letter | Visit record > tap Print Referral Letter > wait > sync > tap View Referral Letter |
| Record a payment | Open visit > tap Mark Paid |
| See my revenue | Finance (bottom menu) > set date range and filters |
| Export revenue to Excel | Finance > set filters > scroll to Report Results > tap Export |
| Add a staff member | Hamburger menu > Setup > Users > tap + |
| Change print settings | Hamburger menu > Setup > Profile > Edit > scroll to PrintMode |
| Change clinic details | Hamburger menu > Setup > Manage Workplaces > tap workplace > Edit |
| Change prices | Hamburger menu > Setup > Manage Prices > tap service > Edit |
| Change API key or email | Hamburger menu > Setup > Edit Integration Settings > Edit |
Getting Help
Self-Service Resources (Available 24/7):
- This Help Guide is always available inside the app: hamburger menu > Setup > Help
- Smart EMR Documentation: Visit ai4docs.ai/smart-emr/docs for the complete documentation
- Smart EMR FAQ: Visit ai4docs.ai/smart-emr/faq for frequently asked questions and answers
- Tutorials: Visit ai4docs.ai/smart-emr/tutorials for step-by-step visual tutorials
- AI Chat Assistant: Look for the chat widget (chat bubble icon) on any AI4Docs.AI webpage. Our AI assistant can answer most questions instantly
Community Support:
- Join the AI4Docs.AI Doctors WhatsApp Group for tips, questions, and peer support from other doctors using Smart EMR. Find the group link on our website.
Smart EMR by AI4Docs.AI — Your data, your control, your clinic.
AI4Docs.AI Ltd. (UK Company #16893518) | ai4docs.ai
Version 3.1 | February 2026
