Skip to main content

Create a Commitment Variation


To create a commitment variation


In Procore, purchase orders and subcontracts are called commitments. A commitment is a contractual agreement between a buyer (for example,  a project owner, a main contractor or a speciality contractor) and a seller (for example, a contractor, a subcontractor or a vendor). The seller is responsible for completing project work or fulfilling an order for the buyer. When you need to alter the terms of the original agreement, you can create a commitment variation.


When the Change Events tool is enabled on a project

The process that you will use to create a commitment variation in Procore depends upon a few factors. First, if the Change Events tool is disabled on the project, you will use one of the processes below. Also, keep in mind that the number of steps required to create a commitment variation is dependent upon the variation tier setting that is configured on the project's Commitments tool. See Configure the Number of Commitment Variation Tiers:

  • 1-Tier configuration:
    1. Create a commitment variation as described below. 
  • 2-Tier configuration
    1. Create a commitment potential variation 
    2. Create a commitment variation

Things to Consider


Create a Commitment Variation

If you have created a purchase order or a subcontract and need to alter the terms of that item, use the steps below to create a commitment variation.

  1. Navigate to the project's Commitments tool.
  2. Under Contracts, locate the commitment. Then click Edit.
  3. Click Create Commitment VAR.

    If the Change Events tool is enabled on your project, the Create Commitment VAR button is not available. Follow these steps instead:

  4. In the General tab, do the following:
    • Sign with DocuSign®
      If you have enabled the Procore + DocuSign® integration (see Enable or Disable the DocuSign® Integration on a Procore Project), a tick appears in this box by default. If you do NOT want to collect signatures with DocuSign®, remove the mark.
    • Number
      This field automatically populates based on the number of variations already created. By default, the number will automatically increment by one. 
      How does Procore assign numbers to commitment variations? To learn more, see Can I customise the numbering system for financial objects in Procore?
    • Revision
    • Displays the variation's revision number. When a variation is first created, its revision number is zero. A variation could have multiple revisions because of feedback from a reviewer/approver. 
    • Date Created
      Automatically populates with the date that you create the commitment variation. The date cannot be changed.
    • Created By
      Automatically populates with the name of the user who is creating the variation. 
    • Contract Company
      Automatically populates with the name of the subcontractor or vendor listed on the subcontract. This field is only available for subcontracts.
    • Contract
      Automatically populates with the name of the contract for which the variation is being created. This field is only available for subcontracts.
    • Title
      Enter a name for the variation. The maximum character limit is 255 characters. 
      If you are using an integrated ERP system, the maximum character limit for the 'Title' field on a commitment is different for each system. For a list of each system and its limitation, see What is the maximum character length for a commitment's 'Title'?
    • Status
      Select a status for the variation. To learn more, see What are the default statuses for variations in Procore?
    • Private
      Mark this tickbox to make the variation visible only to users with 'Admin' level permissions on the Commitments tool. 
    • Change Reason
      Select one of these reasons for the potential variation: Client Request, Design Development, Allowance, Existing Condition or Backcharge. To learn how to configure change reasons, see Set Default Change Management Configurations.
    • Accounting Method
      This field inherits the accounting method that was specified in the contract.
    • Due Date
      Select a due date for when the variation must be approved by. 
    • Issued Date
      Select the date when the variation was issued.
    • Designated Reviewer
      Select the Procore project user at your organisation who will be responsible for approving or rejecting this variation later. See Approve or Reject Commitment Variations.
      • The 'Designated Reviewer' can submit an approve or reject response only when a variation is in the Pending - In Review status. 
      • To send an email notification to the 'Designated Reviewer' to notify that person that a variation is awaiting their response, you have these options:
        • You can forward the main contract variation to the 'Designated Reviewer' by email. See Forward a Variation to a Project User by Email
        • The pending variation will also be listed in the 'My Open Items' area in the project's Home page. The user can check this page at any time. 
      • After the 'Designated Reviewer' submits an approve or reject response, the 'Reviewer' field (directly below the 'Designated Reviewer' field) shows the date/time stamp of that users response. The 'Reviewer' field is only visible to the 'Designated Reviewer.'
    • Request Received From
      Select a user from the project's directory who you are submitting the variation on the behalf of. 
    • Description
      Enter a detailed description of the variation.
      • If you are exporting the variation to Sage 300 CRE® and Integration by Ryvit, entries exceeding one thousand (1000) characters will be truncated during the export. 
      • If you will be exporting the variation to a different integrated ERP system, you can to enter an unlimited number of characters in Procore.
    • Programme Impact
      If known, you can provide an estimate of the number of additional days that would potentially be added to the current project programme if the variation were approved.
       In Beta
      Note to users participating in the 'Subcontractor Estimated Completion' limited release beta program. When a user places a variation in the 'Approved' status and it includes a value in 'Schedule Impact' field of the variation, Procore automatically updates the 'Estimated Completion Date' field in the commitment contract by the number of days entered. To learn more about this programme, see Commitments: (Beta) Subcontractor Estimated Completion Date.
    • Location
      Use the location drop-down menu to select a location the [item] impacts. Either select from the predefined locations or add a multi-tiered location. See Add a Multi-tiered Location to an Item. This location may be as general as the site location at the first tier or as specific as where on the site the contractor will be working at the second tier.
    • Reference
      Reference any other tools, materials or documents that are related to the variation.
    • Executed
      Mark this tickbox if the variation has already been executed.
    • Field Change
      Mark this tickbox if the variation requires a field change.
    • Paid in Full
      Mark this tickbox if the cost is already covered in the budget.
    • Attachments
      Select and add any relevant documents.
  5. Click Create or Create & Email to send the variation to any users listed as 'Reviewers'. 

Add a Bill of Quantities (BOQ) to the Variation

If there are costs associated with the variation, add line items to the variation's Bill of Quantities (BOQ). add-commitment-schedule-of-values.png

  1. Click the Bill of Quantities tab.
  2. Click Edit.
  3. Click Add Line
    • Main Contract Line Item
      Select a line item from the drop-down list. If there is no line item that fits, select Not Budgeted
    • Change Event Line Item
      Select a change event line item from the drop-down list. 
    • Sub Jobs
      If the Sub Jobs feature is enabled on your project, select one from the list. See Enable Sub Jobs on Projects for WBS.
    • Budget Code
      Select a budget code from the drop-down list. See What is a budget code in Procore's WBS? 
    • Description
      Type a description for the new variation. 
    • Cost Amount
      Enter an amount in the box. 
    • Optional: Tax Codes
      If you are using tax codes with this project, select a tax code to use for the line item.
      Don't see the Tax Codes field? This field only appears when the tax codes feature is enabled on the Procore project. See How can I use tax codes on a project?
  4. Click Add
  5. Repeat these steps for each line item. 
  6. Click Save.

For Companies That Have Enabled the ERP Integrations Tool

After the commitment variation is placed into the 'Approved' status in the Commitments tool, project managers will typically send the variation to the ERP Integrations tool where it must be accepted by an accounting approver for export to the integrated ERP system. For instructions, see Send a CV to ERP Integrations for Accounting Acceptance

See Also