BeyondERP.Newsletter
Menu

Report page · Human resources

New hire prep report

A US-only report that lists recently hired workers to help prepare the new hire report that employers must send to the state.

Business process
Hire for open positions
Menu item
HcmNewHirePreparation
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA US-only report that lists recently hired workers to help prepare the new hire report that employers must send to the state.
What you do hereUse this page to produce a list of workers hired in a date range, optionally with contractors and Social Security numbers, for state new hire reporting.
ExampleFor example, on 3 November 2026 BEAT's US payroll clerk runs the report for 1 to 31 October 2026 with Include contractors off and Print social security number on, gets 6 new employees, and files them with the state new hire registry.
New hire prep report page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itWhen you prepare the US state new hire report for workers hired in a period.
How oftenOn demand, at the interval your state requires for new hire reporting.
What the output showsThe workers hired in the period, with Social Security numbers when you chose to print them. A worker who is missing usually has a hire date outside the period, or is a contractor while Include contractors is off.

Source: Microsoft Learn

Setup steps on this page

Prepare the state new hire filing (US)

List the workers hired in the state's reporting period for the US new hire report.

Steps from Microsoft

  1. Go to Human resources > Workers > Inquiries and reports > New hire prep report.
  2. Under Parameters, set the From date and To date to the hire period you must report to the state.
  3. Set Include contractors when the state also needs contractors, and Print social security number when the report must show it.
  4. In Records to include, filter on the workers or legal entity that the report is for.
  5. Compare the list with the Recent hires section of the Personnel management workspace before you send the data to the state.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
From dateThe first date to include.Microsoft Learn 1 October 2026
To dateThe last date to include.Microsoft Learn 31 October 2026
Include contractorsIncludes contractors as well as employees.Microsoft Learn No
Print social security numberPrints workers' Social Security numbers; available only on the new hire version.Microsoft Learn Yes, for the state filing

Common errors and fixes

MessageWhat to do
A worker hired in the period is missing from the listThe worker is a contractor while Include contractors is off, or the employment start date is outside From date and To date. Turn Include contractors on or correct the start date on the employment, then run it again. Microsoft Learn
Social Security numbers are not printedPrint social security number is off. Turn it on for the state filing only, and handle the printout as sensitive data. Microsoft Learn

Test checklist

  1. Hire one employee and one contractor with start dates inside a test period.
  2. Run the report for the period with Include contractors off.
  3. Run it again with Include contractors on.
  4. Check the first run lists 1 worker and the second 2.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Prepare the state new hire filing (US)Run it after each state reporting period with From date and To date set to that period; turn on Print social security number only for the filing copy.The Recent hires list in the Personnel management workspace shows only the last 7 days by default (Human resources parameters), so a filing period needs a report with explicit dates.How is the state new hire filing prepared?Reading a worker who is missing as 'not hired' when the worker is a contractor with Include contractors off, or has a start date outside the period.Test: New hire list matches the period

Feature management and licence

Licence or add-inUS legal entities only: HR or payroll staff who file the state new hire report run it. No Feature management feature is needed for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared worker data: Data management lists the Worker, Employment V2 and Person details entities as shared, so the report reads the same worker records from any legal entity; narrow it with Records to include. Checked in Dynamics 365
Can it be undoneNothing to undo: The report only reads worker data; it changes nothing. Handle printed Social Security numbers as sensitive data. Microsoft Learn
If you change it laterHires are picked by their employment start date as it stands on the day the report runs, the date the Recent hires list of the Personnel management workspace also uses; a start date corrected later moves the worker into or out of the period on the next run, so keep the file of each filing. Microsoft Learn
Technical architect

6Technical

Menu itemHcmNewHirePreparation Checked in Dynamics 365
FormSysOperationTemplateForm Checked in Dynamics 365
Roles to set it up and use itTo use itHuman resource manager HcmHumanResourceManagerHuman resource assistant HcmHumanResourceAssistantGive people one of these roles. On this system, 2 roles can run this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmNewHirePreparation
Data migrationLoad order: The New hire prep report has no data entity in Data management, so it can't be loaded from a file or a configuration template. It reads the worker and employment records; load them with the Worker data migration template and run the report in each environment.Microsoft Learn
Everyone

8Sources