Kenexa     Kenexa XML Integrations                                                     

 

 

 

Candidate Import Integrations:

Candidate information can be imported from an external system into Kenexa Recruiter BrassRing. Candidate information is any data that applies to a candidate, such as name, address, previous employers, education, skills, or status that is maintained in a client’s HRIS or on a Kenexa Recruiter BrassRing form.

Applicant resume data is posted to the provided Web Service URL via an XML message. Candidate information can be passed as part of a standard candidate upload file, such as current mailing address as well as the employment and education history. In addition to the basic candidate information, it is possible to upload forms and attach them to the candidates in the same feed.

Special Instructions for Candidate Import Integrations

Notes:  Candidate Import is processed through an offline asynchronous process.  Candidate Import service provides two separate status notifications to ensure an accurate and flexible error reporting and notification process. A synchronous response is a real-time validation conducted upon the receipt of the feed. Kenexa Recruiter BrassRing will validate the XML structure as well as the key values in the XML and provide a real-time response to indicate if there was an error or if validation is passed; in which case that the candidate will be queued up for the upload into the Kenexa Recruiter BrassRing. There are three response codes included in the synchronous response:

Code “200” indicates success and the candidate has been enqueued for the upload

Code “401” indicates authentication failure

Code “405” indicates data related issue

After the upload process has been run, a second (asynchronous) notification is generated and can be delivered in two different ways: emailed to a specific email address (or multiple addresses) or posted to the target URL provided. The response mechanism is fully controlled by each XML feed and can be set on the client side programmatically without any changes required on the Kenexa Recruiter BrassRing side. Response codes for the asynchronous response are the same as above. In case of an error, Kenexa Recruiter BrassRing will provide a detailed description in each response so the issue can be addressed and the customer or vendor can resend the data.

Please refer to Candidate Upload Summary.doc for more information about importing candidates via Web Services, and for sample synchronous and asynchronous responses.

 

Interface Benefits:

The following benefits and features are available as part of a standard Candidate XML feed:

 

  • Uses industry standard HRXML and the Web Services interface
  • Enables resume stacking logic
  • Ability to add or remove and codes without the change to the interface
  • Ability to add additional information such as mailing address, employment history, education history, etc.
  • Ability to attach candidate forms

Web Services URL and WSDL

 

BrassRing provides a testing URL for the Candidate Import web service in the staging Enterprise environment. The following Web Server URL should be used during the UAT in Staging:

 

Web Service URL:

 https://stagingimport.brassring.com/CandidateImport/CandidateImportService/CandidateImportService.asmx

 

Service Description (WSDL):

 https://stagingimport.brassring.com/CandidateImport/CandidateImportService/CandidateImportService.asmx?WSDL

 

 Upon completion of the UAT in Staging, the production URLs will be as follows:

 

 Web Service URL:

 https://import.brassring.com/CandidateImport/CandidateImportService/CandidateImportService.asmx

 

Service Description (WSDL):

 https://import.brassring.com/CandidateImport/CandidateImportService/CandidateImportService.asmx?WSDL

 

Sample XML

<?xml version="1.0"?>

