Payment Receipt Record View

The purpose of the Payment Receipt Record View is to enter payments received by customers. From here, users can open the 'Apply Documents' window, review the Journal Details, and post the receipt. When receipts are posted, the Customer Balances and Customer Aging are updated and the receipt becomes available to the Checkbook Deposit transaction. Payment Receipts make a journal entry when they are posted.

Software Version: 2020.01.13 and newer

Page Header

Header Toolbar

Toolbar IconsDescription
Apply DocumentsOpens the Apply Documents window allowing the user to apply this receipt to one or more open transactions.  The Apply Documents button is disabled when the Receipt Amount is 0.
Delete

Deletes the selected record(s). When clicked, users will be prompted with: "Are you sure you want to delete the selected records?". Click "OK" to confirm, or "Cancel" to return without deleting. 

WARNING: Records cannot be recovered once they are deleted!

(lightbulb) If a Payment Receipt that has been fully or partially applied is deleted (prior to posting), all applications will be automatically removed. 

Grid LayoutOpens the Saved Grid Layout menu that allows the user to select another saved layout, create a new layout, save changes to a layout, or assign a saved layout as the default for the page. Once changes are made to a grid, such as columns are added or removed, the user can click the Saved Grid Layout icon and save the changes to the grid layout and name the new layout. The new layout can also be set as the default, instead of the System View. This is useful for creating specific views to separate master files or transaction types (i.e. Invoice specific vs. Credit Memo specific).

(lightbulb) The bolded view is the default view, which will determine the view will automatically display in when opened. 

HelpOpens the online WIKI help page for the current page. 

(lightbulb) This icon is only visible on pages that are documented in the online help.

Journal Details

Opens the Journal Details window showing the Journal Entry for this transaction. 

(lightbulb) Until the transaction Approved or Posted, this is a temporary journal entry so no Journal ID will be assigned. 

The Journal Details Window for this transaction will include:

  • The Cash Receipt Journal Entry (in both the Receipt Currency Amounts and Home Currency Amounts)
    • Debit to the Checkbooks Cash Account 
    • Credit to the Customer A/R Account 
  • All the associated application Journal Entries - even though they may have happened on different dates
  • All the associated Currency Gain/Loss Journal Entries - even though they may have happened on different dates
NewAllows the user to create a new master file record or transaction by opening a blank record view page. This icon is always enabled. 
Notes

Opens the Notes dialog, filtered for the appropriate Note Type(s). From here, users can add, review, or edit Notes associated with the record. This icon is always enabled. 

PrintOpens the Print dialog, showing any applicable printable reports to be printed, downloaded, and/or emailed. 
SaveSaves the changes made to the record. 

(lightbulb) It is only necessary to click the Save button when a change is detected on the page. When a change has been made, a ‘ + ‘ character is displayed prior to the page name in the page title bar (light blue bar in the upper left corner of the page). Clicking Save reloads the page.

Home Tab

FieldsDescription
Amount

A text box to enter the dollar amount of the payment you received in the 'Currency' you specified. This defaults to 0.00 but is required and must be > 0.00 to Approve and/or Post. If not, the message "Amount must be greater than 0.00." will be displayed. This field is only editable after a 'Customer' has been selected and while the transaction Status is "New" and while no applications exist for the receipt. Editing this value, and saving the transaction will re-calculate the 'Applied' and 'Unapplied' fields.

Linked Database Field: ERPx_ARTransactionHeader.ExtendedAmount

Applied Amt.A non-editable text box to identify how much of the Receipt, in the Receipt currency, has been applied. This defaults to 0.00 but will re-calculate as the receipt is applied. Receipts can be posted without applying, but if they have been applied, this amount will be >0.00. This is a calculated field that is not editable on this page. This field is not linked to a Database Field.
Checkbook

A single-select standard lookup to select which checkbook the receipt will be deposited into. This defaults using the following logic after the Customer is selected:

  1. If the Checkbook that is assigned to the Customer is in either the Customer Currency or the Home Currency then default to the Customer Checkbook, else
  2. If the Checkbook that is assigned to the "Default Payment Receipt Checkbook" Sales Preference is in either the Customer Currency or the Home Currency then default from the Preference, else
  3. Set to blank and require a value before enabling the rest of the data fields

