📅 How to Manage Calendar Event Attributes

Understanding Key Concepts

Calendar events operate through three interconnected components that work together to manage your operational schedules:

1. Calendar Event Type

A location Calendar Event Type represents a business event occurring at a specific time, such as store opening/closing hours, delivery days, or employee shift start/end and so on.

2. Calendar Event

A location Calendar Event specifies when an Event Type occurs for a particular location on a weekly basis (e.g., "Store 123 opens at 9 AM on Mondays.", "Store 456 accepts deliveries every Wednesday."). This currently supports repeating events on a weekly schedule but does not yet handle specific calendar dates.

3. Calendar Day Event

A location Calendar Day Event defines when a certain Event Type occurs for an entire day in a weekly schedule (e.g., "Store 789 is open for deliveries every Wednesday."). These events apply across weekly cycles and are not yet configured for specific calendar dates.

Setting Up Calendar Events

Navigate to Locations from your main dashboard.
Select the location you want to assign Calendar event attributes to, then choose "Explore Attributes" from the upper right corner.
Navigate to Calendar Events and click the "Add Calendar Event" button to configure your event attributes.

Editing Calendar Event Times for Specific Locations

Sometimes, you might need to edit Calendar event times for specific locations. You can do that from the Locations tab by following these steps:

Select the location you want to edit the Calendar event attribute for, and choose "Explore Attributes" from the upper right corner.
Go to Calendar Events, hover over the right side of the event and click the 3 dots, then select "Edit".
Adjust the times as needed. Each event represents a single day and is based on the location's local time.

Setting Up Cross-Over Day Schedules

The event times are set as offsets from the start of the day, allowing flexibility in scheduling, even for events that cross over midnight or involve complex schedules.

To set the schedule for cross-over days, you can select "Prior", "Same" or "Next" day when setting the calendar event time.

Examples of cross-over schedules:

• 24-hour store with a 5:30 AM cycle:
  • Opening time: 5:30 AM
  • Closing time: 5:30 AM the next day
• Store with late closing:
  • Opening time: 9:00 AM
  • Closing time: 2:00 AM the next day

Once set, the cross-over schedules will appear with the +1 icon next to it:

Using API for Calendar Management

Zenput provides three customer-facing API endpoints to help teams retrieve and manage operating hours and other calendar events programmatically:

If a calendar event already exists at a location, you can use the update endpoint to adjust the time. This makes it much easier for teams with frequently changing hours to update calendar events automatically through the API instead of manually managing each change.

For detailed API documentation and implementation guides, visit the Zenput API docs.

Additional Resources

To check how to set up the Calendar event import, and start scheduling your projects based on Calendar events, please check our mini course below: