What's New in 2022
January 5, 2022
Group Note update
When working with a locked group note, you will notice there is no longer an append button. This has been removed to provide clarification regarding the application of an append on a group note. When an append is applied, that note will display on the chart of each participant of a group note and cannot be removed. If you would like to append a group note, follow these steps:
- Navigate to "Group Notes" on the left side menu bar.
- Navigate to the "History" tab.
- Fill out the necessary information to locate the intended group note.


- Select the group note you need to adjust.
- Select "Append to Note" icon in the top right corner.


- Add any notes that you wish to be applied to all participants, and select "Save."
If you need to make adjustments to an individual's notes in a locked group note, you must first unlock the note. If you unlock a Group Note that has signatures applied, those signatures will be removed. If you do not have the appropriate permissions to perform this task, you need to reach out to your System Administrator.
Custom Test update
When creating custom tests you can now delete any unused test. This means that as long as the test has not been added to a client, that test can be deleted. If the test has been added to a client, then the test can only be inactivated.

What happened in 2021
You can review updates from the previous year by visiting What's New (2021).
January 12, 2022
Custom Test improvements
- The "Provider" fields will now default to the user that is logged in, but can be changed as needed.
- When creating Test Groups, the "Provider" will no longer be a required field, and the "Provider" when adding these tests to a client will default to the logged in user as the provider.
- The list of tests in the settings area will now be shown by active status, and then alphabetically by test code.
- There is a new special field that will pull the last entry of tests based on the received date. That special field is {CUSTOMTESTRANGE_LASTENTRY}.
- For additional information regarding Custom Tests, you can reach out to submit a support ticket, or visit Custom Tests. For a list of available special fields, visit Test results.

January 13, 2022
Treatment planning library update
When creating a problem, you will be able to switch the content library when working in the goals and objectives area. The drop-down will display the standard DSM-5 or ICD-10 libraries that you have access to and any custom problem libraries that you create. Once you select a library, you must work in that library for that step, but you can switch when working on objectives. When you are adding a new goal or objective, you will be shown the original library of the problem.
January 17, 2022
For Q-Log tab update
You will now see the number of unread Q-Log messages on your calendar tab on the left hand side menu as indicated by a "Q" and the number of messages. If you know you have Q-Log messages but you aren't seeing this update, you need to select the "Calendar" menu item, and then select the "Q-Log" tab to initiate the feature.

January 20, 2022
eMAR update
When viewing medications in the eMAR, the "Last Administered" line of text has been moved to the top of the medication window, the text size has been slightly increased, the color of the text has been changed to red, and the text has bolding applied. This was done to bring more attention to this information and is only a visual change.

January 31, 2022
Billing update
We have added a Default Place of Service (HCFA Claims) code 10, and we have updated code 2. Code 10 is "Telehealth Provided in Patient's Home" and code 2 has been updated to "Telehealth Provided Other than in Patient's Home." These can be found in the Facilities setup in settings and when attaching Facilities to claims.


February 1, 2022
Lab permissions update
The lab orders permissions have been updated to behave more efficiently. These permissions will operate as detailed below:
- Lab Orders permission only: When selecting the "Prepare Orders" button, the workflow does not change, and you will be taken straight to the Halfpenny order window.


- Proxy Lab Orders permission only: When selecting the "Prepare Orders" button, you will see the Proxy Order window with a list of users to choose from. There will not be a default provider selected, and you must choose the provider you are creating a proxy order for.
- Lab Orders and Proxy Lab Orders permission both selected: When selecting the "Prepare Orders" button, you will see the Proxy Order window, and you as the current user will be the default name selected.


Patient Portal update
When a patient is logged into their portal, they will now see the number of unread items. When the patient clicks to view available files, there will be a new section labeled "Unread." This section will show any documents that are not marked as "read." From the files area, the patient can select the checkmark next to "Mark as read" and all entries will be moved to the "Activity Log" section. This status will only apply to documents that have been portalized since January 6th, 2022.



February 3, 2022
Custom Test update
If you have created an entry for a custom test in the settings area, the Custom Tests section with "Test Results" will automatically be added to your Med/Clinical page. If you would like the location of the "Test Results" to be moved to a different section within the Med/Clinical, you can contact BestNotes Support.


DrFirst medications update
When you use DrFirst, and you are in the "Meds" area of the "Med/Clinical" in BestNotes, and you select the "Refresh DrFirst" button there will now be a behind-the-scenes check for any medication changes since the last "save and close." This means if another user forgets to "save and close" you can still get the latest medication updates without logging into DrFirst. There is a restriction that only allows us to check once every 5 minutes for each client, so the "Refresh DrFirst" button will be grayed out for every user if it is within the 5 minute time period.


