Upload-Interface XML

Also see the general (non-data-format-specific) description of the Upload-Interface.

Vehicle-file naming

The file name extension of the vehicle-file must be .xml. Example: fooBar.xml

Note: This refers to the vehicle-file, not the surrounding ZIP file. The ZIP file (if there is any) always ends with .zip.

XML schema files

Have a look at the XML schema definition to understand what data format is used for the Upload-Interface.
Also see our general XML notes.
In our XML schema, many elements are contained in a sequence. When you create your XML data, make sure the elements you create are in the same order as in the schema. Otherwise, the XML validation will fail.
Parts of the XML refer to our reference data. Here you find reference tables for the enumerated fields, like features, colors, makes, models and others.

Some basic data types used by almost all other schemas	types-1.0.xsd
The ad	seller-ad-1.1.xsd
Price data (included in ads)	price-1.0.xsd
Vehicle data (included in ads)	vehicle-1.0.xsd
Some country specific properties (included in vehicle)	site-specifics-1.0.xsd
For stating the customer number (included in ads)	seller-3.0.xsd

Referencing customers (for TSPs)

When you are acting as a transfer service provider (TSP) with an API-Account and upload ads on behalf of various vehicle sellers, then you have to state the mobile.de customer number for every record (<ad> element).

Put it into the <seller:customerNumber> element which you find here: //ads/ad/seller:seller/seller:customerNumber .

Also see the below example.

Referencing vehicle ads (inventory-key)

For identifying the vehicle ads, put the inventory-key (a.k.a. internal number a.k.a. internal ID) to the <seller-inventory-key> element.

Also see the below example.

Referencing images

For adding images to your ads, throw the image files into your ZIP file and state the names of the files within in the ads in the XML file. Each image gets an <image> element within the <images> element. The file name goes to the ref attribute.

Here is the XPath: //ads/ad/images/image/@ref .

Also see the below example.

Example

<?xml version="1.0" encoding="UTF-8"?/>
<ads
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://services.mobile.de/schema/seller/seller-ad-1.1"
    xmlns:vehicle="http://services.mobile.de/schema/seller/vehicle-1.0"
    xmlns:seller="http://services.mobile.de/schema/common/seller-3.0"
    xmlns:site-specifics="http://services.mobile.de/schema/seller/site-specifics-1.0"
    xmlns:price="http://services.mobile.de/schema/seller/price-1.0"
    xsi:schemaLocation="http://services.mobile.de/schema/seller/seller-ad-1.1 http://services.mobile.de/schema/seller/seller-ad-1.1.xsd">

    <ad> <!-- first ad -->

        <!-- ...ad other stuff here... -->

        <seller-inventory-key value="car1" ></seller-inventory-key>

        <!-- ...ad other stuff here... -->

        <images>
            <image ref="image-one.jpg"/>
            <image ref="ford-from-behind.jpg"/>
        </images>

        <!-- ...ad other stuff here... -->

        <seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
            <seller:customerNumber>123456</seller:customerNumber>
        </seller:seller>
    </ad>

    <ad> <!-- second ad -->
    
        <!-- ...ad other stuff here... -->

        <seller-inventory-key value="car2"></seller-inventory-key>

        <!-- ...ad other stuff here... -->

        <images>
            <image ref="interior.jpg"/>
            <image ref="myOldHonda1.jpg"/>
            <image ref="image-two.jpg"/>
        </images>

        <!-- ...ad other stuff here... -->

        <seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
            <seller:customerNumber>123456</seller:customerNumber>
        </seller:seller>
    </ad>

    <ad> <!-- third ad -->

        <!-- ...ad other stuff here... -->

        <seller-inventory-key>number-one</seller-inventory-key>

        <!-- ...ad other stuff here... -->

        <images>
            <image ref="fiatFromLeft.jpg"/>
            <image ref="fiatFromRight.jpg"/>
        </images>

        <!-- ...ad other stuff here... -->

        <seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
            <seller:customerNumber>456789</seller:customerNumber>
        </seller:seller>
    </ad>

</ads>

Impressum / Imprint