« 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

Maximum length: 100

Example values: hired

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

Available idEvent identifiers:
Name Description

application

Inscripción oferta

cv-read

CV leído

continue-process

Sigues en proceso

discarded

No sigues en proceso (descartado)

cv-deleted

CV borrado

message-send

Enviar mensaje

offer-modified

Oferta modificada

cvs-read

CVs leídos (el tuyo NO)

cvs-managed

Gestión de CVs (movidos de carpeta, el tuyo NO)

return-to-process

Pasas de Descartado a volver a estar en proceso

process-closed

El proceso de seleccion se ha cerrado

process-opened

El proceso de seleccion se ha abierto

offer-deleted-discarded-users

No continúas en el proceso de selección

interviewed

Entrevistado

hired

Contratado

contacted

Sigues en proceso

final-interview

Finalista

offer

Finalista

not-preselected

CV No preseleccionado

declined-by-candidate

El candidato ha rechazado la oferta

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.150

Expired access token

WS.152

Access Token is required

WS.153

Access token not authorized for this operation

WS.154

Invalid access token

WS.155

Invalid access token

WS.156

Wrong access token

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

WS.2105

Current user is not allowed to use this service. Missing ERP Integration product

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>

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: