---
title: "EmployeeTimeSchedulesByEmployeeYearPeriod (Nmbrs)"
description: "Time Schedules by Employee, Year and Period"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Employees.EmployeeTimeSchedulesByEmployeeYearPeriod
original: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Employees.EmployeeTimeSchedulesByEmployeeYearPeriod
updated: 2026-11-01T17:57:29Z
license: https://documentation.invantive.eu/en/
---

# EmployeeTimeSchedulesByEmployeeYearPeriod: Nmbrs Time Schedules by Employee, Year and Period

`read only` `XML`

- Catalog: `Nmbrs`
- Schema: `Employees`
- Label: Time Schedules by Employee, Year and Period

Can only retrieve data.

## API Source

- XML service: `EmployeeService.asmx`
- XML topic: `TimeSchedule_GetListByPeriod`
- XML path: `/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 48 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `EmployeeId` | `number` | [x] |  | Numeric ID of employee. |
| `Period` | `number` | [x] |  | Payroll period within year. |
| `Year` | `number` | [x] |  | Payroll year. |

## Table Columns

The columns of the table `EmployeeTimeSchedulesByEmployeeYearPeriod` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `EMPLOYEEID` | `int32` | Employee ID | [ ] |  |  |
| `ENDDATE` | `datetime` | End Date | [ ] | `/soap:Envelope/soap:Body/nes:TimeSchedule_GetListByPeriodResponse/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule/nes:DtmEnd` |  |
| `ENVIRONMENTID` | `int32` | Environment ID | [ ] | `/soap:Envelope/soap:Body/nes:TimeSchedule_GetListByPeriodResponse/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule/nes:IntEnvironmentID` |  |
| `ID` | `int32` | ID | [x] | `/soap:Envelope/soap:Body/nes:TimeSchedule_GetListByPeriodResponse/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule/nes:ID` |  |
| `MEDEWERKERID` | `int32` | Employee ID | [ ] | `/soap:Envelope/soap:Body/nes:TimeSchedule_GetListByPeriodResponse/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule/nes:IntMedewerkerID` |  |
| `STARTDATE` | `datetime` | Start Date | [ ] | `/soap:Envelope/soap:Body/nes:TimeSchedule_GetListByPeriodResponse/nes:TimeSchedule_GetListByPeriodResult/TimeSchedule/nes:DtmStart` |  |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Nmbrs](/en/release-notes/drivers?driver=nmbrs)

