Back to index

CreateDriver_v2

This method allows you to create a driver in the database, for customers who use ELDs

Parameters:

[in] usn The user-name that you need to use to authenticate on this interface.
[in] pwd The password that you need to use to authenticate on this interface.
[in] options String parameter. You can specify optional StartDate parameter here in the format: "StartDate=YYYY-MM-DD"
[in] name String parameter. This is the display name for the diver.
[in] firstName String parameter. This is the divers' first name.
[in] surname String parameter. This is the divers' surname.
[in] dateOfBirth DateTime parameter. Date of birth for the driver in the format YYYY-MM-DD.
[in] telephoneNumber String parameter. This is the telephone number for the driver.
[in] emailAddress String parameter. This is the drivers email address.
[in] employeeNumber String parameter. This is the drivers employee number.
[in] driverFolderName String parameter. This is the name of the folder that the employee is a member of.
[in] driverLicenseNumber String parameter. This is the drivers license number, must be between 1-20 characters.
[in] licenceIssued DateTime parameter. Date of licence issuing in the format YYYY-MM-DD.
[in] licenceExpiry DateTime parameter. Date of licence expiry in the format YYYY-MM-DD.
[in] driverLicenseStateCode String parameter. This is the drivers license state, must be a valid state code.
[in] driverCountryCode String parameter. This is the country code for the drivers licesnse.
[out] driverID int referring to the ID of the newly created driver.
[out] errorMsg If an error happpens this string contains the error message. In case an error has happened (this variable contains a valid non-empty string) then the return value will not contain any usable data, do not try to parse it as an xml.
return value If the errorMsg variable is null or empty then the returned string contains the requested data in xml format. The xml has the following structure:
<?xml version="1.0" encoding="utf-16"?>
<root>
<drivers>
  <driver driverID="7" name="TestDriver1" />
</drivers>
</root>
Please note this.

Remarks

Minimum R-COM Database version

If StartDate is specified, the minimum version is 0.2930. Otherwise the minimun version is 0.2628.

Error messages

Please see this page.