Ubeeo ATS

[#1]

PAGE UNDER CONSTRUCTION

This document described the ‘Ubeeo ATS - Visma Raet Learning API’-connector. This connector has been built on top of the Visma Raet Learning API.

Ubeeo ATS is a integrated recruitment-portal solution which provides organisations with the complete set of tools to manage their recruitment process. You can read more about their software on: https://ubeeo.nl/

The following fields are used by the Ubeeo ATS connector, required fields are highlighted in bold. Fields described as Uniqe are unique within their entity and tenant.

Field connector	API Endpoint	API attribute	HRCore Business	HRCore Online	Functional description
HRMS_USER_CODE	Employees	personId	N/A - Technische sleutel medewerker	P01001 - Persoonsnummer	Unique identifier of the employee
EXTERNAL_CODE	Employees	personCode	7014 - Uniek Persoonlijk ID (UPI)	P01001 - Persoonsnummer	Unique person identifier of employee
INITIALS	Employees	initials	25 - Voorletters	P00303 - Voorletters	Initials of the employee (with dots)
FORENAMES	Employees	firstNames	51 - Voornamen	P01002 - Voornamen	First names of employee
FIRST_NAME	Employees	knowAs	165 - Roepnaam	P01003 - Roepnaam	The employees nickname
LAST_NAME	Employees	lastName	524 - Opgemaakte naam aanhef* *This field is combination of the last name and the last name prefix	P01008 - Samengestelde naam	The persons last name (based on selected name preference)
REFIX	Employees	lastNamePrefix	N/A *  *he prefix is part of the lastName or available as part of lastNameAtBirthPrefix	P01009 - Samengestelde naam voorvoegsel	The prefix of the employee's last name
GENDER	Employees	gender	36 - Geslacht	P00330 - Geslacht	Gender of the employee
USER_EMAIL_ADDRESS	Employees	emailAddresses type:"Business" address	7212 - E-mailadres	P01035 - E-mail adres werk	List the business email address of the employee
WORK_PHONE	Employees	phoneNumbers type:"Business" number	7374 - Telefoonnummer intern	P01037 - Telefoonnummer werk	The (landline) business phone number of the employee
MOBILE_PHONE	Employees	phoneNumbers type:"Mobile" number	7377 - Telefoonnummer mobiel	P01036 - Telefoonnummer mobiel	The mobile phone number of the employee
	Employees	employments employmentCode	N/A	P01101 - Volgnummer dienstverband	The "serial" number of the employees contract
	Employees	employments hireDate	39 - Datum indienst	P00322 - Datum in dienst	The start date of the employees contract (employment)
	Employees	employments dischargeDate	10520479 - Geplande laatste datum indienst* *Datum uitdienst minus 1 dag	P00830 - Datum uit dienst	The end date of the employees contract (employment)
USER_ORG_USAGES	Employees	employments organizationUnit	6000 - Organisatorische eenheid	P01106 - Hierarchische org. eenheid	The functional organizational unit code of the employees contract (employment)
	Employees	validFrom	N/A - Ingangsdatum	N/A	Start date of the version of the employee
	Employees	validUntil	N/A - Einddatum	N/A	End date of the version of the employee
HRMS_ORG_CODE	OrganizationUnits	id	N/A - Technische sleutel OE	P01061- Code organisatorische eenheid	Unique identifier of the organizational unit
EXTERNAL_REFNO	OrganizationUnits	shortName	548 - Code OE	P01061 - Code organisatorische eenheid	Functional name of the organizational unit
NAME	OrganizationUnits	fullName	549 - Naam OE	P01061 - Code organisatorische eenheid	Functional code of the organizational unit
PARENT_ORG	OrganizationUnits	parentOrgUnit	N/A - Technische sleutel van bovenliggende OE	N/A - Technische sleutel van bovenliggende OE	Unique identifier of the parent organizational unit
UP_ID	OrganizationUnits	manager	7137 - manager	N/A	Unique identifier of the manager of the organizational unit* *Only for HR Core Business. For HR Core Online the manager is part of the role assignment
	OrganizationUnits	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the organizational unit
	OrganizationUnits	validUntil	N/A - Einddatum	N/A	End date of that version of the organizational unit
	RoleAssignments	isDeleted	N/A	N/A	After a record is deleted in the core system, the API will return the record with his id and the flag isDelete=true. This delete means that the whole record including all version are deleted.
	RoleAssignments	id	N/A - Technische sleutel roltoewijzing	P01062 - roleId	Unique identifier of the role assignment
USER_ORG_USAGES	RoleAssignments	organizationUnitCode	548 - code OE	P01061 - Operationele org.eenheid	The organizational unit of the role assignment
UP_ID	RoleAssignments	shortName	548 - code OE	P01062 - Rol code	The functional code of the role assignment
EXTERNAL_CODE	RoleAssignments	personCode	7014 - Uniek Persoonlijk ID (UPI)	P01001 - Persoonsnummer	Unique person identifier of employee attached to that role assignment and organizational unit
HRMS_USER_CODE	RoleAssignments	personID	N/A - Technische sleutel medewerker	P01001 - Persoonsnummer	Unique identifier of the employee attached to that role assignment and organizational unit
	RoleAssignments	startdate	N/A - Ingangsdatum	P01063 - Ingangsdatum roltoewijzing	Start date of the employees assignment to that role assignment in relation to an organizational unit
	RoleAssignments	enddate	N/A - Einddatum	P01064 - Einddatum roltoewijzing	End date of the employees assignment to that role assignment in relation to an organizational unit
	RoleAssignments	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the role assignment
	RoleAssignments	validUntil	N/A - Einddatum	N/A	End date of that version of the role assignment
HRMS_VS_VAL_CODE	Companies	id	N/A - Technische sleutel bedrijf	N/A	Unique identifier of the company
CODE	Companies	code	18 - Bedrijfscode (code)	N/A	Functional code of the company
DESCRIPTION	Companies	fullName	18 - Bedrijfscode (omschrijving)	N/A	Functional name of the company
	Companies	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the company
	Companies	validUntil	N/A - Einddatum	N/A	End date of that version of the company
HRMS_VS_VAL_CODE	JobProfiles	id	N/A - Technische sleutel functie	N/A	Unique identifier of the job profile
DISABLED_FLAG	JobProfiles	isDeleted	N/A	N/A	After a record is deleted in the core system, the API will return the record with his id and the flag isDelete=true. This delete means that the whole record including all version are deleted.
CODE	JobProfiles	shortName	97 - Functie code	func_kd - Functie code	Functional code of the job profile
DESCRIPTION	JobProfiles	fullName	97 - Functie code omschrijving	func_oms - Functie omschrijving	Functional name of the job profile
	JobProfiles	jobFamily	N/A	functie groep	Group of job profile
	JobProfiles	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the job profile
	JobProfiles	validUntil	N/A - Einddatum	N/A	End date of that version of the job profile
HRMS_VS_VAL_CODE	EmploymentTypes	code	7393 - Type Medewerker (code)	P01102 - Soort arbeidsrelatie	Functional code of the employee type
DESCRIPTION	EmploymentTypes	fullName	7393 - Type Medewerker (omschrijving)	P01102 - Soort arbeidsrelatie	Functional name of the employee type
	EmploymentTypes	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the employment type
	EmploymentTypes	validUntil	N/A - Einddatum	N/A	End date of that version of the employment type
HRMS_VS_VAL_CODE	ContractTypes	code	10204687 - Contract type (code)	N/A	Functional code of the type of contract
DESCRIPTION	ContractTypes	fullName	10204687 - Contract type (omschrijving)	N/A	Functional name of the type of contract
	ContractTypes	validFrom	N/A - Ingangsdatum	N/A	Start date of that version of the contract type
	ContractTypes	validUntil	N/A - Einddatum	N/A	End date of that version of the contract type

Connector details

Each night at 02:00 CET Ubeeo ATS does a full-load on the described endpoints and detects changes on their side. The connector does not process historic or future data, but is only interested in actual data. The data is primarily used for user provisioning of the Ubeeo ATS application and providing data for vacancy and candidate process. Every employee needs to comply with the required fields (highlighted in bold) when this is not met the employee will be ignored and not processed. To ensure proper working of the connector the required fields need to be properly configured in the Youforce customer setup. Employees which have been discharged (>14 days) will be ignored and no longer processed by Ubeeo ATS

Role assignments

Although the Ubeeo ATS connector consumes role assignment endpoint data, the actual role assignments is a customer specific configuration within the Ubeeo ATS application

Filter applications for HR Core Business-customers

HR Core Business enables filtering on ‘company’ excluding them from the connector sync. The range of companies depends on how it is configured on the customer level in HR CORE visible through the ‘Search company’ list. There is also a possibility to filter on  ‘employee type’ (7393). By default, no filter is applied and any required filters need to be requested through a service desk ticket  

Filter applications for HR Core Online-customers

HR Core Online enables filtering on the field ‘Employment type’ (P01102). By default, no filter is applied and any required filters need to be requested through a service desk ticket  

Value lists for HR Core Business-customers (for example jobprofile)

Fields with a complex type (code and description) need to be configured in the value lists on the customer level (any lower level is not supported). The value lists can be retrieved through the “valuelist” endpoint.