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. 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: BrassRing provides a testing URL for the Candidate
Import web service in the staging Web Service URL: Service Description (WSDL):
Service Description (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>
<PostalCode>90210</PostalCode>
<!-- Optional tag, Optional value -->
<Region>CA</Region>
<!-- Optional tag, Optional value -->
<Municipality>
<DeliveryAddress>
<AddressLine>
<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 :
<FormInput name="2273" title="
</form> ]]></Payload>
</Packet> </BRpartner:Envelope>
<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>
The following benefits and
features are available as part of a standard Candidate XML
feed:
Web Services URL and WSDL
Sample Asynchronous
Response
© 2008 Kenexa |