IMS Documentation

Clients History

Clients History shows the sales and returns associated with IMS customers. It can be used to investigate one client by phone number or, when permitted, analyze all clients. Results can be shown receipt by receipt, summarized by month, or summarized by year.

Open the reportReports → Clients History
IMS Reports menu with Clients History selected
Path: Reports → Clients History.

Report screen

IMS Client's Sales History report screen
The report can filter by branch, transaction type, dates, category and client phone, then display Details, Monthly or Yearly results.

Run the report

  1. Select one Branch, or select All Stores.
  2. Select Cash Sales or Credit Sales, or keep All Types selected.
  3. Set Date From and To.
  4. Select a customer Category, or keep All Categories selected.
  5. Enter the client's phone number. IMS prefixes it with the configured country code. Users with permission may instead select All Clients.
  6. Select Details, Monthly, or Yearly.
  7. Click Get Report.

Criteria and filters

CriteriaWhat it does
BranchLimits the report to one store available to the logged-in user.
All StoresIncludes all stores currently available to the user. When selected, the Store column is shown in the result.
Trans. TypeChoose Cash Sales or Credit Sales when All Types is cleared.
All TypesIncludes cash sales, credit sales and their corresponding returns.
Date From / ToIncludes transactions from the start of Date From through the end of the To date.
CategoryLimits the report to one customer category when All Categories is cleared.
All CategoriesIncludes every customer category and shows the Category column in the result.
PhoneSearches for one client using the configured country code plus the entered phone number. Only digits are accepted.
All ClientsRuns the report for all matching clients instead of one phone number. The Phone column is displayed when this option is used.
Client accessThe All Clients option is permission controlled. If your user account is not allowed to view all clients, you must search using a specific phone number.

Sales and returns

IMS keeps returns in the client's history so that the result represents the customer's real net activity. Cash Sales includes cash sales and cash returns; Credit Sales includes credit sales and credit returns; All Types includes all four transaction types.

Return quantities and amounts can therefore appear as negative values and reduce the report's Net Qty, Net Total and Total Amount.

Details, Monthly and Yearly views

Details

Details is the default view. Each matching receipt is shown separately. The Date column contains the transaction date/time and the report also displays Transaction and Receipt No.

The bottom Trans. Count displays the number of detailed rows found, while Total Amount adds the Net Total of the matching transactions.

Monthly

Monthly consolidates the customer's transactions by month and year. Individual Transaction and Receipt No. columns are hidden because the report is showing summarized activity instead of individual receipts.

If All Stores is selected, Store remains part of the grouping so the monthly history can still be separated by store.

Yearly

Yearly works like Monthly but consolidates results by calendar year. Transaction and Receipt No. are hidden, while customer, category, store (when applicable), quantities, amounts and current discount remain available.

Report columns

ColumnMeaning
NameCustomer name available from the IMS customer or loyalty record.
PhoneCustomer phone number. Shown when All Clients is selected.
CategoryCustomer category. Shown when All Categories is selected.
StoreStore where the transaction occurred. Shown when All Stores is selected.
Date / Month / YearIndividual transaction date in Details, or the selected summary period in Monthly/Yearly.
TransactionTransaction type, such as sale or return. Details view only.
Receipt NoReceipt number. Details view only.
Full QtyQuantity recorded at full price.
Full AmtAmount recorded at full price.
Disc QtyQuantity recorded with discount.
Disc AmtAmount recorded for discounted quantity.
Net QtyFull Qty + Disc Qty, including the effect of returns.
Net TotalFull Amt + Disc Amt, including the effect of returns.
Curr. DiscThe customer's current discount ratio shown as a percentage.

No data and phone validation

If a specific client is required but no phone number has been entered, IMS displays “Enter client's phone No.”. If the criteria are valid but nothing matches, IMS reports that no matching data was found.

While a long report is loading, IMS disables the criteria, displays progress and provides a Cancel action. Cancelling clears the partial result and returns control to the criteria panel.

Export, email and Save As

Export To Excel exports the generated grid. Send By Email sends the generated Clients History report with the selected date range in the subject. Save As is available with Excel-export permission and requires a generated report.

Permissions

The Clients History menu is controlled by the IMS view client history permission. The same report permission also controls access to Clients Visits. The ability to select All Clients is controlled separately by the view all clients permission.

Export to Excel and Send By Email are also controlled independently by their standard IMS report-output permissions.

Common uses

Customer service

Find a client's receipts

Enter the client's phone number, use Details, select the required dates and click Get Report.

Returns

Check sales and returns together

Keep All Types selected to see both sale and return activity and the resulting net totals.

Trend

Review purchase history over time

Use Monthly or Yearly to summarize the client's history without showing every individual receipt.

Analysis

Compare customer activity across stores

Users with the required access can select All Stores and All Clients to include the Store and Phone dimensions in the report.