Ankota Help Center
Home | Contact Us

Contact Us

HHAeXchange Data Delivery & Visit Management

Overview

Per state requirements, Ankota directly feeds required data to HHAX, a data aggregator serving numerous states, based on complex technical specs. This data becomes part of a library of data made available to the state for internal monitoring. (The content and format of this data is determined by the state in accordance with federal law.)

After reviewing the data, HHAX sends Ankota responses confirming the acceptance or rejection of those visits. If the visits are rejected, HHAX will usually provide a brief explanation as to why. Ankota logs those responses in your Visit Approval Dashboard for your review. Rejections are also highlighted on the Ankota Landing Dashboard.

HHAX always requires caregiver profiles to be accepted before visits will be accepted.

Billing is sometimes completed through HHAX, and sometimes through 837s, depending on the state and payer.

See below for more information on data delivery, responses, and corrections.


The critical workflow to understand is:


INDEX

Data Preparation

The Approval Assistant

Individual Visit Review

Data Lifecycle

Data Management Best Practices

Data Responses & Rejections

Integrated Responses

Rejections

Corrections

Other

Essential Transportation / Essential Errand / Shopping


Data Preparation

Data preparation typically covers the following:

To speed up this process, Ankota usually recommends using the Approval Assistant in the Visit Approval Dashboard to rapidly identify missing data, missing codes, and duration issues prior to approval. Any remaining unapproved visits can be individually reviewed, and then data is delivered.

The Approval Assistant

The Approval Assistant is used for mass review of Needs Action visits. It has four key sections:


The Approval Assistant resolves the majority of all issues that require attention or changes in order to be accepted by HHAX. The most complex step is typically coding. Coding requires the admin to recognize the errors that occurred and apply a code to reflect the error, which will result in the state accepting the visit. Most errors which would cause a rejection can be prevented with a code. The most common codes will automatically be suggested by the Approval Assistant. Missed coding is the most common reason for visit rejection, so it is always beneficial to use the Approval Assistant.


For more on the Approval Assistant, or to watch one of our Ankota Approval Assistant seminars, click here


A screenshot of a computer screen Description automatically generated

Individual Visit Review

After completing a review of Needs Action visits with the Approval Assistance, wait a few minutes before refreshing your Visit Approval Dashboard to pull up all remaining Needs Action visits. There should be significantly fewer visits remaining. 

Next, walk through each visit individually by clicking the paper-and-pencil "Edit" icon () and reviewing the red warnings which could not be resolved by the Approval Assistant. Typically these are unusual warnings. Resolve them, make other adjustments as needed (see additional notes below), then approve the visit, and your visit will be exported.

Regarding other visit adjustments, those will vary based on the visit. Actions may include:


Data Lifecycle

The Ankota/HHAX data life cycle is initiated by visits passing screening or being approved in Ankota. Appropriate, state-required visits are then sent to HHAX, who reviews them and sends feedback to Ankota. Any rejected visits are then reviewed by the Ankota user in the Visit Approval Dashboard, corrected, and re-sent to HHAX. (Rejected visits are much rarer when customers use the Approval Assistant on Needs Action visits.)



Data Management Best Practices

Prepare Appropriately


Use your Dashboards


Use the Approval Assistant Wisely


Data Responses & Rejections

Integrated Responses

Aggregator responses (rejections and acceptances) are automatically integrated into your Ankota Visit Approval Dashboard. Depending on the size of your data delivery and the timing of your export, you could see responses anywhere from a few hours later to a day later.


The exported data statuses will be shown as the data progresses:


Your main concern will be to check for rejections, view the errors, make corrections, and export them. You can filter your Visit Approval Dashboard by Date and Export Status to view your rejected response files (make sure your Ankota Visit Status is in Status: All):


The errors will show specifically in the visit details under Status, as in the screenshot below.


Rejections

Rejection Reasons

Visits can be rejected for a number of reasons, but typically it is one of the following:


The errors will show specifically in the visit details under Status, as in the screenshot below. You can make corrections as needed and re-export. 

For more guidance on rejection reasons and how to proceed, see the Corrections section below.


Corrections

Once you know the error (visible in the visit's rejection details), you will correct the errors as needed and then re-export the visit(s). This may involve adjusting reason codes in the Visit Approval Dashboard before re-exporting a single visit, or completely backing out billing and payroll in order to correct a fundamentally wrong visit (with wrong visit dates, time, visit type, client, or caregiver) before re-exporting the visit. 


Some common errors and the actions to take are outlined below.


ErrorMeaningWhat to Do

Invalid Edit Visit Reason Code value

The reason code was wrong or missing.Update the reason code and re-send via single visit export.
Invalid Edit Visit Action Code valueThe action code was wrong or missing.Update the action code and re-send via single visit export.
Length of the External Visit ID cannot exceed 30 charactersThe visit ID was too long.This should not occur, but very old (pre-2022) visits sent retroactively may have been sent with too long an ID. They can be re-sent with a shorter ID.
101999: Can occur if there is an interruption in serviceThere was an error in data delivery.Re-send the visit with a new visit ID.
Schedule Date should be the visit day or the next day of the visit (inclusive of EVV)This visit was completed on a day it was not scheduled to be completed.Reach out to Ankota Support for best practice based on the specific case.
Schedule duration is 0There was no scheduled duration because the visit was caregiver-scheduled and the visit type does not have a default length.Request Support set a defaulted scheduled duration for this visit type (suggested: 1 hour).
EmployeeZip length is less than 5The zip code of the employee's address was not entered correctlyCorrect the employee's address, then send the employee's data again.
Missing EmployeeSSNThe employee's SSN was not entered.Correct the employee's SSN, then send the employee's data again.
unable to export, Employee not sentThe employee's file was not successfully sent.Review and if needed correct the employee's file, then send the employee's data again.
EmployeeId missing; EmployeeId is emptyThe employee's ID was not entered.Correct the employee's ID and code, then export the employee's data again.
Member is not found based on Qualifier valueThe client's Medicaid ID may be misentered or missing.Check the Medicaid ID. If it is entered incorrectly, correct it. If it correct, reach out to the state.


If you receive a rejection reason not on this list, please reach out to Support for more information.


Other

Essential Transportation / Essential Errand / Shopping

For transport care plan items, Ankota users have the option to turn on an Ankota warning, "Visit with Essential Transportation or Errands at Arrival or Departure not at Client Location." Please note this feature requires configuration and is typically used only with Missouri HHAX visits. Generally, you will want to filter for visits with the Errands warning and manage them BEFORE using the Approval Assistant. This is the only exception to the general "Use the Approval Assistant first" guideline.


This warning works as follows:


After the visit is flagged in Ankota, users will be able to quickly use the Approval Assistant to code the visit appropriately so that visits outside the visit location can be reason coded and exported.


Alternately, users can filter for the warning and then review the visits individually for coding and approval.