Applicant Tracking can integrate with any background check vendor.
Click a hyperlink below to jump to that topic:
Accessing Background ChecksRunning a Background Check
Process Overview
Technical Details
Accessing Background Checks
The background check functionality can be located within each applicant's profile. From there, you can select the Background Checks option in the left navigation bar.
This selection allows a user to view results from previously requested checks, and it includes the option to make a new request.
Running a Background Check
To run a new background check, click New "Your Provider Name" BGC button. This selection will prompt the system to post a JSON string to any URL you provide in a new window.
The following screenshots illustrate what will occur:
Authenticate
As a first step, you will want to reauthenticate the user, as Applicant Tracking does not pass credentials other than the current user’s email address. This means you will first enter the email address affiliated with the user in question and click Sign In to proceed.
Example of a login instance:
Add Details (Optional)
After authenticating your user, you will likely want to get into an order entry process. This means you may want additional information about the applicant for which the order is being placed. If so, make an API call (as illustrated in the technical details further below).
Once the order is placed, the system will indicate a confirmation message, as noted here:
Issue Notification of Completion
You should indicate the successful authentication to the user and notify Applicant Tracking via a web service call that the order has been placed.
Once Applicant Tracking receives the completed post back from your system, the Status section will reflect the result of the check and a “View” link will be displayed that points the user to the report URL you provide.
Process Overview
The following diagram depicts how Applicant Tracking and your service should interact:
Technical Details
Step 1
As outlined above, the user in Applicant Tracking clicks the “Order Background Check” button, and this selection prompts Applicant Tracking to open a new window and to perform a browser-based POST to any URL you desire.
The posted content will appear as follows: | |
---|---|
ATSUserName=ProviderCustomerId&ATSCandidateID=CurrentApplicant.AppNo&ATSUserEmail =CurrentUser.Email | |
Note: *CurrentUser.Email will likely be formatted with URL-escaped characters (example: %40 for @). |
Step 2:
The background check vendor may then authenticate the user and collect order details. When the order has either been created or exists as a draft/in-progress state, the background check vendor should POST back to Applicant Tracking that an order has been started for this person.
Post to URL: | |
---|---|
https://www.applitrack.com/[ClientCode]/onlineapp/8acknowledgecbc.aspx?Provider=[ProviderID] | |
Consider the following terms in relation to this URL:
|
Post the following XML message: | |
---|---|
<?xml version="1.0" encoding="utf-16" ?> |
|
Consider the following requirements in relation to this XML message:
|
Step 3
In order to find out more information about the person/subject of the order, and ultimately place the order, the background check vendor may call out to Applicant Tracking’s general API to download additional details we have on file. Please reach out to our Technical Services group at integrations@frontlineed.com for more information, including our documentation on the R&H API.
Step 4
When the order is complete, return the report to Applicant Tracking.
Post to URL: | |
---|---|
https://www.applitrack.com/[ClientCode]/onlineapp/8acknowledgecbc.aspx?Provider=[ProviderID] | |
Note: This is the same URL from Step 2. |
Post a similar XML message: | |
---|---|
<?xml version="1.0" encoding="utf-16" ?> <Response> <ATSCandidateID>0000</ATSCandidateID> <OrderID>00000</OrderID> <Status>Complete</Status> <Message>Any message to be displayed by Applicant Tracking regarding this order.</Message> <ReportURL>The URL to the report provided by your system.</ReportURL> </Response> |
|
Note: The ATSCandidateID and OrderID in this XML message must match the values provided in the message from step 2. Otherwise, Applicant Tracking will consider this a different background check report. |
Step 5
Applicant Tracking will then expect to show the full background check report via the report URL that was returned. The user will be directed to the ReportURL when they click the View button.