#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 one-off special 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.
Each card saves on its own. Saving one card does not discard unsaved edits in the other two.
The Opening hours panel is exposed at /settings?section=business-hours (business-hours is the section's canonical URL key; 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 sidebar (or in the navigation drawer on mobile); 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; for Client Administrators the portal adds the activeproject_idto that address. - Check that the correct project is selected. Opening-hours changes apply only to the selected project. If the page asks you to select a project, choose one in-scope project first.
- In Weekly hours, use each weekday's Open / Closed switch. Open days require an opening and closing time, chosen from the time picker.
- 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 to add a one-off closure. Choose the date, add an optional reason, then select Save date. The new row appears in the card marked Pending save until the card is saved. Special days added from the portal are always closures — the Status field is fixed to Closed.
- 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. | For Client Administrators the portal resolves the active project from the sidebar switcher and keeps it in the address. Summary-only roles with more than one project must choose one in the panel. |
| 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. If no region is assigned, the card says so instead of showing chips. |
| Upcoming closures | The next projected public-holiday closures for the region (the card lists up to six) | Use Stay open to override a listed closure, or Undo to remove that override. An overridden date is struck through and tagged Open instead. | Saved with the Public holidays card. |
| Open or Closed | Marks a weekday as open or closed, using the switch on each weekday row | 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 | Required when the day is open. Chosen from the time picker (hours 00–23, minutes 00, 15, 30, 45) and must be earlier than Closes. | Existing values are loaded from the selected project. |
| Closes | The closing time for an open weekday | Required when the day is open. Chosen from the same time picker and must 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 closure | Required. Chosen from the date picker, and it cannot duplicate another special day. The server also rejects dates in the past for the project's local date. | New rows default to the next available project-local date. |
| Special day status | The open or closed status shown for a special day | Display-only. Special days added from the portal are always Closed. Existing open special days set up by your partner are listed with their hours, and can be removed but not edited here. | New special days are Closed. |
| 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 sidebar project switcher, or from the in-panel selector if the page asks for one. If no in-scope projects are available, contact your AiDial partner or portal administrator. |
| Opening hours are not provisioned for this project | The project is assigned to your account, but customer-safe opening-hours settings are not connected to it yet. Contact support, or choose another in-scope project. |
| Opens is after Closes | Ensure the opening time is earlier than the closing time for each open weekday. Overnight spans are not supported. |
| Special day will not save | Check that the date is valid, not already used by another special day, 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 | Opening-hours saves are limited to six per five minutes for each project. Wait for the retry guidance shown in the portal, or refresh and try again if the session or security check failed. |