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

https://api3.lumesse-talenthub.com/CareerPortal/SOAP/TalentApplications?wsdl


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

version 30 as of 1 month ago by Lukasz Krzywicki