Events and File Layouts

Employers are often required to report to eSocial when certain transactions are saved in eSocial-mapped components in their payroll, HR, or even financial systems. The government has identified a list of events and published layout specifications for them. Event layouts are report templates that are used to generate XML reports for events.

Global Payroll for Brazil supports the reporting of events that are specific to payroll and HR.

Events are grouped into these high-level categories:

  • Basic table events. They include the initial loading, as well as ongoing updates of tables that identify the employer, employees, employment relationships and so on.

    For example, loading or update of employer data, job codes, establishments, work shifts and time labor, and so on.

  • Non-periodic events or labor events.

    These are labor-related legal facts between the employer and employees that do not occur on a predefined schedule.

    For example, hires, rehires, personal data changes, absence, and so on.

  • Periodic events.

    These are events that occur on a regular basis.

    For example, monthly payroll, 13th salary, social security contribution withholding, and so on.

  • Totaling events.

    These are PeopleSoft queries that are used to query social security contribution and income tax withholding information of employees and employers that was reported successfully to the government through periodic events.

  • Termination events.

    They are a subset of non-periodic events, and are used to report information related to terminations of employees and non-employees.

Please refer to the Understanding Events topic for more information about events that are delivered for eSocial reporting.