Provider Manual · Part VI

Encounter completion — the note & diagnoses

Document the visit and let Hero EMR turn it into a guided completion checklist: the note writer, auto-completion on save, and diagnoses.

14 sections~34 min read8 screenshots
VI
Part VI

Encounter completion — the note & diagnoses

Document the visit and let Hero EMR turn it into a guided completion checklist: the note writer, auto-completion on save, and diagnoses.

6.1The workspace

Open the encounter and meet the note writer

Every visit is documented in the note writer — a two-pane workspace. The left pane is the patient’s chart; the right pane is the note. You write the note on the right, and when you save, the left pane turns into a guided Encounter Completion checklist that walks you through diagnoses, orders, charges, follow-up, and medications before you sign.

  1. Start the encounter. On the dashboard agenda, hover the patient’s appointment row and click the small ▶ play button that appears on the right (its tooltip reads Begin encounter) — the same button sits on the calendar’s appointment list. Double-clicking the appointment row does the same thing. From the chart, open the Encounters tab, single-click a row in the Upcoming visits panel and use Begin encounter in the preview’s action strip. The note opens on a tab labelled Note: <patient>.
    • Once a visit is signed or complete the ▶ button stops appearing on hover — that is deliberate, not a fault. Double-click the row to open a signed visit and add an addendum.
  2. Know the two panes.
    • Left — Chart Review. Tabs for Encounters, Notes, Labs, Imaging, Medications, Immunizations, Medications given, Prenatal, Brain Health, Procedures, Media, and Letters, plus the patient header strip (vitals, allergies, problems, pharmacies). Immunizations, Medications given, Prenatal, and Brain Health only appear when the matching organization feature is switched on under Admin → Additional Features — and Prenatal additionally needs an existing pregnancy episode on file for this patient.
    • Right — the note editor. A rich-text editor. Its toolbar runs bold/italic/underline, a Format dropdown holding headings, lists, alignment, and the note’s display style, then the note-type pill (for example Progress Note), + New note, a Visible or Hidden control for patient-portal visibility, dictation (microphone), and save. The visibility label follows the selected note, including an automatically hidden psychotherapy note; its tooltip reads Manage hidden note when restricted.
  3. Switch panes whenever you need to. The small ⇆ icon button inside the note’s own tab in the tab strip flips the left pane between chart and completion — hover it and the tooltip reads Switch to Encounter Completion or Switch to Chart Review depending on where you are. It shows only on the active note tab, so you can flip back to the chart mid-visit without losing the completion you’ve started. Staff users don’t get the toggle, because they don’t complete encounters.
  4. Go back to the visit’s prep with Pre-visit. When the visit was booked on the calendar, a Pre-visit button sits at the top right of the patient header, just left of the view switcher (Chart Review / Encounter Completion). In the vertical layout, with patient info on the left, it heads the middle column instead. It opens this visit’s Prep tab, the same tab Prep visit… opens from the calendar, so you can finish a review or reconciliation you skipped.
    • On a draft note, an amber number on the button shows how much is still to review there: Prep sections not checked off for this visit and, if your practice uses intake review, intake items waiting for review and provider flags to acknowledge. Hover the button for the list, for example Not checked off: Medications, Allergies. A green check means everything there is reviewed.
    • The number appears only once Prep has been used on this patient’s chart, and counts only what you are allowed to check off. On a signed note the button is just a link.
    • Staff see it when they can open the Prep tab (patient and schedule access).
Dictate instead of type: the microphone in the editor toolbar records and transcribes the visit straight into the note. You can also import a Zoom telehealth transcript — see Run telehealth visits.
Keyboard shortcuts in the note. Ctrl/Cmd+S saves the note, Ctrl/Cmd+Shift+D starts and stops ambient dictation, F2 jumps to the next template fill field (***) and Shift+F2 goes back, and F8 opens the Note Writer guide. These are the defaults — remap any of them under Keyboard Shortcuts in Settings.
“Workspace unavailable”? If a panel is replaced by Workspace unavailable — The current workspace stopped rendering. Retrying will remount this panel without leaving the dashboard., click Retry. Only that panel reloads; you stay signed in and on the same screen. If it keeps coming back, reload the browser tab and tell Hero support what you were doing when it appeared.
6.1bCollaborative editing