This is required before you can enter/edit the remaining receipt fields, Approve and/or Post, or to open the 'Apply Documents' window. If not assigned, the message "Checkbook is required" will be displayed. This field is enabled after a 'Customer' has been selected and while the transaction Status is "New". This field is only editable after a 'Customer' has been selected and while the transaction Status is "New" and no applications for this receipt have been made. 

The lookup contains the list of all the 'Active' checkbooks assigned to the Customer or the Home Currency. 

Linked Database Field: ERPx_ARTransactionHeader.CheckbookSK

Comment

A text box to enter a comment. This defaults to blank and is not required. This field is only editable after a 'Customer' has been selected but remains editable, even after the transaction is posted. This must be <= 60 characters.

Linked Database Field: ERPx_ARTransactionHeader.Description

Currency

A single-select standard lookup to assign the currency of the Receipt. This initially defaults to the 'Home Currency' but updates to the Customer currency once a Customer has been selected, but can be changed after that. This is required to Approve and/or Post or to open the 'Apply Documents' window. If not assigned, the message "Currency is required and must be in either [Home Currency ID] or [Checkbook Currency ID]." will be displayed. This field is only editable after a 'Customer' has been selected and while the transaction Status is "New" and no applications for this receipt have been made.

(lightbulb) Since a Receipt can only be applied to transactions matching the Receipt's currency, the 'Currency' cannot be edited once an application exists. If you need to change the Currency, you must unapply all the transactions that are currently applied.

Validations include:

  • If the Currency assigned to the Checkbook matches the 'Home Currency' then the receipt currency can be any currency with a valid exchange table setup to the Home Currency.
  • If the Currency assigned to the Checkbook does NOT match the 'Home Currency', then the receipt must either be in the Checkbook's currency or the 'Home Currency'.

The lookup contains all 'Active' currencies.

Linked Database Field: ERPx_ARTransactionHeader.CurrencySK

Customer

A single-select load on demand lookup to select the Customer you received the payment from. This defaults to blank but is required before anything other than the 'Receipt Date' can be edited. If not assigned, the message "Customer is required." will be displayed. Because this value determines the initial values assigned for the 'Checkbook' and 'Currency', if it is changed after it has been assigned, a message will appear as: "Changing the Customer will reset the Checkbook and/or Receipt Currency." This field is only editable while the transaction Status is "New" and the 'Applied Amount' is blank or 0.00.

The lookup contains the list of all 'Active' customers, including the customer accounts that are on hold, displayed as Customer Name (Customer ID). 

Linked Database Field: ERPx_ARTransactionHeader.CustomerSK

Payment #

A text box to enter the number of the payment you received, most often associated with the Check #. This field defaults to blank, is not required, and is only editable after a 'Customer' has been selected. This field is always editable, even after the transaction is posted. This must be <= 50 characters.

Linked Database Field: ERPx_ARTransactionHeader.DocNumber

Receipt Date

A date field to enter the date the Receipt was actually received. This defaults to the current date and is required to Approve and/or Post or to open the 'Apply Documents' window. If not, the message "Receipt Date is required." will be displayed. This field is only editable while the transaction Status is "New" but is disabled once an application for this receipt has been made.

(lightbulb) Since the 'Receipt Date' can impact a Currency Gain / Loss when it is applied, it the cannot be edited once an application exists for receipts that are not in the Home Currency. If you need to change the 'Receipt Date', you must unapply all the transactions that are currently applied.

Linked Database Field: ERPx_ARTransactionHeader.TransactionDate

Receipt Type

A single-select standard lookup to select the type of the Receipt. This defaults to "Check" but can be changed. This is required to Approve and/or Post. This field is only editable after a 'Customer' has been selected and while the transaction Status is "New". 

The lookup contains all the values in the MFCashReceiptType Enumeration Class. 

Linked Database Field: ERPx_ARTransactionHeader.CashReceiptTypeEN

Status

