Appointments Datasource
ER Diagram
Appointments Table in the Data Warehouse is the placeholder for all scheduler appointments and their financial attributes. The below ER diagram shows the link between the Appointments table and the main related entities:
Client
Staff
ClientAuthorization
Main Tables
Appointments
Database Table - Field | Type | Description | |
---|---|---|---|
1 | AppointmentID | Number (Integer)
| Check the below image This is the unique identifier of the appointment. If the appointment is part of a series, all occurrences within that series will have the same ID until they are verified. Once verified, they will get their unique ID and the series ID will be updated from null to the series ID |
2 | AppointmentGroupID | Number | Group ID always shows the series ID of the appointment |
3 | SeriesID | Number | is null until the appointment occurrence is created |
4 | AppointmentDate | Date | Scheduled date of the appointment |
5 | AppointmentWeekDay | String | Scheduled day of the appointment (e.g., Monday, Tuesday, etc.) |
6 | AppointmentType | String | A field showing whether the appointment is:
|
7 | AppointmentStartDate | Date |
|
8 | AppointmentStartTime | String | Scheduled start time of the appointment (e.g., 10:00 AM, 11:35 AM, etc.) |
9 | AppointmentEndTime | String | Scheduled end time of the appointment (e.g., 10:00 AM, 11:35 AM, etc.) |
10 | ActualStartTime | String | Actual start time of the appointment (e.g., 10:00 AM, 11:35 AM, etc.) |
11 | ActualEndTime | String | Actual end time of the appointment (e.g., 10:00 AM, 11:35 AM, etc.) |
12 | DurationMin | Number | Length of the scheduled appointment, in minutes. |
13 | ActualDurationMin | Number | Verified actual length of the appointment, in minutes. |
14 | DurationHours | String | A text presentation of the length of the scheduled appointment, in hours and minutes (e.g., “1 Hour 30 Min”) |
15 | ActualDurationHours | String | A text presentation of the actual verified length of the appointment, in hours and minutes (e.g., “1 Hour 30 Min”) |
16 | AppointmentTag | String | The tag assigned to the appointment |
17 | ServiceLine | String | Service Line of the appointment. This is passed from the client authorization |
18 | Service | String | Name of the service on the appointment. |
19 | ServiceID | Number | [Service ID number] |
20 | BillingCodeID | Number | Foreign Key to the client authorization table. Used along with the clientAuthorizationID to link the appointment to the proper authorization to get the authorization details |
21 | DiagnosisID | Number | [Diagnosis ID number] |
22 | DiagnosisCode | String | The ICD10 diagnosis code attached to the appointment. This is passed from the client authorization. |
23 | DiagnosisDescription | String | ICD10 diagnosis description |
24 | AppointmentLocation | String | Refers to the drop down on the appointment screen indicating whether the appointment is at the client home, staff home, or certain facility |
25 | PlaceOfService | String | Standard Place of Service for the claim. This refers to the drop-down on the appointment screen (e.g., 11-Office, 12-Home, etc.) |
26 | StaffID | Number | This is the ID number of the staff member scheduled for the appointment. This is used to link the appointment with staff table to retrieve information about the staff member |
27 | Modifier1 | String | A text string for modifier 1 based on the funder service setup |
28 | Modifier2 | String | A text string for modifier 2 based on the funder service setup |
29 | AuthorizationNumber | String | This refers to the authorization number linked to the appointment |
30 | CancellationNote | String | If the appointment is canceled, there is an option to add a cancelation note. This field refers to this note |
31 | CancellationType | String | Indicates whether the cancelation is staff or client cancellation |
32 | CancellationTypeID | Number | Back-end ID of Cancellation Type 1 - Staff Member |
33 | ClientVerification | String | [Indicates “Yes” if the client verified the appointment, “No” otherwise] |
34 | ClientVerificationDate | Datetime | Datetime when the parent/guardian verified the appointment. Displays “null” if not verified |
35 | ClientAuthorizationID | Number | Used to link to the appointment table with the client authorization table to retrieve information about the authorization |
36 | ClientID | Number | ID number of the staff client scheduled for the appointment. This is used to link the appointment with client table to retrieve information about the client. |
37 | Copay | Float | Refers to on-screen field allowing users to enter a copayment amount entered on the appointment level. |
38 | CopaymentReferenceNumber | String | Refers to on-screen field allowing users to enter a reference number for the copayment amount entered on the appointment level |
39 | DateLastModified | Datetime | Date when the appointment was last modified |
40 | DeletedDate | Datetime | Date when the appointment was deleted |
41 | ActualDurationMin | Number | Actual Duration of the Appointment in minutes [THIS IS A DUPLICATE] |
42 | BaseRate | Number | The base rate at which the service is defined for the company account Company Account → Service Lines → Services → Base Rate |
43 | ContractRate | Number | The contract rate at which the service is defined for the associated funder in company account Company Account → Funder → PICK FUNDER → Service Lines → Billing Code |
44 | CopaymentAmountCollected | Number | Refers to on-screen field in Appointment > Enter a copayment > Amount collected:* |
45 | DurationMin |
| Scheduled duration of appointment in minutes [THIS IS A DUPLICATE] |
46 | MileageCalculated | Number | For travel appointments, this is the mileage calculated based on the distance between the origin and destination |
47 | MileageCost | Number | The cost calculated for the travel appointment based on the company account setting for mileage cost |
48 | MileageCostTotal |
| [NEED DESCRIPTION - WHAT IS DIFFERENCE BETWEEN THIS AND MILEAGE COST?] |
49 | NumberOfUnits | Number | Total number of units of service delivered based on the duration of the appointment and the unit type. For example, if the appointment is 1 hour and the unit type of the service scheduled is “15 min”, the number of units will be 4. |
50 | SeriesRecurrenceFrequency |
| Refers to the recurrence pattern selected if an appointment is part of a series |
51 | PayType | String | Indicates if the Staff Member assigned to the appointment has an Hourly or Salary Pay Type |
52 | StaffPayHourly | Number | The scheduling provider total pay based on the selected pay code on the appointment. This is calculated based on the duration of the appointment multiplied by the pay rate |
53 | StaffPaySalary | Number | If the scheduled staff is a salaries employee, the StaffPayHourly will be 0 and this field will show the salary defined for the employee per pay period |
54 | TotalCharges | Number | The total charges calculated for the appointment according to:
|
55 | UnitRate | Number | The unit rate at which the appointment is calculated |
How Appointment ID is set
When a series is scheduled in the system, this series is broken down in the Data Warehouse according to the recurrence pattern to individual records
All the records in the Data Warehouse will use the series ID as an appointment ID
Once an occurrence is verified in the system, it will be assigned a new record with a new ID
The occurrence Appointment ID in the system will replace the appointment ID in the Data Warehouse