Co-edit a note with another clinician

Collaborative editing lets two or more clinicians work on the same saved encounter note and Encounter Completion screen at once, the way several people edit one shared document. Changes merge live over a websocket, so a supervising physician and a resident — or a scribe and a clinician — can build the note together without overwriting each other. Unless an admin has chosen one mode for the whole practice (see step 1), it is off by default and is a per-clinician setting: the clinician who owns the encounter must have it enabled for a shared session to be allowed.

  1. Turn it on (encounter owner). Open the top-toolbar Settings gear and choose SOAP Notes, which opens as its own SOAP Notes tab. Choose Settings in its left rail and turn on Collaborative editing under Collaboration. It saves immediately. The same page also holds your Note writing engine, Note display style, and Chart Context — see Note templates.
    • If the switch is locked and reads Managed by your administrator (Admin → Documentation), your practice uses one mode for everyone — collaborative notes or single-editor notes — and only an admin can change it, under Admin → Documentation.
    • Co-editing only works on a saved encounter. A brand-new, unsaved standalone note can’t be co-edited yet — press Save Note first (see Auto-completion).
  2. Edit together. When a second clinician opens the same encounter, they briefly see “Connecting… Waiting for collaboration sync”, then a presence bar appears across the top of the note: a green Connected dot, an “N people editing” count, and a colored avatar with each editor’s initials (hover an avatar for the full name and Active now).
    • Sections that someone is editing highlight with a colored border and lock to whoever is in them, so two people don’t type over the same paragraph. You can unlock a colleague’s section if you need to take it over.
    • Toasts announce when someone joins, leaves, or starts signing.
  3. Finalize without collisions. When one clinician begins signing/finalizing the visit, everyone else sees a signing-in-progress lock so two people can’t sign at once. If a signing lock is held too long it can be force-unlocked, then the visit closes through the usual Sign & close step.
A live encounter note with a presence bar showing a green Connected dot, a 1 person editing count, and the clinician's colored initial-avatar marked Active now
The presence bar on a live note: a green Connected dot, the editor count, and an initial-avatar. As more clinicians join, additional avatars appear and the count rises to “2 people editing,” and so on.

With a second clinician in the note the presence bar shows two avatars and any section they’re working in carries their color — their cursor and edits stream in live as the two of you write, and either of you can hand a locked section back and forth.

Caution: every collaborator sees the same live PHI for this patient in real time, so only invite clinicians who should have access to this chart. And remember the switch lives with the encounter owner — if the owner hasn’t turned on Collaborative editing (and no practice-wide mode is set), a shared session won’t start even if everyone else has it on.
6.1cCopy forward

Copy forward: start a draft from an earlier signed note

Copy forward copies the text of an earlier signed note for the same patient into the draft you are writing, so you can update last visit’s history, assessment and plan instead of retyping them. Copy forward is off by default.

An administrator, or staff with documentation-policy management access, enables it under Admin → Documentation → Copy forward using the Copy forward checkbox. This workflow is available in the desktop note editor.

  1. Open an editable draft and choose Copy forward. Select an earlier signed note for the same patient. The picker shows its type, author, date, and an AI summary or text preview. A note that cannot be copied explains why.
  2. Press Copy forward. If the current draft already contains writing, Copy into this note asks whether to Add below or Replace current content. Read the choice before replacing work.
  3. Review the copied text for this visit. Update the history, findings, assessment, and plan, then save the draft normally. Copying does not sign it or carry out its old orders.

Treatment Smart Blocks start the new visit empty where the old visit’s values would mislead. In .ketinfusion and .ketim, every time, the vitals, weight, dose, treatment number, IV access and injection site, the staff, today’s scales and scores, the drug screen, PDMP and pregnancy test results, and the codes are left out. In .spravato (and a practice’s own copy of it), the times and minutes, the vitals, today’s scales and scores, the screening results, the treatment number, the lot and the staff are left out; the dose and the codes carry. The program, HPI, exam, premeds, plan, frequency and baselines carry in all three. Fields that fill from the chart (weight, today’s PHQ-9, baseline vitals) fill again from the new visit. The note you copied from does not change.

Every copied Smart Block takes the block’s current version, the one its shortcut inserts today: fields your practice added since the earlier note appear with their starting values, and renamed fields and new choices show. The earlier visit’s values carry into every field the block still has. A field the block no longer has, or a choice it no longer offers, is left out. A block that was deleted or turned off is copied as it was.

