Information

Complete

This screen displays information about the current customer - or if there is no current customer, a Select button allowing you to select a customer, and a New button to create one. It is also the first screen displayed after you log in - if you are new to OpenVPMS you might want to check out Introduction and Concepts.

With a current customer, the screen is as follows:

The screen areas are as follows:

(1) the information panel - the fields here are as follows:
name - this provides a link back to this customer information screen, ie pressing it on the Account screen, brings you back here
ID - the customer's ID number
phone - the phone number displayed here is the customer's preferred one. If the name of the phone number contact is other than the default 'Phone Number' then the name will also be shown - eg 9876 1234 (Home).
email - the customer's email address, clicking this brings up the Send Email window
Balance - the current account balance - ie what the customer owes us
Overdue - the part of the balance that is overdue, ie is overdue for payment
Current Amount - the part of the balance that is due to activity in the current accounting period
Unbilled - the total of any transactions that have not yet been finalised
Projected Amount - the sum of Balance+Unbilled - ie what the balance will be after the unbilled transactions are finalised
Alerts - shows any current alerts for the customer - you can click on the alert to display its details, or if there are more than 4 and 'More...' is displayed, press the View All button to display all the alerts
SMS Button - this will be displayed if the customer has an SMS enabled phone number - press it to send an SMS message

(2) the select area - this shows the customers name and address (which will be the billing address if there is one, else the preferred if is there is one, else the first found) and phone number (which will be the Home number if one has been recorded), and two buttons:
Select - pressing this brings up the Select screen to let you select another customer
Select Again - pressing this brings up the same screen but with you previous selection settings. This allows yoiu to quickly select another customer from the list when the one you chose previously was not the correct one, ie it was the wrong Jennifer Chan

(3) the header area - for the descriptions of these fields, click here

(4) the tabs area - for the descriptions of the fields in the Account Type and Appointments tabs, see below, for the others, click here

(5) the bottom buttons - these are as follows:
New - create a new customer
Edit - edit the current customer - note that you will be editing the compete customer record and all the tab items
Delete - delete the current customer - a confirmation window will appear
Merge - merge this customer with another - a select screen will appear to let you select the customer to be merged in. After you have selected the customer, a confirmation window will be displayed. Note that header information (name, title, etc) of the current customer is retained, but the tab items (patients, contacts, etc) are simply combined, ie there will be two addresses, two phone, numbers, etc etc, and you will need to edit the resulting customer record to delete the unwanted parts.
Note that the Merge button will not be displayed unless the user is a member of the Administrator category - see Concepts|Users.

 

Account Type tab
This shows the Account Type and its parameters as follows:


For an expanation of the fields see Administration|Lookups|Customer Account Type

 

Appointments tab
This tab is used to display the customers appointments as follows:

You can see that this operates as a select screen. By default the Status is set to 'Pending' which will thus show just the customer's current and future appointments. However, you can select either All or one of the other Appointment statuses to display historical data.

If you click on the patient name that will take you to the patient's Medical Records screen. If you click elsewhere on the line this will take you to the Workflow|Scheduling screen.

Create/Edit

Complete

This is the screen used to create and edit the customer record.

Note that if you are adding a new customer & patient, the easiest way is to use the New button on the Customers|Information screen, fill in the customer details, and before pressing OK to complete the customer add, click the Add button on the Patients tab, and then click the binoculars icon following the Patient name field - this will give you the Patient Select screen on which there is a New button so that you can add the new patient for this new customer.

The fields in the header section are as follows:
Id - the customer's ID
Last Name - the customer's last name - note that you need to provide this even if the customer is a company
Title - the customer's title - select from those allowed - these are controlled by Administration|Lookups|Person Title
Initials - the customer's initials -these are best entered as 'J T' or 'J.T.' rather that 'JT' - the last will be propercased to 'Jt'.
First Name - the customer's given name(s)
Company Name - enter the company name if applicable
Referred By - if applicable, select the appropriate value from the list - these are controlled by Administration|Lookups|Customer Referral
Preferred Vet - if applicable, select the appropriate value from the list - these are controlled by Administration|Lookups|Customer Vet. Note that this is a documentation field - it does not set the default clinician for this customer.
Insurance Plan - if applicable, select the appropriate value from the list- these are controlled by Administration|Lookups|Customer Insurance. As of OpenVPMS 2.0, insurance should be managed per patient, via Patient|Medical Records|Insurance.
Travel - if applicable, enter appropriate information such as 'charge 100km for visit'
Active - untick this to deactivate the customer
Account Type - select the account type from the pull-down list. Initially the system has the following Account Types available: Normal (the default), Valued Customer, and Bad Debt.  More can be added using the Administration|Lookups|Customer Account Type.
The Account Type can be used for reporting purposes (eg list all customer of type xxx), but more importantly it allows discounts to be applied (eg all valued customers get a 15% discount), and it allows customer alerts to be displayed (eg all Bad Debtor customers show with a red alert).
Practice Location - used to indicate the preferred practice of a customer, in multi-location practices. This is used as follows:

  • in various reports to select a set of customers
  • to select those customers for whom statements and reminders  are processed
  • potentially to change the content in documents as a function of the customer's preferred practice location (this requires tailoring of the varios document templates)

 

