Business Range Overview

What a Business Range Is

A business range is a container that groups together a set of per-day open hours and, optionally, a set of hourly caps that apply only during those hours. Business ranges answer the question "when is this owner open, and what are its limits during that window?" They are used by buyers, buyer conversions, offer conversions and schedules.

A business range carries:

• Owner: the entity the range belongs to. The relationship name distinguishes a buyer's own hours from its conversion-window hours.
• Time zone: ranges are evaluated in the owner's time zone, not UTC.
• Display settings: color, selection, and sort order used by the day-part editor UI.
• Day parts: a pre-computed expansion of the range's days into segment indices, used for fast overlap checks and for rendering the grid.
• Hourly limits: attempt hourly limit, connection hourly limit, buyer conversion hourly limit, revenue hourly limit,, concurrency limit, off-hook concurrency limit, plus buyer spacing settings (type, limit, seconds, minutes, hours).

Business Hours

Each business range contains one or more business hour entries. A business hour is a single row per day-slice with:

• Day of week (Sunday through Saturday).
• Time open (e.g., 9:00 AM).
• Time close (e.g., 5:00 PM).
• Work day and invert flags that affect how the row is interpreted in the grid UI.

A range like "Monday-Friday 9am-5pm" produces five business hour entries: one per day, each with open at 9:00 AM and close at 5:00 PM.

Multiple Ranges Per Owner

An owner can have many business ranges. They are additive: when the system asks "is this owner open?" it checks each range and stops at the first one that returns open. This enables split schedules, multi-timezone coverage, and per-range caps.