Visibility restrictions still apply. A note hidden from a patient or guardian portal cannot be copied into a draft that would expose it there. Every copy is logged. Use the explanation in the picker if a source is unavailable.
6.1dNotes without an appointment

Write a note with no appointment: New visit note and Quick note

To write a note when nothing was booked — a walk-in, a telephone call that needs documenting, an unscheduled or non-visit encounter, or documentation after the fact — start an unscheduled visit from the chart with New visit note. It creates the encounter without an appointment and opens its note in the note writer, the same note you get from a scheduled visit.

  1. Have the button turned on (administrator, once). New visit note is off by default. An administrator turns it on under Admin → Documentation (it is also listed in Admin → Additional Features). It then shows to providers, and to staff who have permission to edit draft notes.
  2. Open the patient’s chart and click New visit note. It sits on the chart’s tab bar next to New orders (its tooltip reads Start an unscheduled visit for this patient and open its note). It is not offered from the chart pane inside an open note.
  3. Fill in the New visit note dialog.
    • Visit type — the office visit (or a follow-up) is preselected. Choose carefully: “Choose it now: the note writer can’t change it later.” The visit type also decides which note template dictation starts with. Orders-only visit types, and types your practice turned off or hid, are not offered (see Visit types).
    • Provider — you, by default. “The visit is billed under this provider.” Staff choose the provider.
    • Department — asked only when your practice uses departments and Hero can’t tell which one the visit belongs to.
    • Date — always today. To document a visit from an earlier day, start it here and then change its date with the date-of-service chip in the note toolbar.
  4. Click Start note. The new visit appears on the chart’s Encounters tab and its note opens. Write, save, and sign it exactly like any other visit (Auto-completion, Sign & close).
Just a short note, no visit to bill? Physicians can use Quick note instead: hover the magic wand and choose Quick note (or press Ctrl+N). Sign & file to chart signs it and files it under a new notes-only encounter in one step — there is no Encounter Completion, diagnoses or charges.
Started one by mistake? A visit you started and never wrote anything in can be removed — see Delete a note or encounter opened by mistake.
6.1eDate of service

Change the visit date (date of service) from the note

The date chip in the note toolbar is the visit’s date of service — the date billed for the visit. Use it to backdate a note to the day the patient was actually seen, for example a hospital encounter or a call documented the next morning. Hover it and the tooltip reads Date of service: <date>. Click to change it.

  1. Click the date chip while the note is a draft. A small Date of service calendar opens: “This is the date billed for the visit. Pick a day to change it.” On a signed visit, start an addendum first; the visit’s clinician or a practice administrator can change a signed visit’s date that way.
  2. Pick the day. It saves at once — there is no reason to type and no extra dialog — and the chip briefly reads Saved. The appointment, the recorded check-in and start times, and any claim not yet sent move to the new day. Coding, charges, diagnoses and the note text don’t change. Every change is recorded in the visit’s history.

When the date can’t change, the calendar says why instead of offering days:

MessageWhat to do
The date of service can’t be in the future.Pick today or an earlier day.
This visit’s appointment hasn’t happened yet. To change its date, reschedule the appointment.Move the appointment on the calendar.
This visit’s claim has already been sent to <payer>. To change its date, use Correct & Refile in Billing.Your billing team corrects the claim.
This visit’s claim is on hold for review in Billing.Resolve the hold in Billing, then change the date.
To change a signed visit’s date, start an addendum first.Create an addendum, then use the chip.
Hospital visits are dated by their admission. Move the rounding day instead.Change the rounding day on the hospital stay.
Someone else has this visit open.Ask them to close it, then try again.
Imported records keep the date they were imported with.Imported visits can’t be redated.
6.1fDelete a note

Delete a note or encounter opened by mistake

If you opened a new note you didn’t need, started an extra progress note, or began an encounter for the wrong patient, you can delete it while it is still an unsigned draft. What you can remove depends on how far it got: an unsigned draft note can be deleted by its author, an empty encounter can be deleted from the chart, and a signed note or visit is never deleted — it is amended or marked entered in error.

