Shift approvals import

Manage your employees' worked shifts in bulk using the Pending Shift Approvals import

The Shift Approvals Import feature allows you to export your pending shifts from the Approve Shifts page and manage them via the downloaded CSV. Once you have updated the status of any pending shifts, you can reimport the CSV back in, where you will see the shifts have been managed!

This method of shift approvals is often used in the following scenarios:

  • Send to managers who do not access the system for approvals.
  • In labour hire, it is sent to external clients for approval. This can serve as a form of timesheet sign-off.
  • Save time in approving shifts when only minor adjustments need to be made in your shifts.

In this article, we will discuss:  

  • How to export your pending shifts  
  • Managing your shifts in the CSV file  
  • How to import your pending shift updates back into your platform  
  • What data validation is needed for a successful import

  If you'd like to import shifts directly to your roster, please take a look at our guide on Bulk Import Roster Shifts.

Export pending shifts

In certain circumstances, you might want to export your pending shifts to make any necessary changes in bulk or share the data with someone external to your platform for sign-off.

Before doing this, it is essential to note that you can only export and edit shifts that have not been actioned. This option cannot be used for shifts that have already been approved or declined

To export your pending shifts:

  1. Navigate to Time & Attendance > Approve Shifts.
  2. Next to the CSV Export button, select the arrow and choose Export and edit.
     
      Hot tip: There is no need to filter in the Approve Shifts menu, as this will be done in the export. 

  3. This will then take you to the Pending Shifts Import menu, where you can start with Step 1 and select:
    • The start date - This is a mandatory field. This is the commencement date of the week, which aligns with the Approve Shifts menu. 
    • Office Code - Optional. Filter operations & rosters by the office code assigned to the operation. 
    • Operation  - Optional. Filter rosters by the operation they sit under. 
    • Roster - Optional. Filter to a specific roster. 
    • Include clock times - Optional. Includes the clock times in the export. These times may not be edited. 

         Hot tip: This export respects admin user permissions. Meaning your admins will only be able to see the rosters and operations that are available to them.
  4. Export Shifts to download the CSV file.

Manage pending shifts

Once you have exported your shift details into the CSV file, you can review, edit, and manage them as needed. 

Before editing your downloaded CSV, please remember the following details:

  • Unactioned pending shifts cannot be re-imported - All shifts must be approved or declined. Alternatively, you can delete a row if you want to manage that shift separately (via another import or the Approve Shifts page).
  • Only certain fields can be edited - Only the fields highlighted below in our section on Data Verification can be updated.
  • No new shifts can be added through the import - Any additional shifts that were not rostered initially or submitted will need to be added directly from the Approve Shifts page

To manage your pending shifts:

  1. Navigate to your files, and locate and open the CSV file downloaded with all your pending shift information.
  2. Edit the following fields as necessary.
    • Approval Start - The approved start time of the shift.  
    • Approval End - The approved end time of the shift. 
    • Unpaid Approval Break Start - The approved start time of an unpaid break. 
    • Unpaid Approval Break Length - The approved length of an unpaid break. 
    • Paid Approval Break Start - The approved start time of a paid break. 
    • Paid Approval Break Length - The approved length of a paid break. 

        Hot tip: If your employees took multiple paid or unpaid breaks, you can add these in by adding an additional column for each break, and numbering them accordingly.

      E.g Unpaid Approval Break Length 1, Unpaid Approval Break Length 2 etc.
       
    • Shift Status - The approval status of the shift (approve or decline).
    • Public Holiday Approval Type - Specify whether the permanent employee worked or not. 
    • Leave Type - Add leave to a shift. This will often be used when employees go home sick. 
    • Leave Hours - Mandatory if 'Leave Type' is used. The number of leave hours.
    • Absent Reason - Optionally add an Attendance code when declining shifts or adding leave. 
    • Absent Comment - Optionally provide more information when the 'Absent Reason' field is used. 
  3. Save your CSV file, ready for import. Please don't close your file until you complete the import steps outlined below. 
Import pending shifts

With changes made to the exported CSV file, you are ready to import them back into your platform. Doing this will update the status of all the pending shifts on your Approve Shift page. 

To import your pending shifts:

  1. Navigate to Time & Attendance > Approve Shifts.
  2. Next to the CSV Export button, select the arrow and choose Export and edit. 
  3. To the right, in Step 2, select Choose file, and find your file with the changes.
  4. Select Import Shifts.
    • If the import encounters any errors with the CSV file due to incorrect data, you will be notified of the line where the error occurs and what the error is. 
    • In this case, resolve the errors and re-import the file.

  5. The CSV will upload, and your changes will be reflected in the Approve Shifts menu. Feel free to double-check and ensure that all shifts have been managed before payroll. 
