Agriaffaires.com / MachineryZone.com / Truckscorner.fr

AA / MZ / TC XML SPECIFICATIONSS

The XML file must be encoded using UTF8.

The name of the xml file is text free.

Xml file must include all the ads to be published.

Changing the names and attributes of nodes is prohibited.

Names and attributes are case sensitive.

Values in bold are sample values which may be replaced by your own values.

The id attributes may contain any type of value (numbers, letters, codes …).

XML file details

Root of the xml file (mandatory)

type: Define the feed configuration

Equipments nodes description

Primary equipments node (mandatory)

Contains all the equipments of the stock list.

Single equipment node (mandatory)

id: Unique identifier for each equipment (in the dealer's software).

Crawler dozer

</category>

Category of the equipment (mandatory)

id: Unique identifier for each category.

Text : Name of the category.

List : http://www.agriaffaires.com/rubric/properties/html/en

j.wayne@construction-llc.com

</seller>

…

</sellers>

List of sellers for the current equipment (optional)

Email or unique ID (alphanumeric) can be used as an identifier for each seller. They must refer to an existing user of the customer account.

Users can be created using specific nodes in the XML file (see Sellers node description).

If node is missing, the seller of the equipment will be the main user of the account.

GLENVIEW

</address>

Address of the equipment (optional)

Contains a unique identifier that refers to an address of the account.

New addresses can be created through the XML file (see Address’ node description).

If node is missing, equipment will be located on the main address of the account.

Auction sale of the equipment (optional) :

Contains a unique identifier that refers to the auction registered for the current equipment.

New auctions can be added through the XML file, using the <auction> node (see Auction’s node description)

MAT00019489-1.jpg

</picture>

MAT00019489-1.jpg

</picture>

MAT00019489-1.jpg

</picture>

…

</pictures>

Names or URLs of the jpg files for the pictures (optional)

main: main picture of the ad (1) or secondary one (<empty>)

By default the main picture is the first in the list.

A maximum of 50 pictures can be listed, depending on package subscription

http://www.youtube.com/...

</video>

<video>

http://www.youtube.com/...

</video>

…

</videos>

URLs of the equipment’s video record (optional)

main: main video of the ad (1) or secondary one (<empty>)

By default the main video is the first in the list.

Deere

</property>

950J

</property>

2009

</property>

4931

</property>

…

</properties>

Properties of the equipment (mandatory)

id: Unique identifier for each property of a category

name: Name of the property

text: Value of the property for this equipment

There can be as many properties as needed.

Please check mandatory properties: http://www.agriaffaires.com/rubric/properties/html/en

Specific properties

D459

</property>

Equipment reference (ex: stock number,...) (optional)

Y

</property>

Used equipment can be firsthand (Y) or not (N) (optional)

05/11/2013

</property>

Indicates if the equipment is available from a specific date (dd/mm/yyyy) (optional)

Very Good

</property>

Condition of the equipment (optional)

If the equipment is brand new, you can specify “New” as condition.

If node is missing, equipment’s condition will be set to: “Used”.

</property>

Price of the equipment (optional)

<currency>: please refer to the ISO 4217 codes’ list to inform the currency of the indicated price.

<vatrate>: VAT rate in percentage (%)

<vatexcl>: Price excluding VAT

<vatincl>: Price including VAT

<en>Equipment description</en>

<fr>Description de l’équipement </fr>

…

</property>

Free comments about the equipment (optional)

Multilanguage is available using <language> nodes.

Languages’ nodes are built from ISO 639 codes *

http://mywebsite.com/ads/ad001.html

</property>

URL for auction ads (optional)

Display a redirecting link to the online auction ads.

Sellers node description

Primary sellers node (mandatory)

Contains all the sellers defined in the XML file.

OR

Single seller node (mandatory)

id: email or alphanumeric ID as unique identifier for each seller

Gender of the seller (optional)

Possible values: MR (used by default); MRS

<name>WAYNE</name>

Identity of the seller (mandatory nodes)

<email>

j.wayne@agricorp.com

</email>

Email of the seller (mandatory)

If not used as <seller id>, email must be provided here.

+1 (502) 515 3636

</mobilephone>

Seller’s contact details (optional)

en

</mainlanguage>

Main language spoken by the seller (optional)

Content of the node must be from ISO 639 languages’ codes*

If node is missing, language will be the one of the main user of the account.

Purchasing Manager

</occupation>

Main occupation of the seller (optional)

Please refer to the following list of occupations :

If node is missing, default occupation will be “Sales Representative”.

Addresses node description

Primary addresses node (mandatory)

Contains all the addresses defined in the XML file.

Single address node (mandatory)

id: unique identifier for each address (text free)

<title>EQUIP LLC Main address</title>

Title of the address (mandatory)

EQUIP LLC

</compagnyname>

<street1>8500 Dundas</street1>

<street2>Main Street</street2>

<city>GLENVIEW</city>

<state>California</state>

http://www.equip-llc.com

</website>

Address’ contact details (All nodes mandatory ; excepted “street 2” and “website”)

For nodes <state> and <country> please see the list of accepted value:

Building company

</activity>

Activity of the company related to the address (optional)

If node is missing, activity will be the one of the main user of the account.

<siret>

93941692100012

</siret>

SIRET identification number

Mandatory for French professional dealers

Optional for other countries

Auctions nodes description

Primary node for the auction sale (mandatory)

Contains all the auction sales defined in the XML file.

Single node for the auction sale (mandatory)

id: Unique identifier of the auction sale

<name>

GLENVIEW AUCTION EVENT

</name>

Name of the auction sale (mandatory)

GLENVIEW

</location>

Location of the auction sale (mandatory)

ID of the address location (from Address’ node)

dd/mm/yyyy

</datestart>

Starting date of the sale (mandatory)

Format : dd/mm/yyyy

dd/mm/yyyy

</dateend>

Ending date of the sale (mandatory)

Format: dd/mm/yyyy

<phone>

+1 (559) 817 3636

</phone>

Auction sale phone number (optional)

<fax>

+1 (559) 817 4242

</fax>

Auction sale fax number (optional)

Primary node for the visits of materials on exhibition parks (optional)

Opening days and hours for the visits (optional)

date : date of the visit (dd/mm/yyyy)

starthour : start time of the visit (hh :mm)

endhour : end time of the visit (hh :mm)

Auction mode: upward (U) or downward (D) (optional)

By default, auction mode is upward

Auction sale with reserve price (1) or not (0) (optional)

By default, the sale will not have a reserve price

<url>

http://www.mysite.com/auction=267

</url>

URL of the auction sale on the customer website (optional)

* Lists of codes (languages, country areas, activities, …) used on Agriaffaires, MachineryZone and Truckscorner websites are available here:

List of categories and fields - EN

Did this article help you?