#Opening hours
| Role | Access Level |
|---|---|
| Client Admin | Edit |
| Client Manager | View only |
| Client Staff | No section |
#Overview
Opening hours settings define the customer-safe operating schedule for each in-scope project. The portal lets a Client Administrator manage weekly opening hours, public-holiday handling, and upcoming special open or closed days from three separate cards: Weekly hours, Public holidays, and Special days. The page also shows a read-only After-hours impact summary. Routing and partner-only workflow controls remain outside this portal section.
The Opening hours panel is exposed at /settings?section=business-hours (the URL key business-hours is preserved for compatibility; the page itself reads "Opening hours").
The browser uses your signed-in portal session and calls the portal server route at /api/settings/business-hours; it does not send an API key. The portal server resolves project scope and forwards the session bearer token to AiDial, so out-of-scope projects are rejected without exposing raw project identifiers.
#Prerequisites
- You are signed in to the AiDial portal as a Client Administrator. See Signing In for instructions.
- Your session includes at least one active project. If your organisation has multiple projects, choose the project you want to review before making changes. Client Administrators use the project switcher in the top bar; summary-only roles may be asked to choose a project inside the panel.
- Client Managers can review a summary-only Opening hours view, and Client Staff do not receive this Settings section.
#Configuring Opening hours
- Select Settings from the sidebar.
- Open the Opening hours tab. The direct route is
/settings?section=business-hours. - If the page asks you to select a project, choose one in-scope project first. Opening-hours changes apply only to that selected project.
- In Weekly hours, set each weekday to Open or Closed. Open days require an opening and closing time.
- Select Save weekly hours to save the weekly card, or Discard changes to reset that card.
- In Public holidays, choose Close on public holidays or Follow regular hours. Review the read-only region chips and use Stay open or Undo on upcoming closures when a projected public holiday should be overridden.
- Select Save public holidays to save the public-holidays card, or Discard changes to reset that card.
- In Special days, select Add date for one-off open or closed dates. Choose Closed or Open with custom hours, add an optional reason, then select Save date to add the pending row.
- Select Save special days to save special-day rows, or Discard changes to reset that card.
- Review After-hours impact to see whether the summary reflects the published runtime, a saved draft that is pending publish, or an unavailable runtime summary.
#Field Reference
| Field Name | Description | Validation Rules | Default Behaviour |
|---|---|---|---|
| Project | The in-scope project whose opening hours are being reviewed or edited | Required when more than one project is available. Out-of-scope project references are rejected without disclosing other projects. | A single in-scope project is selected automatically; multi-project sessions must choose one project. |
| Public holidays | Controls whether public holidays close the business or follow regular weekday hours | Required. Choose Close on public holidays or Follow regular hours. | Loaded from the current project state. |
| Holiday region | Read-only public-holiday country/subdivision chips managed by your partner | The region cannot be edited from this card. Request change opens a support request link only; it does not save a region change. | Loaded from the AiDial holiday-region projection for the selected project. |
| Upcoming closures | Projected public-holiday closures for the region | Use Stay open to override a listed closure, or Undo to remove that override. | Saved with the Public holidays card. |
| Open or Closed | Marks a weekday as open or closed | Closed weekdays clear opening and closing times. Open weekdays require both times. | Loaded from the current project state. Re-opening a closed weekday fills 08:30 to 17:30 if no time is already set. |
| Opens | The opening time for an open weekday or open special day | Required when the day is open. Must use HH:MM 24-hour format and be earlier than Closes. | Existing values are loaded from the selected project. |
| Closes | The closing time for an open weekday or open special day | Required when the day is open. Must use HH:MM 24-hour format and be later than Opens. Overnight spans are not supported. | Existing values are loaded from the selected project. |
| Special day date | The date for a one-off open or closed override | Required. Must be a valid date and cannot duplicate another special day. Backend validation also rejects past special days in the project's local date. | New rows default to the next available project-local date. |
| Special day status | Whether the special day is Closed or Open with custom hours | Required. Open special days require Opens and Closes; closed special days must not include times. | New special days default to Closed. Switching to open with empty times fills 10:00 to 14:00. |
| Reason | Optional note for a special day | Optional text up to 120 characters. Empty values are saved as no label. | No reason. |
| Last changed | Per-card saved-change timestamp in the card footer | Display-only. Shown per section when available; otherwise the footer says no saved changes yet. | Returned by AiDial with each load or save. |
| After-hours impact | Read-only summary of how after-hours routing will behave for this schedule | Display-only. The source pill can show published runtime, pending publish, or unavailable. | Calculated by AiDial from published runtime or saved draft state. |
#Common Issues
| Issue | Resolution |
|---|---|
| Cannot edit opening hours | Only Client Administrators can modify opening hours. Client Managers and partner roles can review a summary only, and Client Staff do not receive this Settings section. |
| No project is loaded | Choose a project from the top-bar project switcher or the in-panel selector if the page asks for one. If no in-scope projects are available, contact your AiDial partner or portal administrator. |
| Opens is after Closes | Ensure the opening time is earlier than the closing time for each open weekday or special day. Overnight spans are not supported. |
| Special day will not save | Check that the date is valid, not duplicated, and not in the past for the project's local timezone. |
| Holiday region needs changing | Use Request change from the Public holidays card. The link opens a support request and does not make a settings write. |
| Save is rejected because the state changed elsewhere | The portal reloads the latest server state for the affected card after a stale-save response. Review the reloaded values before saving again. |
| Changes are pending publish | Review After-hours impact. A Pending publish source means the saved draft is available, but the runtime schedule has not yet been confirmed as matching it. |
| Schedule is summary-only | Some partner-managed or unsupported live schedule shapes cannot be edited from the portal. Review the summary and contact your AiDial partner for changes. |
| Change is rate-limited or blocked by security checks | Wait for the retry guidance shown in the portal, or refresh and try again if the session or security check failed. |