Skip to main content

Search

Welcome to the Eploy Knowledge Base

Experian Right To Work Integration: Setting the "Group/Request Pool" Dropdown in Eploy

Integrations
  • Updated

If you use Experian Right To Work or Rightcheck with Eploy, a Vacancy dropdown Custom Question will specify the Group and Request Pool for application checks for each Vacancy. 

If you are not sure which Question this is, please ask your Eploy project manager or contact integrations@eploy.co.uk

This guide will explain the link between the entries in this dropdown and the Group/Request Pools in ExperianRTW or Rightcheck.

Accessing the Options

In order to see / change the options available in the "Group/Request Pool" list, you need to have the "System Admin (Drop Down Lists)" permission. 

You can access the options for the field either by going to Admin > Drop Down Lists and finding the relevant option in the "Show Values For", or (if you are not sure which Option Type to update) by accessing the question in Admin > Customise Fields > Custom Fields, the selecting the 'Fields' tab, accessing the field for the Group/Request Pool selection, and then clicking the 'Preview' link. 

Adding/Updating an option

If you need to add a new Option, you can do this by clicking 'New' in the toolbar. To update an existing option, simply click the ID or Description of the one you need to change.

Important: When creating a new option, you need to include correctly formated JSON in the Reference field. See the next section for more details. You may find it easier to copy the Reference from one of the existing options first, so that you can paste and adapt this for your new option.

JSON Format

Each option in the "Group/Request Pool" list should contain JSON in the following format:

{ CheckPoolID: 'POOL-XXX-XX0X-XXXX', IsIDVT: true, GroupID: 'GRP-0XX-XXX0-XXXX' }

Breaking this down, there are parameters within the JSON:

  • CheckPoolID (string)- this is the id of the CheckPool that applicants to the vacancy will go to if they require a Recruiter Request (i.e. those who cannot complete an IDVT check). Note: the ID needs to be in 'single quotes'.
  • IsIDVT (boolean)- determines whether applicants who have idenitified that they can complete an IDVT check will be put through the IDVT route initially (if this is set to false then all checks for the vacancy will be via Recruiter Request route).
  • GroupID (string)- this is the id of the Group that applicants to the vacancy will be added to. Note: the ID needs to be in 'single quotes'.

You can simply copy the JSON above into the Reference field and adjust the parameters accordingly to link each option to the relevant Request Pool and Group. To find out the RequestPoolID and GroupID, read the next section.

The Description in the dropdown entry is what will be visible in the dropdown- this can be any value.

Getting the CheckPoolID and GroupID 

In the Experian RTW or Rightcheck interface, you can see the IDs relevant to each Check Pool and Group

CheckPools:

Click the 'Request Pools' option in the 'Requests' section on the left-hand menu. The Request Pool IDs show in the column on the left, or within each record.  

Groups:

Click the 'Groups' option in the 'Organisation' section on the left-hand menu. The Group IDs show in the column on the left, or within each record.  

Related to