« Back to SOAP operation list

addEvent

When a candidate applies to a job post an application identified by a unique code is created. This application may be associated to one or more TimeLine events. A TimeLine event is created every time the application undergoes a status change, for instance when the cv included in the application has been read by the company, or when the candidate is rejected from the application process. A post to this operation creates an application event associated to the applicationId provided by the authenticated user.

Request

WSDL URL

https://api.infojobs.net/soap/WSApplicationTimelineService?wsdl

Security

  • User Role: ROLE_EMPLOYER

Parameters

Name Description

application

String

Required

Identifier of the application that we want to create a TimeLine event for.

Example values: 706280-6d45-483a-8327-d8c81b2ab

idEvent

String

Required

Text key that identifies the kind of event. The operation /dictionary/timeline-event returns all the allowed key values.

Maximum length: 100

bodyMessage

String

Optional

When an event with key message-send is created, you must send the body message you want to show to the candidate.

Maximum length: 1500

Response

Response fields

Fields related to Event entity
Name Description

date

Date

The date of the last event of the job offer feed.

Example value: 2011-05-31T09:09:20.000+0000

description

String

The event description.

Maximum length: 200

initializer

Boolean

true if the event is the first of the current application process stage, false otherwise.

finisher

Boolean

true if the event is the last of the current application process stage, false otherwise.

rejectedReasons

Array(String)

Array with rejection reasons if present.

Error codes

Code Description

WS.2100

The application application is not a valid parameter.

WS.2101

The event idEvent is not active anymore.

WS.2102

The event idEvent is not valid.

WS.2103

The user is not allowed to manage the offer related with the application

WS.2104

The field application is mandatory

Examples

This example adds a cv-read event to an application.

Request

	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tim="http://timeline.application.endpoints.www.soap.infojobs.net/">
	   <soapenv:Header xmlns:ij="http://api.infojobs.net/soap/authn" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
	      <wsse:Security soapenv:mustUnderstand="1">
	         <wsse:UsernameToken wsu:Id="SecurityToken-3025a7e6-5134-48a6-b021-350bd5ddc789">
	            <wsse:Username>SOAP-TEST</wsse:Username>
		    	  <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-PASSWORD</wsse:Password>
	         </wsse:UsernameToken>
	      </wsse:Security>
	      <ij:authnHeader>
		   <token>20000000-0000-0000</token>
	      </ij:authnHeader>
	   </soapenv:Header>
	   <soapenv:Body>
	      <tim:addEvent>
	         <wsAddTimelineEventRequestBean>
	            <application>e343ba71-0b20-47e3-85dd-90268c8fb1c6</application>
	            <bodyMessage>bla bla bla</bodyMessage>
	            <idEvent>cv-read</idEvent>
	         </wsAddTimelineEventRequestBean>
	      </tim:addEvent>
	   </soapenv:Body>
	</soapenv:Envelope>
	</dev>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <wsse:Security soap:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsu:Timestamp wsu:Id="TS-1">
            <wsu:Created>2017-04-24T09:05:05.710Z</wsu:Created>
            <wsu:Expires>2017-04-24T09:10:05.710Z</wsu:Expires>
         </wsu:Timestamp>
      </wsse:Security>
   </soap:Header>
   <soap:Body>
      <ns1:addEventResponse xmlns:ns1="http://timeline.application.endpoints.www.soap.infojobs.net/">
         <wsAddTimelineEventResponseBean>
            <date>2017-04-24T11:05:05.135+02:00</date>
            <description>La empresa ha leído tu CV</description>
            <finisher>false</finisher>
            <initializer>false</initializer>
         </wsAddTimelineEventResponseBean>
      </ns1:addEventResponse>
   </soap:Body>
</soap:Envelope>

Sections: