Holiday Hours

The Holiday Hours section allows the entry of special hours for specific holidays and for other times of the year where hours may change, such as Black Friday. Currently only single days can be submitted, so sale hours over a set of days, say the week leading up to Christmas, will need to be entered individually. Additionally, Holiday Hours have to be entered for each location: blanket entries for all locations are not available.

Date is required for each Holiday entered: ID and Name are optional. The Date field should be in YYYY-MM-DD format, where YYYY is the four digit year (i.e., 2017 instead of 17), MM is the numeric equivalent of the month and DD represents the day of the month. The ID should match a HolidayCountry ID in the Bullseye system, for example, the ID for the Canadian Victoria Day entry for 2017 is 49. Name will be used to describe the entered day: if the name for the matching HolidayCountry ID is meant to be used, then Name should be omitted.

Either the Closed entry or the OpeningTime and ClosingTime entries are required. If both are provided, the Closed entry takes precendence over the other two. OpeningTime and ClosingTime entries should be in the format hh:mm:ss, where hh stands for the hours in 24 hour format, mm stands for minutes and ss stands for seconds. An example would be 18:30:00. All times are in the timezone of the location.

Syntax:

<xs:sequence>
  <xs:element name="HolidayHours" minOccurs="0">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Holiday" minOccurs="1" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="ID" type="xs:int" minOccurs="0" />
              <xs:element name="Name" type="xs:string" minOccurs="0" />
              <xs:element name="Date" type="xs:date" />
              <xs:element name="Closed" type="xs:boolean" minOccurs="0" />
              <xs:element name="OpeningTime" type="xs:time" minOccurs="0" />
              <xs:element name="ClosingTime" type="xs:time" minOccurs="0" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:sequence>

 

Example: 
<HolidayHours>
  <Holiday>
    <ID>28</ID>
    <Date>2017-10-31</Date>
    <Closed>true</Closed>
  </Holiday>
  <Holiday>
    <Name>Pre-Veterans Day</Name>
    <Date>2017-11-09</Date>
    <OpeningTime>07:00:00</OpeningTime>
    <ClosingTime>22:00:00</ClosingTime>
  </Holiday>
  <Holiday>
    <Name>Black Friday</Name>
    <Date>2017-11-24</Date>
    <OpeningTime>05:00:00</OpeningTime>
    <ClosingTime>22:00:00</ClosingTime>
  </Holiday>
  <Holiday>
    <Name>Christmas Eve</Name>
    <Date>2017-12-24</Date>
    <OpeningTime>05:00:00</OpeningTime>
    <ClosingTime>14:00:00</ClosingTime>
  </Holiday>
  <Holiday>
    <ID>15</ID>
    <Date>2017-12-25</Date>
    <Closed>true</Closed>
  </Holiday>
  <Holiday>
    <ID>31</ID>
    <Name>Christmas Day</Name>
    <Date>2017-12-25</Date>
    <Closed>true</Closed>
  </Holiday>
</HolidayHours>