Skip to main content

Toast: Extract and Required Data Guide

Guide users to add Toast payroll access, extract data, and format files for setup.

This guide walks you through granting access, downloading the required reports, and preparing the files for upload.

Export employee demographics and pay information

Create a custom employee-attribute report containing demographic, employment, and pay data.

  1. From the left menu, select Reports.

  2. Select the Custom tab.

  3. Select Add + in the upper-right corner.

  4. Name the report Employee demographics.

  5. From Template, select EE attribute.

  6. Select Save.

  7. Add the following fields by selecting the plus icon beside each one:

    • First Name

    • Middle Name

    • Last Name

    • Address Line 1

    • Address Line 2

    • City

    • State

    • ZIP

    • SSN

    • Date of Birth

    • Original Hire Date

    • Termination Date

    • Employment Status

    • Primary Email

    • Pay Type

    • Salary Type

    • Hourly Rate

    • Annual Salary

    • Payroll Salary

    • Level 2 – Location, if the account has more than one workplace

    • Level 1 – Company, if the login contains more than one FEIN

    • Workers’ Compensation Code, if applicable

    • EEO Classification, if applicable

    • Employment Type, if applicable

  8. Select Queue.

  9. When the report is ready, download it from Report Courier.

Export employee withholdings

  1. From the left menu, select Reports.

  2. Select the Standard tab.

  3. Search for W-4.

  4. Select the arrow on the right side of Employee W-4 Audit Report.

  5. Select Run Report.

  6. The report downloads as an HTML webpage. Open the file and save it as a CSV.

Export employee deductions

  1. From the left menu, select Reports.

  2. Select the Custom tab.

  3. Select Add + in the upper-right corner.

  4. Name the report Employee Deductions.

  5. From Template, select Employee Deductions.

  6. Select Save.

  7. Add the following fields:

    • First Name

    • Last Name

    • Deduction Name

    • Deduction Amount

    • Deduction Percent

    • Start

    • End

    • Adjusted Limit

    • Calendar Year

    • Level 2 – Location, if the account has more than one workplace

    • Level 1 – Company, if the login contains more than one FEIN

  8. Select Queue.

  9. When the report is ready, download it from Report Courier.

Export historical payrolls

Historical payroll data must be provided differently for completed quarters and the current open quarter.

Completed quarters

  1. From the left menu, go to Reports > Standard.

  2. Find Per Pay Period Employee Payroll Audit Report.

  3. Select the arrow to the right of the report name.

  4. Use the FEIN menu to select the correct company entity.

  5. Select every check date in the applicable completed quarter:

    • Q1: January 1–March 31

    • Q2: April 1–June 30

    • Q3: July 1–September 30

    • Q4: October 1–December 31

  6. Select:

    • Include Taxes

    • Include Earnings

    • Include Deductions

  7. Under Group Data by, select Group By Employee.

  8. Select Run Report.

  9. The report downloads as an HTML webpage. Open the file and save it as a CSV.

  10. Repeat these steps for each completed quarter in the current year.

Open quarter

  1. Follow steps 1–6 under Completed quarters, selecting every completed payroll in the current quarter.

  2. Under Group Data by, select Group By Pay Period.

  3. Select Run Report.

  4. Open the downloaded HTML file and save it as a CSV.

Capture company tax-account information

Complete these steps for each company entity or FEIN included in the setup.

  1. From the left menu, select Taxes.

  2. Select Tax Resources in the upper-right corner.

  3. Select Edit State Tax Accounts.

  4. Capture a screenshot of the entire page, ensuring that all relevant account details are visible.

Download tax returns

  1. From the left menu, select Taxes.

  2. Select Tax Documents in the upper-right corner.

  3. Download the tax package for every completed quarter in the current year.

  4. If setup begins in Q1, also download the most recent available prior-year quarterly return, such as Q3 or Q4, so the tax-account information can be verified.

  5. If setup begins later in the year, download every completed quarterly return from the current year.

Prepare files for upload

Before uploading the files:

  1. Convert HTML or Excel reports to CSV where required.

  2. Open each CSV and confirm that it contains the expected employee-level detail.

  3. Remove report titles, repeated header rows, blank rows, subtotals, and grand totals that are not part of the underlying data.

  4. Do not rename or remove required data columns.

Did this answer your question?