Skip to main content
A price book is a price list that sits on top of your product catalog. It holds prices for a set of products in one or more currencies. It can change those prices by quantity and by attributes of the deal, such as region or customer type. Use a price book when the same products sell at different prices to different markets or segments, and you want reps to start from approved prices instead of typing them. A typical case is a list price in USD, a derived EUR and GBP price list, and a higher rate for one region. For where prices sit in the object graph, see How Alguna works.
Available on request: contact support or your account team to turn it on. It may depend on your plan.
Price books are managed in the dashboard, under Price Books in the Pricing & Packaging section of the navigation. A quote created through the API can start from a price book; see Use a price book on a quote or subscription.

​
How a price book sets a price

A price book works out a price for each product in four steps:
  1. Currency. It takes the product’s price in the currency of the deal. That price is either set directly for the currency or converted from the base currency.
  2. Tier. It picks the rate tier that matches the quantity.
  3. Multipliers. It applies every multiplier whose scope matches the product, the currency and the deal’s driver values.
  4. Rounding. For converted prices, it rounds the result if the price book is set to round.
The result is a list price and, when one is set, a floor price for the product.

​
Create a price book

On Price Books, choose New Price Book, enter a Price Book Name and choose Create Price Book. The price book opens for editing. Its editor has six tabs: Setup, Currencies, Drivers, Products, Pricing and Multipliers.

​
Setup

Set the price book’s name and an optional Description.

​
Currencies

Choose the Base Currency and answer Does this price book support multiple currencies? For a multi-currency price book, choose How should prices be determined for each currency? For Relative pricing, you enter the exchange rate for each currency yourself. How should derived prices be rounded? offers two options: Add each extra currency with its Exchange Rate. The base currency always has a rate of 1.00.

​
Drivers

A driver is a deal attribute that can change the price, such as region, customer tier or contract length. Choose Add Driver and set: Drivers have no effect on their own. They decide which multipliers apply.

​
Products

Choose Add Product to add products from your catalog to the price book. Each product is marked Required or Optional.

​
Pricing

Pick a product, then a currency, to set its pricing. For each product and currency you set a billing interval (Monthly, Quarterly, Semi-Annual or Yearly) and one or more rate tiers. Each tier covers a quantity range and has a Price and an optional Floor price. When a quantity falls inside a tier’s range, that tier’s price applies. A quantity above every tier uses the highest tier. In a Relative multi-currency price book, the non-base currencies show Auto-converted from the base currency, with the exchange rate. Their tiers are read-only. To set prices for one of those currencies by hand, choose Set Custom. To go back to converted prices, choose Use Auto. A custom price for a currency is used as entered, with no conversion.

​
Multipliers

A multiplier scales the price for the deals it matches. Choose Add Multiplier and set: A multiplier with no scope applies to all products and currencies. A multiplier with several conditions applies only when all of them match. When several multipliers match, each one is applied to the price in turn. A multiplier is also applied to the floor price.

​
Simulate pricing

Open a price book from the Price Books list and choose Simulate Pricing to test it before reps use it. Choose a currency and driver values, then add products and quantities. The simulator shows the price each product resolves to, its floor, and a calculation trace with the exchange rate and each multiplier applied. Enter an actual price to check it against the floor. A price below the floor is flagged as below the allowable floor.

​
Use a price book on a quote or subscription

When an organization has at least one price book, creating a subscription or quote offers From a price book. Pick a price book, then add the products you are selling. The products are priced from the price book in the deal’s currency. When the price book has drivers, the builder shows a Drivers section with one selector for each driver. Picking a value, such as a region, prices the products again with the multipliers that match. Changing a quantity picks the matching rate tier. Every price stays editable, down to the product’s floor price. A price entered below the floor is flagged, and the quote or subscription cannot be saved until the price is at or above the floor. Through the API, Create a quote accepts a price_book_id, so a blank quote takes its pricing from that price book. It cannot be combined with plan_id or source_subscription_id. Once a quote or subscription is created, its prices belong to it. Like a plan, a price book is a starting point for building the agreement. The prices the rep confirms are the ones that bill.

​
Price books, plans and rate cards

For pricing in several currencies without a price book, see Multi-currency.

​
FAQ

Does changing a price book change existing subscriptions? No. A price book sets prices when a quote or subscription is built. Prices already on a quote or subscription stay as they are. Can a rep go below the floor price? No. The builder flags any price below the floor, and the quote or subscription cannot be saved until the price is at or above it. Do multipliers stack? Yes. Each matching multiplier is applied in priority order, so two multipliers of 1.10 and 0.90 give a factor of 0.99.