Delete an unsigned draft note

  1. Open the note and click the × on it. When the visit has one note, the × sits on the note-type chip in the note toolbar (for example Progress Note); when the visit shows a tab strip with several notes, it sits on the selected note’s tab. Its tooltip reads Delete this note, or explains why the note can’t be deleted.
  2. Confirm with Delete note. A completely blank note is deleted straight away. A note with any writing in it first asks Delete this note?: “This removes the note from the visit and the chart. As with all medical records, a copy is kept in the audit history.” Keep note backs out. If a colleague is in the note at that moment, the dialog names them.
  3. Check what happened to the visit. If the dialog also said “The empty visit will be removed too.”, the note was the visit’s only note and nothing else was on it, so the encounter leaves the chart as well. A visit that still holds anything else — orders, charges, vitals, diagnoses — stays on the chart.

The × is unavailable, with the reason in its tooltip, when:

  • you are not the note’s author (Only the note’s author can delete it.) — ask the author;
  • the note is signed (A signed note is changed with an amendment.) or in review — see Addenda;
  • the visit is already closed, or the note is open on another device (open it on this one);
  • it is an addendum’s draft — use Discard empty addendum instead;
  • it is the psychiatry half of a psychiatry and psychotherapy note pair (“This note is half of a psychiatry and therapy note pair, so it can’t be deleted on its own. If no psychotherapy was provided, remove the psychotherapy note from its tab.”; to drop the psychotherapy half, use Remove psychotherapy note on its tab, below), or an outside note (outside notes are removed by unfiling their document).

Remove the psychotherapy note from a pair

A split note template writes a psychiatry note and a psychotherapy note for the same visit (Psychotherapy add-on). If it wrote a psychotherapy note for a visit with no psychotherapy, for example a diagnostic screening, remove that half while both notes are unsigned drafts:

  1. Click the × on the psychotherapy note’s tab. Its tooltip reads Remove psychotherapy note.
  2. Confirm with Remove note. The dialog always asks first: Remove this psychotherapy note? “Use this when no psychotherapy was provided.” and “The psychiatry note stays; delete any Psychotherapy Add-On section from it. As with all medical records, a copy is kept in the audit history.” Keep note backs out. Hero confirms Psychotherapy note removed and opens the psychiatry note.
  3. Tidy the psychiatry note. Delete any Psychotherapy Add-On section from it, and check Charges has no 90833, 90836 or 90838 before you sign. Once the psychotherapy note is removed, Hero no longer suggests those codes for the visit.

Anyone who can edit both notes can do this, not only the author. It is refused, with the reason in the tooltip, when the psychiatry note is signed (“The psychiatry note of this pair is signed, so this psychotherapy note can’t be removed. A signed note is changed with an amendment.”), when you can’t edit the psychiatry note right now, or when the pair revises a signed pair. Signed notes are changed with an amendment.

Delete an empty encounter from the chart

  1. Right-click the draft visit on the chart’s Encounters tab and choose Delete empty draft. On a Mac, Control-click or click with two fingers on the trackpad to right-click. The item appears only for a past or current draft that has nothing in it; staff need permission to edit draft encounters.
  2. Confirm with Delete draft. The dialog explains: “Nothing was written in this encounter — no note text, orders, charges, vitals, or attachments. Deleting it removes it from the chart.” Keep backs out.

“This encounter can’t be deleted because…”

Hero only deletes an encounter when nothing would be lost. The message lists what is on it, for example it has documentation in progress, it has a note with content, it has diagnoses, it has charges, it has prescriptions, it has vitals or it has questionnaire answers. Documentation in progress means the visit’s Encounter Completion worksheet already holds something — usually because the note was saved and Hero filled in diagnoses, orders, charges or follow-up from it. Such an unsigned visit can’t be deleted. Delete your draft note (above) so nothing unsigned of yours remains on it, and leave the visit unsigned; nothing is billed or sent until someone signs it.

A signed visit was a mistake: entered in error

A signed visit is never deleted. Physicians and administrators can right-click it on the Encounters tab and choose Mark as entered in error… (see Encounters). The visit leaves the encounter list; its notes are not deleted — they stay readable under the chart’s Notes tab with Status: Void. Diagnoses and medication changes from that visit stay on the chart, so correct them separately if they were wrong.

6.1gChange the provider

Change the provider on an encounter