Data validation

When importing data into foundU, the data must be provided in the correct format. Below, you will find all the information required about the included columns of this import as well as the accepted formats for editable data. 

  Please note: The bold rows in the below table denote editable columns in your export. 

Column Name Column definition Editable Accepted format
Record ID The ID of the shift which is required for the import.  N N/A
Employee ID Unique identifier for the employee.  N N/A
External ID External ID assigned to the employee.  N N/A
Employee Name Employee's full name.  N N/A
Employment Type Employment type of the employee (full-time, part-time, casual).  N N/A
Operation Office Code Office code assigned to the operation the shift was worked at.  N N/A
Operation Name Operation the shift was worked at. N N/A
Roster Name The roster the shift was worked on.  N N/A
Position The position that was worked by the employee.  N N/A
Date The date the shift started.  N N/A
Day The day the shift started.  N N/A
Roster Start The rostered start time of the shift (24-hour time). N N/A
Roster End The rostered end time of the shift (24-hour time). N N/A
Roster Break The rostered break duration of the shift (minutes).  N N/A
Clock Start The clocked start time of the shift (24-hour time).  N N/A
Clock End The clocked end time of the shift (24-hour time).  N N/A
Clock Break Start The clocked start time of the unpaid break (24-hour time).  N N/A
Clock Break Length The clocked break duration of the shift (minutes).  N N/A
Approval Start The start time to be approved for the shift.  Y 24-hour time formatted as hh:mm
Approval End The end time to be approved for the shift.  Y 24-hour time formatted as hh:mm
Approval Unpaid Break Start

The start time of the unpaid break to be approved.

If inputting multiple unpaid breaks, add extra columns and number each break start sequentially.

e.g. Approval Unpaid Break Start 1, Approval Unpaid Break Start 2 etc. 

Y 24-hour time formatted as hh:mm
Approval Unpaid Break Length

The duration in minutes of the unpaid break to be approved.

If inputting multiple unpaid breaks, add extra columns and number each break start sequentially.

e.g. Approval Unpaid Break Length 1, Approval Unpaid Break Length 2 etc. 

Y Numbers only provided as minutes (e.g. 30 minutes provided as 30 - 1 hour 10 minutes provided as 70).
Approval Paid Break Start

The start time of the paid break to be approved.

If inputting multiple unpaid breaks, add extra columns and number each break start sequentially.

e.g. Approval Paid Break Start 1, Aproval Paid Break Start 2 etc. 

Y 24-hour time formatted as hh:mm
Approval Paid Break Length

The duration in minutes of the paid break to be approved.

If inputting multiple unpaid breaks, add extra columns and number each break start sequentially.

e.g. Approval Paid Break Length 1, Approval Paid Break Length 2 etc. 

Y Numbers only provided as minutes (e.g. 30 minutes provided as 30 - 1 hour 10 minutes provided as 70).
Shift Status The approval status of the shift. Y

a, A, approved, Approved, approve, or Approve.

d, D, declined, Declined, decline, or Decline.

Public Holiday Indicates if a shift is on a public holiday.  N N/A
Public Holiday Approval Type The approval type of public holiday shifts for permanent employees. 
The 'shift status' column should still be set to approve.
Y

Worked or W

Not Worked or NW

Pay Base or NWB

Leave Type Leave entitlement to be added to the shift.  Y Leave entitlement title.
Leave Hours Leave entitlement hours to be added to the shift.  Y Numbers only. Minutes should be provided as a decimal place (e.g. 1 hour & 30 minutes will be 1.5).
Absent Reason The reason for declining or adding leave to a shift.  Y PM & ATT Code title. 
Absent Comment Additional information about the absent reason.  Y Free text. 

 

Public holiday approvals

  • When the Public Holiday column is populated, the Public Holiday Approval Type column will be mandatory for full-time & part-time employees. Casual employees are always paid public holiday rates for working so require no additional approval. 
  • The Shift Status column (approve or decline) must still be used for public holiday approvals. 

 

Adding leave to a shift

  • The Leave Type column should have the leave entitlement written exactly as it appears on your platform. For example, entering "sick leave" when your entitlement is "Personal Leave" will return an error. 
  • You can find the entitlements in Payroll settings > Leave Rules or on the employee's profile

 

Adding an absent reason

  • When declining a shift via the shift status column or when adding leave to a shift, you can optionally add a reason.
  • The Absent Reason column should have the PM or ATT code title written exactly as it appears on your platform. For example, entering "Went home sick" when your ATT code is "Sick" will return an error. 
  • You can find your PM & ATT codes in Platform Settings > PM & ATT Codes.
  • When adding a code to the Absent Reason column, you can optionally add additional information in the Absent Comment column.