File Uploads
Project Description
The New Mexico State Behavioral Health Services Division requires the ability to capture client registration, enrollment, notes, and services in BHSDSTAR for the CareLink program. This document describes the file specifications required to upload the client registration data from an external system to BHSDSTAR.
File Information
File Transfer Options
Files can be uploaded directly into the STAR web application.
File Format
All CareLink Interface Files are pipe-delimited, flat files containing one record per row. Field values may be surrounded by double quotes; however, double quotes are only required when including a pipe character in the data field. A header row is not required but may be included. If the header is included the header column names must match the values in the Name column provided below. Also, the data fields are required to be in the order specified below. Finally, the file name can be any valid Windows OS file name but must use the “txt” extension.
Error Handling
Errors for Invalid Records will be displayed in the Web Application on the Upload History tab. A drill-down on the errors is provided to see specific details. These errors include uploads performed through the web application. Providers are expected to review the upload history, correct any errors and re-upload the errored records.
Contact Information
Please send your question via email. Please remember that it is a HIPAA Violation to send a client’s personally identifiable information (PII) through email.
If your question does not contain any PII, please send an email to: support@fallingcolors.com
If your question is about a client and you do not know the individual's ID number, click on the Find tab, enter their name or part of their name and click search. Use the ID number when communicating a question about a client. (Example of a Client ID: C001000000012345)
Data File
1.1
Field | Name | Description | Required | Validation |
1 | Program | Name of the program the data is being uploaded to. | Yes | The value must be CareLink |
2 | NPI | The NPI of the vendor that provided the services. | Yes | Must match NPI of vendor already registered in Star. |
3 | ProviderSite | The name of the site uploading documents | No |
|
4 | FirstName | The first name of the client | Yes |
|
5 | MI | The middle initial of the client | No |
|
6 | LastName | The last name of the client | Yes |
|
7 | DOB | The date of birth of the client | Yes | Must be a valid formatted as “yyyy/mm/dd” |
8 | SSN | The Social Security Number of the client | Yes | Can either be nine consecutive numbers or include the “-“ character |
9 | MedicaidRecipient | Is this client a Medicaid Recipient or not? | Yes | A single character either “Y” or “N” |
10 | MedicaidID | The Medicaid identification number of the client | Yes |
|
11 | MCO |
| Yes | Must be one of the following values:
|
12 | MCOID | A unique identifier of the MCO. | No |
|
13 | MRN | The MRN of the client at the provider is specified by the NPI. | Yes | Must match MRN of the client already registered in Star for vendor identified by NPI. |
14 | Street | The street address of the client | No |
|
15 | City | The city the client lives in | No |
|
16 | State | The State the client lives in | No | Provide either the valid two-digit State abbreviation or the fully spelled out name. |
17 | Zip | The zip code the client lives in | No | Provide either the five-digit zip code or the 5+4 code. |
18 | Phone | The primary phone number of the client | No |
|
19 | Message | Can a message be left at this phone number | No | A single character either “Y” or “N” |
20 | Ethnicity | The ethnicity of the client | No | If included, must be one of the following values:
|
21 | Race | The race of the client | No | If included, must be one of the following values:
|
22 | Gender | The gender of the client | Yes | A single character: “M”, “F”, or “O” |
23 | Pregnant | Is the client pregnant? | No | A single character either “Y” or “N” |
24 | Language | The primary language of the client | No | If included, must be one of the following values:
|
25 | OtherLanguage | The secondary language of the client | No | Freeform text – maximum of 20 characters. |
26 | Veteran | Is the client a veteran | No | A single character either “Y” or “N” |
27 | ActiveMilitary | Is the client active in the military | No | A single character either “Y” or “N” |
28 | LivingCondition | Is the client currently homeless | No | A single character either “Y” or “N” |
29 | CCL | The Care Coordination Level of the client | Yes | Must be one of the following values:
|