Search all docs
Provider Workflows
Chart Notes
Auto-apply KX Modifier
Getting Started with Chart Notes
AI Appt. Summaries
Chart Note Clinical Types
Download Chart Notes as PDFs
Goals on the chart note
How to add Measurements
Import Previous Medical History
Navigating Flowsheets
Navigating Inbox Workflows
Navigating the Chart Note
Set up Custom Chart Note Templates
Setting up Co-signers on Your Note
Sign a Chart Note
Text Snippets For Your Note
Chart Note Features Not Supported
Chart Notes
Claim Details
Claim Details
Front Office Workflows
Appointments
The Insights Appointments Page
Adding Prior Auth and Alerting
Alternate Methods for Scheduling
How to Add a Walk-In Patient
How to Run an Eligibility Check
How to Schedule an Appointment
How to Take Payments
Sending out reminders and forms
Understanding Appointment Details
Updating Appointment Statuses
Appt. Features not supported
Appointments
Daily Operations
Daily Operations
Patient Communications
General Patient Flows Features
Text Blast Page
Insurance Intake Page
Functional Outcome Measurements
Getting Started with Patient Portal
Complete Intake Forms
Navigating Patient Workflows
Manage Patient Appointments
Manage Payments through Patient Portal
Patient Intake Automation
Update Insurance Info
View Home Exercise Programs
Patient Communications
Patient Responsibility
Charge Saved Credit Cards
Manage Credit Cards
Setting up a Payment Plan
How to Cancel PR
How to Send a Patient Payment Link
How to Push to PR
How to Record Payments
How to Refund a Payment
How to Request via Text or Email
How to Set Up Miscellaneous Line Item Charges
How to Take Payment for Families
How to Undo a Write Off
How to Write Off PR
Patient Responsibility Page
PR Overpayment Refunds and Estimated vs. Remittance PR
PR Settings
PR Timeline
Patient Responsibility
Billing Workflows
Front Office Payments
Front Office Payments
Reports
A/R Reports
Building and Running Reports
Claim Adjustments Report
Collections Report
Custom Collections Report
Detailed Charges Report
Export Claim Details
Generate a Transaction Report
Patient Balances Report
Patient Charges Report
Patient Claims One-pagers
Patient Collections Report
Patient Eligibility Report
Posting Log Report
Site Transaction Report
Site Transaction Report Summary
Submitted Claims Report
Upcoming Patient Statements Report
Reports
Owners & Administration
Last updated:
Aug 21, 2025
Understand Import Errors
Action Items
Front Office Workflows
Overview
Although the Athelas encounter import system operates at about 99% effectiveness, occasionally we’ll still encounter issues translating data from your EHR into Athelas claim format.
Generally this happens when a patient or encounter is missing key details, or an entity from your EHR is missing from the Athelas backend systems. Here’s a few of examples:
A new provider has been added in your EHR but but they haven’t been added to the list of approved providers in Athelas yet.
A patient is missing their insurance member ID.
An encounter is using a custom CPT code that isn’t recognized by Athelas.
A patient appears to be a duplicate of another existing patient, and Athelas is temporarily pausing the import to allow time for investigation.
When these issues arise, members of the Athelas Ops team investigate and attempt to solve them for you. However, a subset of import errors will inevitably require action from your team to fix, and for those errors we have the Import Errors page.