Hero has no control that switches an existing encounter from one provider to another. The provider is set when the visit starts — from the appointment’s provider, or the Provider you pick in New visit note — and the visit is billed under that provider. Use one of these routes instead:

  • An upcoming appointment is booked with the wrong provider: reschedule it onto the right provider’s calendar (see Change an appointment’s provider or visit type). An encounter nobody has started moves with it; once its note is started or a claim exists, the move is refused, so cancel and rebook instead.
  • The encounter was started under the wrong provider and nothing was written: delete it with Delete empty draft or by deleting its blank note (Delete a note or encounter), then start the visit under the right provider with New visit note.
  • You saw the patient and a colleague’s visit is already open: add your own note to that visit with + New note in the note toolbar (its tooltip reads Add another note to this encounter). Each note keeps its own author; the visit’s provider does not change.
  • The visit is signed: if it was documented under the wrong provider, a physician or administrator marks it Mark as entered in error… and the correct provider documents a new visit.
6.1hNote type & template

Change the note type or the note template of a note you haven’t signed

Two different things are called a note’s “type”: the note type label (for example Progress Note), and the note template the AI writes into when you dictate. Both can change until the note is signed.

  1. Change the note type label. Click the note-type pill in the note toolbar (labelled Note type) and pick another. The list is your practice’s note types, which an administrator manages under Admin → Documentation → Note types. You can’t relabel a note you can only read.
  2. Rewrite a dictated note with another template. If the note was written from a recording, click the history icon next to the microphone (Retranscribe or view transcript) and choose Retranscribe. The Retranscribe from saved recording? dialog has a Note Template picker: choose the template you want and press Retranscribe. Choose Replace this text (the old text is kept in Version History) or Keep this text and add the new note after it. This works only on the computer where you recorded, for up to 10 days (see Recordings).
  3. Pick the template before you record next time. The Note Template picker in the recording overlay sets the template for that recording. To change which template a visit type always starts with, set its Note template under Settings → SOAP Notes → Visit types (see Note templates). The visit type itself can’t be changed from the note.

A typed note has no template to swap: insert another starting point with a dot phrase such as .soap (see Note modules), or copy forward an earlier note.

6.1iVisit types

Add your own visit types, including ones you don’t bill, and hide the ones you don’t use

The Visit type list in New visit note is your practice’s visit types. An administrator, or staff with documentation-policy management access, manages it under Admin → Documentation → Visit types, next to Note types: “The types clinicians choose from when they start a new visit note. Add your own, or hide built-in types your practice doesn’t use. Notes already written keep their type.” Each change saves on its own; there is no Save button.

  1. Add a type. Type its name in Add a visit type, e.g. Non-billable Admin Note. Below it, Billable starts ticked: “Signing a note of this type bills the visit as usual. Uncheck it for admin notes and other notes you never bill: they create no charge or claim. You can’t change this after the type is added.” Then click Add (or press Enter). A type you don’t bill shows Not billed in the list.
  2. Rename, turn off or delete your own types. The pencil renames a type. Turn off stops offering it; you can turn it back on any time. The trash can deletes it after “Delete …? Clinicians can’t choose it anymore. Notes already written keep it.” A type that one of your scheduling visit types still uses can’t be turned off or deleted: “Visit types in scheduling still use this type. Change or remove them first.”
  3. Hide built-in types you don’t use. Built-in types are marked Built-in. Every practice shares them, so you can’t rename or delete them. Hide takes one off your practice’s lists only.
  4. Bring a type back. Open Hidden or turned off below the list and click Show on a built-in type or Turn on on one of yours. You can delete your own types from there too.

Hidden and turned-off types leave New visit note, the Encounter Type choice when you set up a scheduling visit type, and the injection visit type choices. Visits and notes that already have the type keep it and still show it.

Notes of a visit type you don’t bill

A note of one of your own types with Billable unticked is signed with No charge: no charge and no claim, and the chart and Billing Monitor show No charge. The note writer hides Charges, says “This visit type isn’t billed, so no charge or claim will be made.”, and needs no diagnosis to sign.

  • First signature only. A visit that was already signed keeps the billing it was signed with, even when it is reopened, re-signed or addended.
  • Built-in types bill as usual. Only the types your practice added follow the Billable box.
6.1jQuick vitals

Enter vitals without leaving the note

