You use this program to view data relating to your customers in the Accounts Receivable module.
You typically use this program to verify customer details and to view details of customer invoices and payments. This could be driven internally from your credit control department, or externally in response to a customer request.
This program can be run at any time.
There are no dependencies between this program and any other program.
Field | Description | ||||
---|---|---|---|---|---|
Options | |||||
Preferences | Configure options that will determine the level of detail you want to view within the query (see Preferences). | ||||
Options | Define the month for which you want to view balances and the ageing date for balances (see Options). | ||||
Show Profits |
View the Profit summary and Profit percentage values in the Customer History section for the selected customer. See Password considerations in Notes and warnings. |
||||
Query | |||||
Post Dated Checks | View details of post dated checks for the customer. | ||||
Multiple Address Lines | View multiple ship to addresses for the customer. | ||||
Subaccounts | View sub accounts attached to the customer. | ||||
Customer Contracts | View the contract pricing details held against the customer. | ||||
Buying Group Contracts |
View the buying group information defined for the customer. Buying groups are defined using the Buying Groups program. |
||||
Invoices & Payments | Use the AR Invoices for Customer program to view customer invoices and their corresponding payments. | ||||
Show Statements |
View the customer's statement in a browser window. You can typically use your right mouse button within the browser window to view additional options available. For example, you can print the statement by selecting the Print option. You can customize the design used to render this information using the Browser Queries and Themes program.
|
||||
Contact | Use the Contact Query program to view information on contacts for the customer. | ||||
Customer | Enter the code of the customer whose details you want to query. | ||||
Find | Use the Key Search program to locate items according to extensive search criteria. | ||||
Play | View any multimedia objects that have been assigned to the customer. | ||||
Edit | Maintain multimedia objects for the customer. | ||||
Notes | The first 10 lines of Customer Notes and Management
Notes are displayed in this section. You can view and edit the
notes by typically using your right mouse button to select the
first line of text.
|
||||
Management Notes | Use the Admin Notepad Editor (Monospaced Text) program to view and maintain credit
management notes for the customer. These notes can be printed on the Credit Management report. You can also use the follow up date to indicate the date according to which credit narrations must be printed on the report. See Password considerations in Notes and warnings. |
||||
Customer Notes | Use the Admin Notepad Editor (Monospaced Text) program to view and maintain notes for the customer. | ||||
Additional | Use the Admin Notepad Editor (Rich Text) program to capture additional free format notes against the customer. | ||||
Contacts | Use the Contact Query program to view information on contacts for the customer. |
You use the Preferences option from the Options menu to define the level of detail you want to view within the query.
Field | Description | ||||
---|---|---|---|---|---|
Invoices & Payments | |||||
Invoice ageing selection | Refer to Invoice Ageing for information on how the aged balances for a customer are determined. | ||||
No ageing | Select this if you do not want to display invoices in the Invoices listview according to their age. | ||||
Aged buckets | Display invoices according to the ageing buckets defined for the customer. The ageing buckets are displayed as they are held on file (i.e. no re-ageing is performed). | ||||
Aged invoices | Re-age invoices according to the current system date. | ||||
Include retained invoices | Include invoices with a zero balance which have been retained for more than one month. These are the customer's prior months' zero balance invoices. | ||||
Invoice display | |||||
Include retained invoices | Include invoices with a zero balance that you are
retaining for a prescribed period of time.
|
||||
Zero balance current invoices | Include zero balance invoices that
became zero in the current
month. Note that if you post a zero balance invoice (using AR Invoice Posting for example) then disabling this preference does not prevent the invoice from being displayed. In this case you would need to run the Balance function of the AR Period End program to exclude these invoices. |
||||
Ascending sequence | Display the invoices in the Invoice table/file from the first invoice number in the table/file. This applies to invoices viewed within the listview pane of the Invoices tab. | ||||
Descending sequence | Display the invoices in the Invoice table/file from the last invoice number in the table/file. This applies to invoices viewed within the listview pane of the Invoices tab. | ||||
View invoices and payments in | |||||
Detail | View invoice and payment details together with any transactions processed against the invoice. | ||||
Summary | View invoice and payment details only. | ||||
Payments display | |||||
Earliest payments first | View payment details from the oldest payments held on file. This applies to payments viewed within the listview pane of the Payments tab. | ||||
Latest payments first | View payment details from the most recent payments held on file. This applies to payments viewed within the listview pane of the Payments tab. | ||||
Invoice ageing method | This defaults to the ageing method defined against the Invoice ageing method setup option, but can be changed for the query. This does not affect the ageing method defined at company level (Accounts Receivable Setup).
|
||||
By statement | Age invoices according to the last seven period end dates. An invoice is defined as current if the invoice date is after the last period end date. | ||||
By aged statement | Age invoices according to the last seven period end dates. An invoice is defined as current if the invoice date is after the second last period end date. | ||||
By invoice date | Age invoices according to the difference between the invoice date and the system run date. | ||||
By invoice due date | Age invoices according to the due date of the invoice. This is calculated as the invoice date plus the days till due as defined within the AR Invoice Terms program. The invoice remains current for as long as the due date remains greater than the ageing date. | ||||
Sales Orders & Movements | |||||
Movements display | These options apply to the Movements listview only. | ||||
Earliest movements first | View sales movements from the oldest movements held on file. This applies to movements viewed within the listview pane of the Movements tab. | ||||
Latest movements first | View sales movements from the most recent movements held on file. This applies to movements viewed within the listview pane of the Movements tab. | ||||
Sales orders | This applies to the Sales Orders listview only. | ||||
Show active orders only | Exclude completed orders (i.e. orders in a status of 9) from being displayed in the listview pane of the Sales Orders tab. | ||||
General | |||||
Foreign customer values in |
|
||||
Local currency | View the transaction values for foreign currency customers in the local currency. | ||||
Foreign currency | View the transaction values for foreign currency customers in the foreign currency. | ||||
Convert to local value at | This option is only enabled if you selected to view foreign customer values in the local currency. | ||||
Entry-time rate | Convert the foreign currency transaction values into the local currency at the exchange rate at which the transaction was processed. | ||||
Current rate | Convert the foreign currency transaction values into the local currency at the exchange rate currently defined for the foreign currency. | ||||
Save Preferences | Save these preferences against your operator code and use them for future runs of the program until next you change them. | ||||
Close | Save the preferences for the current run of the program only. |
This screen is displayed when you select Options from the Options menu.
Field | Description |
---|---|
Balances as of | Indicate whether you want to view balances as at the current month, previous month 1, or the previous month 2. |
Current month | View balances as of the current month. |
Previous month 1 | View balances as of the previous month. |
Previous month 2 | View balances as of the month before last. |
Ageing date | If you selected to view balances as of the Previous month 1 or Previous month 2 then you use this field to indicate the date according to which you want to age invoices. |
The details about the customer are displayed in these fields.
Some of the details that can be viewed include:
Field | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Customer Details | |||||||||||||||||||||||||||||
Credit status |
The message "No Credit Allowed" is displayed in this field if the Credit status code = 9. In all other cases, this field is blank. Customer credit statuses are reset when:
Refer to Credit Status for information on how a customer's credit status is determined. |
||||||||||||||||||||||||||||
Credit status code |
The following codes can be displayed in this field:
|
||||||||||||||||||||||||||||
Master sub-account | This indicates whether the customer is a master or a sub account. This is blank if the customer is neither a master nor a sub account. | ||||||||||||||||||||||||||||
Over limit |
This is calculated and displayed irrespective of whether credit checking is required for customers. The Over limit value is calculated as follows:
|
||||||||||||||||||||||||||||
Credit checking | This indicates the credit checking method defined against the customer. | ||||||||||||||||||||||||||||
Order value |
This indicates the value of orders and dispatch notes not yet invoiced. This amount is amended by the following programs:
|
||||||||||||||||||||||||||||
Order value released |
This is the total value of all shipped order lines. The Order value released is only displayed if Credit checking is required and the Apply check to current orders only option is selected. If the Apply check when quantity moved to ship option is selected (Sales Orders Setup) then the order does not have to be any specific status for it to be included in this total. If you are using dispatch notes, then the order value released includes the value of any dispatches that have been dispatched but not invoiced. With this option selected, ship values are added as soon as an item is moved to ship on an order or an item is dispatched. If the option Apply check when quantity moved to ship is not selected, then ship values from orders are only added when orders are in a status of 8 and when dispatch notes are in a status of 7. When an order is invoiced, the Order value released is reduced. The Order value released is recalculated when you run the Balance function of the Order Purge program and you select the option: Validate inventory quantity allocations. This value includes tax if credit checking is set to include tax, except when USA tax is in force. USA tax is always excluded from the credit checking calculations. |
||||||||||||||||||||||||||||
No of orders |
This indicates the number of active sales orders together with the number of completed orders held against the customer since the last sales order purge was run. Completed orders (i.e. orders in a status of 9) are excluded from the number of orders displayed only after you have run the Order Purge program. The following programs increment the number of orders displayed at this field:
|
||||||||||||||||||||||||||||
Last payment | This indicates the date on which the last payment was processed against the customer. | ||||||||||||||||||||||||||||
Last sale | This indicates the date on which the last sale was processed against the customer. | ||||||||||||||||||||||||||||
Average no of days to pay |
This field is recalculated each time you use the AR Payments and Adjustments program to process a payment for the customer or you run the Balance function of the AR Period End program. The formula for Average number of days to pay is NumZeroDays / NumZeroInvoices. These fields are in the ArCustomerBal table. For each invoice or debit note paid, two totals are updated:
When a payment is processed:
The average number of days to pay is calculated as:
For the Average no of days to pay to be correctly calculated, you need to ensure that the option: Average number of days to pay calculation - Number of months to use is defined as required. The number of months determines the cut-off point for including paid invoices (i.e. zero balance invoices) in the average number of days to pay calculation. |
||||||||||||||||||||||||||||
Ageing - invoice value |
You can view the invoices that make up these balances in the Ageing column of the Invoices listview. Invoices are aged according to the terms code for each invoice. The standard ageing buckets are displayed in 30 day buckets (30 days, 60 days, 90 days, etc.) but if you are using the Number of days fixed option and you defined your own ageing buckets, then the ageing bucket headings are displayed according to the headings defined in the AR Terms Ageing Headings program. |
||||||||||||||||||||||||||||
Balance |
This indicates the customer's current balance. This is calculated by the Customer Query program at the time of performing the query. Therefore, no other programs need to be run to update the balance prior to performing the query. Refer to Invoice Ageing for information on how the aged balances for a customer are determined. |
||||||||||||||||||||||||||||
Ageing - no of invoices |
This indicates the number of invoices that make up the balance for the corresponding periods in the Ageing - invoice value fields. The number of invoices for each period is determined by checking if the invoice balance is zero. If it is then the program determines the period in which the balance became zero. However, if the invoice became zero in the current period, then it is still included in the current period until you run the Month end function of the AR Period End program. |
||||||||||||||||||||||||||||
Master account details | |||||||||||||||||||||||||||||
Highest balance attained |
This indicates the highest balance ever owed by the customer. This balance is not set to zero at month end or year end and is purely for information purposes. This field can be updated by the following programs:
|
Field | Description | ||||
---|---|---|---|---|---|
Sold to address |
|
||||
Ship to address |
|
Details that can be viewed include the following:
Field | Description | ||||||
---|---|---|---|---|---|---|---|
Prev 24 months sales | |||||||
Previous 1 - Previous 24 |
|
||||||
MTD summary by value |
|
||||||
Sales summary |
|
||||||
Profit summary |
Profit summary and Profit percentage information can only be viewed when a password is defined for AR Viewing of customer profits in customer query. When you select the Show Profits option, you are requested to enter the appropriate password before the profit information is displayed. See Password considerations in Notes and warnings.
|
||||||
Profit percentage |
Profit percentages are calculated from the A/R customer Master Balances file.
|
||||||
Metrics |
Select the hyperlink against the relevant metric to view the transactions that make up that value. |
Details that can be viewed include the following:
This pane displays custom form information defined against the customer.
Field | Description |
---|---|
Custom Form Data Entry | Select this to use the Custom Form Data Entry program to enter custom form data against the supplier. |
This displays a graphical representation of the value of invoices for the customer aged according to the ageing buckets that are defined.
Refer to Invoice Ageing for information on how the aged balances for a customer are determined.
This displays a graphical representation of the value of sales processed for this customer over the past 24 months.
This displays details of invoices, debit notes and credit notes raised for the customer.
Field | Description | ||||
---|---|---|---|---|---|
Type |
This indicates the document type.
|
||||
Terms |
For invoices created using the AR Finance Charge Calculation program, the default terms are the terms defined against the setup option: Finance charges - Terms. |
||||
Sales order |
This indicates the sales order from which the invoice was created. If there is no sales order number, then this indicates that the invoice was created using the AR Invoice Posting program. |
||||
POD |
This indicates whether proof of delivery information exists for the invoice.
|
||||
POD reference |
This indicates the reference defined against the proof of delivery. |
||||
Ageing |
This column displays the age of the invoice, unless you selected the Preference: No ageing. You can sort invoices by age by using your mouse pointer to select the column heading. This enables you to view the invoices which make up the ageing balances in the Ageing - invoice value section in the Customer Information pane. Refer to Invoice Ageing for information on how the aged balances for a customer are determined. |
You can highlight a line in this listview and typically use your right mouse button to select one of the following:
Order Details
Proof of Delivery
Exchange Rates. This indicates the foreign to local conversion rate for the transaction. This option is only enabled for foreign currency customers.
Revaluation Details. This option is only enabled for foreign currency customers.
Field | Description |
---|---|
Type |
The type 'Rev' indicates that the AR Exchange Rate Revaluation program was used to revalue the transaction. This only applies to foreign currency customers. 'Cr' indicates a Credit note posted to the invoice (i.e. when using the AR Invoice Posting program to generate the credit note, the option: Post to existing invoice was selected). 'Dr' indicates a Debit note posted to the invoice (i.e. when using the AR Invoice Posting program to generate the debit note, the option: Post to existing invoice was selected). |
Date |
This indicates the date of payment. |
Pmt jnl |
This indicates the payment journal created for the payment transaction. |
Reference |
A reference of 'Reval' indicates that the AR Exchange Rate Revaluation program was used to revalue the transaction. This only applies to foreign currency customers. |
Settlement discount note |
This column displays the discount credit or debit note number if you selected to print discount credit and debit notes. |
Jnl notation |
This indicates the Accounts Payable journal number for contra entries processed using the Customer-Supplier Contra program. |
Movements are only displayed if the Customers option Retain detail movements is enabled against the customer. |
Field | Description |
---|---|
Stock description |
By default, this displays the stock description defined against the sales order. If the sales order has been purged, then for a stocked item, this displays the description defined against the stock code. If you processed a Billing for a stocked item using the Sales Order Entry program and you changed the description for the item, then the description you defined is displayed, unless the new description is spaces, in which case the description defined against the stock code is displayed. |
Long stock description |
This displays the stock description defined against the stock item. |
Unit price |
This is the result of a calculation based on the line quantity and line sales amount, so both order and line discount have been taken into account. If you want to see the contract price for a scheduled order, then you have to look at the sales order or the invoice. |
Payment information is only displayed in this listview when the Retain payments details option is enabled in Accounts Receivable Setup.
This information is based on records in the ArPayHistory table and only reflects the actual payment amounts received from the customer. It does not reflect any discounts applied to the payment.
AR Collector information is based on records in the ARSTRN file.
The payment details for the currently highlighted line are displayed in the Payment Details pane.
Only the first 15 characters of the payment Reference are displayed.
This pane displays the payment details for the line currently highlighted in the Payments listview.
This information is based on records in the ArInvoicePay table and reflects invoice payments and adjustments and therefore also includes any discounts applied. Information such as the AR Payment run number, Collector, Salesperson and Invoice notation taken from the ARSTRN file are also displayed.
Field | Description |
---|---|
Entry number |
This indicates the Journal entry number, which enables you to differentiate between payment detail entries when two payments are made against one invoice on one journal number. |
You use the Sales Orders tab to view all sales orders for the customer.
Some of the listview columns include:
Field | Description |
---|---|
Doc type | This is the document type processed using the Sales Order Entry
program. Cr note indicates a Credit note, while Dr note indicates a Debit note. |
Ship date | This indicates the ship date for the line.
None indicates that it is a scheduled order. |
Scheduled | Yes indicates that the order is a scheduled order. In this case, the Ship date is displayed as None. |
Include item in MRP | Indicates whether the order is included in the Material Requirements Planning calculation. |
This displays details of work in progress outstanding for the customer (i.e. details of jobs linked to outstanding sales orders for the customer).
This listview displays information on jobs linked to sales orders for the customer.
This pane displays job details for the job currently highlighted in the Work in Progress listview.
Some of the details that can be viewed include:
Field | Description |
---|---|
Dates |
If you are using the Factory Scheduling module and you enabled the Update planned dates with scheduled dates setup option (Factory Scheduling Setup) then planned dates against a job are updated with the scheduled dates from the Factory Scheduling system. |
Password access to the following functions in this program may be defined in the Password Definition program. When defined, the password must be entered before you can access the function.
Field | Description |
---|---|
AR Viewing of customer profits in customer query | This password restricts access to viewing customer profits using the Customer Query program. The Show Profits option in the Customer Query program is only enabled when this password is defined. |
AR Maintenance of credit management notes | This password restricts access to maintaining Management Notes for a customer using the Customer Query or Customers program. This does not prevent the notes from being displayed. |
Inserting Application Help
You would typically follow this procedure to display help for the current program in a customized pane that can be pinned to the program window.
Information includes step-by-step instructions for the various functions available within the program, including a brief overview of what the program does, what setup options are required and how to personalize the program.
Open the program for which you want to insert application help into a customized pane.
This functionality is only available for a program that has panes.
Right-click any form field.
You can also click the triangle menu icon that appears in the title area of a pane.
Select Insert Application Help from the context-sensitive menu.
The application help appears in a pane within your program. You can reposition the pane using the docking stickers or pin it to the program window.
Removing the Application Help pane
If you no longer want to display application help in a pane for your current program, you can simply remove it.
Select the Close icon in the right-hand corner of the application help pane.
Confirm that you want to delete the pane.