This dashboard gives you a list of unsolved import issues prioritized by total value and number of affected claims. If you see an error here it means that Athelas needs your assistance to resolve the issue and get these claims imported/submitted.
Below, we’ll walk you through how to use this dashboard in partnership with Athelas to reduce the number of outstanding import errors to zero
.
Best Practices
1. Aim to review Import Errors on a weekly basis. Many errors can be fixed with a quick update to the EHR, and the sooner these updates are made the sooner claims can go out to the payer.
2. Whenever your practice adds a new provider or facility, check in with your Athelas representative. We need to add this entity to our systems before we can submit claims for them, and until then these imports will not succeed.
3. The single most common error type is a single missing field like an ICD10 code or a missing policy id. In these cases you can update the encounter in your EHR and the corrected data should flow into Athelas as part of the next overnight import.
4. Athelas has the ability to create ‘Import Rules’ to transform the data taken from your EHR as its imported. If you see an error where Athelas needs to interpret what’s in your EHR differently (e.g. patients with no member ID are Self-Pay) then ask your Athelas representative to help you create an import rule to solve this.
Feature Walkthrough
1. List of Import Errors
To dig into your Import Errors, scroll down the page until you find a table that looks like the image below:

This table contains groups of errors, categorized by type. That means for example that every current instance of the issue ‘Invalid place of service code’ will be bundled together for review.
Click any error type to expand it and inspect the individual errors. This will give you the detail necessary to look up the patient/encounter in your EHR to make repairs.
2. Import Error Details View
Once you’ve found a particular import error you want to examine, click in and you’ll find the full details of what Athelas was able to extract from your EHR.

Here you can spot check for any data that may be missing or problematic. For example: in the image above, the encounter has no ICD10 codes, and these are required in order to create a claim in Athelas. In this case, the CPT code PEPTD
is also a custom code used by the practice to indicate a particular self-pay service.
Knowing this, the practice contacted their account manager who created an import rule that treats these claims as Self Pay and adds the appropriate ICD10 code automatically, solving the issue not only for this encounter but for all future encounters as well.
3. Grouping, Segmenting, and Filtering
Sometimes you’ll be on the hunt for a particular error or error type, and when that’s the case you’ll want to make use of this dashboard’s filtering and grouping mechanisms. By default, errors are grouped by error message (aka error type), but you can change the grouping to Patient ID, Patient Name, or Date of Service using the dropdown provided.

You also have the option to segment claims by month of service and narrow the list of errors using a variety of filters using the controls at the top of the dashboard.

4. Correcting import errors on Insights
You can use the encounter creation flow to correct import errors, and create encounters on insights.

To use this feature, click into an error message group, and find the import error you want to correct. Then, click the blue “Import” button. This will open the encounter creation flow in the Encounter Details page, populate it with the imported data, and notify you of any errors found in the imported data.

