Employee Entity

The employee entity contains information about an individual dealer employee. Employees need to be configured by certified dealer managers. Their primary use is to allow reviewers to tag employees that they dealt with in their review as they write it, which in turn lets us filter and report to other end users on reviews written for particular employees.

Sample Employee XML

<Employee>
  <AtDealershipSince>
    <Date>2015-08-01T00:00:00</Date>
    <Months>5</Months>
    <Years>2</Years>
  </AtDealershipSince>
  <AverageRating>5</AverageRating>
  <Biography>
    Internet Sales 
    tom.downing@actontoyota.com 
    978-431-5861 
 
    I am originally from Arlington, MA and currently live locally in Chelmsford. I have worked professionally within the automotive industry since 1992. Nearly all of the time has been on the retail side, however, I spent several years venturing into automotive publishing. One of the more interesting Toyota projects I worked on was with author and Toyota enthusiast Moses Ludel and his piece The Toyota Truck & Land Cruiser Owner's Bible.
 
    I've worked for Bob Moran, owner of Acton Toyota of Littleton, for the last 6 years with a little more than one year here at Acton Toyota. In that time, I've become a Toyota Certified sales representative.
 
    In my free time, I am a singer and songwriter.
  </Biography>
  <CertifiedBadgeURL>
    http://www.dealerrater.com/ncdn/u/NotSet/Graphics/certified_employee_badge_round.png
  </CertifiedBadgeURL>
  <DealerId>15322</DealerId>
  <EmployeeCertifications>
    <Certification>Certification 1</Certification>
    <Certification>Certification 2</Certification>
  </EmployeeCertifications>
  <FirstName>Tom</FirstName>
  <Id>13241</Id>
  <ImageURL>http://apicdn.dealerrater.com/images/users/actontoyota/TomDowning.jpg</ImageURL>
  <InIndustrySince>
    <Date>2001-02-01T00:00:00</Date>
    <Months>11</Months>
    <Years>16</Years>
  </InIndustrySince>
  <LanguagesSpoken>
    <Language>Arabic</Language>
    <Language>English</Language>
  </LanguagesSpoken>
  <ManufacturersSold>
    <Manufacturer>
    <Id>15</Id>
    <Name>Ford</Name>
    </Manufacturer>
    <Manufacturer>
    <Id>28</Id>
    <Name>Lincoln</Name>
    </Manufacturer>
    <Manufacturer>
    <Id>49</Id>
    <Name>Used Car Dealer</Name>
    </Manufacturer>
  </ManufacturersSold>
  <LastName>Downing</LastName>
  <Position>Internet Sales</Position>
  <TotalReviews>116</TotalReviews>
  <Department>SALES</Department>
</Employee>

Employee Attributes

Attribute	Type	Description
AtDealershipSince	date/years/months	The date that the employee joined the dealership (this is in the "Date" property). We also offer the number of years and months since "now" (the API invocation time) for convenience. This will change over time, so please be aware.
AverageRating	double	An average rating (1-5) of all reviews this employee has been tagged in.
Biography	string	Each employee can optionally have a biography. The biographies are normally a few paragraphs and serve to introdce a consumer to the employee.
CertifiedBadgeURL	string	A URL to the certification badge of the employee when the employee is a certified. When the employee is not certified this field will be missing.
DealerId	int	The primary key of the dealer to which this employee belongs.
EmployeeCertifications	string array	A list of optional certifications that the employee has listed in their profile.
FirstName	string	The employee's first name.
Id	int	The employee's primary key. Used to uniquely identify an employee in the system.
ImageURL	string	Fully qualified URL to the employee's image. The URL given uses HTTP; the endpoint does support HTTPS, but given a defect in our CDN provider's service, the certificate will come back invalid. If you have a valid usecase that requires access to uploaded images via HTTPS, please contact our IT staff.
InIndustrySince	date/years/months	The date that the employee joined the automotive industry (this is in the "Date" property). We also offer the number of years and months since "now" (the API invocation time) for convenience. This will change over time, so please be aware.
LanguagesSpoken	string array	A list of languages that the employee speaks.
ManufacturersSold	array of manufacturer with Id (int) & name (string)	A list of vehicle makes that the employee sells (for sales and internet department employees only).
LastName	string	The employee's last name.
Position	string	The employee's position (or job title) at the dealer.
TotalReviews	int	The total number of reviews this employee has been tagged in.
Department	string	The department that the employee belongs to at the dealer.
YouTubeURL	string	A URL to a YouTube video featuring the employee.
AgentId	int	This is a lead specific piece of data that gets put into ADF/XML emails to push the lead to the correct employee. This field is not present if it is not available.