Advantage Finance XML Developer's Site

Here follows the XML structure for sending applications to Advantage via XML Soap.

• The nodes in red are mandatory.
• At least one of <Flat>, <HouseName>, and <HouseNumber> must be specified in each address. If more than one field can be submitted you may do so.
• Where there is an attribute specified such as <Applicant AppID=1> the value will be a number. In this example AppID=1 for the main applicant and AppID=2 for the joint applicant. For the address details it will be <Address AddID=1> for the first address, Add=2 for the second address and so forth.
• Certain nodes, such as RentMortgageFrequency are specified with a word. A full list can be found on the Node Word Values page.
• All dates are to be sent in the format: dd/mm/yyyy.
• The RentMortgage and RentMortgageFrequency nodes are only used with the first address node for each applicant. It won't break if you include them in the second and third addresses but they won't be stored.
• The DealerID node is a number relating to the id with which you are stored in our database.
• XMLSoapPassword is a maximum 50 character string used only for authenticating XML Soap applications.
• DealerReference is a string used for linking applications in our database to your database, optional.
• DealerNote is used for sending over a short note about the application. This note can be seen by an underwriter and your Sales Manager.

See below for maximum field lengths for all nodes.

<Advantage>
	<NumberOfApplicants>
<Applicant AppID=1>
	<Title>
	<FirstName>
	<LastName>
	<DOB>
	<MarritalStatus>
	<Email>
	<Mobile>
	<ResidentialType>
	<DependentChildren>
	<NumberOfAddresses>
	<NumberOfEmployments>
	<Address AddID=1>
		<!-- You must specify a minimum of one of the following three fields, more if possible -->
		<Flat>
		<HouseName>
		<HouseNumber>
		<Street>
		<Town>
		<County>
		<PostCode>
		<Telephone>
		<TimeMonths>
		<RentMortgageCost>
		<RentMortgageFrequency>
	<Employment EmpID=1>
		<JobTitle>
		<CompanyName>
		<Street>
		<Town>
		<County>
		<PostCode>
		<Telephone>
		<TimeMonths>
		<Status>
<Income>
	<IncomeMain>
	<IncomeMainFrequency>
	<IncomeJoint>
	<IncomeJointFrequency>
<Goods>
	<Make>
	<Model>
	<Colour>
	<Mileage>
	<DateReg>
	<RegNo>
	<CashPrice>
	<CashDeposit>
	<PartExchange>
	<FinanceRequired>
<Dealer>
	<DealerID>
	<XMLSoapPassword>
	<DealerReference>
	<DealerNote>

An example of a sent XML file. [Sent.xml]

Maximum lengths for the nodes.