Summary:
This article explains how to create and upload an Individual File in the ProviderTrust application, including required and optional data fields, formatting rules, and error prevention tips. Our accepted file format is .csv UTF-8 format or .psv. A file template is provided at the bottom of this article, and support is available for additional assistance.
Overview
The Individual File is the method to add or update individual-level data within your ProviderTrust system. This article provides detailed guidance on how to prepare and format the file correctly to ensure successful upload and processing.
File Format Requirements
| Specification | Details |
|---|---|
| Accepted File Types |
.csv (UTF-8 encoded) or .psv
|
| Header Row (Row 1) | Must remain unchanged. Do not edit or rename any column headers. Modifying this row may result in file errors. |
| File Naming Convention | Use your company name and date (e.g., Test Client - Individual File - 04 29 2020.csv) |
| Template Requirements | A downloadable file template is available at the bottom of this article. Remove the example data in Row 2 before uploading. |
| Multiple Records | Multiple rows may share the same External ID, indicating multiple addresses or attributes for a single individual. This approach allows for the inclusion of multiple addresses or other related information for a single entity. |
| Removal of Individuals | To remove an individual, enter a termination date in the End Date column or contact your Implementation Manager to enable the auto-termination feature. For more information regarding our best practices, refer to ProviderTrust Best Practices for Ending Monitoring. |
Uploading Your File
Once your file is complete and validated, upload it securely to ProviderTrust via SFTP.
For detailed upload instructions, refer to How To: Upload Data to SFTP
If you have any questions about the files, please contact our Client Care team at support@providertrust.com or 615-938-7878 ext 1.
File Specifications
| Column Header | Description |
| External ID |
Required - Determined during the Implementation process The External ID is a variable character field and can include letters, numbers, and special characters. It must be unique across your entire organization. This is the key identifier to add, update, or remove a subject. There is a 255-character limit.
UI Visibility: Yes Included in Reports: Yes |
| Type |
Required Specifies record type; must be Exact Value = "Individual" UI Visibility: Yes Included in Reports: Yes |
| First Name |
Required Subject's first name. There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Middle Name |
Optional Subject's middle name. There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Last Name |
Required Subject's last name. There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Date of Birth |
Optional Must be in the following date format: yyyy-mm-dd UI Visibility: Yes Included in Reports: Yes |
| SSN |
Optional SSN must be exactly 9 digits, including leading zeros, and does not contain any dashes. Leaving this field blank will not fail the file UI Visibility: Yes Included in Reports: Yes |
| NPI |
Optional NPI must be exactly 10 digits Leaving this field blank will not fail the file. UI Visibility: Yes Included in Reports: Yes |
| TIN |
Optional Tax Identification Number (TIN) associated with an individual. TIN should only be supplied if an individual is the business owner or the primary pharmacist. Data in the TIN field will not be used in monitoring. The TIN must be exactly 9 digits, including leading zeros, and must not contain any dashes. Leaving this field blank will not fail the file. UI Visibility: Yes Included in Reports: Yes |
| Specialty |
Optional - Determined during the Implementation process Can be 1 to many. Specialty is a variable character field and can include letters, numbers, and special characters. Specialty can be used to supply customized data. There is a 255-character limit. Leaving this field blank will not fail the file. UI Visibility: Yes Included in Reports: No |
| Taxonomy |
Optional - Determined during the Implementation process Can be 1 to many. Taxonomy is a variable character field and can include letters, numbers, and special characters. Taxonomy can be used to supply customized data. There is a 255-character limit. Leaving this field blank will not fail the file. UI Visibility: Yes Included in Reports: No |
| License Type |
Required (if license monitoring services are contracted) License type is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. The data within this column can be left blank if not contracted for license monitoring. UI Visibility: Yes Included in Reports: Yes |
| License Issuer |
Required (if license monitoring services are contracted) UI Visibility: Yes Included in Reports: Yes |
| License Number |
Required (if license monitoring services are contracted) License Number is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. The data within this column can be left blank if not contracted for license monitoring. UI Visibility: Yes Included in Reports: Yes |
| License Issued |
Optional (if license monitoring services are contracted) Must be in the following format: yyyy-mm-dd. The data within this column can be left blank if not contracted for license monitoring. UI Visibility: Yes Included in Reports: Yes |
| License Expiration |
Optional (if license monitoring services are contracted) Must be in the following format: yyyy-mm-dd. The data within this column can be left blank if not contracted for license monitoring. UI Visibility: Yes Included in Reports: Yes |
| Document Type |
Optional - Determined during Implementation Document Type should only be used under specific circumstances and should be discussed during Implementation. Two types are available today: Certificate of Insurance and Credential Form. Document Type is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Document Expiration Date |
Optional - Determined during Implementation Document Type should only be used under specific circumstances and should be discussed during Implementation. Must be in the following format: yyyy-mm-dd There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Address Type |
Optional: String Value Can be 1 to Many; Address Type defines the purpose or category of an address. Common examples include
Address Type is a variable character field and can include letters, numbers, and special characters. Address Type can be used to supply customized data. Multiple addresses are supported for individuals. Each address entered will display in the system as a separate record tied to the same subject. There is a 255-character limit. UI Visibility: No (option to concatenate Type name with Address Name) Included in Reports: No |
| Address Name |
Optional Can be 1 to Many; The Address Name serves as an additional identifier or label for the address, such as "Corporate Office" or "HR Department." It is not utilized in our screening processes and may be left blank. The Address Name is a variable character field that may contain letters, numbers, and special characters. Address Name can be used to supply customized data. Multiple addresses are supported for individuals. Each address entered will display in the system as a separate record tied to the same subject There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| Address Line 1 |
Optional Can be 1 to Many; Address Line 1 should include the street address (e.g., 123 Main Street). ProviderTrust prefers that home addresses be provided for individuals. A business address may be included only if it is the sole available address. Address Line 1 is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| Address Line 2 |
Optional Can be 1 to Many; Address Line 2 should specify secondary address details, including apartment, suite, or unit numbers (e.g., Apt 4B, Suite 300).Address Name 2 is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| City |
Optional Can be 1 to Many; City is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| State |
Optional Can be 1 to Many; State is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| Zip |
Optional Can be 1 to Many; Must be either 5 or 9 numeric digits (no alpha), accepted formats include 12345 An invalid zip will error out the row. Leaving this field blank will not fail the file. UI Visibility: Yes Included in Reports: No |
| County |
Optional Can be 1 to Many; County is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| Country |
Optional Can be 1 to Many; Country is a variable character field and can include letters, numbers, and special characters. There is a 255-character limit. UI Visibility: Yes Included in Reports: No |
| Business Unit |
Optional - Determined during Implementation Can be 1 to Many; if not designated, ProviderTrust will designate as 'No Business Unit'. If a Business Unit is specified, then the Network must also be specified, or the row will error out. Business unit is a variable character field and can include letters, numbers, and special characters. Business unit can be used to supply customized data. There is a 255-character limit. UI Visibility: Yes Included in Reports: Yes |
| Network |
Optional - Determined during Implementation Can be 1 to Many; Network must be supplied if using business units. Network is a variable character field and can include letters, numbers, and special characters. Network can be used to supply customized data. There is a 255-character limit. Networks cannot exceed 5,000 unique values. UI Visibility: Yes Included in Reports: Yes |
| End Date |
Required - Determined during Implementation The End Date sets the date monitoring will end for an individual and removes the individual from the Active Population list.
Entering a Past End Date Clients may enter an End Date in the past; however, the monitoring termination date applied in the system will be the date the file is processed, not the historical date provided in the file.
Auto-Term Functionality If an End Date cannot be supplied, auto-term functionality may be discussed during implementation. Data Consistency Requirement If the same External ID appears on multiple rows, the End Date must be consistent across all rows. Mismatched End Dates may cause the file to error. Refer to: How To: Review File Errors (EndDate/Data Mismatch)
|
Date of Birth Format in the Provider File
When entering a Date of Birth (DOB) in your provider file, please use the format YYYY-MM-DD (for example, 2022-09-13).
You may notice that when you open or download the file in Excel, the date automatically changes to a different format, such as 9/13/22. This happens because Excel automatically reformats date fields based on your computer’s regional settings.
This is an Excel limitation and does not affect how the system reads your file. As long as the date was entered in YYYY-MM-DD format before uploading, it will be processed correctly.
Comments
0 comments
Article is closed for comments.