<BRpartner:Envelope version="01.00" xmlns:BRpartner="http://trm.brassring.com/brpartner">

       <Sender>

             <Id>HRXMLUSER</Id>                        <!-- Required - This is provided by Kenexa. Do not change this information  -->

             <Credential>25008</Credential>         <!-- Required - This is provided by Kenexa. Do not change this information -->

       </Sender>

       <Recipient>

             <id type="email">email@kenexa.com</id>  <!-- Optional - This is the Acknowledgement response. It can also be id type="email".  Entering this information is optional  -->

       </Recipient>

       <TransactInfo transactType="data">

             <transactId>10000009</transactId>

             <timeStamp>2008-07-25T16:50:09.548000-0600</timeStamp>

       </TransactInfo>

       <Packet>

             <PacketInfo packetType="data">

                    <packetId>1</packetId>

                    <Action>INSERT</Action>

                    <Manifest>CANDIDATE_UPLOAD</Manifest>

             </PacketInfo>

             <Payload><![CDATA[<?xml version="1.0" encoding="UTF-8"?>

<Candidate xmlns:RHrxml="http://ns.hr-xml.org/2004-08-02" xmlns:BRpartner="http://trm.brassring.com/brpartner">

       <CandidateRecordInfo>

             <Id idOwner="CandidateId">

                    <IdValue/>

             </Id>

             <Status>Active</Status>

       </CandidateRecordInfo>

       <CandidateSupplier relationship="x:vendor">

             <SupplierId>

                    <IdValue>Vendor</IdValue>

             </SupplierId>

             <EntityName>Verifications</EntityName>

       </CandidateSupplier>

       <CandidateProfile xml:lang="EN">

             <PersonalData>

                    <PersonName>

                           <GivenName>Gabriela</GivenName>

                           <MiddleName/>

                           <FamilyName>Sabatini</FamilyName>

                    </PersonName>

                    <ContactMethod>

                           <Location>home</Location>

                           <Telephone>

                                 <FormattedNumber>(100) 111-0091</FormattedNumber>

                           </Telephone>

                           <Fax>

                                 <FormattedNumber>(100) 111-0092</FormattedNumber>

                           </Fax>

                           <InternetEmailAddress>Gabriela.Sabatini@hotmail.com</InternetEmailAddress>

                           <InternetWebAddress>myinternetpage</InternetWebAddress>

                           <PostalAddress>                               

                                 <CountryCode>US</CountryCode>                  <!-- Required tag, required value -->

                                 <PostalCode>90210</PostalCode>                  <!-- Optional tag, Optional value -->

                                 <Region>CA</Region>                                     <!-- Optional tag, Optional value -->

                                 <Municipality>Hollywood</Municipality>           <!-- Optional tag, Optional value -->

                                 <DeliveryAddress>

                                        <AddressLine>123 Hollywood Ave</AddressLine>                      <!-- Optional tag, Optional value -->

                                        <AddressLine/>                                                                              <!-- Optional tag, Optional value -->

                                 </DeliveryAddress>

                           </PostalAddress>

                    </ContactMethod>

                    <ContactMethod>

                           <Location>office</Location>                                                             <!-- Optional tag, Optional value -->

                           <Telephone>

                                 <FormattedNumber>(100) 111-0093</FormattedNumber>         <!-- Optional tag, Optional value -->

                           </Telephone>

                    </ContactMethod>

                    <ContactMethod>

                           <Location>office</Location>                                                             <!-- Optional tag, Optional value -->

                           <Telephone>

                                 <FormattedNumber>(100) 111-0094</FormattedNumber>         <!-- Optional tag, Optional value -->

                           </Telephone>

                    </ContactMethod>

             </PersonalData>

             <!-- Up to 5 maximum EmploymentHistory\EmployerOrg can be passed. You can omit them all if you choose. -->

             <EmploymentHistory>

                    <EmployerOrg>

                           <EmployerOrgName>ING</EmployerOrgName>                                                           <!-- Required tag, Optional value -->

                           <PositionHistory>

                                 <OrgName>

                                        <OrganizationName>Profit Sharing Director</OrganizationName>                 <!-- Required tag, Optional value -->

                                 </OrgName>

                                 <Description>Directed the profit sharing distribution process</Description>       <!-- Required tag, Optional value -->

                                 <StartDate>

                                        <Year>2001</Year>                                                                                                       <!-- Required tag, Required value -->

                                 </StartDate>

                                 <EndDate>

                                        <Year>2007</Year>                                                                                                       <!-- Required tag, Required value -->

                                 </EndDate>

                           </PositionHistory>

                    </EmployerOrg>             

             </EmploymentHistory>

             <EducationHistory>

                    <!-- Up to 3 maximum can be passed -->

                    <SchoolOrInstitution schoolType="university">

                           <School>

                                 <SchoolName/>                                   <!-- Optional. This is theEducational Institute.  Leaving this value empty is Ok  -->

                           </School>

                           <Degree degreeType="bachelors">

                                 <DegreeName/>                                  <!-- Optional. This is the Area of Study.  Leaving this value empty is Ok  -->

                                 <DegreeDate>

                                        <Year/>                                        <!-- Optional. This is the Grad Year.  Leaving this value empty is Ok  -->

                                 </DegreeDate>

                                 <DegreeMeasure>

                                        <EducationalMeasure>

                                               <MeasureSystem/>

                                               <MeasureValue>

                                                     <NumericValue/>                   <!-- Optional. This is the GPA.  Leaving this value empty is Ok  -->

                                               </MeasureValue>

                                        </EducationalMeasure>

                                 </DegreeMeasure>

                           </Degree>

                    </SchoolOrInstitution>

             </EducationHistory>       

       </CandidateProfile>

       <UserArea>

             <BRpartner:codes>

                    <BRpartner:code>UBS_Vendor</BRpartner:code>             <!-- Required - This is provided by Kenexa. Do not change this information  -->

                    <BRpartner:code>UBS_Import</BRpartner:code>                <!-- Required - This is provided by Kenexa. Do not change this information  -->

             </BRpartner:codes>

             <BRpartner:candidatetype>Internal</BRpartner:candidatetype>

             <BRpartner:PostBackResumekey>yes</BRpartner:PostBackResumekey>

       </UserArea>

</Candidate>

 

 ]]></Payload>

       </Packet>

       <Packet>

             <PacketInfo packetType="data">

                    <packetId>2</packetId>

                    <Action>SET</Action>

                    <Manifest>CAN_SEARCH_FORM</Manifest>

             </PacketInfo>

             <Payload><![CDATA[<?xml version="1.0"?>

             <form resumeKey="" formName="Candidate Search" LastName="Cn" formTypeId="76" FirstName="Shiva" action="UPDATE" language="EN" email="shiva@nath@ubs.com" homePhone="+91 4106226 8">

                    <FormInput name="2268" title="GPN">1</FormInput>

                    <FormInput name="2269" title="Rank">ED</FormInput>

                    <FormInput name="2270" title="Current Business Title">test title</FormInput>

                    <FormInput name="2271" title="Current Work Region">LOC_P</FormInput>

                    <FormInput name="2272" title="Current Work Country">GBR : United Kingdom</FormInput>

                    <FormInput name="2273" title="Current Work City">Calgary</FormInput>

             </form>

 ]]></Payload>

       </Packet>

</BRpartner:Envelope>

 

 

Sample Asynchronous Response

 

<Envelope version="01.00">

       <Sender>

             <Id>HRISUSER</Id>

             <Credential>100</Credential>

       </Sender>

       <Recipient>

             <Id></Id>

       </Recipient>

       <TransactInfo transactType="response">

             <TransactId>5555</TransactId>

             <TimeStamp>2006-02-20T12:29:36Z</TimeStamp>

             <Status>

                    <Code>200</Code>

                    <ShortDescription>Success</ShortDescription>

                    <LongDescription>Candidate Import was a success</LongDescription>

             </Status>

       </TransactInfo>

       <Packet>

             <PacketInfo packetType="response">

                    <PacketId>2</PacketId>

                    <Action>SET</Action>

                    <Manifest>MANIFESTNAME</Manifest>

                    <Status>

                           <Code>200</Code>

                           <ShortDescription>Success</ShortDescription>

                           <LongDescription>EEO Form created/updated successfully</LongDescription>

                    </Status>

             </PacketInfo>

       </Packet>

       <!-- Resumekey will be posted back only if request inclued PostBackResumeKey tag -->

       <RESUMEKEY>4687956</RESUMEKEY>

</Envelope>

© 2008 Kenexa