Resource: getemployee.nv
HTTP-method: GET
Returns the information of a single employee.
Querystring parameters:
| Parameter | Occurs | Example | Description |
| netvisorkey | 0...1 | 1 | Employees Netvisorkey |
| employeenumber | 0...1 | 100 | |
| employmentperiods | 0...1 | 1 | Include employment periods 1 = yes 0 = no |
| employeepayrollinformation | 0...1 | 1 | Include payroll information 1 = yes 0 = no |
| educationalinformation | 0...1 | 1 | Include educational information 1 = yes 0 = no |
| additionalinformationfields | 0...1 | 1 | Include additional information fields 1 = yes 0 = no |
| employeesettlementpoints | 0...1 | 1 | Include settlement points 1 = yes 0 = no |
Response:
| Level | Element name | Type and length | Occurs | Description | Example |
| Root | root | Aggr. | 1 | ||
| 1 | employee | Aggr. | 1 | ||
| 2 | employeebaseinformation | Aggr. | 1...n | ||
| 3 | netvisorkey | Numeric | 1 | Employee's netvisorkey | 8 |
| 3 | employeenumber | Numeric | 1 | Employee's number | 123 |
| 3 | employeeidentifier | String | 1 | Employee identifier type: finnishidentifier, foreignidentifier, companyidentifier | foreignidentifiertype |
| Attr. | foreignidentifiertype | String | 1 | Foreign person's identifier type: taxidentificationnumber, foreignpersonalidentifier, other. Use only if person is foreign | taxidentificationnumber |
| 3 | issuingcountry | String, max 2 | 1 | Employee's home country | fi |
| Attr. | type | String | 1 | Always ISO-3166 | ISO-3166 |
| 3 | firstname | String, max 50 | 1 | Employee's first name | Anna |
| 3 | lastname | String, max 50 | 1 | Employee's last name | Ammattilainen |
| 3 | fullname | String | 1 | Employee's full name | Ammattilainen Anna |
| 3 | payrollservice | Numeric | 1 | Payroll service | 1 = yes 0 = no |
| 3 | resourcemanagement | Numeric | 1 | Travel expense service | 1 = yes 0 = no |
| 3 | lunchbenefit | Numeric | 1 | Lunch benefit in use | 1 |
| 3 | nationality | String, maks. 2 | 1 | Employee's nationality | se |
| Attr. | type | String | 1 | Always ISO-3166 | ISO-3166 |
| 3 | language | String, maks. 2 | 1 | Employee's language, default is 'fi' | fi |
| Attr. | type | String | Language format | ISO-3166 | |
| 3 | municipality | String, maks. 255 | 1 | Employee's home city | Lappeenranta |
| 3 | gender | String | 1 | Gender: male, female | male |
| 3 | dateofbirth | Date | 1 | Date of birth | 1970-10-20 |
| 3 | streetaddress | String, maks. 255 | 1 | Employee's address | Keisarinnankatu 1 |
| 3 | postnumber | String, maks. 50 | 1 | Employee's post number | 56120 |
| 3 | city | String, maks. 255 | 1 | Employee's post office | Lappeenranta |
| 3 | country | String, maks. 2 | 1 | Employee's home country | fi |
| Attr. | type | String | 1 | Always ISO-3166 | ISO-3166 |
| 3 | phonenumber | String, maks. 50 | 1 | Employee's phone number | 050 123 456 |
| 3 | String, maks. 100 | 1 | Employee's e-mail address | anna.ammattilainen@yritys.fi | |
| 3 | bankaccountnumber | String, maks. 34 | 1 | Employee's bank account number, IBAN | FI71 7997 9580 0073 35 |
| 3 | bankidentificationcode | String, maks. 20 | 1 | BIC | NDEAFIHH |
| 3 | activity | Numeric | Employee's activity. Does not indicate whether empoyee has an active employment | 1 = yes 0 = no | |
| 2 | employmentperiods | Aggr. | 0...1 | Employment periods | |
| 3 | employmentperiod | Aggr. | 0...n | Employment period | |
| 4 | netvisorkey | Numeric | 1 | Employment period's netvisorkey | 3 |
| 4 | companystartdate | Date | 1 | Start date of continuous employment | 2017-01-01 |
| Attr. | format | String | 1 | Date format, always ansi | ansi |
| startdate | Date | 1 | Start date | 2017-01-01 | |
| Attr. | format | String | 1 | Date format, always ansi | ansi |
| 4 | probationenddate | Date | 1 | End date of probation | 2017-04-01 |
| Attr. | format | String | 1 | Date format, always ansi | ansi |
| 4 | employmentmode | Numeric | 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, which is Netvisor ID |
| 4 | profession | String, max. 250 | 1 | Professional title | Tester |
| 4 | comment | String, max. 500 | 1 | Comment | Knows what she is doing |
| 4 | enddate | Date | 1 | End date | 2017-12-31 |
| Attr. | format | String | 1 | Date format, always ansi | ansi |
| 4 | endreason | Numeric | 1 | End reason | 2=Retirement 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(Not in use anymore) 1 = Normal employment ending 3 = Employee's death 7 = Probation period 8 = Cancellation of the employment 9 = Bankruptcy of the company 10 = Change of ownership of the company |
| Attr. | type | String | 1 | Linking type of endreason | Attribute type is always netvisor, which is Netvisor ID |
| 4 | occupationclassification | String | 1 | Occupation class | TK10-code of occupation class |
| Attr. | type | String | 1 | Linking type of occupation classification | always isco |
| 4 | employmentcontract | Numeric | 1 | Duration of employment | >1 = Permanent 2 = Temporary |
| Attr. | type | String | 1 | Linking type of employment contract | always netvisor |
| 4 | employmentform | Numeric | 1 | Form of employment | 1 = Full-time2 = Part-time |
| Attr. | type | String | 1 | Linking type of employment form | always netvisor |
| 4 | parttimepercent | Decimal | 1 | Part-time percent | Decimal number from 0 to 100 |
| 4 | regularworkinghours | Numeric | 1 | Regular working hours | Decimal number from 0 to 168 |
| 4 | groundsforemployment | Numeric | 1 | Grounds for employment | 0=Other grounds 1=Working or employment relationship |
| 4 | kevaprofessionalclasscode | Numeric | 1 | Keva professional class code, max 20 characters | Professional class codes |
| 4 | kevaemploymentregistration | Numeric | 1 | Keva employment registration, max 2 characters | Keva employment registration codes |
| Attr. | type | String | 1 | always keva | keva |
| Attr. | pensionprovidercode | Numeric | 1 | Pension provider code | Keva: Incomes register codes |
| 4 | ispaymenttypemonthlywage | Numeric | 1 | Form of payment: Monthly wages | 1=yes 0=no |
| 4 | ispaymenttypehourlywage | Numeric | 1 | Form of payment: Hourly wages | 1=yes 0=no |
| 4 | ispaymenttypepiecewage | Numeric | 1 | Form of payment: Contract pay | 1=yes 0=no |
| 4 | collectiveagreement | Numeric | 1 | Collective agreement | Income register: Codes |
| Attr. | pensionprovidercode | String | 1 | always cbacode | cbacode |
| 4 | stateemploymentfund | Numeric | 1 | Employed with assistance from the State employment fund | 1=yes 0=no |
| 4 | carbenefityear | Numeric | 1 | Year of commissioning of the company car, max 4 characters | 2012 |
| 4 | isabroadcarbenefit | Numeric | 1 | Company car benefit received in another country. | 1=yes 0=no |
| 4 | caremissionvalue | Numeric | 1 | Car emission value, an integer between 0-100 | 85 |
| 2 | employeepayrollinformation | Aggr. | 0...1 | Payroll information | |
| 3 | payrollrulegroup | Aggr. | 1 | Payroll group name | |
| 4 | netvisorkey | Numeric | 1 | Payroll groups netvisorkey | 2 |
| 4 | name | String | 1 | Employees payroll group | Monthly salary |
| 3 | taxnumber | Numeric | 1 | Tax number | 123456789101 |
| 3 | foreclosure | Numeric | 1 | Foreclosure | 1=yes 0=no |
| 3 | foreclosuremaintenancepersons | Numeric | 1 | Foreclosure maintenance persons | 3 |
| 3 | nosocialsecuritypayment | Numeric | 1 | Not subject to employer's sickness insurance payment | 1=yes 0=no |
| 3 | accountingaccount | Aggr. | 1 | Advance debt account | |
| 4 | netvisorkey | Numeric | 1 | Advance debt account's netvisorkey | |
| 4 | name | String | 1 | Advance debt account's name | Receivables from employees |
| 4 | number | Numeric | 1 | Advance debt account's number | 1751 |
| 3 | hierarchy | Aggr. | 1 | Hierarchy level | |
| 4 | netvisorkey | Numeric | 1 | Hierarchy level's netvisorkey | 4 |
| 4 | name | String | 1 | Hierarchy level's name | Oy Yritys Ab |
| 3 | placeofbusiness | String | 1 | Place of business for income register | Pääkonttori |
| 3 | defaultdimensions | Aggr. | 0...1 | Default dimensions | |
| 4 | defaultdimension | Aggr. | 0...n | Default dimension | |
| 5 | dimensionname | String | 1 | Dimension name. | Kustannuspaikat |
| 5 | dimensionitem | String | 1 | Dimension item name. | DevOps |
| 3 | payslipdeliverymethod | String | 1 | Payslip delivery method | 1 = local printing 2 = printing service 3 = e-salary |
| 3 | type | String | 1 | Attribute type is always netvisor, which is Netvisor ID | netvisor |
| 3 | isjointowner | Numeric | 1 | In a shareholder relationship with payer | 1=yes 0=no |
| 3 | isathlete | Numeric | 1 | Athlete | 1=yes 0=no |
| 3 | isperformingartist | Numeric | 1 | Performing atrist | 1=yes 0=no |
| 3 | employeeinsurancetype | Numeric | 1 | Työeläkevakuutuksen tyyppi | 1=Tyel 2=MYEL 3=YEL 4=No pension insurance |
| 3 | ispersonworkingonaroadferryonalandislands | Numeric | 1 | Person working on a road ferry on Åland Islands | 1=yes 0=no |
| 3 | isentrepreneurwithoptionalyelormyel | Numeric | 1 | Entrepreneur, no YEL or MYEL insurance obligation | 1=yes 0=no |
| 3 | receivessalaryfromdiplomaticembassy | Numeric | 1 | Person receiving a wage paid by a diplomatic mission | 1=yes 0=no |
| 3 | ispersonreceivingeppoinsurancesalary | Numeric | 1 | Person receiving wages for insurance purposes under the EPPO Act | 1=yes 0=no |
| 3 | isinvoicingserviceuserwithoutbusinessid | Numeric | 1 | Person using the invoicing service who does not have a Business ID | 1=yes 0=no |
| 2 | employeeeducationalinformation | Aggr. | 0...1 | Degrees | |
| 3 | degree | Aggr. | 0...n | Degree | |
| 4 | name | String | 1 | Name of the degree | Merkonomi |
| 4 | school | Numeric | 1 | Name of the school | Kauppaoppilaitos |
| 4 | graduationyear | Numeric | 1 | Graduation year | 2021 |
| 4 | isprimarydegree | Numeric | 1 | Is this the primary degree | 1=yes 0=no |
| 2 | employeeadditionalinformationfields | Aggr. | 0...1 | Additional information fields | |
| 3 | additionalinformationfield | Aggr. | 0...n | Additional information field | |
| 4 | netvisorkey | Numeric | 1 | netvisorkey | 1 |
| 4 | name | String | 1 | Additional information field's name | Food allergies |
| 4 | value | String | 1 | Additional information field's value | fish |
| Attr. | type | String | 1 | text, datetime | text |
| 4 | group | String | 1 | 1=Basic information 2=Contact information 3=Educational information | 1 |
| Attr. | type | String | 1 | Attribute type is always netvisor, which is Netvisor ID | netvisor |
| 2 | employeesettlementpoints | Aggr. | 0...1 | Settlement points | |
| 3 | employeeunemploymentinsurance | Aggr. | 0...n | Unemployment insurance | |
| 4 | netvisorkey | Numeric | 1 | Settlement's netvisorkey | 1 |
| 4 | type | String | 1 | Settlement point handling | nohandling = no handling automatichandling = Automatic handling under17yearsold = under 17 years old 17to64yearsold = 17 to 64 years old over65yearsold = over 65 years old partowner = part owner |
| 4 | name | String | 1 | Insurance specific settlement point definition | Unemployment insurance |
| 3 | employeeaccidentinsurance | Aggr. | 0...n | Accident insurance | |
| 4 | netvisorkey | Numeric | 1 | Settlement point netvisorkey | 2 |
| 4 | type | String | 1 | Settlement point handling | attachedtosettlementpoint |
| 4 | name | String | 1 | Insurance specific settlement point definition | Accident insurance |
| 3 | employeegrouplifeinsurance | Aggr. | 0...n | Group life insurance | |
| 4 | netvisorkey | Numeric | 1 | Settlement point netvisorkey | 3 |
| 4 | type | String | 1 | Settlement point handling | attachedtosettlementpoint |
| 4 | name | String | 1 | Insurance specific settlement point definition | Group life insurance |
| 3 | employeeunionmembershipfee | Aggr. | 0...n | Union membership fee | |
| 4 | netvisorkey | Numeric | 1 | Settlement point netvisorkey | 4 |
| 4 | type | String | 1 | Settlement point handling | attachedtosettlementpoint |
| 4 | name | String | 1 | Insurance specific settlement point definition | Union membership fee |
| 3 | employeeotherinsurance | Aggr. | 0...n | Other insurance | |
| 4 | netvisorkey | Numeric | 1 | Settlement point netvisorkey | 5 |
| 4 | type | String | 1 | Settlement point handling | attachedtosettlementpoint |
| 4 | name | String | 1 | Insurance specific settlement point definition | Other insurance |
| 3 | employeeworkpensioninsurance | Aggr. | 0...n | Work pension insurance | |
| 4 | netvisorkey | Numeric | 1 | Settlement point netvisorkey | |
| 4 | type | String | 1 | Settlement point handling | nohandling = no handling automatichandling = Automatic handling under17yearsold = under 17 years old 17to64yearsold = 17 to 64 years old over65yearsold = over 65 years old partowner = part owner |
| 4 | name | String | 1 | Insurance specific settlement point definition | TyEL |
| 3 | employeeforeclosure | Aggr. | 0...n | Foreclosure | |
| 4 | netvisorkey | Numeric | 1 | netvisorkey | 6 |
| 4 | type | String | 1 | Settlement point handling | attachedtosettlementpoint |
| 4 | name | String | 1 | Insurance specific settlement point definition | Foreclosure |
Did you find it helpful? Yes No
Send feedbackSorry we couldn't be helpful. Help us improve this article with your feedback.