Type this visit’s vitals right in the note. They are saved to the chart for this visit, and a vitals card is added where your cursor was.

  1. Type .addvitals and press Enter. Or click the pulse button in the note toolbar (Enter this visit’s vitals and add them to the note). .vitalsentry and .quickvitals do the same. A small panel opens where you typed.
  2. Type the blood pressure, then press Tab. Tab moves through diastolic, heart rate, respiratory rate, temperature, SpO2, weight and height. BMI fills in from weight and height.
  3. Press Enter to save. Or click Save to note; Esc cancels. Vitals saved confirms it, and the Vitals this visit card appears in the note.
A Vitals panel inside the note, labeled Measured now, saved to this visit, with blood pressure 128 over 82, heart rate 72 bpm, respiratory rate 16 per minute, temperature 98.4 °F, SpO2 98 percent, weight 180 lb, height 70 in, BMI 25.8, a hint Enter saves, Esc cancels, and Cancel and Save to note buttons
The panel opens where you typed .addvitals. Tab moves from field to field; BMI fills itself in.
The note now holds a Vitals this visit card with one column at 6:43 PM: BP 128/82, HR 72, RR 16, Temp 98.4 °F, SpO2 98%, Weight 180 lb (81.6 kg), Height 5 ft 10 in (177.8 cm), BMI 25.8; the chart header shows the new weight and height, and a toast reads Vitals saved, Saved to this visit and added to the note
Saved to the visit and added to the note. The chart header shows the new weight and height straight away.
  • Units. Click °F, lb or in to switch to °C, kg or cm. The panel starts in the units you use on the vitals bar.
  • Measured now. Vitals entered here are recorded at the current time. To record another time, or more vital signs such as pain or head circumference, use Add encounter vitals from the vitals bar.
  • Same checks. The panel checks values the same way the vitals bar does, for example that both blood pressure numbers are there.
  • Who can. Staff need the Record and edit vitals permission.
6.1kNote types

Add, rename or retire your practice’s note types

The note types clinicians pick from the note-type pill, for example New Patient H&P, Procedure Note or Telephone Note, are your practice’s own list. Every practice starts with one built-in type, Progress Note, which new notes start on. An administrator, or staff with documentation-policy management access, manages the list under Admin → Documentation → Note types: “Labels clinicians pick from when writing a note. New notes start on the default; clinicians can change it per note.” Each change saves on its own; there is no Save button.

  1. Add a note type. Type its name in Add a note type, e.g. Psychotherapy Note and click Add (or press Enter), or click one of the Suggestions below the box. Names must be different from the ones already on the list. A new type goes to the bottom of the list.
  2. Choose the default. The type new notes start on is marked Default. Click Make default on another type to make it the default instead; there is only ever one.
  3. Rename or reorder. The pencil renames a type. The up and down arrows move it; the note-type pill lists your types in this order.
  4. Remove a type you don’t use. The trash can removes a type no note uses yet. A type that notes already use is retired instead, and those notes keep it (the tooltip reads “Retires this label; notes already using it keep it”). Retired types are listed under Retired, where Restore brings one back. The built-in type can’t be removed, only renamed.
  5. Use it on a note. In the note writer, click the note-type pill (labelled Note type) and pick the type. The pill opens once the note has been saved, so type a word or start dictating first; until then it shows the default. You can change the type until the note is signed (see Note type & template), and the chart’s Notes tab can filter by it (Note types).
A note type is a label, not a template. It doesn’t change what the AI writes when you dictate: that comes from the note template of the visit type (Settings → SOAP Notes → Visit types; see Note templates). Visit types, which decide the template and whether a visit is billed, are a separate list (see Visit types).
Ask F3. Press F3 anywhere in Hero EMR and ask, for example, “How do I add a note type?” (see Hero EMR Assistant).
6.2Auto-completion

Write the note, hit Save, and the encounter completes itself

