Submitting JOLTS Services

Submitting JOLTS Services

The Oklahoma Office of Juvenile Affairs requires that information about services performed by contracted organizations be submitted on a monthly basis and ChartCaddy is capable of submitting that service information to the JOLTS website. The general process is ChartCaddy users enter their work normally as chart items, an administrator approves and finalizes those chart items normally, and then sometime during the month an administrator enters their JOLTS username and password in a particular spot in ChartCaddy. At that point the information on all services performed for the previous month is submitted to JOLTS automatically. While the time frame defaults to the previous month any date range can be designated. The JOLTS username and password are not retained by ChartCaddy.

All clients, users, and services have to be set up correctly in both ChartCaddy and JOLTS for all services to be submitted. Since that can be challenging, especially the first time the process is run, the process results in a detailed report about what happened. Specifically any services that failed to be submitted and the reason why is noted. Therefore the intention is that the process be run repeatedly for a particular month until all issues have been resolved. In order for service information to be submitted the following conditions must be met:

  1. The service provider must be an active user in JOLTS.
  2. The client must be set up with the proper program(s) and services in JOLTS.
  3. The JOLTS user must be linked in ChartCaddy.
  4. The JOLTS client must be linked in ChartCaddy.
  5. The ChartItem must be in Final status in ChartCaddy.
  6. The duration of the item must be at least 15 minutes in ChartCaddy.
  7. The ChartItem must be potentially billable in ChartCaddy. In other words some ChartCaddy services such as For Information Only notes are never billable and are therefore ignored by the JOLTS submission process.

The process errs on the side of caution so while there is little danger of the process running amok, there is a serious danger of submitting the wrong data if the clients and users links are not set up correctly in ChartCaddy. Therefore it is very important to enter the right JOLTS ID numbers for clients and users in ChartCaddy. There is also the danger of services not being submitted at all, so it is also important to pay attention to the report that is generated after running the process.

NOTE: ChartCaddy only adds services to JOLTS that don't already exist. This is normally good enough except care must be taken when deleting or "significantly" updating services in ChartCaddy after they have been submitted to JOLTS. In other words, any changes to historical services in ChartCaddy need to be replicated manually in JOLTS. For this reason most organizations have a deadline where providers are expected to have documented services by, and only after that deadline are services submitted to JOLTS. That way it is easier to keep track of which services, if any, need to be manually updated in JOLTS.

Setup

The first thing you should do is correctly set up any users and clients in JOLTS that you want to submit service information for. You will need a JOLTS client ID for each client as well as the JOLTS active user ID for each user. You can find a list of active user ID numbers in JOLTS under Reports -> Youth Service -> Active User List.

The next step is to link ChartCaddy users to JOLTS users by pulling up the user in ChartCaddy under Settings -> Users -> Search -> <user>, scrolling down to the User Credentials section, and updating the “Bill Legacy” field for any credential. The format should be JOLTS:XXXX; with XXXX being the JOLTS active user ID. The process will ignore anything after the semicolon and only one credential needs to be updated.

The final step is to link ChartCaddy clients to JOLTS users by pulling up the client under Clients -> Search -> <client>, scrolling down to the Client Payers section, and adding a line for any JOLTS payer. The JOLTS client ID goes in the Client ID field. JOLTS does not have to be the primary payer source (or even be active) for a client, it just needs to be listed.

Running The Process

To run the process go to Settings → Organization in ChartCaddy and enter your JOLTS username and password in the JOLTS User and JOLTS Pass fields respectively. The process defaults to the previous month and a high level of log detail, which can be changed if desired. Then click the “Process JOLTS” button and a progress indicator will appear at the top of the screen. When the process is complete there will be an option to download the report. Somebody still needs to log into JOLTS and “approve” the services that have been submitted.

Report Details

The report consists of a short summary at the top and then exceptions grouped in categories below that. If all potential services are submitted successfully to JOLTS then only the summary section is printed. The summary section consists of:
  1. Start Date – First date of services to be submitted, so the start date is “inclusive”.
  2. Stop Date – First date of services not to be submitted, so the stop date is “exclusive”.
  3. JOLTS User – Username used to access JOLTS.
  4. Processed – Number of services attempted to be submitted.
  5. Previously Added – Number of services that have already been submitted.
  6. Newly Added – Number of services submitted on this process run.
  7. Unmapped Services – Number of failed submits due to ChartCaddy service map issue.
  8. Unmapped Users – Number of failed submits due to ChartCaddy user map issue.
  9. Unmapped Clients – Number of failed submits due to ChartCaddy client map issue.

Potential exception categories are:
  1. Unmatched JOLTS Clients – The client has a JOLTS ID in ChartCaddy, but the client could not be found in JOLTS. Verify that these clients exist on JOLTS and that their JOLTS IDs are correct in ChartCaddy.
  2. Unmatched JOLTS Program For Clients – The client has a JOLTS ID in ChartCaddy and exist in JOLTS, but do not appear to have any active programs in JOLTS. Verify that these clients has appropriate programs set up in JOLTS.
  3. Unmatched JOLTS Services - The client has a JOLTS ID in ChartCaddy, exist in JOLTS, and has at least one program set up in JOLTS, but the correct service was not found. Verify that the indicated services is available in JOLTS for these clients.
  4. Unknown JOLTS Error – This error should be extremely rare, but if it does occur please contact customer support with the details about this error.
  5. Short Duration Items – The duration for these items are less than 15 minutes.
  6. Unmapped Services – ChartCaddy was unable to determine the correct JOLTS service. Please concact customer support with the details about this error, preferably with suggestions as to which JOLTS service it should be mapped to.
  7. Unmapped Users – The user has not been linked to JOLTS in ChartCaddy.
  8. Unmapped Clients – The client has not been linked to JOLTS in ChartCaddy.