---
title: "Apply a Supplier Contract to Sales Quotes and Orders"
canonical: "https://kb.myframeworks.com.au/space/CO/490733604/Apply%20a%20Supplier%20Contract%20to%20Sales%20Quotes%20and%20Orders"
format: markdown
---
Apply negotiated supplier pricing to sales quotes or orders using the **Special Buy-in** feature, then create linked purchase orders to fulfill the order using the contracted pricing.

> 📝 ## Prerequisites
> 📝 
> 📝 - Supplier contract exists for the customer, branch and products you're adding to the quote or order.
> 📝 - SCP feature code is active.
> 📝 - Quote or order is open in Sales Order Maintenance.
> 📝 - Products with available contracts have been added to the quote or order.

## The Application Workflow

1. Open the quote or order in **Sales Order Maintenance**.
2. Add products to the quote or order.
3. [Identify products with available contracts](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/490733604/Apply+a+Supplier+Contract+to+Sales+Quotes+and+Orders#Identify-Products-with-Available-Contracts).
4. [Apply supplier contract pricing using Special Buy-in](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/490733604/Apply+a+Supplier+Contract+to+Sales+Quotes+and+Orders#Apply-Supplier-Contract-Pricing).
5. [Create a linked purchase order](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/490733604/Apply+a+Supplier+Contract+to+Sales+Quotes+and+Orders#Create-a-Linked-Purchase-Order) (if fulfillment required).

---

## Identify Products with Available Contracts

![image-20250526-231302.png](media://5f948733-1115-4ea9-a731-2b13b4823f5a)

Before applying contract pricing, verify which products have supplier contracts available.

### Steps

1. In the **Order Lines Grid**, locate the **Has Supplier Contract** column.
2. Products with available supplier contracts show an enabled (ticked) **Has Supplier Contract** checkbox.
3. Note which products have contracts available—these are the products you can apply special pricing to.

> ✅ **Tip:** If the **Has Supplier Contract** column is not visible, right-click the grid header and enable it from the column chooser.

---

## Apply Supplier Contract Pricing

![image-20250526-231457.png](media://8e8871c3-2e3f-48a7-b800-cc9754670c1d)

Use the Special Buy-in feature to apply the negotiated contract pricing to product lines.

### Steps

1. Click **Actions** in the top-right of the sales order screen.
2. From the **Actions** menu, select **Special Buy-in**.
3. In the **Special Buy-In** window, configure the pricing application:
  **Mode**
  - Select how the new sell price will be calculated from the contract cost:
    - **Pricing by Markup %** - Apply a markup percentage to the new cost.
    - **Pricing by GP %** - Calculate sell price to achieve a target GP percentage.
    - **Fixed Sell Pricing** - Enter a specific sell price directly.
  **Supplier Contract**
  - For **sales orders**: The **Supplier Contract** field automatically populates with a contract matching the customer and branch. The **New Cost** and **Rebated Cost** fields highlight in green to help you compare with **Current Costs**.
  - For **sales quotes**: Search for and select the appropriate supplier contract before the cost comparison fields appear.
  **Pricing Calculation** (depending on mode selected)
  - **Mark Up %** field: Enter the markup percentage to apply to the new cost (if using Pricing by Markup % mode).
  - **GP %** field: Enter the target GP percentage (if using Pricing by GP % mode).
  - **New Sell** field: Enter the fixed sell price (if using Fixed Sell Pricing mode).
4. Review the cost comparison:
  - **Current Cost**: The product's existing cost before applying the contract.
  - **New Cost**: The cost from the supplier contract.
  - **Rebated Cost**: The cost after any supplier rebates are applied (if configured).
5. Click **Save** to apply the contract pricing to the selected product lines.

### Pricing Mode Examples

**Pricing by Markup %:** If the new contract cost is $100 and you enter a 30% markup, the sell price becomes $130.

**Pricing by GP %:** If the new contract cost is $100 and you enter a 25% GP, the system calculates the sell price as $133.33 (to achieve 25% GP).

**Fixed Sell Pricing:** You enter the sell price directly (e.g., $125), and the system calculates the resulting GP based on the new contract cost.

---

## Create a Linked Purchase Order

![image-20250526-231531.png](media://d85711cd-9208-4c6d-8e05-258d3d1d471a)

After applying contract pricing, create a linked purchase order to fulfill the order using the contracted pricing.

### Steps

1. Click **Actions** in the top-right of the sales order screen.
2. From the **Actions** menu, select **Linked PO**.
3. In the **Sales Order Fulfilment** screen, configure the branch transfer or purchase order:
  **Supplier**
  - The **Supplier** field is pre-populated with the supplier from the contract.
  **Reference**
  - The **Reference** field automatically includes the contract's end date and supplier reference.
  - This information carries through to the purchase order lines for the supplier's reference.
  **Product Selection**
  - Enable the **Sel** checkbox for each product you want to add to the purchase order.
  - Only products with supplier contract pricing applied are typically selected here.
4. Click **Create Order** to generate the linked purchase order.
5. The system creates the purchase order and displays a confirmation with the PO number.
6. Send the purchase order to the supplier as required using your standard PO distribution process.

> ℹ️ ### Branch Transfers and Supplier Assignment
> ℹ️ 
> ℹ️ The **SOPRetBT** system flag controls supplier assignment behaviour when creating linked purchase orders from sales orders with supplier contracts applied:
> ℹ️ 
> ℹ️ - **If SOPRetBT is enabled:** When the current supplier is an internal branch, the supplier remains as the internal branch on the purchase order. The contract cost is still applied, but the supplier is not replaced. This allows you to track internal branch transfers separately while still using contract pricing.
> ℹ️ - **If SOPRetBT is disabled (default):** The supplier is replaced by the contract supplier when you create the linked purchase order. This is the standard behaviour for all suppliers, whether internal branches or external suppliers.
> ℹ️ - **For external suppliers:** Regardless of the SOPRetBT flag setting, the supplier is always replaced by the contract supplier when creating linked purchase orders.
> ℹ️ 
> ℹ️ **Why this matters:** If your business uses internal branch transfers as preferred suppliers and wants to maintain that supplier assignment while applying contract costs, enable the SOPRetBT flag. If you want contract suppliers to replace internal branch suppliers (standard behaviour), leave the flag disabled.

### What Gets Transferred to the Purchase Order

When you create a linked PO from a quote or order with supplier contract pricing:

- **Supplier**: The contract supplier is used.
- **Product costs**: The contract pricing is applied to the purchase order lines.
- **Reference**: The contract end date and supplier reference appear in the PO line reference field.
- **Quantities**: The order quantities are transferred to the PO.
- **Delivery requirements**: The required delivery date from the sales order is used.

## Result

The supplier contract pricing is applied to the quote or order product lines, updating the cost basis for margin calculations. If you created a linked purchase order, the PO is generated with the contract supplier, costs and reference details, ready to be sent to the supplier. The quote or order maintains the link to the purchase order for fulfillment tracking.

---

## Related Tasks

**Before this procedure:**

- [Understanding Supplier Contracts for Customers](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/492077058)
- [Create a Supplier Contract](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/492109836)

**Related procedures:**

- [Create a Sales Order](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30521804)
- [Create a Sales Quote](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30509150)
- [Edit a Sales Order](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30508114)
- [Linked Purchase Orders](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30523144)

**After this procedure:**

- [Send a Purchase Order to a Supplier](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30515616)
- [Receipt Purchase Orders](https://sterlandsupport.atlassian.net/wiki/spaces/CO/pages/30515486)

> ✅ ## Related Information
> ✅ 
> ✅ - [Sales Order Maintenance](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/28408932) (Layout and Field guide)
> ✅ - <u>[Supplier Contract Maintenance](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/28391886)</u> (Layout and Field guide)

> ⚠️ ## Additional Notes
> ⚠️ 
> ⚠️ **Quote vs Order behavior:** The **Supplier Contract** field auto-populates for sales orders but not for sales quotes. For quotes, you must manually search for and select the appropriate contract. 
> ⚠️ 
> ⚠️ **Multiple contracts available:** If multiple supplier contracts are available for the same product (e.g., one for the customer specifically, one for the branch generally), Frameworks displays the most specific contract first (customer-specific contracts take precedence over branch-wide contracts).
> ⚠️ 
> ⚠️ **No contract pricing applied:** If you create a linked PO without first applying a supplier contract via Special Buy-in, the PO will use the product's standard cost, not the contract cost. Always apply the contract first if you want the contracted pricing to flow through to the purchase order.
> ⚠️ 
> ⚠️ **Repricing after contract application:** If you need to change the markup or GP percentage after applying a contract, you can run Special Buy-in again with different pricing parameters. The contract cost will remain applied; only the sell price calculation method changes.