February 7, 2022
Assessment update
The "Time Begun" and "Time Ended" fields in assessments will now allow you to enter a 24 hour time, and it will be converted automatically, with the colon and "am" or "pm" automatically applied. This will address any issues that may have been a result of the time not having a colon.

February 8, 2022
Problem Details update
In the med/clinical area, when you have the "Problem Details" section included, this would display as "Master Treatment Plan." This has been adjusted, and this section will now appear as "Problem Details." If the "Problem" label located in the System Customization is updated, then that change will be reflected in the display in the med/clinical as well.



DrFirst time-sensitive product alert
We know you rely on us to provide reliable dose check alerts to prevent adverse drug events. We have recently been notified that while the dosing calculator is accurate, a warning may or may not be triggered in some cases when a decimal is involved based on whether the system rounds up or down. Our partner is working to resolve this rapidly, and we are expecting the system warnings to be 100% by February 15, 2022. In the meantime, we are proactively advising that you manually evaluate clinical appropriateness prior to prescribing. We appreciate your patience as we resolve this with our partner.
February 15, 2022
Portal user update
As a client, once you are logged into the Portal, you can update your Name, Password, and User ID. To update your user ID you will update the email address that is used to login to the portal. To update your user ID, follow the steps below.
- Login to your portal.
- Select "My Account."
- In the bottom right corner, select the checkbox next to "Change Email."


- Enter your new email into the "Email" field and the "Confirm Email" field.
- Enter your password.


- Select "Save."
- You will see confirmation of the save at the top of the window.


- You will also receive an email to the new address that will ask you to verify your updated email address. You must verify your email address, otherwise the change will not take affect, and you will still be required to login with the previous email.
- Once your email is verified, enter the new email address to log into the portal and complete the update.


- Now when you navigate to "My Account" you will notice your updated email listed under "Personal Details."
February 21, 2022
Assessment update
Users that have the "System Administrator" checkbox and the "Manage Templates" permission will now have the ability to go to any assessment and select the "view" icon to display all hidden fields. This will allow the form to be viewed in its entirety, and a snapshot can be created. This is intended to be used as a review tool to aid in requesting changes to the assessment, or in the rare case that it needs to be filled out by hand.


February 28, 2022
Appointments in the Activity Log
When an appointment is displayed in the Activity Log and the General Log, they will now display the "Provider" on the far right side. Also, when changing the provider on a recurring appointment, the provider will be updated on the Activity Log as expected. Previously, this was not updating the Provider in the Activity Log.


DrFirst medications display
For all DrFirst medications, we will now show the "Form" as part of the name, since it may contain more details such as ER (Extended Release). This will display in the medications tab, any special fields used, and the eMar.




March 3, 2022
Visual updates
We have updated the look and feel of a couple more places in BestNotes! The "Default Password Groups" has been updated to match the new look and feel, and to list the permissions in the same manner as the User Permissions in the Edit User screen. The "Password Settings" has been updated to match the new look and feel, and will now also include a link to our Password Settings help page. When viewing "Tags" the "Edit Tag" window has also been updated to match the new look and feel.



March 11, 2022
Assessment update
Any assessments that are opened on a client for the first time as of today, will have the user that is logged in added as a signer to that document automatically. Additionally, if that user has a "Default Supervising Provider" set in their "User Details" on the "Provider Setup" tab, that user will be added to the document as a signer as well.


Consent forms update
The "Standard" and "Payer" consent forms will now include a "Select All" checkbox in the "Information to be released" section. Additionally, when a snapshot is saved, the "Select All" checkbox will not be visible.


March 15, 2022
Medications update
When creating a medication in BestNotes, the "As Needed" checkbox must be selected if the medication is to be set as a PRN in the eMar. Previously, if the "as needed" drop-down was selected, it was automatically selecting the "As Needed" checkbox, but the checkbox was not saved until the medication was edited and saved a second time. A tool-tip has been added to help remind you.


April 7, 2022
Appointment update
When you Check-In an appointment on a future date (tomorrow or after), you will receive a warning that asks, "This appointment is in the future, do you wish to continue with the Check-In?"

Consent Form update
We have updated the "Disclosure Format" options on our consent forms. You will now also have the option for "Telephonic" and "Verbal", and the "Other Electronic Format" has been changed to "Other Format".

