Operation calendar

The Operation calendar provides a centralized configuration matrix that allows fulfillment managers to define a standard schedule once and apply it across all warehouse locations sharing the same operational strategy via resource pool definition. When business strategies pivot, this centralized architecture enables fulfillment manager to update the operation calendar a single time, and all associated nodes immediately inherit the new capacity schedule.

For example, a retail enterprise might model several tiers of distribution centers. Tier 1 nodes might operate on a longer operational schedule to support high volume regions, while Tier 2 nodes utilize a shorter operational schedule. By leveraging shared calendars, the management overhead required to maintain these distinct groups is drastically reduced.

Calendar definition components

An operation schedule is constitute by the following core attributes:
  • Calendar ID
    The unique identifier for the schedule template.
  • Description
    A human readable name or description outlining the purpose of the calendar.
  • Start/end period
    Defined by a start date and an end date. The calendar is only effective between these two dates, and the effective period is strictly exclusive of the end date.
  • Slots
    The schedule accommodates full day operations or multiple distinct shifts. Each shift requires a start time and an end time, alongside the specific capacity level for each day of the week, from Monday through Sunday. Any day of the week that is not explicitly defined within the configuration is automatically calculated as having zero capacity.
  • Overrides
    For more information, see Overriding availability.

Example configuration payload

Look at a standard JSON representation of an operation calendar that illustrates a standard weekday shift, a shortened Saturday shift, and holiday overrides.
{
  "description": "Distribution Center Workforce Schedule",
  "calendarId": "DC_WORKFORCE_SCHEDULE",
  "startDate": "2026-01-01",
  "endDate": "2026-12-31",
  "slots": [
    {
      "startTime": "09:00:00",
      "endTime": "17:00:00",
      "workingDays": {
        "mon": 12,
        "tue": 12,
        "wed": 12,
        "thu": 12,
        "fri": 12
      }
    },
    {
      "startTime": "11:00:00",
      "endTime": "17:00:00",
      "workingDays": {
         "sat": 7
      }
    }
  ],
  "overrides": [
    {
      "date": "2026-12-25",
      "slots": []
    },
    {
      "date": "2026-12-31",
      "slots": [
        {
          "startTime": "09:00:00",
          "endTime": "14:00:00",
          "capacity": 3
        }
      ]
    }
  ]
}
For more information, see Operation Calendar API.