See also Local Procedures.

The 6 tabs Patients, Contacts, Identities, Discounts, Tax Exemptions, and Categories are documented below.

Note that in some cases, the tabs have a Hide Inactive xxxxx checkbox. This is present when the item being attached to the customer (ie the patient-owner, the patient-location, or the discount) can be deactivated (either by unsetting its Active flag, or if its To Date is in the past). In this case the item will remain attached to the customer, but the item will not be displayed and the customer will act as though the item was not attached. You can have these inactive items displayed by unchecking the Hide Inactive xxxxx box.

Patients tab
This tab is used to add/delete/edit a) 'Patient Owner' records and b) 'Patient Location' records.

Patient Owner - A patient can have multiple owners either at the same time (because the ownership is shared) or sequentially (because the patient passes from one owner to another).

The screen is as follows:

The fields are:
Patient - the name of the patient - if you use the binoculars to search you will be able (by ticking the All Patients option) to select a patient who has another owner and thus set up multiple ownership
From Date - the date from which the ownership started
To Date - the date on which it ended

Notes:

  1. If you do want to change the ownership of a patient, the easiest was to do it is to edit the patient record (rather than the customer record) since with the patient record, adding another owner automatically terminates the previous ownership.
  2. if you are simply adding patients to a customer, the easiest way to do this is to first call up the Customer|Information screen for the customer, and the click 'Patients' entry in the top menu line to switch to the Patients workspace and then simply press the New button to add the new patient to the current customer.

 

Patient Location - patient locations cope with the situation where the patient is owned by Dr Smith but lives at the Happy Horses stables. To cope with this, we have both Dr Smith and Happy Horses as customers. First we set up Dr Smith and his horse Ballantyne as normal. Then we set up Happy Horses as a customer, and add Ballantyne as a Patient Location record.

For the vast majority of cases, where the patients live with their owners, we don't need Patient Location Records.

The screen is as follows:


The fields are:
Patient - the name of the patient - note that the name search is done across all owners so that 'bal' will find Ballantyne
From Date - the date from which the location started
To Date - the date on which it ended

Note that given the above set up, if we go look at Ballantyne's information we see:

Note also that since a patient can only be in one place at a time, if you simply add a new Patient Location record to the patient, then the previous location will be automatically terminated.

Contacts tab
The Contacts tab (because contacts are used for customers, suppliers, etc) is documented in Concepts|Contacts.

Note that for good reminder control you should have one and only one contact (phone, email, or location) set with the purpose 'Reminder'. If you have multiple contacts with the purpose Reminder, then the first found will be used by the Reminder system.  Similarly if you have no contacts set with the purpose Reminder, then the first contact found will be used for notifying reminders.

Identities tab
The Identities tab is used to set the customer's identities. Note that contrast with patients and products, customers only have one type of identity 'Code', however the customer can have multiple Code identities.

 The fields are:
Code - the code - this can be anything appropriate
Description - an optional description of what the code represents (in the above case 54678 was the client number in the RxWorks system that this data was converted from)

Discounts tab
This tab is used to set the discounts that apply to the customer - see Concepts|Discounts for background.

The fields are:
Discount - the discount - note that this can either be a discount, or a discount group
From Date - the date from which the discount applies
To Date - the date on which the discount ends

Taxes Exemptions tab
This is used to exempt the customer from taxes. See Concepts|Taxes for backround information.

Use the arrows to move the selected item from the Available list to the Selected list and vice versa.

Categories tab
This is used to set the categories (zero, one, or more) to which the customer belongs. See Concepts|Categories for background information.

 

Confirm Delete

Complete

When you press the Delete button on the Customers|Information screen, a confirmation window will appear.

If the customer is not in use and can be deleted, the window will simply ask you to confirm the delete. Press OK to confirm or Cancel to abort.

If it cannot be deleted because it is in use, the text will be "xxxx has relationships and cannot be deleted. Do you want to deactivate it instead?"(where xxx is the name of the customer you are trying to delete). Pressing OK will unset its Active flag, Cancel will abort.

Confirm Merge

Complete

After you have pressed the Merge button on the Customers|Information screen and selected the customer to merge, a confirmation window like the following will appear.

Press OK to merge the customers, or Cancel to abort.

Customer Alerts

Complete

This screen is displayed if you press the View All button on the customer information panel to display the customer's current alerts.

The left hand side of the window displays the alert names.
Selecting an alert displays its details on the right.

For an explanation of the alert fields, see Create/Edit Alerts.

Click:

  • Close to close the window
  • Edit to edit the selected alert