AP Bills with Retainage: Configuration of the Default Retainage Settings

In this topic, you will read about how to set the preference settings related to retainage, configure classes for vendors who retain amounts on bills, and configure particular vendors (and vendor locations) that retain amounts on bills.

General Retainage Settings

In the Retainage Settings section on the General tab of the Accounts Payable Preferences (AP101000) form, you can do the following:

  • To retain taxes calculated on the retained amount, you select the Retain Taxes check box. The system calculates and reports the taxes of the bills with retainage and retainage bills separately. You then need to specify the tax accounts to be debited by the amounts of retained taxes, as described in the Configuration of Taxes section.

    If this check box is cleared, the full tax amount is paid on the bill with retainage.

  • To direct the system to automatically release retainage bills that you create on the Release AP Retainage (AP510000) form, you select the Automatically Release Retainage Documents check box.

To be able to track retainage by document lines, enable the Payment Application by Line feature on the Enable/Disable Features form.

To affect the generation of retainage bills on the Release AP Retainage (AP510000) form, in the Data Entry Settings section on the General tab of the Accounts Payable Preferences (AP101000) form, you can specify the following setting:

  • Clear the Hold Documents on Entry check box to direct the system to automatically remove retainage bills from hold as soon as they are created. With this check box cleared, retainage bills will get the Pending Approval status if approvals are set up in your system for the Bill document type, or the Balanced status if approvals are not used.
  • Select the Hold Documents on Entry check box to direct the system to generate retainage bills with the On Hold status, irrespective of whether approvals are set up.

Configuration of Vendor Classes

If your company works with bills with retainage, you can specify for a vendor class the default retainage payable account and subaccount (if applicable) to record the money that you withheld from the bills associated with the vendors of this class. You specify the account and subaccount in the Retainage Payable Account and Retainage Payable Sub. boxes, respectively, on the GL Accounts tab of the Vendor Classes (AP201000) form.

If you have specified the default account and subaccount for a vendor class, for vendors of the class, the system inserts these values into the Retainage Payable Account and Retainage Payable Sub. boxes, respectively, on the GL Accounts tab of the Vendors (AP303000) form for newly added vendors.

To apply retainage to all bills of vendors created and assigned to a particular vendor class, you select the Apply Retainage check box in the Default Financial Settings section on the General tab of the Vendor Classes form. That is, the Apply Retainage check box will be selected for such vendors on the Vendors (AP303000) form.

To apply payments to individual lines of AP bills with retainage for vendors belonging to a particular vendor class, you can select the Pay by Line check box in the Default Financial Settings section on the General tab of the Vendor Classes form. If a vendor assigned to this class is selected on the Bills and Adjustments (AP301000) form, the Pay by Line check box in the Default Payment Info section on the Financial tab of this form is selected by default.

Configuration of Particular Vendors

For each particular vendor for which your company needs to retain a certain amount of each bill total, you can specify default settings as follows on the General tab of the Vendors (AP303000) form:

  • If your company usually retains an amount on bills, you select the Apply Retainage check box in the Retainage Settings section of the General tab. If this check box is selected, the Apply Retainage check box is selected by default for the bills of the vendor on the Bills and Adjustments (AP301000) form. If this check box is cleared for the vendor, the Apply Retainage check box is cleared for the bills of the vendor on the Bills and Adjustments form.
  • If the Apply Retainage check box is selected, to specify the default percent to be retained from the amount of the bill document lines of the vendor, you specify the percent in the Retainage Percent box in the same section. The system enters this percent for bills of the vendor in the Default Retainage Percent box on the Retainage tab on the Bills and Adjustments form, and this percent is automatically applied to all lines on the Details tab.
  • If you want to apply payments to individual lines of AP bills with retainage for a particular vendor, you can select the Pay by Line check box in the Default Payment Settings section on the Payment Settings tab of the Vendors form. If the vendor is selected on the Bills and Adjustments form, the Pay by Line check box in the Default Payment Info section on the Financial tab of this form is selected by default.

If no Retainage Payable account and subaccount (if subaccounts are used in your system) are specified for the class to which the vendor is assigned, you can specify the account and subaccount in the Retainage Payable Account and Retainage Payable Sub. boxes, respectively, on the GL Accounts tab of the Vendors form. This account and subaccount you specify will be used to record the amount that your company retains from the vendor bills.

If the system has inserted the Retainage Payable account and subaccount (if applicable) specified for the vendor class to which the vendor is assigned, you can override the default account and subaccount of the class in the Retainage Payable Account and Retainage Payable Sub. boxes, respectively.

The default values provided for the vendor can be overridden for a particular bill.

Configuration of a Particular Vendor Location

Note: You can create and configure multiple vendor locations only if the Business Account Locations feature is enabled on the Enable/Disable Features (CS100000) form.

For the default location, the Retainage Payable account and subaccount (if applicable) are those you have specified for the vendor. If a vendor has multiple locations, each non-default location has the same the Retainage Payable account and subaccount that were specified for the default location if the Same As Default Location's check box is selected on the GL Accounts tab of the Vendor Locations (AP303020) form. If you need to override the account and subaccount of a particular non-default location, clear the Same As Default Location's check box.

The accounts specified for the vendor location selected in a bill will be used by default to post retainage entries. The default values provided for the vendor location can be overridden for a particular bill.

Configuration of Taxes

If the taxes calculated on the retained amount are also retained—that is, if the Retain Taxes check box is selected on the Accounts Payable Preferences (AP101000) form,—you have to specify the accounts for retained taxes. To do so, on the GL Accounts tab of the Taxes (TX205000) form, you specify the tax claimable account and subaccount in the Retainage Tax Claimable Account and Retainage Tax Claimable Subaccount boxes, respectively. This account and subaccount will be debited by the tax applied to the retained amount.

The taxes from retainage documents are posted to tax accounts under the non-project code (X by default).

Posting of Retained Sales Taxes

When a sales tax is applied to an accounts payable document with retainage and tax retainage is set up, on release of original and retainage bills, sales tax amounts are posted to the general ledger accounts as follows:

On release of the original bill:

  • The total sales tax amount for a bill line is debited to the tax expense account (specified for the tax in the Tax Expense Account box of the GL Accounts tab of the Taxes (TX205000) form).
  • The retained tax amount is credited to the retainage payable account (specified in the Retainage Payable Account box on the Financial Details tab of the on the Bills and Adjustments form).

On release of the retainage bill: The retained sales tax amount is debited to the retainage payable account and credited to the accounts payable account (specified in the AP Account box on the Financial tab on the Bills and Adjustments (AP301000) form).

Posting of Retained Use Taxes

When a use tax is applied to an accounts payable document with retainage and tax retainage is set up, on release of original and retainage bills, use tax amounts are posted to the general ledger accounts as follows:

On release of the original bill:
  • The total use tax amount for a line is debited to the tax expense account (specified for the tax in the Tax Expense Account box on the GL Accounts tab of the Taxes (TX205000) form).
  • The use tax amount that is not retained is credited to the tax payable account (specified for the tax in the Tax Payable Account box on the GL Accounts tab of the Taxes form).
  • The retained use tax amount is credited to the retainage tax payable account (specified for the tax in the Retainage Tax Payable Account box on the GL Accounts tab of the Taxes form).

On release of the retainage bill: The retained use tax amount is debited to the retainage tax payable account and credited to the tax payable account.