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

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:

  • BIllable

  • Non-Billable

  • Travel

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
2 - Client

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:

  • Duration

  • Rate for the funder

  • Credential

55

UnitRate

Number

The unit rate at which the appointment is calculated

 

How Appointment ID is set

  1. 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

  2. All the records in the Data Warehouse will use the series ID as an appointment ID

  3. Once an occurrence is verified in the system, it will be assigned a new record with a new ID

  4. The occurrence Appointment ID in the system will replace the appointment ID in the Data Warehouse