Changing this value will re-assign the Checkbook and the receipt currency.A single-select standard lookup to select the Status of the Receipt. This defaults to New but can be changed to Approved or Ready to Post. Setting this to Approved, and saving, runs all the posting validations and disables all the fields except the Comment, Payment #, and Status. Setting this to Ready to Post, and saving, posts the transaction, disables  all the fields except the Comment and Payment #, and posts the journal entry.

The lookup contains the list of New, Approved, and Ready to Post.

Linked Database Field: ERPx_ARTransactionHeader.TransactionStatusSK

Unapplied Amt.A non-editable text box to identify how much of the Receipt still needs to be applied. This defaults from 'Amount' entered but will re-calculate as the receipt is applied. Receipts can be posted without applying, but if they have been applied, this amount will be >0.00 and < 'Amount'. This is a calculated field that is not editable on this page. This field is not linked to a Database Field.

Properties Tab

The fields sorted at the bottom of this section, prefixed with "MC:" are only visible on multi-currency payment receipt transactions.

FieldsDescription
Checkbook Currency

A non-editable text box to identify the Currency ID for the currency assigned to the Checkbook. Receipts cannot be posted if this value is missing.

Linked Database Field: ERPx_MFCheckbook.CurrencySK

CheckbookSK

A non-editable text box to identify the SK value of the Checkbook assigned to the Transaction. This is a looked-up value, that is primarily used for support.

Linked Database Field: ERPx_ARTransactionHeader.CheckbookSK

Created

A non-editable text box to identify the Created Date & Time of the Transaction, formatted from the users 'Date Format' preference. This is a system assigned value and is never editable by a user. 

Linked Database Field: ERPx_ARTransactionHeader.CreatedDate

Created By

A non-editable text box to identify the name of the user that created the Transaction. It is formatted to be the "logged-in" users [User First Name] + [User Last Name]. This is a system assigned value and is never editable by a user. 

Linked Database Field: ERPx_ARTransactionHeader.CreatedBy

CustomerSK

A non-editable text box to identify the SK value of the Customer on the Transaction. This is a looked-up value, that is primarily used for support.

Linked Database Field: ERPx_ARTransactionHeader.CustomerSK

GL Date

The date the transaction posted (or will post) to the general ledger. If unassigned when the transactions Status is changed to "Approve" or "Ready to Post", it will default from the Transaction Date. To Approve or Post, the GL Date must be in a valid period that is open for posting. If not the message, "The Fiscal Period is not open." will be displayed on Save.

For Payment Receipts only, If blank, the value will be automatically updated as follows:

  • For Receipts in the Home Currency -  updated to the 'Receipt Date' on Approve or Ready to Post.
  • For Receipts NOT in the Home Currency, that have not been applied -  updated to the 'Receipt Date' on Approve or Ready to Post.
  • For Receipts NOT in the Home Currency, that have been applied -  updated to the 'Receipt Date' on application

The GL Date must be >= the 'Receipt Date'. If not, the message "GL Date must be >= the Receipt Date." will be displayed on Save. The GL Date must fall within a Fiscal Period that is open for Sales. If not, the message, "The Fiscal Period is not open." will be displayed on Save.

Linked Database Field: ERPx_ARTransactionHeader.GLDate

Last Updated

A non-editable text box to identify the Last Updated Date & Time of the Transaction, formatted from the users 'Date Format' preference. This is a system assigned value and is never editable by a user. 

Linked Database Field: ERPx_ARTransactionHeader.LastUpdated

Last Updated By

A non-editable text box to identify the name of the user that last updated the Transaction. It is formatted to be the "logged-in" users [User First Name] + [User Last Name]. This is a system assigned value and is never editable by a user. 

Linked Database Field: ERPx_ARTransactionHeader.LastUser

Receipt Currency

A non-editable text box to identify the currency of the receipt. Receipts may not always be in the same currency as the Checkbook.

Linked Database Field: ERPx_ARTransactionHeader.CurrencySK

Transaction ID

A non-editable text box to identify the Transaction #. This is a system assigned value that is not editable by a user.

Linked Database Field: ERPx_ARTransactionHeader.TransactionID

TransactionSK

Identifies the SK value of the transaction. This is a looked-up value, that is primarily used for support.

Linked Database Field: ERPx_ARTransactionHeader.TransactionHeaderSK

MC: Exchange Date

