Price Book Items

Introduction

A price book item is a billable item in a price book, such as labor or a service.

FieldFX’s Price Book Builder functionality has been deprecated.

Deprecated item Alternative
Configure the FX Item Picker Lightning Component

Use the Price Book Builder to add price book items.

When you add a price book item, you can add the item to:

Prerequisites

To setup and use price book items, you need to:

Have these user licenses Have these permissions Complete these tasks
and review these topics
before continuing

Relationship with Catalog Items

A Price book item must be linked to a catalog item.

You normally add one price book item for a catalog item per price book. You can also add multiple price book items for a catalog item if they are child items in the same package.

Copy Data to Price Book Items

When you add a price book item, data copies from the linked catalog item to the price book item.

Data copies between the following managed fields by default:

Catalog Item Field Price Book Item Field

FX5__Breadcrumb__c

FX5__Breadcrumb__c

FX5__COGS_Account__c

FX5__COGS_Account__c

FX5__Cost__c

FX5__Catalog_Cost__c

FX5__Description__c

FX5__Catalog_Description__c

FX5__Income_Account__c

FX5__Income_Account__c

FX5__Ticket_Item_Record_Type__c

FX5__Ticket_Item_Record_Type__c

FX5__UOM__c

FX5__Catalog_UOM__c

Name

FX5__Catalog_Item_Code__c

You can add custom fields to copy additional information between catalog items and price book items.

Make sure custom fields have the same name, data type, length, and decimal places on both the Catalog Item and Price Book Item objects.

Relationship with Quote Items

You can add price book items to a quote from the:

Copy Data to Quote Items

When you add a price book item to a quote, data copies from the price book item to the quote item.

Data copies between the following managed fields by default:

Price Book Item Field Quote Item Field

FX5__Catalog_Cost__c

N/A

To copy data from the FX5__Catalog_Cost__c field to quote items, add a custom field named Cost__c to the Quote Item object.

FX5__Catalog_Description__c
FX5__Description_Override__c

If you don’t make an entry in the FX5__Description_Override__c field,
quote items inherit their description from the FX5__Catalog_Description__c field
in the price book item.

FX5__Description__c

FX5__Catalog_UOM__c

FX5__Catalog_UOM__c

FX5__Default_Quantity__c

FX5__PBI_Default_Quantity__c

FX5__Discount_Percent__c

FX5__Discount_Percent__c

FX5__Enable_Dynamic_Parenting__c

FX5__PBI_Enable_Dynamic_Parenting__c

FX5__Included_Quantity__c

FX5__PBI_Included_Quantity__c

FX5__Locked_Description__c

FX5__PBI_Locked_Description__c

FX5__Locked_Discount__c

FX5__PBI_Locked_Discount__c

FX5__Locked_Price_Markup__c

FX5__PBI_Locked_Price_Markup__c

FX5__Maximum_Quantity__c

FX5__PBI_Maximum_Quantity__c

FX5__Minimum_Charge__c

FX5__PBI_Minimum_Charge__c

FX5__Minimum_Quantity__c

FX5__PBI_Minimum_Quantity__c

FX5__Parent_Price_Book_Item__c

FX5__Parent_Quote_Item__c

FX5__Price__c

FX5__Price__c

FX5__Pricing_Method__c

FX5__PBI_Pricing_Method__c

FX5__Required_Item__c

FX5__PBI_Required_Item__c

FX5__Requires_Parent_Item__c

FX5__PBI_Requires_Parent_Item__c

FX5__Sequence_Number__c

FX5__Sequence_Number__c

FX5__Surcharge_Env__c

FX5__PBI_Surcharge_Env__c

FX5__Surcharge_Fuel__c

FX5__PBI_Surcharge_Fuel__c

FX5__Ticket_Item_Record_Type__c

RecordType

You can add custom fields to copy additional information between price book items and quote items.

Make sure custom fields have the same name, data type, length, and decimal places on both the Price Book Item and Quote Item objects. * Fields prefixed with Locked are boolean fields that, when True, prevent the related field from being edited. * You can add your own custom locking fields to price books.

Relationship with Ticket Items

You can add price book items to a ticket from the:

Copy Data to Ticket Items

When you add a price book item to a ticket, data copies from the price book item to the ticket item.

Data copies between the following managed fields by default:

Price Book Item Field Ticket Item Field

FX5__Catalog_Cost__c

FX5__Cost__c

FX5__Catalog_Description__c
FX5__Description_Override__c

If you don’t make an entry in the FX5__Description_Override__c field,
quote items inherit their description from the FX5__Catalog_Description__c field
in the price book item.

FX5__Description__c

