Add employment period addjobperiod.nv

Resource: addjobperiod.nv

HTTP-method: POST

With this resource it is possible to add new employment information to an employee.

Parameters used in the request:

Request:

| Level | Element | Type and length | Occurs | Description | Example |
| --- | --- | --- | --- | --- | --- |
| Root | root | Aggr. | 1 | | |
| 1 | employmentperiods | Aggr. | 1 | Employment periods | |
| 2 | employmentperiod | Aggr. | 1..n | Employment | |
| 3 | companystartdate | Date | 0..1 | Start date of uninterrupted employment | 2022-01-01 |
| Attr. | format | String | 1 | Date format | ansi |
| 3 | startdate | Date | 1 | Start date | 2022-01-01 |
| Attr. | format | String | 1 | Date format | ansi |
| 3 | probationenddate | Date | 0..1 | End date of probation | 2022-04-01 |
| Attr. | format | String | 1 | Date format | ansi |
| 3 | employmentmode | Numerical | 0..1 | Mode of employment | 1 = employed
2 = leased employee
3 = self-employed person or similar
4 = trainee
5 = voluntary work |
| Attr. | type | String | 1 | Linking type of employment, always netvisor meaning Netvisor identifier | netvisor |
| 3 | profession | String, max 250 | 1 | Occupational title | Specialist |
| 3 | comment | String, max 500 | 0..1 | Comment | New skilled employee |
| 3 | enddate | Date | 0..1 | End date | 2022-12-31 |
| Attr. | format | String | 1 | Date format | ansi |
| 3 | endreason | Numerical | 0..1 | End reason | 2=Employee's old-age pension
4=Employee's own request
5=Reason attributable to the employee
6=Fixed-term employment
11=Financial and production related grounds for termination
12=End of employment by mutual agreement
13=Other reason
(The following are not in use anymore:
1 = Normal ending of employment
3 = Employee's death
7 = Ending of employment during probation period
8 = Releasing the employment
9 = Bankruptcy of the company
10 = Change of ownership of the company) |
| Attr. | type | String | 1 | Linking type, always netvisor meaning Netvisor identifier | netvisor |
| 3 | occupationclassification | String | 0..1 | Occupation category | Occupation class TK10-code |
| Attr. | type | String | 1 | Linking type | Attribute type is always isco |
| 3 | employmentcontract | Numerical | 0..1 | Validity of employment | 1 = Permanent
2 = Fixed-term
Note: an end date must be given for a fixed-term employment |
| Attr. | type | String | 1 | Linking type, always netvisor meaning Netvisor identifier | netvisor |
| 3 | employmentform | Numerical | 0..1 | Type of employment | 1 = Full-time
2 = Part-time |
| Attr. | type | String | 1 | Linking type, always netvisor meaning Netvisor identifier | netvisor |
| 3 | parttimepercent | Numerical | 0..1 | Part-time percent | Allowed value, decimal number in the range 0-100
Note: employmentform must be 2, in order for this setting to be recognized
Rounded to the nearest two decimals |
| 3 | regularworkinghours | Numerical | 0..1 | Regular working hours | Allowed value, decimal number in the range 0-168
Rounded to the nearest two decimals |
| 3 | groundsforemployment | Numerical | 0..1 | Grounds for employment | 0=Other grounds
1=Working or employment relationship |
| 3 | kevaprofessionalclasscode | Numerical | 0..1 | Keva professional class code, max 20 characters.
Keva data can only be given if the company has selected
in payroll settings “The company's earnings-related pension provider is Keva”. | Keva professional class codes:
​Keva: Search for occupational titles |
| Attr. | type | String | 1 | Always keva | keva |
| Attr. | pensionprovidercode | Numerical | 0..1 | Code of the pension insurance company identifier. If not given, default value
“20” is used.
Defines what values are accepted in the field
kevaemploymentregistration. | The value can be found in KEVA's code list.
​Keva: Income register's codes
With an incorrect value the allowed values will be listed. |
| 3 | ispaymenttypemonthlywage | Numerical | 0..1 | Form of payment: Monthly salary | 1=yes
0=no |
| 3 | ispaymenttypehourlywage | Numerical | 0..1 | Form of payment: Hourly pay | 1=yes
0=no |
| 3 | ispaymenttypepiecewage | Numerical | 0..1 | Form of payment: Piecework | 1=yes
0=no |
| 3 | workercategory | Aggr. | 0..n | Employee group for pay transparency reporting. Employee group is related to pay transparency reporting. Instructions can be found here. | Management of employee groups Pay > Settings > Payroll settings > Pay transparency reporting settings > Management of employee groups |
| 3 | name | String | 1 | Employee group must be added in Netvisor | Example group |
| 3 | collectiveagreement | Numerical | 0..1 | Collective agreement | Income register collective agreement codes:
​Income register: Codes |
| Attr. | type | String | 1 | always cbacode | cbacode |
| 3 | stateemploymentfund | Numerical | 0..1 | Employed with assistance from the State employment fund | 1=yes
0=no |
| 3 | carbenefityear | Numerical | 0..1 | Year of commissioning of the company car, max 4 characters | 2022 |
| 3 | isabroadcarbenefit | Numerical | 0..1 | Company car benefit received in another country | 1=yes
0=no |

This article has been translated using an AI-based translation tool. The contents or wording of these instructions may differ from those in other instructions or in the software.