Web Site Integration - Advice for Web Developers

Linking Vehicle Stock data to the Web Site

Webservices

The primary requirement for most web sites is to integrate the Navigator Vehicle Stock with the Web site so that vehicle stock is updated in near realtime.

Navigator provides a web service which provides a vehicle stock list - this is a RESTful web service, responding only to GET and which can optionally return eithera JSON or HTML payload with a snap shot of the vehicle stock.

The web service URL is in the form :

For XML Data

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetNavigatorReport/[apikey],1,XML_VEHICLE_STOCK_LIST,xml,1,WEB,,1,1

For JSON Data

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetNavigatorReport/[apikey],1,XML_VEHICLE_STOCK_LIST,json,1,WEB,,1,1

An API key can be issued on request. Please contact your Project Manager to gain an API key - please note though that requests must come from the DMS Navigator customer for security reasons.

An example of the data that comes in the feed is available on our help pages at : http://v21manual.dmservices.co.uk/vehicle_web_services_2.asp

Images are also available. The feed returns a list of image filenames and these can be individually retrieved using a web service with the URL :-

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetImage/[API KEY],1,[filename]

Methodology

The web service feeds should be used to upload the vehicle stock and associated images into a local Web Site database - the data should not be relied on for live display on the dealer's web site.

It is recommended that the stock is polled no more than once an hour - and less frequently the larger the stock database is (ideally once or twice a day shold be sufficient). Every vehicle has a stock no and this should be used as the primary key when matching to the local database. New vehicles will appear in the feed when advertised, and the feed includes all vehicles up to the point they are sold, in which case they will disappear from the feed.

Advertising a Vehicle

Vehicles need to have advertising details added to them before they appear in the web feed above. To review the options available, please see

https://vimeo.com/412308095/8a3be4905f

Sending Enquiries back to Navigator

Web site enquiries can be sent back into Navigator where they are automatically converted into Sales Enquiries. Navigator Sales People can be organised into Teams (eg Used Sales Team or Contact Centre Team) and enquiries can be automatically routed to the correct team .

There are two ways that an enquiry can be sent back to Navigator :-

Email

The simplest way of sending an enquiry to Navigator is to simply forward an email to a Navigator Email address. An email address can be configured and mapped to a sales team and have an Enquiry Type, Source and Sub-Source attached to it as appropriate. Please discuss this with your Navigator Project Manager to have an email address allocated.

This creates a blank enquiry and requires to Sales Executive to refer to the email itself to create the details on the enquiry.

Web Service

The most comprehensive way of creating an enquiry is to use a Web Service. This is a RESTful service supporting POST and takes an XML or JSON document which is structured to send the enquiry into Navigator.

The API key used to extract the Vehicle Stock Data above can be used in this Web service call.

For details please refer to :- http://v21manual.dmservices.co.uk/transactional-web-service.asp for generic details on the Web Service process, and http://v21manual.dmservices.co.uk/online-sales-360-contact-form.asp for specific details on the implementation of this web service

>>> contact your account manager