FX5__Catalog_UOM__c

FX5__Catalog_UOM__c

FX5__COGS_Account__c

FX5__COGS_Account__c

FX5__Cost_Plus_Markup_Amount__c

FX5__Cost_Plus_Markup_Amount__c

FX5__Cost_Plus_Markup_Percent__c

FX5__Cost_Plus_Markup_Percent__c

FX5__Default_Quantity__c

FX5__PBI_Default_Quantity__c
FX5__Input_Qty__c

FX5__Discount_Percent__c

FX5__Discount_Percent__c

FX5__Enable_Dynamic_Parenting__c

FX5__PBI_Enable_Dynamic_Parenting__c

FX5__Included_Quantity__c

FX5__PBI_Included_Quantity__c

FX5__Income_Account__c

FX5__Income_Account__c

FX5__Locked_Description__c

FX5__PBI_Locked_Description__c

FX5__Locked_Discount__c

FX5__PBI_Locked_Discount__c

FX5__Locked_Price_Markup__c

FX5__PBI_Locked_Price_Markeup__c

FX5__Maximum_Quantity__c

FX5__PBI_Maximum_Quantity__c

FX5__Minimum_Charge__c

FX5__PBI_Minimum_Charge__c

FX5__Minimum_Quantity__c

FX5__PBI_Minimum_Quantity__c

FX5__Parent_Price_Book_Item__c

FX5__Parent_Ticket_Item__c

FX5__Price__c

FX5__Price__c

FX5__Pricing_Method__c

FX5__PBI_Pricing_Method__c

FX5__Required_Item__c

FX5__PBI_Required_Item__c

FX5__Required_Parent_Item__c

FX5__PBI_Requires_Parent_Item__c

FX5__Sequence_Number__c

FX5__Sequence_Number__c

FX5__Standby_Price__c

FX5__Standby_Price__c

FX5__Surcharge_Env__c

FX5__PBI_Surcharge_Env__c

FX5__Surcharge_Fuel__c

FX5__PBI_Surcharge_Fuel__c

FX5__Ticket_Item_Record_Type__c

RecordType

Price Book Item Field

Ticket Item Field

You can add custom fields to copy additional information between price book items and ticket items.

Make sure custom fields have the same name, data type, length, and decimal places on both the Price Book Item and Ticket Item objects.

Record Types

When you add a price book item record type, you must also add the record type to:

  • The Catalog Item object.

  • The Ticket Item Record Type picklist on the Catalog Item object.

  • The Quote Item object.

  • The Ticket Item object.

Parent and Child Items

A parent item has a master-detail relationship with one or more child items.

A child item can only have one parent and cannot be the parent of another item.

You can use parent and child items to bundle related items together on quotes and tickets.

Example

Add a kit for the 20K Hydroblasting service that includes equipment, labor, service, and supply price book items.

Create Parent-Child Relationships

There are two ways to create parent-child relationships between items:

Static Parenting

Use Static Parenting to create parent-child relationships at the price book level.

To set up this feature, complete the following for desired child items:

  • Select Requires Parent Item

  • Select a Parent Price Book Item

You can then add parent items to quotes and tickets and their child items will get added automatically.

Dynamic Parenting

Use Dynamic Parenting to create parent-child relationships on the fly.

To set up this feature, complete the following for dynamic parent items:

  • Select Enable Dynamic Parenting

You can then add child items to dynamic parent items when adding quotes/tickets.

The child items cannot be parents of other items.

How to Use Parent and Child Items

You can add, view, or delete items.

Add Items

When you add a parent item to a quote or ticket, any designated child items also get added.

You can’t add designated child items to quotes or tickets.

When you add a dynamic parent to quote or ticket, you can then add child items to it.

View Items

Parent and child items display grouped together, with child items indented under the parent.

Example 1. A ticket item list in FieldFX Mobile with parent and child items

The Ticket Item grid groups parent and child items together.

Screenshot of a ticket item grid in FieldFX Mobile with parent and child items
Figure 1. In FieldFX Mobile, child items of a parent in a ticket item list are grouped together and indented under the parent item.

Delete Items

When you delete a parent item, any child items also get deleted.

When you delete a child item, only that item gets deleted.

Price Book Constraints

A price book constraint is control on a price book item that enforces restrictions when you add the item to quotes/tickets.

Example

You can define a Minimum Charge for an item so that users can’t change the sales price to below the specified minimum.

Price book constraints maintain contract compliance by preventing changes to item quantities and pricing.

How It Works

Make an entry or selection in one of the following fields to enforce a price book constraint:

Field Constraint

Default Quantity

