Agriaffaires

MachineryZone

Truckscorner

Aller au contenu principal

XML Import File Details v3.6


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

<importfile version="3.4" type="complete">

Root of the xml file (mandatory)

type: Define the feed configuration

Equipments nodes description

<equipments>

Primary equipments node (mandatory)

Contains all the equipments of the stock list.

<equipment id="19399">

Single equipment node (mandatory)

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

<category id="10">

       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

<sellers>

       <seller>

              j.wayne@construction-llc.com

       </seller>

       <seller>45623</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.

<address>

       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.

<auctionsale>1</auctionsale>

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)

<pictures>

       <picture main="1">

              MAT00019489-1.jpg

       </picture>

       <picture>

              MAT00019489-1.jpg

       </picture>

       <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

<videos>

       <video main="1">

              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.

<properties>

<property id="1" name="Make">

       Deere

</property>

<property id="2" name="Model">

       950J

</property>

<property id="3" name="Year">

       2009

</property>

<property id="4" name="Hours">

       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

<property id="10" name="Stockid">

D459

</property>

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

<property id="12" name="First-hand">

Y

</property>

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

<property id="13" name="Availability">

05/11/2013

</property>

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

<property id="14" name="Status">

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 id="15" name="Price">

       <currency>USD</currency>

       <vatrate>20</vatrate>

       <vatexcl>18900</vatexcl>

       <vatincl>22680</vatincl>

</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

<property id="6" name="Description">

       <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 *

<property id="20" name="url">

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

</property>

URL for auction ads (optional)

Display a redirecting link to the online auction ads.

Sellers node description

<sellers>

Primary sellers node (mandatory)

Contains all the sellers defined in the XML file.

<seller id="j.wayne@agricorp.com">

OR

<seller>45623</seller>

Single seller node (mandatory)

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

<gender> MR </gender>

Gender of the seller (optional)

Possible values: MR (used by default); MRS

<name>WAYNE</name>

<firstname>John</firstname>

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.

<phone>+1 (502) 515 1515</phone>

<mobilephone>

+1 (502) 515 3636

</mobilephone>

<fax>+1 (502) 515 4242</fax>

Seller’s contact details (optional)

<mainlanguage>

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.

<occupation>

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

<addresses>

Primary addresses node (mandatory)

Contains all the addresses defined in the XML file.

<address id="GLENVIEW">

Single address node (mandatory)

id: unique identifier for each address (text free)

<title>EQUIP LLC Main address</title>

Title of the address (mandatory)

<companyname>

EQUIP LLC

</compagnyname>

<street1>8500 Dundas</street1>

<street2>Main Street</street2>

<postcode>40025</postcode>

<city>GLENVIEW</city>

<state>California</state>

<country>US</country>

<website>

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:

<activity>

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

<auctions>

Primary node for the auction sale (mandatory)

Contains all the auction sales defined in the XML file.

<auction id="2067">

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)

<location>

GLENVIEW

</location>

Location of the auction sale (mandatory)

ID of the address location (from Address’ node)

<datestart>

dd/mm/yyyy

</datestart>

Starting date of the sale (mandatory)

Format : dd/mm/yyyy

<dateend>

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)

<visits>

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

<visit date="dd/mm/yyyy" starthour="hh:mm" endhour="hh:mm"/>

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)

<saletype>U</saletype>

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

By default, auction mode is upward

<reserveprice>1</reserveprice>

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:

Cet article vous a-t-il aidé ?