Employee

HTTP	Operation	Type	Object	DTO Why-DTOs?
POST	Create	Mutation	`createEmployee`	`EmployeeCreateGLDtoInput`
POST	Update	Mutation	`updateEmployee`	`EmployeeUpdateGLDtoInput`
POST	Delete	Mutation	`deleteEmployee` NEWNew Feature Recently Added. (Introduced in the last version as well as in the previous version)	`EmployeeDeleteGLDtoInput`
POST	Read	Query	`employees filtered by id` Why?
POST	List	Query	`employees`

Description

Employee management.

Allows the identification of a third-party Employee within an organization.
It offers the option to add contacts within the Employee and their details.

Every Employee must have a code, which, depending on the organization’s settings, can be manually entered or automatically generated.
In the DE (German) legislation, automatic numbering is mandatory.

Explore Efficient Record Updates: For comprehensive insights into making precise modifications to records, check out our dedicated page on updates : Key concepts / Updating records

Would you like to see an example of how to add an employee?

graphQL Mutation

mutation ($values: EmployeeCreateGLDtoInput!) {  
  createEmployee(input: $values) {
    id
    code
  }
}

graphQL Variables

{
  "values":{
    "name": "Léon DURANT",
    "shortName": "LEDU",
    "comments":"Employee of the year",
      "addresses": [{
       "firstLine": "123 Generic street",
        "city": "Generic City",
        "zipCode": "12345",
        "countryIsoCodeAlpha2":"FR"
      }]
  }
}

Example of Response

{
    "data": {
        "createEmployee": {
            "id": "e614a276-7de0-4fd2-a10c-e8c29732b530",
            "code": "2"
        }
    }
}

Key	Value
`Authorization`	Bearer Current access Token How to find?
`X-TenantId`	Current tenant id How to find?
`X-OrganizationId`	Current organization Id How to find?
`x-api-key`	Primary or secondary subscription key of your app How to find?

employees

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
modificationDate SSystem field that cannot be assigned SSystem field that cannot be assigned	Datetime	Modification date
creationDate SSystem field that cannot be assigned SSystem field that cannot be assigned	Datetime	Creation date

code NThe value of this field cannot be modified after the record is created	String	Code employee See InfoAdditional information is available in the Info block below	17
name *The value of the field or object is mandatory	String	Employee Name	70
shortName	String	Short Name	70
disabled	Boolean	Inactive See InfoAdditional information is available in the Info block below
disabledDate	Datetime DateThe GraphQL field type is DateTime, but only the date value is considered, the time value is ignored if provided.	Inactive date
status RThis field is read-only, its value cannot be assigned	NONE DISABLED ENABLED GDPR_APPLIED	Status
defaultAccountingAccount DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	AccountingAccount	Fields of AccountingAccount
defaultAccountingAccountId	UUID	Ledger General account See InfoAdditional information is available in the Info block below
comments	String	Comments	2000
gdprApplied	Boolean	GDPR action
gdprAppliedDate	Datetime DateThe GraphQL field type is DateTime, but only the date value is considered, the time value is ignored if provided.	GDPR date action
businessArea DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	BusinessArea	Fields of BusinessArea
businessAreaId	UUID	Business areas Id
addresses[]	Array	List of addresses
contacts[]	Array	List of contacts

Info

defaultAccountingAccountId : Id of the general account in accountingAccount associated with the employee.
The subAccountType of the account must be EMPLOYEE.
disabled : If TRUE the employee can no longer be used, but will remain in the existing information.

code : Code of the employee.
During creation, it is automatically calculated if the option is active in Sequence Numbers, otherwise it is a mandatory value.
In any cases, it is still possible to assign it to enforce a specific value.
Forcing a value allows you to retrieve an alphanumeric code that can already identify the Employee, even if automatic numbering mode is active.

Forcing a value allows you to retrieve an alphanumeric code that can already identify the Employee, even if automatic numbering mode is active.
- If you force a value, it must be strictly numeric and adhere to the rule of a number being between 10000 and 69999 for customers, and between 70000 and 99999 for suppliers or employees.

employees/addresses

Attention, only one address is authorized, even if the representation is an array of addresses

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

countryId	UUID	Country Id
country DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.COMING SOON This feature is currently in development and will be available in the next version. It’s already documented to keep you informed about its upcoming availability	String	Fields of Country
countryIsoCodeAlpha2	String	Country Code See InfoAdditional information is available in the Info block below	2
countryNameRThis field is read-only, its value cannot be assigned	String	CountryName
name	String	Code	50
firstLine	String	First Line	35
secondLine	String	Second Line	35
city	String	Town	35
zipCode	String	Postal Code	9
province	String	Province	25

Info

countryIsoCodeAlpha2 : ISO2 country code.
This field can be used for creation and serves as a simple alternative to assign the country of the address by using the ISO2 code directly, rather than the country ID in the Countries resource.

employees/contacts

Common to customers, suppliers, employees

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

courtesy	NONE MR MISS	Courtesy
name	String	First name (John)	35
surname	String	Family name (Smith)	35
jobName	String	Job name	35
jobArea DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	JobArea	Fields of JobArea
jobAreaId	UUID	Job areas Id
isDefault	Boolean	Main contact
emails[]	Array	List of emails
phones[]	Array	List of phones
socialMedias[]	Array	List Social Networking

employees/contacts/emails

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

emailAddress	String	Email address	70
usage	NOT_SET EMPTY INVOICES PAYMENTS OTHERS	Type
isDefault	Boolean	Main mail

employees/contacts/phones

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

number	String	Phone	20
type	NOT_SET EMPTY LANDLINE MOBILE FAX SKYPE WHATS_APP	Type
isDefault	Boolean	Main phone

employees/contacts/socialMedias

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	UUID

name	String	Name	30
link	String	Link	100

Description

Would you like to see an example of how to add an employee?

graphQL Mutation

graphQL Variables

Example of Response

Header

employees

Info

employees/addresses

Info

employees/contacts

employees/contacts/emails

employees/contacts/phones

employees/contacts/socialMedias