Expense Contracts
Applicable Packages This article applies to the Kahua for K-12 Education, Kahua for Owners, Kahua for General Contractors, and Kahua for Subcontractors packages. If you are not sure if this is relevant to you, please contact your domain administrator.
Notice Kahua is a very flexible and customizable platform. In your domain, this application may have been modified to meet your company's needs. The online help uses default field labels for field names and describes standard workflows. Please check with your domain administrator for specific information about working in your organization's domain.
Expense Contracts are contracts that track costs associated with a construction project. You can track associated items, such change orders and pay requests, in their own apps.
Key elements of the Expense Contracts app are as follows:
-
Contracts created in the Expense Contracts app will display in the Work Breakdown app. The column the contracts appear in will differ depending on its status.
-
You can set up Master Service Agreements if that is appropriate for your project. For more information, refer to Master Service Agreements (MSA) .
How to . . .
To create a new contract, complete the following steps:
-
Review the header to ensure that you are in the correct project or partition.
-
Navigate to the Expenses > Contracts app (Apps > Cost Management > Expenses > Contracts).
-
Click New in the action bar.
Note If Master Service Agreements (MSAs) are enabled, New with MSA will be available from the New menu. For more information on setting up contracts with an MSA, refer to Link an expense contract to the MSA.
-
Complete the following fields as appropriate:
Note Depending on how this app is configured for your domain, there may be fields or sections listed here that do not appear for you, fields and sections that appear for you which are not listed here, or fields and sections which appear in a different order. If you have any questions, check with your domain administrator.
Field Description Details Number Allow Kahua to auto-number the record, or enter a different value.
Note The number format can be configured by your domain administrator. Refer to Application configuration.
Date Select the appropriate contract date. Description Enter a brief description. Use SOV Breakdown Select this option to use the schedule of values breakdown. Associate Change Order Lines to Contract Lines Select this option allow funds from a change order to be directly added to or subtracted from the line items on a contract.
Master Services Agreement If using, select the appropriate Master Services Agreement (MSA) to associate with this contract.
Note An administrator must enable MSAs in configuration for this field to appear. Refer to Expense Contracts.
For more information on MSAs, refer to Master Service Agreements (MSA) .Work Package If desired, select the appropriate work package. For more information, refer to Work Packages.
Type Select the contract type.
Note This lookup list is managed in the Configuration app. Refer to Lookups.
View Template If appropriate, select a portable view template other than the default here.
Note For more information on portable views, refer to Portable Views.
Parties From Contact / From Company / From Company Office Select the appropriate contact from the company issuing the contract. The From Company and From Company Office fields will auto-populate once the From Contact has been selected. Modify as needed.
To Contact / To Company / To Company Office Select the appropriate contact from the company the contract is being issued to. The To Company and To Company Office fields will auto-populate once the To Contact has been selected. Modify as needed.
To Contract Signer Select the contract signer. Certifications If the To Company has certifications that should be tracked with the contract, select those here.
Note Certifications are managed on the company record in the Contacts > Companies app. Refer to Certifications.
Scope Not to Exceed Amount If appropriate, enter the contract's Not to Exceed value here. Scope of Work Enter the scope of work. Addenda / General Provisions Enter this information as appropriate. Work Completed Retainage % / Stored Material Retainage % Enter work completed and stored material retainage percentages.
Note Retainage is the percent of each payment that is withheld until the end of the project or other agreed upon milestone.
Liquidated Damages? Select this option if Liquidated Damages are part of the contract.
Once selected, the following fields appear. Complete as appropriate:
-
Liquidated Damages Start Date
-
Liquidated Damages Per Day
-
Liquidated Damages Not to Exceed Amount
Number of Pages Enter the number of contract pages. Notes Enter any additional notes as desired. Dates & Workflow If using the available workflow options (see Submitting into Workflow), most of the date fields will auto-populate as the contract moves through the workflow. The remainder can be completed manually.
Items Currency If using multi-currency, this field will appear and auto-populate with the currency set for the project. Modify as needed.
Note Currency for a project is managed on the Currency tab in the Configuration app. Refer to Currency.
Status Select the status. Entry Type Select the appropriate value:
-
Unit Price
-
Total Value
-
Unit Price Calculated
-
Lump Sum
For more information on working with grids, refer to Item Grids. Number This field auto-populates and is read only. Activity Code Select the appropriate activity code. Cost Item Type / Item Category Select the appropriate values. Description Enter a description of the item.
Note If Default Description to Activity Code Description is selected in Configuration, the activity code description will be applied by default but can be edited.
Tax Rate This field auto-populates and is read only.
Note This field displays when the Separate Line Item Tax Type is selected.QTY / UOM / Unit Price If the Entry Type is set to "Unit Price" or "Unit Price Calculated", the QTY (Quantity), UOM (Unit of Measure), and Unit Price fields will appear.
Status The status of the line item appears here. Total The total amount for the line item is entered here. Currency If multi-currency has been configured, available currencies can be selected here.
For more information on working with grids, refer to Item Grids. Currency This field will auto-populate with the currency set for the project. Modify if needed.
Note Currency for a project is managed on the Currency tab in the Configuration app. Refer to Currency.
Status Select the status. Entry Type Select the entry type. Tax Type Select the tax type. Number This field auto-populates and is read only. Activity Code Select an activity code. Cost Item Type Select the cost item type. Description This field will auto-populate once an activity code is selected. Modify if appropriate. Tax Rate / Is Manual / Taxable Make the appropriate selections.
Note These fields appear when the "Separate Line Item" Tax Type is selected.Status Select the appropriate status. Total Enter the total value of the line item. Reviewers Reviewer information appears here.
Note To use the review workflow, the Use Review Workflow setting must be enabled on the Settings tab in configuration and the approval must be configured in Configuration > Approvals. Refer to Approval configuration.
Signatures Signature information appears here.
Note To use the signature workflow, the Use Signature Workflow setting must be enabled on the Settings tab in configuration and the approval must be configured in Configuration > Approvals. Refer to Approval configuration.
Comments New Comment Enter any appropriate comments.
Note Comments are threaded. The author name and the time and date it was posted will auto-populate once the contract has been saved.Exhibits Select Upload to upload exhibit documents from your computer, or Add to add exhibit documents from the Exhibits app. For more information, refer to Exhibits.
References Upload or select any relevant files or documents. You can use drag and drop to add a file to this section. For more information on using this section, refer to References section.
-
-
Click Save when you are done.
-
Once the contract is saved you can complete the following actions:
Note These are dependent on workflow and may not show up for you. For information on setting up workflows see Submitting into Workflow.-
Void
-
Submit for Review
-
Submit for Signature
-
Set to...
-
Projected
-
-
Pending
-
Approved
-
Approved & Lock
-
You can generate a report from a selected log view, or use one of the built-in reports available by default in each application. For more information on creating your own reports, including how to set up scheduled reports, refer to Creating ad hoc reports.
Note For information on modifying the logo that appears on reports in your project, refer to Managing report logos.
To generate a report from a log view with up to 10,000 records, select the report icon
. If your log view contains more than 10,000 records, the report icon will be disabled and you can select to download the records to a CSV file instead. For more information, refer to Generate a report from a log view.
To generate an application report, complete the following steps:
-
Navigate to the application.
-
Select Reports in the application title bar.
-
Select the report you want to run.
-
Apply any desired filters.
-
Select View or Download as appropriate. For more information, refer to Viewing Reports.
-
Click the Close icon
when you are done.
Your project may be configured to require an approval document as part of the approval workflow for records in this app. An approval document is created in the References section of a record. To create an approval document, select Add Approval Doc, name the document and select the appropriate supporting files. These files are then combined into a single PDF that can become part of the approval workflow.
For more detailed information on creating an approval document, refer to Create an approval document.
Note For information on setting up approvals, refer to Approval configuration.
Your domain administrator or another user with the appropriate permissions can configure the app in the Configuration application.
Important When working in the Configuration app, it is important to review the header and ensure that you are working at the correct level in the hierarchy, either the root domain or at a partition or project level.
Settings that you establish at the root domain or lower levels will inherit down the hierarchy until they are overridden. For more information on the hierarchical structure of Kahua, refer to Understanding the hierarchical structure of Kahua.
The Configuration app can be accessed directly through the apps list (Apps > Administration > Configuration), or by right-clicking on an application in the launch bar and selecting Configure. When you select Configure for an app from the launch bar, the detail view of the configuration page for that application opens automatically.
For general information about the Configuration app, including how to set up an approval workflow, refer to Configuration app.
For general information on configuring this app in Configuration, refer to Application configuration.
The following items are specific to this application:
| Options | Description |
|---|---|
| Settings tab | |
| Use Review Workflow |
Select this option to make the Review workflow available. Note You must also configure the Review approval in Configuration > Approvals. Refer to Approval configuration. |
| Use Signature Workflow |
Select this option to make the Signature workflow available. Note You must also configure the Signature approval in Configuration > Approvals. Refer to Approval configuration. |
| Use Manual Status Override |
Select this option to allow users with the appropriate permissions to use workflow action buttons to increment status of a record (to Pending, Approved, etc.). This option is typically used when workflow is not enabled. |
| Use Manual Approve & Lock | |
| Cost Status Read Only |
Select this option to have the cost status of the contract and line items appear as read-only. The fields cannot be manually edited. This requires the status field to be updated by only workflow or the selection of action items (e.g. Set to Pending, Set to Approved, etc.), depending on other cost configuration selections. |
| Default Description to Activity Code Description |
Select this option to have the activity code's description applied to the Description field of an item in a cost items grid. The activity code's description is applied as the default value, but it can be edited. |
| Use Master Service Agreements |
Select this option to enable fields related to Master Service Agreements (MSA) on contracts. For more information on using Master Service Agreements, refer to Master Service Agreements (MSA) . |
| Settings tab - Cost Unit Settings | |
| Default Entry Type | Select a default value. |
| Can View? | If selected, the Entry Type field is visible on the Items section. |
| Can Change? | If selected, the Entry Type field is editable. |
| Allow Item Entry Type Selection? | If selected, the Entry Type field appears in the grid for individual items. |
| Excluded Entry Types | Select entry types to remove them from the drop-down list. |
| Settings - Tax Settings | |
| Default Tax Entry Type | Select None or Separate Line Item. |
| Can View? | If selected, the Tax Type field is visible on the Items section. |
| Can Change? | If selected, the Tax Type field is editable. |
| Allow Manual Tax Entry? | |
| Set Taxable on New Items? | |
| Excluded Entry Types | Select tax entry types to remove them from the drop-down list. |






