Price lists

A price-list type is a category that groups price lists and controls which sale rules they may use. Price-list types are managed in Entities → Price List.

Every organization starts with one system-defined type called the default price list (machine name DEFAULT_PRICE_LIST). The default type is the primary rental rate — it carries the full price structure (price rows with frequency, duration, cost, and discount tiers for digital; cost and discount tiers for printed and directory).

An administrator can create additional (custom) price-list types. Custom types contribute surcharge lines to proposals alongside the default rental price. For example, an organization might define types for installation costs, production costs, or maintenance fees.

A price list is a named record that holds a pricing structure and is assigned to one or more inventory items.

Price lists are managed in the Price Lists section. The section displays tabs for each non-archived price-list type, plus an All tab and a Discounts tab.

A sale rule determines how the cost per unit of measure translates into a cost for a placement period. The full set of sale rules in the system is:

CityScreen Deals restricts which sale rules are available based on the proposal type’s inventory model:

These restrictions apply to custom price lists. Default price lists have the additional constraint that sale rules on discount tiers within price rows must also match the inventory model.

A default price list for a digital proposal type carries two additional type-specific settings and a table of price rows.

A default price list for a printed proposal type carries one type-specific setting and a single price row.

A default price list for a directory proposal type has the same shape as a printed price list: a single price row with a cost per unit of measure and optional discount tiers.

Each price row on a default price list can carry a collection of discount tiers. A tier defines three values:

When a proposal calculates the price for an item, it evaluates all tiers on the matching price row and selects the single tier whose calculated threshold is the highest value that does not exceed the actual quantity. If two tiers tie on threshold, the one with the higher percentage wins.

For a full description of how tier selection works, see quantity discount.

Within a single price row, each combination of sale rule and count must be unique — duplicates are rejected.

The Discounts tab in the Price Lists section manages an organization-wide table of volume discounts based on the number of distinct inventory items in a proposal.

Each row defines:

Changes to this table take effect when the administrator clicks Save.

The volume discount is independent of per-price-row discount tiers. It appears as a separate line in the proposal totals. See volume discount for how it is applied.

Each price list has a Targeting tab that shows which inventory items are currently assigned to it and allows the administrator to add or remove items.

The kind of items shown depends on the proposal type’s inventory model:

When a proposal needs a price for an inventory item, the system looks up price lists as follows:

Custom surcharge prices are filtered to only those price-list types that are in the proposal type’s configured list of price-list types.

If no default price list covers the item, or if the digital price list has no row matching the chosen frequency and duration, the item gets no base price in the proposal.

For the detailed calculation mechanics, see digital pricing and printed pricing.

The price list’s name, sale rule, description, assignee, and employee groups can be edited after creation.

For default price lists, the price rows, discount tiers, and type-specific settings (block duration, default ad duration, placement period) can also be edited.

For custom price lists, the flat price value can be edited.

The price-list type and proposal type fields are set at creation and cannot be changed.

A price list can be deleted. Deleting a price list removes the inventory assignments but does not retroactively change any proposals that already used prices from it — proposal prices are persisted at calculation time and are not recalculated from the price list on save.