SOAP Web Service - Create 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 Create an employee method of the Service Manager REST API.


  • This web service allows a new employee to be created using the Service Manager wizard.


Best Practice

  • You can also use the EZV_CreateUserXML 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.
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
begin_of_contract string Arrival date for the employee in the company.
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.).
department_code string Department identifier of the employee..
e_mail string Email address of the employee.
function_id string Identifier for the employee function (His job).
identification string Employee number (unique). If several employees have the same name / first name, enter this information to distinguish them.
language_id string Identifier for the language in which Service Manager is displayed when the employee connects to the application.
location_code string Location identifier of the employee.
notification_type_id string Identifier for the means of communication of the employee (Example: Mail, phone).
profil_id string Profile identifier of the employee.
str_login string Employee login allowing access to Service Manager.
supplier_id string Company identifier of the employee.

Description of the actions carried out

1. An employee is created in the AM_EMPLOYEE table.

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

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.
-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:30
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