This field is used to convert the transaction total 'Receipt Amount' to the 'Home Currency' amount.

This is a non-editable text box to show the date range of the 'Rate' (Exchange Rate) on the 'Exchange Table' being used to convert the 'Receipt Amount' to the 'Home Currency' amount. This is only displayed and required when the Receipt currency is not in the 'Home Currency'.

This is looked-up using the 'Receipt Date', not the 'GL Date'. This is displayed as: From [Rate From] to [Rate to]. For example, "From 10/01/19 to 10/07/19". The date values are formatted based on the User Preference for 'Date Format'.

This value is a looked up from the 'Exchange Table' and not stored in the database while the transaction is in a Status of "New". When the Status is changed to either "Approved" or "Ready to Post" the value is updated and written to the database. For posted transactions, this is the value that existed when the transaction posted.

MC: Exchange Rate

This field is used to convert the transaction total 'Receipt Amount' to the 'Home Currency' amount.

This is a non-editable text box to show the 'Calculation Method' and 'Rate' being used to convert the 'Receipt Amount' to the 'Home Currency' amount. This is only displayed and required when the Receipt's currency is not in the 'Home Currency'. It is set as follows:

  • If the 'From Currency' on the Exchange Table matches the Receipt currency, then the 'Calculation Method' will default from the 'Calculation Method' on the Exchange Table.
  • If the 'From Currency' on the Exchange Table matches the 'Home Currency', the 'Calculation Method' will be the opposite as it is on the Exchange Table.

This is formatted as: [Calculation Method] by [Rate]. For Example, "Multiply by 1.0250" or "Divide by 1.0250".

This value is a looked up from the 'Exchange Table' and not stored in the database while the transaction is in a Status of "New". When the Status is changed to either "Approved" or "Ready to Post" the value is updated and written to the database. For posted transactions, this is the value that existed when the transaction posted.

MC: Exchange Table

This field is used to convert the transaction total 'Receipt Amount' to the 'Home Currency' amount.

This is a non-editable text box that displays the 'Exchange Table ID' used to convert the 'Receipt Amount' to the 'Home Currency' amount. This is only displayed and required when the Receipt's currency is not in the 'Home Currency'.

This is assigned as the first Exchange Table containing both the 'Home Currency' and the foreign currency assigned to the Receipt, with a valid 'Rate' (exchange rate) for the 'Receipt Date'. If there are no Rates that cover the 'Receipt Date' then the last Rate will be used. If there are no Exchange Tables containing both the 'Home Currency' and the foreign currency then this will be blank and the message "A valid exchange does not exist between [ReceiptCurrencyID] and [HomeCurrencyID]." will be displayed on Save after the Status is changed to Approve and/or Ready to Post.

This value is a looked up from the 'Exchange Table' and not stored in the database while the transaction is in a Status of "New". When the Status is changed to either "Approved" or "Ready to Post" the value is updated and written to the database. For posted transactions, this is the value that existed when the transaction posted.

MC: Currency Conversion

This field is used to convert the transaction total 'Receipt Amount' to the 'Home Currency' amount.

This is a non-editable text box that displays the currencies on the 'Exchange Table' being used to convert the 'Receipt Amount' to the 'Home Currency' amount. This is formatted as: "From [Receipt Currency] to [Home Currency]". This is only displayed and required when the Receipt's currency is not in the 'Home Currency'.

This value is a looked up from the 'Exchange Table' and not stored in the database while the transaction is in a Status of "New". When the Status is changed to either "Approved" or "Ready to Post" the value is updated and written to the database. For posted transactions, this is the value that existed when the transaction posted.

MC: Home Currency Amount

This field is used to convert the transaction total 'Receipt Amount' to the 'Home Currency' amount.

This is a non-editable text box that displays the Receipt Amount converted to the Home Currency. This is only displayed and required when the Receipt's currency is not in the 'Home Currency'.

This value is a looked up from the 'Exchange Table' and not stored in the database while the transaction is in a Status of "New". When the Status is changed to either "Approved" or "Ready to Post" the value is updated and written to the database. For posted transactions, this is the value that existed when the transaction posted.

Related Topics



 Page Definitions

Page Definitions


 Technical Details

Technical Details