Master Agreements

A master agreement is a type of contract, set at the project level, between a general contractor and a supplier to purchase goods or services later. A master agreement lets you set up the terms, conditions and pricing of a contract. You do not commit the value of the agreement until you write an associated contract or purchase order against it. For example, a master agreement could be an agreement to purchase services across multiple years of a contract. Instead of purchasing all the services now, you can write contracts for the services against the agreement as needed over the duration of the project. All transactions of the contract purchase order associated to the master agreement for visibility.

A master agreement is not a standard contract purchase order. Because you receive and pay against all the contracts and purchase orders associated to it, it is not necessary to create a goods receipt or payment term against a master agreement. These are made against the individual associated contracts.

Configuration

You configure a new contract type to be specific for master agreements. A contract type that is configured to be a master agreement can only be used as a master agreement.

Settings in the Contract type setup configuration in the organization settings (Settings > Contract> Configurations > Contract type configuration setup) let you indicate whether a contract type is a master agreement and, if so, whether to publish to the ERP system. For contract types that are not master agreements, you can indicate whether to allow association to the master agreement.

To configure a contract type as a master agreement, set the Is this a Master agreement toggle to Yes, and then indicate whether to publish to the ERP system. After the master agreement has been used, you can no longer change these settings. The master agreement tab is only shown in the register home page if there is one contract type that has the Is this a master agreement setting set to Yes.

When defining the required fields for the master agreement, it is best practice to set the Enable, Require for purchase order, and Lock after purchase order settings to Yes. A vendor is required by the ERP system. If you publish to an ERP system, you must enable the Vendor field and require it for a purchase order or publishing will fail. Other field requirements must match those of your ERP system's requirements, so you can successfully sync the master agreement to the ERP system.

For contract types that are not master agreements, you can indicate whether the contract type can be associated to a master agreement. A contract must be associated to a master agreement to be able to write contracts of that type from the master agreement. Set the Allow association to Master Agreement toggle to Yes to allow associations. Set the toggle to No if you do not want to be able to write contracts against the agreement.

Create a master agreement

You can use Contract to create and manage master agreements. The following steps walk you through the process of creating a master agreement.

Step by Step — Create a master agreement

Create a master agreement in Contract when you want to have an agreement about contract terms and pricing without having to commit the financial resources right away.

Master agreements are created on the Master agreements tab. You must have at least one contract type configured as a master agreement to see this tab.

  1. From the Contract >Master agreements tab, click the Add master purchase agreement icon. The Add master purchase dialog box opens.

  2. Complete the following fields in the dialog box:

    • Description

    • Type

    • Subtype

    • Effective date

    • Vendor

    • Storage location

    • Scope of contract

  3. Click Add. This brings you to the Master agreements Header tab, which is similar to the Header tab for a contract.
  4. Complete the header information, and then click Save.

You can now complete the remaining tabs as you would with a regular contract.

Master agreement tabs

Master agreements can have the following tabs, based on your master agreement contract configuration:

  • Header

  • Line items

  • Schedule of values

  • Vendor change order log

  • Back charges

  • Supporting documents

  • Workflow assignments

  • Sync log

  • Contract closeout

  • Associations

The Associations tab is unique to master agreements. The other tabs work the same as the Contracts tabs.

Contract totals icon

Click the Contract totals icon to display a slide-out panel that has a breakdown of the master agreement's totals.

The slide-out panel is similar to the Contract totals slide-out panel with the following exceptions:

  • A section for change orders shows the total amount of change orders, total amount of potential change orders, and the accrued liquidated damages.

  • The Received to date, Contract invoices, Submitted to date, Paid to date, Retained to date amounts, and percentages come from the contracts that have been associated to the master agreement and not from the master agreement itself.

See Contract creation for more information about the Contract totals slide-out panel.

Master agreement banner

The master agreement banner shows at the top of all pages in the master agreement to help you track the current value and associations.

The Current value is the amount of the master agreement. The remaining fields come from the contracts associated with the master agreement. For example, as you write associations to the master agreement, the Associations value increases.

The Remaining to buy field on the Associations and Vendor change order tabs is automatically calculated. The remaining to buy is the difference between the master agreement current value and the total associations current value.

Master agreement line items