April 8, 2022
Activity log update
When an appointment appears on the activity log, you will no longer have the ability to add a text note to the appointment, instead this will now show additional appointment details.

User Details update
When updating a user's Access Tags, you may notice a few minor updates. The hover text has been updated to provide additional clarity to the function of the Access Tags. The "Global" checkbox has been disabled, because this is a minimum requirement for any user. The "Check All" button has been moved to the top right corner without a label to reduce the temptation to select this box, as selecting this box is extremely restrictive to a user's access and should not be selected unless there is a specific need.

April 20, 2022
Report update
When viewing the "Log Frequency Report" that is located on the client's activity log, you will now see all of the assessments listed.


April 22, 2022
Q-Log update
We have updated the look and feel of the Q-Log creation window! There are now updated icons, and the color scheme has been updated to match the other areas that have been updated.

April 26, 2022
System Customization update
The "Religion" list has been updated to what is determined by the FHIR standard. In addition to that System Administrators will now have the ability to add custom religion options through the System Customization tool. For more information, visit Custom Religions.


May 3, 2022
Authorizations update
All current active Authorizations will now be shown at the top of the list, followed by expired, and then inactive.

May 18, 2022
Special field display update
If you use the special field "XLASTVITALS" you will notice the layout of the results has been updated. This will now have a vertical layout instead of a horizontal one. In addition to that we have addressed some formatting issues. To find out more about Special Fields, visit All Special Fields.

May 25, 2022
Diagnosis Widget update
When using the Diagnosis Widget, if you enter the "Code" before entering the "Category", the "Category" will now automatically populate when you select a code.

June 3, 2022
Calendar Export update
You now have the ability to generate a new "Calendar Export" URL if you feel that your iCal URL has been compromised. If you select the "Generate New URL" button next to the iCal URL, the original URL will no longer provide updates. Anyone that has the old URL will still see any appointments that have already been downloaded, but they will not receive any updates moving forward.

June 13, 2022
API updates
When using the "putContact" method for a client or regular contact, we will check to see if the following fields match exactly with another entry updated in the previous hour. If so, we will return an error letting you know "Duplicate record found, unable to create contact." If one of the phone fields is empty, you will no longer receive a validation error. If you are using the put/contactDatafield method, you will have the option to send us multi-select options for the new combo box. You can review our API Documentation for additional information.




Portal application update
When contacts are imported from a portal application, these contacts will now have the "Global" tag. Previously contacts would have either an "Inquiry" or "Current" tag.
June 22, 2022
DSM-5 TR Release
The DSM-5 TR code set has been added into BestNotes to replace the DSM-5 codes. You can refer to the DSM-5 TR manual for the specific changes. If you are currently using the DSM-5, this will only be available for use through June 30, 2022, and will be sunset on July 1, 2022. This will give you two weeks to begin using the new code set, and we recommend adoption immediately. The DSM-5 TR does not reference any of the ICD-9 codes, and as a result, this code set has been sunset. Moving forward, you can search for ICD-10 and DSM-5 TR codes.
API update
If you are using the API to view assessments and treatment plans, you will want to update the "getMedClinDefinition" method with the "getAsmtTxPlanDefinitions" method. The original "getMedClinDefinition" method will be removed as of July 1st 2022. The benefit to the new method, is that this has been updated to include the full list of assessments and treatment plan document definitions, where the old method only included our original 8 document types (HXPX, ITP, MTP, etc). You can review our API Documentation for additional information, or reach out to submit a support ticket if you have any questions.
June 23, 2022
In Progress tab
On the Calendar tab, there is a new "In Progress" tab between the "General Log" tab and the "For Review" tab. This tab will show all Notes, Templates, and Group Notes assigned to you (the logged in user) that are not "Locked" for the time period selected with the filter. The default filter is "7 days". The Notes and Templates can be accessed by selecting the date and time of the note or the client's name. The Group Notes will show the name of the group, not the group note title. Selecting the date and time of the Group Note will open the note to allow you to continue working on it. If you don't see the "In Progress" tab, you will need to log out and log back into BestNotes.




July 7, 2022
Census and Demographics report
We have added a new Standard report! This report will display information based on your Access Tags and the time frame selected. A daily census will be displayed if you select to view a specific month, or a monthly census if you select to view a quarter or a year. The graphs that will be shown are the "Daily or Monthly Census", "Program Census", "Top Diagnosis", "Birth Sex by Age", "Preferred Language", and the "Top Payers". To see specific information regarding the information included in the graphs, you can hover over the bars and pie pieces. Additionally, if you select the "Show Details" checkbox, a table will display below the graphs that will give you individualized information for each client. When you export this report, the data points will be placed in separate columns to allow you to more easily create pivot tables and summaries of the information.





