Rethink Staff Get/Post API
GET Staff
A get is needed to get staff demographics by a Staff ID or all Staff Members. The API client will send the Staff ID as a parameter to the API and the demographics returned will be the data mapped in the below table
POST to add a new staff or modify a staff
A post method is needed to insert or update staff information into Rethink. The input to the method will be a staff object based on the below mapping table
A post method will also be used to pass a list of Staff Ids and return corresponding information.
Staff General Information |
|
| ||||||
# | Field | Data Type | Max Length | Description | Required | Expected Values | Error Message |
|
1 | staffId | number | 20 | Rethink Staff ID. This will be null in case a new staff is being created. Rethink will assign a Staff ID. If the staff is being updated, the staff ID will need to be sent to Rethink | Situational | 1234 | Invalid StaffID: ID does not exist under this Company Account Invalid Format - Must be a number Exceeds Max Length |
|
2 | username | string | 100 | Username of the Staff Member | Yes | janedoe1 | Invalid Format: Must be a string Exceeds Max Length Username already exists in the system Minimum length of the username should be 6 characters |
|
3 | statusId | number | 10 | Status ID connected to the Staff Status should be passed. The Status IDs are the IDs for statuses configured in the Company Account > Staff Settings > Staff Statuses. The Status IDs will be provided by Rethink during implementation. | Yes | 11 | Invalid Status Id. Status Id does not exist under this account. Exceeds Max Length |
|
4 | companyStaffId | string | 100 | External System Assigned Staff ID for the Staff | No | 445667 |
Exceeds Max Length |
|
5 | firstName | string | 100 | Staff Member's First Name | Yes | Jane | Exceeds Max Length |
|
6 | middleName | string | 100 | Staff Member's Middle Name | No | Mary | Exceeds Max Length |
|
7 | lastName | string | 100 | Staff Member's Last Name | Yes | Doe | Exceeds Max Length |
|
8 | dateOfBirth | string | 10 | Staff Member's Date of Birth. | No | 1965-12-12 | Invalid Format: Must be a date format |
|
9 | phone | string | 13 | Contact Number of the Staff | No | 7879898877 | Exceeds Max Length |
|
10 | addressStreet | string | 100 | Staff Member's Street Address | No | 123 Avenue | Exceeds Max Length |
|
11 | city | string | 100 | Staff Member's City | No | Miami | Exceeds Max Length |
|
12 | stateId | number | 2 | ID associated with the with the State. See Appendix for State. | No | FL | Exceeds Max Length Invalid Format - Must be a number Invalid State ID . Valid range of values is 1-52. |
|
13 | zipCode | string | 9 | 5 or 9 digit Zip Code | No | 331780000 | Exceeds Max Length Invalid Format - Dashes are not supported |
|
14 | timeZoneId | string | 100 | See TimeZone data dictionary Appendix 8.0. Time Zone | Yes |
| Invalid Time Zone |
|
15 | locationIds | list of numbers |
| Location ID(s) associated to the intended location should be passed. The Location IDs are the IDs for the Location configured in Company Account > Locations > Location. The Location IDs will be provided by Rethink during implementation. Multiple locations should be sent as list of location IDs | Yes | 1 | Invalid Location Id. Location Id does not exist under this account.
Invalid Format - Must be a number. |
|
16 | employeeTypeId | number | 10 | Employee Type ID are the IDs for the the Employee Types configured in Company Account > Staff Member Settings > Employee Types. The Employee Type ID will be provided by Rethink during implementation. | No | 1 | Invalid Employee Type Id. Employee Type Id does not exist under this account.
Invalid Format - Must be a number. |
|
17 | roleId | number | 10 | Role IDs for Staff are the IDs that define role of the staff and inherit permissions based on role of the staff. Role ID of the Role are configured in Company Account > Roles. The Role ID will be provided by Rethink during implementation. | Yes | 1 | Invalid Submission: Value does not exist under this Company Account
|
|
18 | string | 200 | Staff Member's Email | Yes | Invalid Format: Must be email format Exceeds max length Email already exists in the system |
| ||
19 | npiNumber | string | 10 | Staff Member's NPI Number | No | 1801424978 | Invalid Format: Must be an number Exceeds max length Invalid NPI Number |
|
20 | medicaidNumber | string | 15 | Staff Member's Medicaid Number | No | 1122334455 | Invalid Format: Must be an number Exceeds max length |
|
21 | practionerId | string | 20 | Staff Member's Practitioner ID | No | 938874655678767 | Invalid Format: Must be an number Exceeds max length |
|
22 | taxonomyCode | string | 10 | Unique alphanumeric code to designate provide classification and specialization | No | 651044004 | Invalid Format: Must be a string Exceeds max length |
|
23 | supervisorId | number | 20 | Supervisor assigned to the staff member. | No | 23 | Exceeds Max Length supervisorId is same as staffId Invalid supervisorId |
|
24 | serviceLineIds | list of numbers | 10 | Service Line ID associated to the intended Service Line should be passed. The Service Line IDs are the IDs for values configured in the Company Account > Service Lines. The Service Line ID will be provided by Rethink during implementation. | No | 2 | Invalid Submission: Value does not exist under this Company Account
|
|
25 | funderIds | list of numbers | 100 | Funder ID associated to a Funder should be passed. Funder IDs will be provided by Rethink during implementation. the Funders configured in Company Account > Funders > Name | No | 1 | Invalid Submission: Value does not exist under this Company Account
|
|
26 | List of Availabilities | staffAvailability | List<staffAvailability> |
|
| No | List of Availability for Staff |
|