ANTE User Manual

National Holidays

National Holidays lets you maintain a shared list of national holidays for every company in the system, organized by year. You can add holidays one at a time, edit or delete them, copy a whole year's holidays to a new year, or bulk-import a year's holidays from a file.

⚠️ Developer Access Only

This page lives in the Developer portal and is only available to users with developer privileges.

Where to Find It

In the Developer portal sidebar, open the Tenants group and click Holidays.

Page Layout

The National Holidays page is titled "Manage national holidays for all companies". At the top right are three buttons:

  • Import — bulk-import holidays from a JSON file (see Importing Holidays).
  • Copy Year — copy all holidays from the selected year into a new year.
  • Add National Holiday — open the form to create a single holiday.

Below the buttons is a Year selector. Pick a year from the dropdown to view the holidays for that year. When the page first loads, it shows the current year if it has holidays; otherwise it shows the earliest available year.

Holiday Sections

Holidays for the selected year are split into two tables:

  • Regular Holidays — holidays of the Regular type.
  • Special Non-Working Holidays — holidays of the Special type.

Each section header shows a count of how many holidays it contains. If a section has none, it shows "No regular holidays found" or "No special holidays found".

Table Columns

ColumnDescription
DateThe holiday's date, shown in full (for example, "January 01, 2027"). Holidays with no fixed date show TBD.
Holiday NameThe name of the holiday
(actions)Edit (pencil) and Delete (trash) buttons for each row

Common Tasks

Adding a Holiday

  1. Click Add National Holiday.
  2. Under Holiday Information, fill in:
    • Holiday Name (required)
    • Holiday Type (required) — choose Regular or Special from the dropdown
    • Date (optional) — pick a date from the calendar. Leave it blank for a holiday whose date is not yet known (it will show as TBD).
    • Year (required) — defaults to the year you were viewing
  3. Click Create Holiday.

A success message confirms the holiday was created and you return to the holiday list.

Editing a Holiday

  1. Find the holiday in either the Regular Holidays or Special Non-Working Holidays table.
  2. Click the pencil (edit) button on that row.
  3. Update the Holiday Name, Holiday Type, Date, or Year.
  4. Click Update Holiday.

Deleting a Holiday

  1. Find the holiday and click the trash (delete) button on that row.
  2. In the Delete Holiday confirmation, review the holiday name.
  3. Click Delete to confirm.

A success message confirms the holiday was deleted.

Copying a Year

Use this to set up a new year quickly by reusing an existing year's holidays.

  1. Select the year you want to copy from using the Year selector.
  2. Click Copy Year.
  3. In the Copy Year Holidays dialog, enter the Target Year (the new year to copy into). It defaults to the next year.
  4. Click Copy.

All holidays from the source year are copied to the target year, and all copied dates are set to TBD — you can then edit each holiday to set its actual date. After copying, the page switches to show the new target year.

Importing Holidays

Use Import to load a whole year's holidays at once from a JSON file.

  1. Click Import to open the Import National Holidays dialog.
  2. Enter the Target Year (required) — the dialog suggests the next year that has no holidays yet.
  3. Provide your holiday file by either dragging and dropping a .json file onto the upload area or clicking it to browse for a file. Only .json files are accepted.
  4. Once the file is read, the dialog shows a preview:
    • Total, Regular, and Special counts.
    • A table listing each holiday's Name, Type (Regular or Special), and Date (or TBD when no date is given).
  5. If anything is wrong with the file, an error message explains the problem (for example, a missing name or an invalid date format). Fix the file and upload it again.
  6. Click Import to add the holidays to the target year.

A success message confirms the import, and the page switches to show the imported year.

📌 Tip: Click Download Template in the import dialog to get an example file showing the exact format expected.

File Format

The file must be a list of holidays, with at most 50 holidays per import. Each holiday has these fields:

FieldRequiredDescription
nameYesThe holiday name
typeYesEither REGULAR or SPECIAL
dateNoA date in YYYY-MM-DD format, the word TBD, or left empty for a holiday with no fixed date

Holiday Types

TypeWhere it appears
RegularListed under Regular Holidays
SpecialListed under Special Non-Working Holidays