July 18, 2022
Labs integration update
Earlier this year Halfpenny Technologies was acquired by Accumen Technology Solutions. They have now officially rebranded, and all of Halfpenny Technologies references throughout BestNotes will now be Accumen Technology Solutions. You are still receiving the same service through BestNotes, for more details regarding the transition, you can visit Accumen completes Halfpenny Technologies integration.
July 21, 2022
API updates
When utilizing the API, you will now have the ability to pull all the data points for a given contact and document type (e.g., IA, ASMT1, MTP, etc.). The information returned will include the "field Id", "value", "column X" and "column Y" numbers if that data point is part of a table. If you are subscribed to a BestNotes Profile, you will see which documents belong to that profile.


When using the API to pull in the email fields, there is now a validation in place. This has been updated to follow the same validation rules that apply when adding an email within the BestNotes application. If an email isn't valid, you will see an error message letting you know. You can see more details about the API methods available in the BestNotes API documentation.

API Credentials update
When creating a new set of API credentials, you will only see the "Private Key" once time. After this key has been saved, you will see the "Public Key" for identification purposes. Icons have been added to facilitate copying of the public and private keys. You can also only set the options to "Show Identifying PHI" and the "Permissions" of "Read", "Write" or "Read/Write" upon key generation. After the save, you will not have the ability to edit those options. You can see more details about the API methods available in the BestNotes API documentation.




July 26, 2022
API updates
When using the API, the getVitals method has been updated to display the vitals information in the same order that it appears on the BestNotes Vitals. We have also made an update so that you will only be able to use a particular API signature for 1 minute instead of 10 minutes. Best practice recommends that you should generate a new signature for each call made.
The API Get Related method has new field. This will now return the type, name, and/or company name for any related contacts. You can see more details about the API methods available in the BestNotes API documentation.


Register/Ledger report updates
We have made some improvements to our Register/Leger report. The "Fields to Display" area is now a scrolling window. The layout was adjusted on the "Filter Criteria" including moving the "Item/Code" next to the "Category" fields. The selection area at the top will collapse when results are returned to provide a cleaner display of the results. To adjust the criteria or displayed fields again, select the arrow in the top right corner. The icon and toolbars have also been updated to match the updated look and feel of BestNotes.



Manage user update
If you have the appropriate permissions to inactivate users, you will find that it is no longer required for there to be an email in order to inactivate a user. If you need to reactivate a user, an email address will be a required field.

Payers update
We have updated the way that the Payers window works. When searching for a payer's name, it will search across the whole name, rather than just the beginning letters. In addition, the only payers that will display on a search list are those that are active. If the client's current payer is inactive, that payer will be shown, but when searching to change the payer, only the active payers will be listed.

August 3, 2022
Academics update
When viewing the "Report Card" in Academics, you will now have an option to add comments.

August 4, 2022
Deleted contact update
When viewing a contact's chart, or if you have the contact listed in the search results, and that has been deleted by another user, you will receive an alert notifying you that the contact has been deleted. When you select "Ok" the screen will refresh and take you to the Contacts tab.


August 12, 2022
C-Appointment Status report updates
The C-Appointment status report has been updated to filter dates according to the logged in user's time zone. Previously this report would run based on BestNotes's server's time zone. Additionally, we updated the images in the "Conf.", "Paid", and "Log" columns to font icons to help the report load faster.


Client Test Results report update
Test groups have been added to the "Test" drop-down filter to allow you to filter for all tests included in a group. A new filter has also been added for "Result Value". This filter will show all non-numeric options.


BestNotes Utilization report update
The BestNotes Utilization report has been updated to include "ASAM Continuum Documents". This part of the report will check to see if you have the ASAM Continuum included in your Med/Clinical area. There is an extra charge for the ASAM feature, you can visit ASAM Continuum for more information.


C - Appointment Forecasting report update
This report has been updated to allow you to select multiple facilities.

August 17, 2022
DrFirst update
When accessing ePrescribe (DrFirst), certain fields are required in the client's chart. These fields include First Name, Last Name, Home Address, Phone, City, State, and Zip code. If any of these fields contain invalid characters, you will see a message on the DrFirst screen. This message will tell you which fields contain the invalid characters, and what the rules are for each field.