Click through the flow and modify the imported encounters data. Once you’re done, click the “Create” button. Athelas will attempt to create your encounter and notify you in case of persistent errors.
In Conclusion
When occasional issues arise bringing encounters from your EHR into Athelas, the Import Errors tab will be your guide to getting things patched up. A weekly check into this interface will help you and the Athelas team make sure we’re capturing 100% of eligible encounters for submission.
Table of Contents
Search all docs
Provider Workflows
Chart Notes
Auto-apply KX Modifier
Getting Started with Chart Notes
AI Appt. Summaries
Chart Note Clinical Types
Download Chart Notes as PDFs
Goals on the chart note
How to add Measurements
Import Previous Medical History
Navigating Flowsheets
Navigating Inbox Workflows
Navigating the Chart Note
Set up Custom Chart Note Templates
Setting up Co-signers on Your Note
Sign a Chart Note
Text Snippets For Your Note
Chart Note Features Not Supported
Chart Notes
Claim Details
Claim Details
Front Office Workflows
Appointments
The Insights Appointments Page
Adding Prior Auth and Alerting
Alternate Methods for Scheduling
How to Add a Walk-In Patient
How to Run an Eligibility Check
How to Schedule an Appointment
How to Take Payments
Sending out reminders and forms
Understanding Appointment Details
Updating Appointment Statuses
Appt. Features not supported
Appointments
Daily Operations
Daily Operations
Patient Communications
General Patient Flows Features
Text Blast Page
Insurance Intake Page
Functional Outcome Measurements
Getting Started with Patient Portal
Complete Intake Forms
Navigating Patient Workflows
Manage Patient Appointments
Manage Payments through Patient Portal
Patient Intake Automation
Update Insurance Info
View Home Exercise Programs
Patient Communications
Patient Responsibility
Charge Saved Credit Cards
Manage Credit Cards
Setting up a Payment Plan
How to Cancel PR
How to Send a Patient Payment Link
How to Push to PR
How to Record Payments
How to Refund a Payment
How to Request via Text or Email
How to Set Up Miscellaneous Line Item Charges
How to Take Payment for Families
How to Undo a Write Off
How to Write Off PR
Patient Responsibility Page
PR Overpayment Refunds and Estimated vs. Remittance PR
PR Settings
PR Timeline
Patient Responsibility
Billing Workflows
Front Office Payments
Front Office Payments
Reports
A/R Reports
Building and Running Reports
Claim Adjustments Report
Collections Report
Custom Collections Report
Detailed Charges Report
Export Claim Details
Generate a Transaction Report
Patient Balances Report
Patient Charges Report
Patient Claims One-pagers
Patient Collections Report
Patient Eligibility Report
Posting Log Report
Site Transaction Report
Site Transaction Report Summary
Submitted Claims Report
Upcoming Patient Statements Report
Reports
Owners & Administration
Search all docs
Provider Workflows
Chart Notes
Auto-apply KX Modifier
Getting Started with Chart Notes
AI Appt. Summaries
Chart Note Clinical Types
Download Chart Notes as PDFs
Goals on the chart note
How to add Measurements
Import Previous Medical History
Navigating Flowsheets
Navigating Inbox Workflows
Navigating the Chart Note
Set up Custom Chart Note Templates
Setting up Co-signers on Your Note
Sign a Chart Note
Text Snippets For Your Note
Chart Note Features Not Supported
Chart Notes
Claim Details
Claim Details
Front Office Workflows
Appointments
The Insights Appointments Page
Adding Prior Auth and Alerting
Alternate Methods for Scheduling
How to Add a Walk-In Patient
How to Run an Eligibility Check
How to Schedule an Appointment
How to Take Payments
Sending out reminders and forms
Understanding Appointment Details
Updating Appointment Statuses
Appt. Features not supported
Appointments
Daily Operations
Daily Operations
Patient Communications
General Patient Flows Features
Text Blast Page
Insurance Intake Page
Functional Outcome Measurements
Getting Started with Patient Portal
Complete Intake Forms
Navigating Patient Workflows
Manage Patient Appointments
Manage Payments through Patient Portal
Patient Intake Automation
Update Insurance Info
View Home Exercise Programs
Patient Communications
Patient Responsibility
Charge Saved Credit Cards
Manage Credit Cards
Setting up a Payment Plan
How to Cancel PR
How to Send a Patient Payment Link
How to Push to PR
How to Record Payments
How to Refund a Payment
How to Request via Text or Email
How to Set Up Miscellaneous Line Item Charges
How to Take Payment for Families
How to Undo a Write Off
How to Write Off PR
Patient Responsibility Page
PR Overpayment Refunds and Estimated vs. Remittance PR
PR Settings
PR Timeline
Patient Responsibility
Billing Workflows
Front Office Payments
Front Office Payments
Reports
A/R Reports
Building and Running Reports
Claim Adjustments Report
Collections Report
Custom Collections Report
Detailed Charges Report
Export Claim Details
Generate a Transaction Report
Patient Balances Report
Patient Charges Report
Patient Claims One-pagers
Patient Collections Report
Patient Eligibility Report
Posting Log Report
Site Transaction Report
Site Transaction Report Summary
Submitted Claims Report
Upcoming Patient Statements Report
Reports
Owners & Administration
Last updated:
Aug 21, 2025
Understand Import Errors
Action Items
Front Office Workflows
Overview
Although the Athelas encounter import system operates at about 99% effectiveness, occasionally we’ll still encounter issues translating data from your EHR into Athelas claim format.
Generally this happens when a patient or encounter is missing key details, or an entity from your EHR is missing from the Athelas backend systems. Here’s a few of examples:
A new provider has been added in your EHR but but they haven’t been added to the list of approved providers in Athelas yet.
A patient is missing their insurance member ID.
An encounter is using a custom CPT code that isn’t recognized by Athelas.
A patient appears to be a duplicate of another existing patient, and Athelas is temporarily pausing the import to allow time for investigation.
When these issues arise, members of the Athelas Ops team investigate and attempt to solve them for you. However, a subset of import errors will inevitably require action from your team to fix, and for those errors we have the Import Errors page.

