This method gets a list of staff at a dealership you have access to from your access code.

URL : http://webservice.dealerhub.net/dealerhub/WS/DealerHubV1.cfc?wsdl

Method : getstaff

Input Parameters :

XMLSecurity
XMLData

There are always 2 parameters passed, these are both XML strings, and the first is XMLSecurity which holds the secuirty information, i.e your access code and the dealercode that you want to access the data for, and the second is the XML data you are going to pass in.

This webservice does not need any value in the XMLData parameter, you can pass it as an empty string.

If you need to view the information on how to format the XMLSecurity data string, please click here

Example output for a valid call:

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet>
<StaffMember>
<NAME>Mike Harrison</NAME>
<ACTIVE>1</ACTIVE>
<DISPLAYLANG>EN</DISPLAYLANG>
<EMAIL>mike@dealerhub.net</EMAIL>
<MOBILE>07677755444</MOBILE>
<LEVELNAME>Sales Manager</LEVELNAME>
<SINGLESIGNONCODE>5C5062455EB4DF486B962DA9BCDDC7E6</SINGLESIGNONCODE>
<RID>1005</RID>
</StaffMember>
<StaffMember>
<NAME>Chris Parsons</NAME>
<ACTIVE>1</ACTIVE>
<DISPLAYLANG>EN</DISPLAYLANG>
<EMAIL>chris@dealerhub.net</EMAIL>
<MOBILE/>
<LEVELNAME>Sales Exec</LEVELNAME>
<SINGLESIGNONCODE>6DG173677EB4DF486B962DA9BCDDC7E6</SINGLESIGNONCODE>
<RID>1005</RID>
</StaffMember>
</ResultSet>

 

Output :

Field Name Field Type Field Description
Name String The users name
Active Numeric 1 = Yes they are active, 0 = No they have their account disabled
DisplayLang String Display language, EN = English
Email String Users email address
Mobile String Users Mobile number
Level Name String The users level name, i.e sales manager, receptionist etc
SingleSignOnCode String Unique code per user thats to be used when creating a single sign when integrating software products
RID Numeric Retailer ID number this user belongs to

 

Example output for an invalid call / or general error in a webservice call

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
<Error>
<ErrorCode>2</ErrorCode>
<ErrorInfo>No Data found </ErrorInfo>
</Error>
</ResultSet>

There may be multiple errors returned in the XML packet, they are separated by <Error> blocks and each block contains an ErrorCode to allow you to do some processing logic on the numerical value returned, and an ErrorInfo which is used by the developer or administrator to visually see what the problem is with the submission.