The Line items tab lets you define the line items of the master agreement. These line items can be used when you add line items to an associated contract. You must have at least one line item to publish the master agreement.

The line items register is similar to the register for contract line items. The first line in the line item register of every master agreement is a default placeholder 0000 line item, where a net price can be manually entered. This line item is used to hold value that is not specifically applied to numbered line item. For example, if you add an associated contract or purchase order that already has a line item, the value of the associated line item will show in the 0000 line item progress viewset.

Contract line items can be reassigned to master agreement line items. All information, other than quantity, from the master agreement line are updated.

See Line items tab for information about line item details.

Publish a master agreement

After you have added one or more line items, you can publish the master agreement.

Step by Step — Publish a master agreement

When you publish the master agreement to the ERP system, the ERP system creates a master contract. You then write purchase orders against the master contract.

The master agreement must have at least one line item.

  1. Go to a master agreement.

  2. Click Publish master agreement. The master agreement is available for association. If Contract is configured to publish the master agreement to the ERP system, a master contract is created in the ERP system.

You can now associate contracts to the master agreement.

After the master agreements has been published, you can still update it. To update, enter your changes, and then click Save. The Update master agreement button is enabled. Click the button to update the master agreement.

Associations

The Associations tab lists all contracts that are associated to the master agreement. After a contract is associated with the master agreement, any purchase orders created from the contract go against the master agreement.

The values in the banner do not include tax. You can see tax values in the Total tax column on the Associations register. The tax amount is the sum of the Tax amount field in all line items for associated contracts. To see a break-down of all taxes that make up the total tax, hover over the information icon in the Total tax column.

You can associate a new or existing contract to a master agreement from the Associations tab. Bid package vendor flow to Master agreement vendor upon association.

You can download a purchase order from the Associations tab.

Step by Step — Add a new contract to a master agreement

You can create a contract and associate it to a master agreement in a single procedure.

You can use only those contract types that are allowed to be associated with a master agreement.

  1. From the Associations tab, click the Add contract icon, and then select New contract/purchase order. The Add contract dialog box opens.

  2. Enter information in the fields as you would with any contract. The contract type drop-down list includes only those contract types that are allowed to be associated with a master agreement. The Vendor field is disabled as is filled with the vendor name from the master agreement.

  3. Click Add. The contract Header page opens.

You can then add contract details with any other contract. See Line items tab for information about adding line items to an associated. contract.

Step by Step — Add an existing contract to a master agreement

Associate an existing contract to a master agreement

You can associate an eligible contract to a master agreement from the Associations tab.

Contracts are eligible when the contract type allows association with a master agreement and the vendor is the same as the vendor of the master agreement or has not been assigned.

  1. From the Associations tab, click the Add contract icon, and then select Existing contract/purchase order. The Add existing contract dialog box opens.

  2. Select a contract from the list of eligible contracts, and then click Add. The contract is added to the Associations register. If the contract had no vendor assigned, the vendor in the contract is updated to the vendor of the master agreement.

You can add line items from the master agreement. See Line items tab for information about adding line items to an associated contract.

Close out master agreement

When you no longer want contracts to be written against the master agreement, you can close it out. You can either close out the entire master agreement, which closes all line items, or you can close individual line items.

Step by Step — Close out master agreement

Close out a master agreement when you no longer want contracts to be written against it. Closing out the master agreement closes all of its line items. Any existing contracts associated with the master agreement remain open until they are closed.

You cannot add line items from a closed master agreement even if the contract is already associated to it.

  1. From the Details section on the Header page of the master agreement, change the Status field to Closed.

  2. Click Save. The Update master agreement button becomes the Closeout Master agreement button.

  3. Click Closeout Master agreement to close out the master agreement. The master agreement is removed from the Agreement ID drop-down list on the Contract header.

  4. Click Update master agreement to publish the closure to the associated contracts. The master agreement is no longer available for use.

Step by Step — Close out a master agreement line item

Close out a master agreement line item when the line item has run out of resources or for any reason you no longer want contracts written against the line item.

This function is recommended when the master agreement has multiple line items. If the master agreement only has one line item, it is best practice to close out the master agreement.

  1. From the line item details, change the value of the Status drop-down list to Closed.

  2. Click Save. The line item is no longer available in lists when you add a line item from a master agreement.