Create a Configurable PDF of a MC/Client Payment application in the Client Contracts Tool
Limited Release
The Client Contracts tool is available as a limited release for Procore customers in the United States who have implemented the Procore for Speciality Contractors point-of-view dictionary. To learn more, see What tool names and terms are different in Procore for main contractors, owners and speciality contractors?Objective
To create a customised PDF for a MC/Client payment application using the configurable PDF options.
Background
When working with a MC/Client payment application in Procore, the Detail tab and the Configurable PDF tab of the payment application show its line items. The Configurable PDF tab lets you customise the way line items display on a MC/Client payment application. With the features in this tab, you can group and summarise your payment application's data the way you want before presenting it to the MC you are billing.
In a Configurable PDF, a group is an object that organises payment application line items together. In Procore, the default groups are available in a Configurable PDF are Sub Job (if enabled), Division, Cost Code and Cost Type. You can also create custom groups that contain custom items to then apply those custom items to your PDF.
Examples
- How to Organise a Configurable PDF Using a Default Group
Let's assume your team created different sub jobs on a Procore project to represent different project phases (see Add 'Sub Job' Segment Items to a Procore Project). In this example, you want to create a configurable PDF that groups the line items on the MC/Client payment application into the appropriate project phase. Assuming you have created sub-jobs names 'Phase 1', 'Phase 2' and 'Phase 3', you can choose 'Sub Job', from the 'Add Group' drop-down list. You can then place all of the line items that have been classified as 'Phase 1', 'Phase 2' and 'Phase 3' into separate groups. - How to Organise a PDF Using a Custom Group
Let's assume your team uses its own system of customised billing codes. You can create a new group for the configurable PDF named 'Billing Group 1" to house your codes. Then you can create new items in the group to represent your bill codes. For example, 'Bill Code A', 'Bill Code B', 'Bill Code C' and so on. Once your group and codes are created, you can then apply the group to the configurable PDF and then assign your custom bill codes to the individual line items on the payment application.
Things to Consider
- Required User Permissions:
- 'Admin' level permissions on the project's Client Contracts tool.
- To view a configurable PDF on a client contract, 'Read Only' permission on the Client Contracts tool
- Additional Information:
- You can export a PDF copy of the Configurable PDF tab to share with the MC. See Export a Configurable PDF of a MC/Client Payment application from the Client Contracts Tool.
- You can email the Detail tab of a payment application. To learn more, see Email a MC /Client Payment application from the Progress Billings Tool.
Prerequisites
- Create a client contract. See Create Client Contracts.
- Add the BOQ line items to the client contract. See Update the Bill of Quantities on a Client Contract.
- Confirm that all parties to the client contract are in agreement prior to changing its status to 'Approved.' See Approve a Client Contract.
- Add a MC/Client payment application to the client contract. See Create a MC/Client Payment application for a Client Contract.
Steps
Manage Custom Groups
These steps show you how to navigate to the Manage Custom Groups window.
- Navigate to the project's Client Contracts tool.
- Locate the client contract associated with the MC/Client payment application containing the configurable PDF. Then click the Number link.
- Click the Payment Applications tab.
- Locate the payment application that you want to customise in the list. Then click View.
- Click the Configurable PDF tab.
- Open the Add Group drop-down list.
- Select any of the default groups in the list.
- Optional: Click Manage Custom Groups.
- In the Manage Custom Groups window, continue with:
- Add a New Group to the Add Group Menu
- Add Items to a Group
Add a New Group to the Add Group Menu
These steps show you how to create a custom group so it appears as an option in the 'Add Group' drop-down list in the Configurable PDF tab.
- In the Manage Custom Groups window, click Add Group.
- Type a label for the group in the Enter Group Name label box. Then press ENTER. Add as many groups as you want.
Note
- After you press ENTER, the system automatically saves the group name and adds it as a selection in the Add Group drop-down list on the Configurable PDF tab.
- To delete a group, click the (x) next to the group name to permanently remove it and any items associated with the selected group.
- Continue with the next step.
Add Items to a Group
These steps show you how to add bill codes to a custom group.
- In the Add Custom Groups window, locate the group that you want to add billing codes to.
- Click Add Item.
- In the Enter Item Name box, type a label for the code. Then press ENTER.
Note
- Add as many items as you want to each group.
- Click the Save button.
A GREEN 'Groups Saved' banner appears at the bottom of the page. - Continue with the next step.
Assign the Payment Application's Line Items to an Item in a Group
After you have created the groups and items that you want to use for your payment application, you can start organizing your line items so they appear as you want.
- Click the Configurable PDF tab.
- Place a tick next to the payment application line items that you want to assign to a custom item.
Note: This action changes the label on the 'Add Group' drop-down list to 'Edit.' - In the Edit drop-down list, select the group that contains the custom items that you want to assign to your payment application's line items.
- Click Save.
Tips
- Any payment application line items not assigned to a custom item in a group will appear in a section titled 'Unspecified [Billing Group Name]'. There is no option to remove that naming convention.
- If you do not want the 'Unspecified [Billing Group Name]' to appear on your payment application, it is recommended that you add an item named 'None' or 'Other' (or a term of your choice) to your group. Then assign your payment application's line items to that item in the group.