Summary
This article explains how to create and upload an Organization 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 Organization File is used to add or update organization-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 - Organization 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 organization. This approach allows for the inclusion of multiple addresses or other related information for a single entity. |
| Removal of Organizations | To remove an organization, 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 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 = "Organization" UI Visibility: Yes Included in Reports: Yes |
| Business Name |
Required UI Visibility: Yes Included in Reports: Yes |
| Does Business As |
Optional “Doing Business As” name is associated with the individual or entity. This is the trade name or alias under which the provider or organization operates, which may differ from the legal name. "Does Business As" 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 |
| TIN |
Optional Tax Identification Number (TIN) associated with an individual or business. TIN must be exactly 9 digits, including leading zeros, and must not contain any dashes. 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 |
| 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 |
Optional (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 |
Optional (if license monitoring services are contracted) License Issuer 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 Number |
Optional (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 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 organizations and entities. 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 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 organizations and entities. 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 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 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 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 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 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 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 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 End date sets a date for monitoring to end for an organization as well as removes the organization from the Active Population list. A date must be supplied to end monitoring for a subject; it must be in yyyy-mm-dd format. This date represents an "up to" date. A runnable is executed periodically throughout the day to terminate subjects on that date. If a client enters today's date, the termination will occur the first time the runnable runs on that date. End Date should be left blank for all active subjects. If a date is unable to be supplied, an auto-term functionality will be discussed during implementation. For more information regarding our best practices, refer to ProviderTrust Best Practices for Ending Monitoring. Note: If the same External ID appears on multiple rows, the End Date must be consistent across those rows or the file may error. Refer to, How To: Review File Errors (EndDate/Data Mismatch). UI Visibility: Yes Included in Reports: Yes |
Comments
0 comments
Article is closed for comments.