Edit employment period editjobperiod.nv

Resource: editjobperiod.nv

HTTP-method: POST

The resource can be used to edit a single employment detail of an employee. Only the changed information needs to be sent in the message.

Request:

| Level | Element | Type and length | Occurs | Description | Example |
| --- | --- | --- | --- | --- | --- |
| Root | root | Aggr. | 1 | ​ | ​ |
| 1 | employmentperiods | Aggr. | 1 | Employment periods | ​ |
| 2 | employmentperiod | Aggr. | 1 | Employment period | ​ |
| 3 | companystartdate | Date | 0..1 | Start date of continuous employment | 2022-01-01 |
| Attr. | format | String | 1 | Date format | ​ |
| 3 | startdate | Date | 0..1 | Start date | 2022-01-01 |
| Attr. | format | String | 1 | Date format | ​ |
| 3 | probationenddate | Date | 0..1 | End date of probation | 2022-04-01 |
| Attr. | format | String | 1 | Date format | ​ |
| 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 | Attribute type is always netvisor,
i.e. Netvisor identifier |
| 3 | profession | String, max 250 | 0..1 | Occupational title | Specialist |
| 3 | comment | String, max 500 | 0..1 | Comment | New competent 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 no longer in use:
1 = Normal ending of employment
3 = Employee's death
7 = End of employment during the probation period
8 = Releasing the employment
9 = Bankruptcy of the company
10 = Change of ownership of the company) |
| Attr. | type | String | 1 | Linking type of end reason | Attribute type is always netvisor,
i.e. Netvisor identifier |
| 3 | occupationclassification | String | 0..1 | Occupation category | Occupation class TK10-code or if left empty, the occupation category will be cleared. |
| Attr. | type | String | 1 | Linking type | Attribute type is always isco |
| 3 | employmentcontract | Numerical | 0..1 | Duration of employment | 1 = Permanent
2 = Temporary
Note: a temporary employment period must be given an end date |
| Attr. | type | String | 1 | Linking type | Attribute type is always netvisor,
i.e. Netvisor identifier |
| 3 | employmentform | Numerical | 0..1 | Form of employment | 1 = Full-time
2 = Part-time |
| Attr. | type | String | 1 | Linking type | Attribute type is always netvisor,
i.e. Netvisor identifier |
| 3 | parttimepercent | Numerical | 0..1 | Part-time percent | Allowed value is a decimal number in range 0-100
Note: employmentform must be 2,
in order for this to be recognized
Rounded to the nearest two decimals |
| 3 | regularworkinghours | Numerical | 0..1 | Regular working hours | Allowed value is a decimal number in 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 “Yrityksen työeläkevakuuttaja on Keva” selected in payroll settings. | Keva professional class codes:
​Keva: Ammattinimikkeiden haku |
| 3 | kevaemploymentregistration | Numerical | 0..1 | Keva employment registration, max length 2 | Keva employment registration codes:
​Keva: Tulorekisterin koodisto |
| Attr. | type | String | 1 | Always keva | keva |
| Attr. | pensionprovidercode | Numerical | 0..1 | Pension company ID-code. If not given, default value "20" will be used.
Defines what values are accepted in the element kevaemploymentregistration. | The value can be found in KEVA's code list:
​Keva: Tulorekisterin koodisto
If the value is incorrect, the allowed values are 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 in 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 | Codes for collective agreements in the Incomes Register:
​Tulorekisteri: Koodistot |
| 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.
*