Tipser product FEED specification

This format of the feed is no longer maintained. All integrations that are live already will remain supported.

See Product Feed Specification for our current preffered feed specification.

This is the preferred format for import of product data to tipser.com. Example feeds are located further down.

Outline of the xml format:

<?xml version="1.0" encoding="utf-8"?>
<TipserFeed>
  <Currency></Currency>
  <CreationDate></CreationDate>
  <Products>
   <Product></Product>
  <Products>
</TipserFeed>

Product structure

The products <product></product> in the feed need to be nested with all it's variants (colours, size, etc.).

Every single product as well as the variants in the product can contain unique images, descriptions, prices, properties, etc. for maximum flexibility. Every single variant should have a SKU to ensure there's a unique match between the systems. If there's another field that uniquely identifies a certain product between the systems, such as ProductID (e.g. when SKUs are re-used), this shall be specified on the product and variant level.


Header fields

Products

The Products element can have any number of Product elements. Products defines all the products to be available for this merchant. If an existing product is removed from the feed, the product will also be hidden in the shop.

Mandatory attributes

The Product element defines one product using the following element:

Optional elements

The Product element can also have the following optional elements:

Variants

The Variant in the Product element can have the same attributes as the Product, and will then overwrite the attributes from the master product. Otherwise the variant will inherit the master product attributes.


However, there are a few elements that are mandatory on the variant level that VariantProductId and SkuId

Export document template

You can download a template from here

<?xml version="1.0" encoding="utf-8"?>
<TipserFeed>
  <Currency></Currency>
  <CreationDate></CreationDate>
  <Products>
   <Product>
     <Name></Name>
     <Description></Description>
     <Price></Price>
     <FullPrice></FullPrice>
     <VAT></VAT>
     <MediaData>
       <Media></Media>
     </MediaData>
     <ProductId></ProductId>
     <Brand>
       <Name></Name>
       <ImageUrl></ImageUrl>
     </Brand>
     <Status></Status>
     <OriginUrl></OriginUrl>
     <Categories>
       <Category></Category>
     </Categories>
     <AdditionalMetaData>
       <MetaData>
         <Key></Key>
         <Value></Value>
       </MetaData>
     </AdditionalMetaData>
     <DisplayAttributes>
      <Attribute>
        <Key></Key>
        <Value></Value>
      </Attribute>
    </DisplayAttributes>
     <DeliveryTime>
       <Min></Min>
       <Max></Max>
       <Unit></Unit>
     </DeliveryTime>
     <DeliveryNote></DeliveryNote>
     <BoughtTogetherWith>
       <ProductId></ProductId>
     </BoughtTogetherWith>
     <ReplacableWith>
       <ProductId></ProductId>
     </ReplacableWith>
     <Variants>
      <Variant>
        <VariantProductId></VariantProductId>
        <Name></Name>
        <Description></Description>
        <Price></Price>
        <FullPrice></FullPrice>
        <FreightCost></FreightCost>
        <Status></Status>
        <MediaData>
          <Media></Media>
        </MediaData>
        <SelectableAttributes>
          <Attribute>
            <Key></Key>
            <Value></Value>
          </Attribute>
        </SelectableAttributes>
        <DisplayAttributes>
          <Attribute>
            <Key></Key>
            <Value></Value>
          </Attribute>
        </DisplayAttributes>
        <SkuId></SkuId>
        <Stock></Stock>
        <DeliveryTime>
          <Min></Min>
          <Max></Max>
          <Unit></Unit>
        </DeliveryTime>
        <DeliveryNote></DeliveryNote>
        <AdditionalMetaData>
          <MetaData>
            <Key></Key>
            <Value></Value>
          </MetaData>
        </AdditionalMetaData>
      <Variant>
     </Variants>
   </Product>
  </Products>
</TipserFeed>