Before you start
This article is for practices using Cornerstone. If you use Avimark or Impromed, see the guide for your system.
⚠️ Upgrade to HappyBridge. HappyBridge is our newest Cornerstone connection, built by our own team, and it's the most stable way to connect. It sends the note itself into Cornerstone every time, so the most common export problem, a note arriving as a link, doesn't happen. If your practice is still on our older connector, it keeps working and everything below still applies, but we recommend moving over. It takes about fifteen minutes from Settings in HappyDoc: see Cornerstone: Setting Up Your Connection ↔️. Or tell us and we'll do it with you.
You'll need:
HappyBridge (or our older connector) running on your Cornerstone server.
Google Chrome on that server if you use HappyDoc there. Microsoft Edge doesn't work properly with HappyDoc.
Appointments synced from Cornerstone, or a visit with the patient's Cornerstone Patient ID.
Step 1: Check your doctors are set up
Each doctor has to be linked to their Cornerstone record before their notes can be sent across. We do this for you during setup, so there's nothing to configure.
Click the Account menu at the top right, then Settings.
Click Schedule, then the Staff tab.
On HappyBridge, check each doctor has a green Synced label. On the older connector there's no label; just check every doctor is listed.
If a name is missing, or a clinician has just joined, tell us and we'll add them.
Step 2: Switch on export
In Settings, click Integrations.
On the Cornerstone card, switch on Enable Export.
Optional: switch on Sync checked-in patients to bring Daily Planner check-ins into HappyDoc, in a room called Checked-In.
Optional: pick a Default Record Color so HappyDoc rows stand out in Cornerstone.
Optional, on HappyBridge: switch on Auto-finalize notes in Cornerstone and set Finalize after to the number of days you want (1 to 365).
Sync checked-in patients and Auto-finalize stay off until you switch them on. With Auto-finalize off, notes stay Tentative in Cornerstone until someone finalizes them there.
Step 3: Choose how your note looks in Cornerstone
Each document has its own Export Settings. If you use our standard HappySOAP, first make your own copy: in Settings, click Documents, click Create Custom, pick HappySOAP, click Get Started, name it and click Save.
In Settings, click Documents.
Click the three dots next to your custom document and choose Edit Document.
Click Export Settings at the top right.
Choose a font, and a layout: Indented Fields or Center-aligned Objective Section.
Under Record Color, choose the account default, no color, or a custom color for this document.
Close the window and click Save.
The preview shows the layout only, not your font or your own fields. Your export follows the document, so new fields, custom instructions and bold field titles carry across on their own. The text color in Cornerstone can't be changed.
Step 4: Export a note
Open a visit that came from Cornerstone. These have a circular arrow on the Visits page.
Generate the document you set up in Step 3.
In the toolbar above the document, click Export.
If something's wrong, a red message appears at the top right, for example when the patient can't be found. Check the Patient ID on the visit.
Step 5: Find the note in Cornerstone
In Cornerstone, open the patient's clipboard.
On the Summary tab, find the HappyDoc row.
Double click the row to open the note.
Schedule sync: today and the next seven days sync on their own. For an earlier date, go to that date and click sync.
Bold carries over: text you bold yourself in HappyDoc stays bold in Cornerstone. Use Chrome on the server: not Microsoft Edge. |
If you're on our older connector
Setting up for the first time, or ready to upgrade? Use HappyBridge instead: Cornerstone: Setting Up Your Connection ↔️. The steps below are for practices staying on the older connector for now. They're done on your Cornerstone server.
On the Cornerstone server, open Chrome and sign in to HappyDoc.
Open Settings, then Integrations, and click Download Cornerstone Agent.
Right click the downloaded file, choose Extract All, then double click setup.exe. If Windows warns you, click More info, then Run anyway.
Open HappyDoc Setup from the Start Menu. The Configuration screen opens.
Click the blue gear icon to fill in most of the settings.
Enter the Account ID and API Key from Settings, then Integrations, in HappyDoc.
Optional settings on the same screen:
Default Document Status: whether notes arrive in Cornerstone as Draft, Tentative or Final.
Include Visit Date: adds the visit date to the note's title in Cornerstone.
Auto Finalize (Days): how many days before a note finalizes in Cornerstone.
Click Save and look for the Successful status.
Close the window with the X. The connector keeps running in the background. To come back to it, open HappyDoc Setup from the Start Menu again.
Troubleshooting / FAQs
Q: I don't see an Export button in HappyDoc.
A: Four things need to be in place: 1) your account is set up for export (HappyBridge, or the older connector, is running on your Cornerstone server, and Enable Export is switched on in Settings, then Integrations), 2) the appointment was synced from Cornerstone or has a valid Patient ID that matches Cornerstone, 3) the doctor is set up for export, and 4) the document is set up for export. We do 3 and 4 for you. A visit started in HappyDoc without a Patient ID shows Export greyed out.
Q: An appointment booked today isn't in HappyDoc yet.
A: HappyDoc syncs your schedule for today and the next seven days on its own, but an appointment booked or changed in the last few minutes may need a manual sync. Press the sync button in HappyDoc, wait about 30 seconds, then refresh the page.
Q: I see a URL in Cornerstone when I export instead of a document.
A: This only happens on our older connector. The lasting fix is to upgrade to HappyBridge, which sends the note itself every time: see Cornerstone: Setting Up Your Connection ↔️, or tell us and we'll do it with you. If you'd rather stay on the older connector for now, update it:
In HappyDoc, go to Settings, then Integrations, and click Download Cornerstone Agent.
Run the installer over your existing installation, on the Cornerstone server itself and not a workstation.
When it finishes, check that the database and the service both show as connected, then export again.
Restarting the connector won't fix this one; updating does. At any point you can send us a screenshot of the connector screen on the server and we'll tell you which step you're on.
Q: Can I export a visit with more than one pet on it?
A: Not in one click. Export sends a note to a single patient record, so a visit covering two pets needs each note exported separately. Name the visit with both pets, such as Bella and Max, and HappyDoc will generate a document for each pet. Export the first pet's document as usual. For the second, change the Patient ID on the visit to that pet's ID, click Export, then set the ID back. The full walkthrough is in Multi-Pet Visits: Recording Two Patients at Once 🐾.
Q: Can the row in Cornerstone be colored so my HappyDoc record stands out?
A: Yes. Open Settings, then Integrations, and under Cornerstone choose a Default Record Color. You can also give one document its own color in the Document Builder, under Export Settings. The text color can't be changed.
Q: Can I change the date of the record in Cornerstone after export?
A: No. The note files under the date it was sent. You can put the visit date in the document title, and on the older connector you can switch on Include Visit Date in the connector settings on your Cornerstone server, so it shows in the title in Cornerstone.
Q: Which of my Cornerstone templates does HappyDoc fill in?
A: HappyDoc's export uses its own layout, built from your custom document in Document Builder: Create a Custom Note 🛠️. You can't see or edit it in Cornerstone. To add or remove fields, change them in the Document Builder and click Save. Your export follows the document, so there's nothing else to update. If a field doesn't come across after that, tell us.
Q: Why is the font large or out of proportion when I view the note in Cornerstone?
A: Check your printer settings. If the computer is set up to print labels, Cornerstone can display the note that way. Set the printer to standard paper size.
Q: My records aren't under the Medical Notes tab, or they show as a non medical note under Summary.
A: In Cornerstone:
Click Controls, then Defaults, then Practice and Workstation.
Click Documents. Under Default templates, find "For Medical Note Quick Text documents use".
Type the ID of a text only medical note template.
Click Apply, then close.
To find a text only medical note template ID:
Click Lists, then Documents, then Templates.
Untick the boxes that don't say "text only".
Use an ID from the ID column where the Type is "Medical Note(Text Only)".
Q: My record isn't exporting into Cornerstone. What can I do?
A: If you click Export and something goes wrong, HappyDoc shows a red message at the top right, for example if the patient can't be found. In that case, check the Patient ID. On HappyBridge there's nothing to check on the server: send us the patient name and the time of the visit and we'll look. If you don't see an error and you're on the older connector, open HappyDoc Setup from the Start Menu on the Cornerstone server and check that both the Database and Service boxes are ticked. If not, click Restart. If you're still stuck, copy any errors from that screen into a chat with us.
Q: HappyDoc won't work properly on our Cornerstone server.
A: Use Google Chrome on the server, not Microsoft Edge. If Chrome isn't installed there, install it, sign in to HappyDoc in Chrome, and try again.
Q: How long do notes stay Tentative in Cornerstone?
A: On HappyBridge, open Settings, then Integrations. Under Cornerstone, turn on Auto-finalize notes in Cornerstone and set Finalize after to the number of days you want. Notes arrive in Cornerstone as Tentative and finalize after that many days. Notes already in Cornerstone don't change. With it off, notes stay Tentative until someone finalizes them in Cornerstone. On the older connector, use Auto Finalize (Days) in the connector settings on your server.
Q: Can patients checked in on the Daily Planner show up in HappyDoc?
A: Yes. In Settings, then Integrations, turn on Sync checked-in patients. They appear as visits in a room called Checked-In.
💬 Need a hand? Chat with us in the app (bottom right corner) or email [email protected]. We're always happy to help.
Related Articles











