Talent Applications

 

This webservice allows to manage applications submitted by the candidate. 

It allows to view applications, documents (CV, Cover Letter and CandidatePack) and withdraw the application.

Response Format

XML

SOAP METHODS


This method accepts candidate consent This method must be called with candidate credentials. The user name must be set to the following format for example: TechnicalID:saif:FO The password must be the candidates password used for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
consentId
Long
[mandatory] id of consent to accept
applicationId
Long
[mandatory] id of application
comment
String
Comment
langCode
LangCode
[mandatory] langCode

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
void
Void
The method getList returns list all applications submitted by candidate. Depending on configuration list contains all applications submitted by candidate or list is limited to applications submitted from a career site. This method must be called with candidate credentials. The user name must be set to the following format for example: TechnicalID:saif:FO The password must be the candidates password used for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
langCode
LangCode
Language code
displayConsents
Boolean
Flag indicating whether display or not user's consents Used for translation of application statuses and error messages If not provided then site master language is used. Click to see possible values

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
application
List
List of all submitted applications.
  id
Long
Id of application.
  jobAdvertTitle
String
Title of the job advert related to current application.
  creationDate
Date
Date and time when application was made. Time offset is provided.
  status
TranslationDto
Selection process status of given application.
    translatedValue
String
Status translated value.
    rawValue
String
Status code.
  generalApplication
Boolean
Indicates whether or not application was submitted to program(general application).
  applicationFromAgency
Boolean
This indicates that application was not created by candidate but it was created by HR agency. This value can be used to filter applications and do not display them for candidate or limit possible actions.
  postingTargetId
Long
Id of posting target related to given application.
  candidateConsents
List
List of candidate data privacy consents.
    candidateConsent
CandidateConsentDto
Candidate data privacy consents.
      consentDto
ConsentDto
Object representing consent data.
        id
Long
Database ID of Consent
        type
ConsentType
Type of Candidate consent. Indicates what type of consent. Can be one of possible values: - TALENT_POOL - consent for Talent Pools and General Applications - APPLICATION - consent for Applications - LINKEDIN_RSC - consent releated to LinkedIn
        language
LangCode
Language represented as Talentlink LangCode standard, ie: UK, EN, DE. Determines the language of provided consent text.
        introductionText
String
The headline of consent
        fullText
String
Full text of consent. This is exactly what candidate has seen when accepting / rejecting consent.
        department
DepartmentDto
Represents the first level department of consent.
          id
String
          name
String
          level
Integer
          shortName
String
          parentDept
DepartmentDto
        defaultConsent
Boolean
True / false determining if consent is default
        current
Boolean
True / false determing if the consent is current version Current version will be presented to new candidates. Candidate can have assiged not current version if it has changes since agreement.
        version
Long
Number specifying version of the consent.
        user
UserDto
UserDto determines who has created the consent.
          id
Long
ID is the internal auto generated user of the Talentlink BackOffice system
          firstName
String
First name of user for in BackOffice, for example, Saif
          lastName
String
Last name of user, for example, Anjary
          login
String
Login username to access the Lumesse BackOffice
          email
String
Email of the user in the Lumesse BackOffice.
          cellphone
String
Cellphone number of the user
          type
String
ADVANCED = HR recruiter MSS = line manager
          active
Boolean
IF true user is active
        createdDate
Date
Date of creation of the consent.
        uniqueIdentifier
String
String unique identifier for consent.
      status
CandidateConsentStatus
Status of candidate consent. Can be one of the following values: - REQUESTED - communication has been sent to candidate asking for consent agreement - GRANTED - permission is given - REVOKED_BY_USER - permission is refused by TLK user - WITHDRAWN_BY_CANDIDATE - permission is refused by candidate
      lastGrantedDate
Date
Date of last grant action. Is null when grant has been never invoked.
      lastRevokedDate
Date
Date of last revoke action. Is null when revoke has been never invoked.
      lastRequestedDate
Date
Date of last request action. Is null when request has been never invoked.
      lastRequestedUser
UserDto
User invoking last request action. Is null when request has been never invoked.
      lastGrantedUser
UserDto
User invoking last grant action. Is null when grant has been never invoked.
      lastRevokedUser
UserDto
User invoking last revoke action. Is null when revoke has been never invoked.
      comment
String
Additional comment for consent. Can be null.
The method getListWithDocuments returns list of all applications submitted by candidate together with any files attached by the candidate during application process (i.e. CV, Cover Letter) and additionally the Candidate Pack (all structured documents and attachments merged into one PDF). This method must be called with candidate credentials. The user name must be set to the following format for example: TechnicalID:saif:FO The password must be the candidates password used for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
langCode
LangCode
Language code
displayConsents
Boolean
Flag indicating whether display or not user's consents Used for translation of application statuses and error messages If not provided then site master language is used. Click to see possible values

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
application
List
List of applications with attached files.
  id