This dashboard gives you a list of unsolved import issues prioritized by total value and number of affected claims. If you see an error here it means that Athelas needs your assistance to resolve the issue and get these claims imported/submitted.
Below, we’ll walk you through how to use this dashboard in partnership with Athelas to reduce the number of outstanding import errors to zero
.
Best Practices
1. Aim to review Import Errors on a weekly basis. Many errors can be fixed with a quick update to the EHR, and the sooner these updates are made the sooner claims can go out to the payer.
2. Whenever your practice adds a new provider or facility, check in with your Athelas representative. We need to add this entity to our systems before we can submit claims for them, and until then these imports will not succeed.
3. The single most common error type is a single missing field like an ICD10 code or a missing policy id. In these cases you can update the encounter in your EHR and the corrected data should flow into Athelas as part of the next overnight import.
4. Athelas has the ability to create ‘Import Rules’ to transform the data taken from your EHR as its imported. If you see an error where Athelas needs to interpret what’s in your EHR differently (e.g. patients with no member ID are Self-Pay) then ask your Athelas representative to help you create an import rule to solve this.
Feature Walkthrough
1. List of Import Errors
To dig into your Import Errors, scroll down the page until you find a table that looks like the image below:

This table contains groups of errors, categorized by type. That means for example that every current instance of the issue ‘Invalid place of service code’ will be bundled together for review.
Click any error type to expand it and inspect the individual errors. This will give you the detail necessary to look up the patient/encounter in your EHR to make repairs.
2. Import Error Details View
Once you’ve found a particular import error you want to examine, click in and you’ll find the full details of what Athelas was able to extract from your EHR.

Here you can spot check for any data that may be missing or problematic. For example: in the image above, the encounter has no ICD10 codes, and these are required in order to create a claim in Athelas. In this case, the CPT code PEPTD
is also a custom code used by the practice to indicate a particular self-pay service.
Knowing this, the practice contacted their account manager who created an import rule that treats these claims as Self Pay and adds the appropriate ICD10 code automatically, solving the issue not only for this encounter but for all future encounters as well.
3. Grouping, Segmenting, and Filtering
Sometimes you’ll be on the hunt for a particular error or error type, and when that’s the case you’ll want to make use of this dashboard’s filtering and grouping mechanisms. By default, errors are grouped by error message (aka error type), but you can change the grouping to Patient ID, Patient Name, or Date of Service using the dropdown provided.

You also have the option to segment claims by month of service and narrow the list of errors using a variety of filters using the controls at the top of the dashboard.

4. Correcting import errors on Insights
You can use the encounter creation flow to correct import errors, and create encounters on insights.

To use this feature, click into an error message group, and find the import error you want to correct. Then, click the blue “Import” button. This will open the encounter creation flow in the Encounter Details page, populate it with the imported data, and notify you of any errors found in the imported data.

