Using employee

Overview

This section allows you to manage the company's employees. In Duett Økonomi, an employee is considered a cost carrier that can be utilized in various processes, including:

  • Time registration
  • Payroll processing
  • Voucher registration
  • Invoicing

Any changes to salary information must be made directly in Duett Økonomi.

Employee
Property Description Default Create
address1 Required. The street address of the employee. See StreetAddress object below. x
address2 The second line of the street address of the employee. See StreetAddress object below. x
bankAccount The bank account number of the employee. Used to reimburse the employee x
countryCodeKey If from a non norwegian country, the country code for international identification. x
country If from a non norwegian country, the country name for international identification. This is found in the response.
email E-mail address of the employee. x
employeeNo Identification number of employer which can be used as an external id. Autogenerated if no number/identifier is submitted. This number can not be changed in PUT or PATCH. x
extraVacationDaysOver60 The number of vacation days over the default amount that the employee can take. x
gender Valid enum values: null, male, female. If 'Absence' (Fravær) is used in Duett, and self-reported sick leave is to be reported to Statistics Norway, it is important that this field is filled in correctly. null x
useForeignBank Boolean. Whether you will use the IBAN number for the employees bank account x
foreignBankInfo Information about the foreign bank. You can put the "Iban" info in the iban field within this object and Duett will gather the other information about the bank for you: "foreignBankInfo": {"iban":GB24BKEN10000031510604} x
groupAffiliations An array of group ids that this employee will be connected to x
name The name of the employee. x
personId The norwegian personal number of the employee, if they have one. x
phoneMobile The mobile phone number of the employee. x
phonePrivate Alternative phone for the employee. x
selfReportSickChildDays The number of days used to report that a child is sick an employee has by default. x
show If the employee has been soft deleted, this will be set to false. They will no longer show in Duett Økonomi. x
vacationDays The default number of vacation days an employee has. x
workingHours The default number of hours this employee should work on a working day.
carrier The carrier object of this employee (Employees are considered carriers within Duett)
zipCodeKey/zipCodeAbroad The post code of the employee x
zipCodeName The name of the area that the zipCodeKey of this employee relates to. Relevant only for norwegian addresses.
zipCodeNameAbroad If from a non norwegian country, the country code for international identification. x
ForeignBankInfo
Property Description Default Create
iban The field contains a check that it is a valid IBAN number based on the criterion that the IBAN number starts with a country code and a certain number of characters (numbers and letters) that are used for the individual country. The field can also be filled in with a numerical account number if the supplier has a bank account in a country that does not use IBAN. X
bicSwift BIC stands for Bank Identifier Code and is the code that identifies the bank. BIC is also called SWIFT and is required for payments to a number of countries and always when using IBAN. Automatically completed if Iban has been submitted. X
bankCode Used in countries that do not have an IBAN, e.g. the USA. The code differs from country to country, and should be used together with the BIC/SWIFT in those countries. Automatically completed if Iban has been submitted.
costCoverage Code. As standard when creating new suppliers, this is set to "Delt" (Shared). "Delt" means that the sender pays costs in Norway and the recipient pays costs abroad. Shared costs are mandatory for SEPA payments where IBAN is also mandatory. The SEPA area comprises the EU (including some overseas possessions) + Norway, Liechtenstein, Iceland, Switzerland, Andorra, Monaco, San Marino and the United Kingdom. Other choices from the list are "Mottaker betaler" (Recipient pays), "Avsender betaler" (Sender pays) and "Avsender betaler kostnader i Norge, mottaker betaler i utlandet" (Sender pays costs in Norway, recipient pays abroad). This last option applies if the supplier has an account type other than IBAN. See /Register/v2/GetCostCoverage Automatically completed if Iban has been submitted. X
payType Code. The Currency Register Act requires information on what the amount applies to when paying abroad. Purchase/sale of goods is set as standard. This can be changed, see selection in pick list. If you receive 2 invoices of such a size that the type of payment is required, and these apply to 2 different purchases (e.g. one applies to the purchase of goods and the other applies to the purchase of services) then you should change the code for payment of the next invoice. See /Register/v2/GetPayType Automatically completed if Iban has been submitted. X
bankName Name of the bank. Automatically completed if Iban has been submitted. X
abroadZipCode Foreign zip code. Automatically completed if Iban has been submitted. X
abroadZipCodeName Name of the town/ place. Automatically completed if Iban has been submitted. X
address Address. Automatically completed if Iban has been submitted. C
address2 Address. Automatically completed if Iban has been submitted. X
countryCode ISO country code. Automatically completed if Iban has been submitted. X

Example: 


                                        {
                                          "address1": "19 example street",
                                          "address2": null,
                                          "bankAccount": "82753948224",
                                          "countryCodeKey": "NO",
                                          "email": "employee@example.com",
                                          "employeeNo": "521",
                                          "extraVacationDaysOver60": 5,
                                          "groupAffiliations":[
                                              {
                                                  "id":15816
                                              }
                                          ],
                                          "name": "Waseem Sulimahn",
                                          "personId": "08109915921",
                                          "phoneMobile": "55556666",
                                          "phonePrivate": "55556666",
                                          "selfReportSickChildDays": 3,
                                          "show": true,
                                          "vacationDays": 26,
                                          "workingHours": 7.5,
                                          "zipCodeKey": "3524"
                                        }

Foreign employee example: 


                                        {
                                          "address1": "6860 Skiles Brook",
                                          "address2": null,
                                          "bankAccount": "59444700127",
                                          "countryCodeKey": "SE",
                                          "email": "Jaquelin_Ratke@hotmail.com",
                                          "employeeNo": "47250a10-2e0b-4184-b516-09891d4f6e24",
                                          "extraVacationDaysOver60": 5,
                                          "useForeignBank": true,
                                          "foreignBankInfo": {
                                            "iban": "SE4550000000058398257466"
                                           },
                                          "name": "Marlene Kemmer",
                                          "personId": "17012131984",
                                          "phoneMobile": "55556666",
                                          "phonePrivate": "55556666",
                                          "selfReportSickChildDays": 3,
                                          "show": true,
                                          "vacationDays": 26,
                                          "workingHours": 7.5,
                                          "zipCodeAbroad": "0018",
                                          "zipCodeNameAbroad": "Aaaa"
                                        }