Long
Id of application.
  jobAdvertTitle
String
Title of the job advert related to current application.
  creationDate
Date
Date and time when application was made. Time offset is provided.
  status
TranslationDto
Selection process status of given application.
    translatedValue
String
Status translated value.
    rawValue
String
Status code.
  generalApplication
Boolean
Indicates whether or not application was submitted to program(general application).
  applicationFromAgency
Boolean
This indicates that application was not created by candidate but it was created by HR agency. This value can be used to filter applications and do not display them for candidate or limit possible actions.
  documents
List
List attached files associated with application.
    document
DocumentBaseDto
Document object.
      id
Long
Unique Id of the document
      applicationId
Long
Id of the application this document belongs to.
      name
String
Name of the current Document
      description
String
Free text description of the current document.
      documentType
String
Business type of the current document (cover letter, resume, mail...) Click to see possible values
      objectType
String
Type of document that can be used to distinct between uploaded file - ATTACHEDFILE or form based document- STRUCTURED or free form document - FREEFORM.
      author
String
Author of the document - person who created structured document or uploaded file.
      creationDate
Date
Date when the current document was first created
      lastUpdateDate
Date
Date when the current document was last modified.
  postingTargetId
Long
Id of posting target related to given application.
  jobNumber
String
Number of opening associated with given application.
  candidateConsents
List
List of candidate data privacy consents.
    candidateConsent
CandidateConsentDto
Candidate data privacy consents.
      consentDto
ConsentDto
Object representing consent data.
        id
Long
Database ID of Consent
        type
ConsentType
Type of Candidate consent. Indicates what type of consent. Can be one of possible values: - TALENT_POOL - consent for Talent Pools and General Applications - APPLICATION - consent for Applications - LINKEDIN_RSC - consent releated to LinkedIn
        language
LangCode
Language represented as Talentlink LangCode standard, ie: UK, EN, DE. Determines the language of provided consent text.
        introductionText
String
The headline of consent
        fullText
String
Full text of consent. This is exactly what candidate has seen when accepting / rejecting consent.
        department
DepartmentDto
Represents the first level department of consent.
          id
String
          name
String
          level
Integer
          shortName
String
          parentDept
DepartmentDto
        defaultConsent
Boolean
True / false determining if consent is default
        current
Boolean
True / false determing if the consent is current version Current version will be presented to new candidates. Candidate can have assiged not current version if it has changes since agreement.
        version
Long
Number specifying version of the consent.
        user
UserDto
UserDto determines who has created the consent.
          id
Long
ID is the internal auto generated user of the Talentlink BackOffice system
          firstName
String
First name of user for in BackOffice, for example, Saif
          lastName
String
Last name of user, for example, Anjary
          login
String
Login username to access the Lumesse BackOffice
          email
String
Email of the user in the Lumesse BackOffice.
          cellphone
String
Cellphone number of the user
          type
String
ADVANCED = HR recruiter MSS = line manager
          active
Boolean
IF true user is active
        createdDate
Date
Date of creation of the consent.
        uniqueIdentifier
String
String unique identifier for consent.
      status
CandidateConsentStatus
Status of candidate consent. Can be one of the following values: - REQUESTED - communication has been sent to candidate asking for consent agreement - GRANTED - permission is given - REVOKED_BY_USER - permission is refused by TLK user - WITHDRAWN_BY_CANDIDATE - permission is refused by candidate
      lastGrantedDate
Date
Date of last grant action. Is null when grant has been never invoked.
      lastRevokedDate
Date
Date of last revoke action. Is null when revoke has been never invoked.
      lastRequestedDate
Date
Date of last request action. Is null when request has been never invoked.
      lastRequestedUser
UserDto
User invoking last request action. Is null when request has been never invoked.
      lastGrantedUser
UserDto
User invoking last grant action. Is null when grant has been never invoked.
      lastRevokedUser
UserDto
User invoking last revoke action. Is null when revoke has been never invoked.
      comment
String
Additional comment for consent. Can be null.
The method withdraw changes status of application and excludes it from selection process.
This method must be called with candidate credentials.
The user name must be set to the following format for example: TechnicalID:saif:FO
The password must be the candidates password used for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
applicationIds
List
Ids of the applications to be withdrawn.
langCode
LangCode
Language code Used for translation of error messages If not provided then site master language is used. Click to see possible values

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
void
Void
This method withdraw candidate consent for a given application and changes the status of this application to withdrawn.
This method must be called with candidate credentials.
The user name must be set to the following format for example: TechnicalID:saif:FO
The password must be the candidates password used for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
consentId
Long
[mandatory] id of consent to withdraw
applicationId
Long
[mandatory] id of application
comment
String
Comment
langCode
LangCode
[mandatory] langCode

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
void
Void