SOAP Web Service - Update an Employee


Note: Service Manager SOAP web services are no longer maintened since the Oxygen version. You can still use them but we recommend that you use the Service Manager REST API to take advantage of the latest enhancements and features.

Open url.png See Update an employee method of the Service Manager REST API.


  • This web service allows a specified employee to be modified using the Service Manager wizard.


Best Practice

  • You can complete the missing fields by using the EZV_ModifyUserXML web service. It allows you to update any field using an XML structure.

List of parameters

Mandatory parameters

You must enter the parameters below.

Object Type Description / Example
account string Service Manager account used.
example 50004: Production base ; 50005: Sandbox base
login, pass string Login / password used to connect to Service Manager.
identification string Employee number (unique). If several employees have the same name / first name, enter this information to distinguish them.
last_name string Name and first name of the employee to create. Respect your naming conventions for names.
example Adam, Carol ; Leblanc - Fred

Optional parameters

Object Type Description / Example
cellular_number, fax_number, phone_number string Cellular_number, fax_number and phone_number of the employee.
civil_status_id string Identifier for employee title (civility) (Example: Mr., Mrs.).
cost_per_hour string Employee costs per hour when his interventions are charged back.
default_cost_center_id string Identifier of the default cost center to which equipment / contracts / licenses will be charged back and for which the employee is responsible.
function_id string Identifier for the employee function (His job).
icq_number string ICQ address of the employee.
it_correspondant string 1 = The employee performs a specific role as IT correspondent in the company. 0 otherwise.
language_id string Identifier for the language in which Service Manager is displayed when the employee connects to the application.
manager_id string IIdentifier for the hierarchical person in charge of the employee.
messenger_sign_name string Messenger address of the employee.
notification_type_id string Identifier for the means of communication of the employee (Example: Mail, phone).
supplier_id string Company identifier of the employee.
validator_id string Identifier of the person in charge of financial approvals for the employee.
vip_level_id string VIP level identifier of the employee.

Description of the actions carried out

1. The employee is updated in the AM_EMPLOYEE table.

2. The updated fields are the same to those updated by the Service Manager update wizard.

  • The fields last_name and/or identification (one of the two or both can be informed) are used as search keys.
  • The field last_name can be modified but not the field identification.

Return codes for the web service

Code Error Corrective action
1 Request processed successfully
-1 Database not found Check that the account parameter matches a Service Manager account.
-2 Unable to connect to Service Manager Check and correct the login and pass parameters.
-7 Missing name / first name of the employee Enter the last_name parameter.
-8 Incorrect employee number The employee number does not correspond to an existing employee. Check and correct the identification parameter.
-13 One of the parameters relative to a date is incorrect Check and correct the date parameters.
-18 Incorrect employee profile The profile does not correspond to an existing user profile. Check and correct the profil_id parameter.
-22 Maximum number of connections have been reached Check that your profile defined on the Service Manager account authorizes the execution of the action requested to the web service.
Last modified by Unknown User on 2021/12/22 15:38
Created by Administrator XWiki on 2013/03/25 18:25


Recent changes
•  EV Service Manager
•  Service Apps
•  EV Self Help
•  Service Bots

Powered by XWiki ©, EasyVista 2021