Getting Started Guide

This documentation prepare you for implementing Barnebys XML Feeds.

Reference and Types

Before starting make sure you read the reference for Barnebys XML Feeds. This sections provides you with the feed structure and data types that should be used for the feed.

Object classification

Depending on what tags used in the feed Barnebys will identify the object as an auction or fixed price item. If <auction /> node is present the object will be classified as an auction item.

Auction example

<?xml version="1.0" encoding="utf8" ?>
<barnebys version="2.0">
    <items id="1">
        <item>
            <title>Rolex Watch</title>
            <description>A mighty fine watch</description>
            <url>https://yoursite.com/object/12345</url>
            <image>https://yoursite.com/media/12345.jpg</image>
            <category>Watch</category>            
            <price>
                <estimate>100.00</estimate>
                <bid>150.00</bid>
                <currency>SEK</currency>
            </price>
            <auction>
                <start>2017-05-02T07:11:00+00:00</start>
                <end>2017-06-02T07:17:00+00:00</end>
            </auction>
        </item>
        <item>
           ...
        </item>
    </items>        
    <items>
        ...
    </items>
</barnebys>

Dealer/fixed price example

<?xml version="1.0" encoding="utf8" ?>
<barnebys version="2.0">
    <items id="1">
        <item id="1">
            <title>Rolex Watch</title>
            <description>A mighty fine watch</description>
            <url>https://bla.com/bla</url>
            <image>https://bla.com/bla.jpg</image>
            <category>Watch</category>            
            <price>
                <amount>100.00</amount>
                <currency>SEK</currency>
            </price>
        </item>
        <item id="2">
           ...
        </item>
    </items>        
    <items id="2" type="dealer">
        ...
    </items>
</barnebys>

Implementation

To simplify the integration Barnebys has an XML Scheme to be used for validation of the feed.

Prerequirements

The feed has to be on a public server but can be protected by a password if so needed. Barnebys system will fetch the feed from the remote server using protocol for HTTP/S or FTP.