Click through the flow and modify the imported encounters data. Once you’re done, click the “Create” button. Athelas will attempt to create your encounter and notify you in case of persistent errors.
In Conclusion
When occasional issues arise bringing encounters from your EHR into Athelas, the Import Errors tab will be your guide to getting things patched up. A weekly check into this interface will help you and the Athelas team make sure we’re capturing 100% of eligible encounters for submission.
Last updated:
Aug 21, 2025
Understand Import Errors
Action Items
Front Office Workflows
Overview
Although the Athelas encounter import system operates at about 99% effectiveness, occasionally we’ll still encounter issues translating data from your EHR into Athelas claim format.
Generally this happens when a patient or encounter is missing key details, or an entity from your EHR is missing from the Athelas backend systems. Here’s a few of examples:
A new provider has been added in your EHR but but they haven’t been added to the list of approved providers in Athelas yet.
A patient is missing their insurance member ID.
An encounter is using a custom CPT code that isn’t recognized by Athelas.
A patient appears to be a duplicate of another existing patient, and Athelas is temporarily pausing the import to allow time for investigation.
When these issues arise, members of the Athelas Ops team investigate and attempt to solve them for you. However, a subset of import errors will inevitably require action from your team to fix, and for those errors we have the Import Errors page.

This dashboard gives you a list of unsolved import issues prioritized by total value and number of affected claims. If you see an error here it means that Athelas needs your assistance to resolve the issue and get these claims imported/submitted.
Below, we’ll walk you through how to use this dashboard in partnership with Athelas to reduce the number of outstanding import errors to zero
.
Best Practices
1. Aim to review Import Errors on a weekly basis. Many errors can be fixed with a quick update to the EHR, and the sooner these updates are made the sooner claims can go out to the payer.
2. Whenever your practice adds a new provider or facility, check in with your Athelas representative. We need to add this entity to our systems before we can submit claims for them, and until then these imports will not succeed.
3. The single most common error type is a single missing field like an ICD10 code or a missing policy id. In these cases you can update the encounter in your EHR and the corrected data should flow into Athelas as part of the next overnight import.
4. Athelas has the ability to create ‘Import Rules’ to transform the data taken from your EHR as its imported. If you see an error where Athelas needs to interpret what’s in your EHR differently (e.g. patients with no member ID are Self-Pay) then ask your Athelas representative to help you create an import rule to solve this.
Feature Walkthrough
1. List of Import Errors
To dig into your Import Errors, scroll down the page until you find a table that looks like the image below:

This table contains groups of errors, categorized by type. That means for example that every current instance of the issue ‘Invalid place of service code’ will be bundled together for review.
Click any error type to expand it and inspect the individual errors. This will give you the detail necessary to look up the patient/encounter in your EHR to make repairs.
2. Import Error Details View
Once you’ve found a particular import error you want to examine, click in and you’ll find the full details of what Athelas was able to extract from your EHR.

Here you can spot check for any data that may be missing or problematic. For example: in the image above, the encounter has no ICD10 codes, and these are required in order to create a claim in Athelas. In this case, the CPT code PEPTD
is also a custom code used by the practice to indicate a particular self-pay service.
Knowing this, the practice contacted their account manager who created an import rule that treats these claims as Self Pay and adds the appropriate ICD10 code automatically, solving the issue not only for this encounter but for all future encounters as well.
3. Grouping, Segmenting, and Filtering
Sometimes you’ll be on the hunt for a particular error or error type, and when that’s the case you’ll want to make use of this dashboard’s filtering and grouping mechanisms. By default, errors are grouped by error message (aka error type), but you can change the grouping to Patient ID, Patient Name, or Date of Service using the dropdown provided.

You also have the option to segment claims by month of service and narrow the list of errors using a variety of filters using the controls at the top of the dashboard.

4. Correcting import errors on Insights
You can use the encounter creation flow to correct import errors, and create encounters on insights.

To use this feature, click into an error message group, and find the import error you want to correct. Then, click the blue “Import” button. This will open the encounter creation flow in the Encounter Details page, populate it with the imported data, and notify you of any errors found in the imported data.

Click through the flow and modify the imported encounters data. Once you’re done, click the “Create” button. Athelas will attempt to create your encounter and notify you in case of persistent errors.
In Conclusion
When occasional issues arise bringing encounters from your EHR into Athelas, the Import Errors tab will be your guide to getting things patched up. A weekly check into this interface will help you and the Athelas team make sure we’re capturing 100% of eligible encounters for submission.