General lead interface

DV relays back lead information to the lead management system of the advertiser. For custom or unsupported lead management systems the general lead interface can be used. This is implemented as a simple HTTPS callback/webhook.

Interface description

DV will POST leads as an XML message to an endpoint given by the advertiser using the HTTPS protocol. The endpoint should process/store the lead and return a simple XML message so DV knows the message has been accepted.
The request XML is defined in https://www.doorlinkenvoorraad.nl/xml/lead-1.2.xsd.
The response XML should contain a <success>-tag with the value of 1.

Sample transaction

Request:

POST /endpoint HTTP/1.0
Host: www.leadmanagementsystem.com
Content-type: text/xml; charset=UTF-8
Content-length: 476

<?xml version="1.0" encoding="UTF-8"?>
<lead version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://www.doorlinkenvoorraad.nl/xml/lead-1.2.xsd">
	<id>123</id>
	<customer_number>456</customer_number>
	<created>2015-11-04T12:00:00+01:00</created>
	<name>John Doe</name>
	<email>john.doe@hotmail.com</email>
	<message>I’d like to purchase this vehicle</message>
	<vehicle>
		<stock_number>789</stock_number>
	</vehicle>
</lead>
				

Response:

HTTP/1.0 200 OK
Content-type: text/xml; charset=UTF-8
Content-length: 83

<?xml version="1.0" encoding="UTF-8"?>
<response>
	<success>1</success>
</response>
				

(SSL is omitted in this example)