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.