As soon as there is text in the note and you press Save Note, Hero EMR reads what you wrote and automatically switches the left pane into Encounter Completion, pre-filling each section from the note. A plan that says “follow up in three months” sets the follow-up; an assessment of “generalized anxiety disorder” is ready to drop in as a diagnosis. You review and adjust rather than start from a blank form.

  1. Type your note and click Save Note. Any free text or dictated/structured content counts. Saving is what triggers completion, and the note needs at least 25 characters of text: an empty or very short note still saves, but produces no diagnoses, orders, charges, follow-up, or instructions.
  2. Save again and Hero adds, never replaces. The first save fills the sections straight away. Diagnoses and orders you entered by hand while talking to the patient stay exactly as you left them: the save reads the note and adds only what isn't there yet (a diagnosis, lab or imaging study it doesn't already have, or a charge line for a code the visit has no line for). It fills the visit level only when none is chosen, the follow-up timing unless you confirmed or booked one (a visit type you picked stays), and patient instructions only when they are empty. Suggested prescriptions are refreshed from the note, and a prescription you ordered or approved is never suggested again. A medicine the plan says to continue (“Continue sertraline 50 mg daily”) is suggested as a refill at its current strength, directions and supply; delete the suggestion when the patient doesn’t need one. A medicine another clinician prescribes (“continue lisinopril per PCP”), or one only listed in the medication history, is not suggested. Hero remembers what it has already put on the visit, so a diagnosis, lab, study or charge line you removed (or a study you changed, say to “with and without” contrast) is not put back on a later save, and a visit level you cleared stays cleared; only what is new in the note since then is added. It doesn't ask first. Once Hero has filled the visit from the note, a later save asks Update from the note? — “Hero adds what the note has that isn't here yet. What you entered stays.” Press Enter or click Add from note to add; Cancel skips the read. Start over asks once more, then “Replaces the unsent diagnoses, orders, charges, follow-up and instructions with what the note says.” Sent orders, a booked follow-up visit and in-office tests stay either way, and nothing changes if the read fails. If only the after-visit summary fails, your patient instructions and stop suggestions stay as they were and the finished message says “Patient instructions were not updated…”. Start over also makes Hero forget what it put on the visit before. The finished message says what was added, for example “Added from the note: 2 diagnoses, 1 order. Your entries were kept.”, or “Nothing new in the note”. An addendum is different: the same dialog then reads “This addendum will be analyzed without clearing the encounter’s existing diagnoses, orders, charges, follow-up, or patient instructions” — it adds what it finds instead of replacing, leaves the visit’s charges and after-visit instructions alone, and never disturbs an order you already sent. See Change a visit after you’ve signed it.
  3. The completion checklist appears. The left pane now shows collapsible sections: Diagnoses, Orders, Charges, Instructions, Follow-up, and Medications. Suggested values (for example a 2-week follow-up) are already in place. A practice that uses In-office medications also gets Medications given in clinic, between Orders and Charges.
  4. Work top to bottom, or jump around. Use Expand All / Collapse All at the top to open every section at once. The footer chips — Dx, Orders, E/M, F/U, and Meds (plus Linked once you have both a diagnosis and an order) — are a live progress tracker: each turns green when that part is complete and doubles as a jump link.
  5. Finish with Sign & Close Visit. The big button at the bottom finalizes the visit in one step. If something required is still missing, clicking it tells you what to fix instead of signing (see Sign & close the visit).
Encounter Completion panel with collapsible Diagnoses, Orders, Charges, Instructions, Follow-up and Medications sections, a Follow-up auto-set to 2 weeks, a Dx/Orders/E/M/F/U/Meds progress tracker, and a Sign & Close Visit button
Saving a note with text flips the left pane into Encounter Completion, pre-filled from what you wrote — here the follow-up is already set to 2 weeks.
Some things leave before you sign. Charges, the signed note, medication discontinuations, and the follow-up request are only committed when you finalize with Sign & Close Visit. Individual orders are different: every prescription, lab, imaging, and referral row carries its own Sign & Send button, and pressing it transmits that order immediately — controlled prescriptions through the EPCS two-factor flow. Once an order shows as sent it has already left the EMR, whether or not the visit is signed.
Keyboard shortcuts. Inside Encounter Completion, Alt+D jumps to Diagnoses, Alt+O to Orders, Alt+E to E/M coding, Alt+I to Patient instructions, and Alt+F to Follow-up. Ctrl/Cmd+Enter signs and closes the visit. These are the defaults — remap any of them under Keyboard Shortcuts in Settings.
6.3Diagnoses

Add diagnoses (ICD-10)