Appointment Reminders update
If you use appointment reminders, you now have an option to have the preferred name appear when the appointment reminder is sent out. If there is not preferred name, this will default to the patient's first name. This can be enabled by System Administrator users only, by navigating to "Settings", then "Appointment Reminders". In the section titled, "Options" you will select the checkbox for "Use patient's preferred name".


Special field update
If you are using the special fields "XLEVELSOFCARE_ACTIVE" or "XLEVELSOFCARE_NO_LOCATIONS_ACTIVE" any Programs (Levels of care) that have a future Date of Discharge (DOD) will now be included in these special fields.

August 29, 2022
Label update
In all areas of BestNotes, the label "Gender" has been updated to "Birth Sex" in accordance to FHIR standards.

September 15, 2022
API update
We have added a new method to our API. You can now use the getMedications method to pull medications for a specific client. To learn more about the getMedications method visit our BestNotes API.
September 23, 2022
Census and Demographics report update
When reviewing the Census and Demographics report, if a client had multiple payers, it showed the client multiple times and displayed the program text in details multiple times. This has been corrected along with a few other bug fixes. We have also added more information to the Report Criteria that can be found by selecting the red question mark.


November 10, 2022
Contact chart updates
The contact charts have been updated with new icons and color schemes. The "Register/Ledger" tab and the "Activity Log" will be updated in the near future!

November 16, 2022
Portal sharing update
To assist you with adhering to the Information Blocking legislation, we have made some improvements when sharing to the portal. To learn more about Information Blocking, you can visit Information Blocking and BestNotes. You can now restrict certain documents from being shared to the portal. This can be done by the System Administrator by following the instructions in the Portal document exceptions. In addition, you now have an option to send all of the available documents to the portal with one click! This button is currently only able to share documents to the patient directly and not related contacts. It will turn orange when the documents have been sent, until a new document has been added to the activity log that has not been shared. To learn more about sharing documents to the portal visit Share documents to the portal.


Portal display update
The contacts name preferred name that is set in the "Edit Contact" screen will be used on the portal. If there is no value in this field, it will default to the contact's first name.

eMAR update
We have updated the "RX#" to "Rx/Inventory ID", and added a "Date Filled", and a "Notes" field to the "Inventory" window. In addition, there will now be a "History" section that will appear after inventory has been added or updated for existing medications. When the inventory of a medication is added or updated, you will have the option to add a note for the reason for the update. As updates are made, the changes will be listed at the bottom including updates to the Pharmacy, Phone, Date Filled, Added, Expiration, and Notes. This will also display who made the update, and when the update took place. The "Expiring Meds: by Group" report has also been updated to include the "Filled" date and the "Refills" remaining.




November 29, 2022
Close app update
When closing the desktop application by selecting the "X" in the top right corner the app will now display an updated alert, and will close the application completely instead of just logging you out. The updated alert states, "Are you sure you want to log off and close BestNotes?" If you don't see this new message, you just need to log out and log back in for the update to apply.


December 1, 2022
New User Permission
We have added a new user permission titled, "Manage User Groups". This permission will allow users to create and manage User Groups in Settings. This permission was previously only available to users that were marked as "System Administrator."


Register/Ledger updates
We have updated the look and feel of the register in the contact's "Register" tab, the Activity Log register, and the Group Notes ledger area.



December 12, 2022
Contact photo updates
The empty photo view has been updated to improve visibility of the upload icon. The contact photo upload dialog box has also been updated to match the new look and feel of BestNotes. And when you have a photo uploaded, you can now select the photo to view it enlarged.



December 15, 2022
BestNotes notification email
When you or your clients receive email notifications from the BestNotes application, these will come from 'notification@bnemail.com'. You can whitelist the address to ensure it doesn't get sent to spam.
December 20, 2022
Consent form update
You will now have the ability to remove any signer that has not already signed the consent form. When the consent form is open, follow these steps:
- Select the trash can icon next to the name of the signer that you would like to remove.


- Then select "Update signers."
- The icon will still show that the entry is unsigned, but the activity log will no longer show that the signature is required.


December 28, 2022
API update
We have added a new method to our API. You can now use the getAllergies method to pull allergies for a specific client. To learn more about the getAllergies method visit our BestNotes API.
December 31, 2022
More updates
To see what our most recent updates are, visit What's New (2023).
Next Steps
- What's New (2023)
- BestNotes API
- Information Blocking and BestNotes
- Portal document exceptions
- Share documents to the portal
- ASAM Continuum
- BestNotes API documentation
- All Special Fields
- Custom Religions
- Accumen completes Halfpenny Technologies integration
- Custom Tests
- Test results
- What's New (2021)