FeedOps Retail Feed Schema

Use this schema to create your own connection to FeedOps (software development skills required)

For eCommerce stores for which FeedOps doesn't have built in direct integration, product and promotion data is accessed by means of an XML feed.

Product Inventory Feed

An inventory feed is an XML document described by the FeedOps Retail Standard Vertical schema that contains a list of all applicable inventory items and promotions currently available on a website.

The schema XSD to validate against can be found at  http://verticals.feedops.com/v1/retail_standard.xsd

Inventory Item

An inventory item represents a single product (for example ‘iPod Touch’) that is for sale on a website. Each variant of a product is a separate inventory item and should have a unique SKU.

Example

<items>
  <item>
    <sku>123456</sku>
    <first_category url_value=”suits”>Suits</first_category>
    <second_category url_value=”suits/formal”>Formal Suits</second_category>
    <brand url_value=”brand=123”>Hugo Boss</brand>
    <price>1999</price>
  </item>
</items>

Inventory Item Feed Elements

Inventory Promotion

An inventory promotion represents a special offer available for use on your website. Promotions often include a coupon code that can be entered at checkout to access the promotion. They may apply to all products, or may only apply to specific SKUs or when a certain cart value is reached. You need only include promotions that are available to all customers or that you want to advertise.

Example

<items>
  <item>
    <sku>123456</sku>
  </item>

  <promotion>
    <offer_id>Summer Sale 2017</offer_id>
    <offer_type>GENERIC_CODE</offer_type>
    <generic_redemption_code>SUMMER-2017</generic_redemption_code>
    <percent_off>10</percent_off>
    <skus>
      <sku>123456</sku>
    </skus>
  </promotion>
</items>

Inventory Promotion Attributes

Feed Validation

There are two aspects to validating the feed:

Schema Validation

Please ensure that the feed validates against the relevant XSD: http://verticals.dynamiccreative.com/v1/retail_standard.xsd

Feed Item Validation

As the feed is developed, please provide the feed through to your technical representative for review. We will perform additional checks over and above the schema validation that we undertake that often require rework before the feed is ready to be connected to FeedOps. Generally, most issues can be resolved quickly across one or two review cycles.

Common Validation Issues

Problem: XML does not conform to XSD Schema

Solution: Ensure the feed validates against the XSD Schema as provided

Problem: url_value attributes are not valid

Solution: url_value attributes for first_category, second_category and so on should allow us to generate a landing page to show all of the products within that category. Only the path is required, do not include the protocol or hostname.

Problem: all relevant category elements are not provided

For example, a product is available on a website via a menu structure of Suits > Formal Suits > Wedding Suits

The item is provided in the feed as follows:

Solution: url_value attributes for first_category, second_category and so on should allow us to generate a landing page to show all of the products within that category. Only the absolute path is required, do not include the protocol or hostname.

Problem: filter url_value attributes are not provided correctly

If your website supports filtering by attributes such as brand or colour or size, we require those url_value attributes so that we can correctly generate a landing page for relevant products.

Solution: Please refer to the example XML above to see the correct usage of a url_value for a brand attribute.