Specify a Default Quantity so the item gets added in that quantity.
Don’t specify a Default Quantity to set the default quantity as "1".

Included Quantity

Specify an Included Quantity so customers receive that quantity at no charge but must pay for extra items.
Don’t specify an Included Quantity to make customers pay for every item.

Minimum Quantity

Specify a Minimum Quantity so you can’t add less than that quantity of the item.
Don’t specify a Minimum Quantity to remove this restriction.

Maximum Quantity

Specify a Maximum Quantity so you can’t add more than that quantity of the item.
Don’t specify a Maximum Quantity to remove this restriction.

Locked Description

Select Locked Description so you can’t change the item’s description.
Deselect Locked Description to remove this restriction.

Locked Discount

Select Locked Discount so you can’t change the item’s discount.
Deselect Locked Discount to remove this restriction.

Locked Price/Markup

Select Locked Price/Markup so you can’t change the item’s price.
Deselect Locked Price/Markup to remove this restriction.

Minimum Charge

Specify a Minimum Charge so you can’t charge less than that amount for the item.
Don’t specify a Minimum Charge to remove this restriction.

Step-by-Step Guides

Add Multiple Items using the Price Book Builder

FieldFX’s Price Book Builder functionality has been deprecated.

Deprecated item Alternative
Configure the FX Item Picker Lightning Component
  1. Open the Price Book Builder

  2. Click Expand on the right side of the page

    Expand icon
  3. Select catalog items

  4. Click Add Selected

    Child items get added automatically when you add their parent item.
  5. Click Close on the left side of the Item picker

    Collapse icon

Add a Single Item

  1. Access FieldFX Back Office.

  2. Open the Price Books tab.

  3. Open the price book.

  4. Under Price Book Items, click New.

  5. Complete the following:

    Field Action

    Sequence Number

    Enter a sequence number to use for the item.

    Sequence numbers control the order of price book items in lists. Refer to the Sequence Numbers article for more information.

    Catalog Item

    Select the catalog item for which you are adding the price book item.

    Use a standard price

    Select "Straight Price" in Pricing Method and enter a Price to set a price for the item.

    Mark up the item by a dollar amount

    select "Cost Plus Markup Amount" in Pricing Method and enter a Cost Plus Markup Amount to set a price for the item.

    You must also enter a Cost for the linked catalog item.

    Mark up the item by a percentage of cost

    Select "Cost Plus Markup Percent" in Pricing Method and enter a Cost Plus Markup Percent to set a price for the item.

    You must also enter a Cost for the linked catalog item.

    Discount Percent

    Enter the percentage discount to grant on the item.

    Default Quantity

    Enter the default quantity to add to quotes/tickets.

    Included Quantity

    Enter the quantity to give customers at no charge.

    Example

    If the Included Qty is three and you add five items to a ticket, the customer receives three items at no charge and must pay for two items.

    Description Override

    Enter a catalog description to use for the item in this price book.

    This entry overrides the description inherited from the linked catalog item

    Do not select this option if the item is the child of another item.

    Refer to the Parent & Child Items section above for more information on this feature.

    Requires Parent Item

    Select to make this item a child of another price book item. Then, select a parent item in Parent Price Book Item.

    Do not select this option if the item is the parent of another item.

    An item cannot be both a child of an item and the parent of another item.

    When you select Requires Parent Item, you can’t add the item to quotes/tickets without adding its parent item first.

    Refer to the Parent & Child Items section above for more information on Parent & Child Items relationships.

    Surcharge Fuel

    Select to apply a surcharge for fuel costs.

    Required Item

    Select to add the item to every new quote/ticket.

    Don’t select Required Item for child items.

    If you deselect Required Item, any existing quote items/ticket items will still be required.

    Standby Price

    Enter the price to charge when the item is on standby and not in use on a job

    Example

    If you move a crane to a work site and the customer delays the start of the job, charge the customer the standby price for the crane until the job begins.

    Minimum Charge

    Enter the minimum price to charge for the item.

    Locked Description

    Select to prevent users from changing the item’s description.

    Locked Discount

    Select to prevent users from changing the item’s discount percentage.

    You can’t apply stage pricing to price book items that have Locked Discount selected.

    Locked Price/Markup

    Select to prevent users from changing the item’s price or markup.

    Minimum Quantity

    Enter the minimum quantity that users can add to quotes/tickets.

    Maximum Quantity

    Enter the maximum quantity that users can add to quotes/tickets.

    Currency

    Select the currency in which to display the item’s prices. +\

    This field displays if you enable the Multiple Currency feature.

    The currency you select overrides the default currency for the price book.

  6. Click Save.