The Diagnoses section captures the ICD-10 codes for the visit. You can search the full code set, click a frequently-used or favorite code, and reorder the list to set the primary diagnosis.

  1. Search by code or description. Type into Search ICD-10 codes… (for example anxiety or F41.1) and press Enter, or click the + button in the box. Either opens the Search ICD-10 Codes window — the inline box itself doesn’t list results. Click a row there to add it to the visit.
    • In that window, Billable codes only hides category headers that a payer would reject, and the specialty filter narrows the list to one specialty’s codes.
    • A green ⓘ next to a description marks an HCC relevant code.
  2. Or use the quick lists.
    • Frequently Used Diagnoses — one-click chips for the codes your practice uses most.
    • My Favorite Diagnoses — your personal shortlist. Manage it with the gear or Add favorites (see Favorites).
  3. Set the primary and order. Added codes appear under Current Diagnoses. The first one is tagged Primary and every other row carries a Secondary badge — click that badge to promote the row to primary. You can also drag the handle to reorder, star a row to favorite it, or click × to remove it. Adding the first diagnosis turns the Dx tracker chip green.
Twelve diagnoses reach the claim. An insurance claim (837P) carries at most 12 diagnoses, so only the first 12 in your ordered list are submitted. Anything past position 12 stays in the chart but is never billed — put the codes that matter for this claim at the top.
Diagnoses section with an ICD-10 search box, Frequently Used Diagnoses chips, a My Favorite Diagnoses area, and an empty Current Diagnoses list
Search, frequently-used chips, and favorites all feed the same Current Diagnoses list.
Current Diagnoses showing Generalized anxiety disorder F41.1 with a Primary badge, a favorite star, a drag handle, and a remove control; the Dx tracker chip is now green
The first code becomes Primary; drag to reorder and the Dx chip turns green.
Diagnoses drive more than the note. They’re what you link orders to for medical necessity (Link diagnoses to orders) and they flow into the charges you submit.
6.3aDiagnoses the AI keeps

The AI keeps your established diagnoses, and shows when it changes one

When Encounter Completion fills in the diagnoses, the AI starts from the patient’s established diagnoses: the codes on the last signed visit and the active problem list. It keeps your code exactly, with the same subtype, episode and severity, unless today’s note clearly documents a change. It never swaps a specific code for an “unspecified” one because the note is short.

  • “ADHD, predominantly inattentive type (F90.0)” stays F90.0 when the note says “ADHD, continue Vyvanse”.
  • “Major depressive disorder, recurrent, moderate (F33.1)” stays F33.1 when the note says “depression, stable on sertraline”.
  • An AI-written note uses the same diagnosis names and codes in its Assessment and Plan.

When a code does change

If today’s note documents a change (“now meets criteria for combined presentation”, “worsened, now severe”, “now in partial remission”, or the new code written in the note itself), the new code is used and the diagnosis gets an amber Changed from … label.

  1. Save the note as usual. Encounter Completion opens with the diagnoses filled in.
  2. Look for an amber Changed from … label. It sits next to a diagnosis in Diagnoses.
  3. Click the label. It shows the code on file (from the last visit or the problem list), this visit’s code, and the reason, in the note’s own words.
  4. Keep it or put it back. If the change is right, do nothing. If not, click Use … with the code on file. It replaces the new code in place, and its orders and charges move with it.
Encounter Completion with Post-traumatic stress disorder, chronic (F43.12) as the primary diagnosis, an amber Changed from F43.10 label beside it, and suggested sertraline and prazosin orders linked below; the note's assessment names F43.12
The note documents chronic PTSD, so the diagnosis carries Changed from F43.10.
The Changed from the diagnosis on file popover: This visit's note reads as a change, so the new code was kept. Check it before you sign. Problem list: F43.10 Post-traumatic stress disorder, unspecified. This visit: F43.12 Post-traumatic stress disorder, chronic, This visit's note names F43.12. Orders and charges move with the code, and a Use F43.10 button
The details: the code on file, this visit’s code and why. Use F43.10 puts the code on file back.
  • New problems are not changes. A diagnosis added for a new problem (for example panic disorder next to your generalized anxiety disorder) gets no label.
  • Combined codes. When ICD-10 rules combine two conditions into one code (for example diabetes with kidney disease), the label says so.
  • Advanced AI coding. It works the same with Advanced AI coding on or off.

Need help? Email support@heroemr.com.