Related Products in Icecat XML and JSON Data Channels

Avatar for Petya Lesnyak
By
Likethumbsup(1)Dislikesthumbsdown(0)

Icecat allows channel partners to retrieve information about product relations, for instance, recommended products, accessories, and consumables. To further explain, this manual describes the Related Products section and its attributes in Icecat product XML and JSON files.

Tag <ProductRelated> in XML Related Products

The tag <ProductRelated> is mandatory. However, If a product doesn’t have any Product Relations, then the empty <ProductRelated> tag is added. Further, if there is a product relation, each Product Relation is indicated in a separate <ProductRelated> tag.

Example of structure / product XML view:

<ProductRelated ID="" Category_ID="" Preferred="">
     <Product ID="" Prod_id="" ThumbPic="" Name="">
        <Supplier ID="" Name=""/>
     </Product>
</ProductRelated>

Attributes of ProductRelated tag:

  • ID – Identifier of a Product Relation.
  • Category_ID – Icecat Category ID of a related product.
  • Preferred – indicates if a Product Relation is recommended by a brand. (0 = NOT recommended / 1 = recommended)

Tag <ProductRelated> → <Product> in XML:

Tag <Product> is mandatory. So, there is always only one <Product> tag for each Product Relation.

Attributes of <Product> tag:

  • ID – Icecat Product ID.
  • Prod_id – Product code of a related product.
  • ThumbPic – Link to the main image of a related product in thumb size. However, It is empty, if the image is unavailable.
  • Name – Product model description of a related product. 

Tag <ProductRelated> → <Product> → <Supplier> in XML:

Tag <Supplier> describes a product brand.

Attributes of <Supplier> tag:

  • ID – Icecat brand ID.
  • Name – Brand name.

Tag <ProductRelated> → <ProductRelatedLocales> in XML:

In addition, you can find another tag for products that have localized Product Relations<ProductRelatedLocales>.

Attributes of <ProductRelatedLocales> tag in XML

  • ID – Icecat ID of a product relation.
  • langid – Icecat ID of a locale which this relation assigned for.
  • Preferred – Similarly, it indicates if a Product Relation recommended by a supplier for a specific locale. (0 = NOT recommended / 1 = recommended consequently)
  • StartDate – The date from which this relation recommended by brand.
  • EndDate – The date till which this relation recommended by brand.

Tag “ProductRelated” in JSON Related Products section:

Similarly, in a JSON product data file, the Related Products section is indicated by the “ProductRelated”:[] tag.

For example the Product JSON view:

"ProductRelated": [ 
    {
      "ID":154671578,
      "CategoryID":977,    
      "Preferred":0,
      "IcecatID":33447789,
      "ProductCode":"NSVGALOCK",
      "ThumbPic":"",
      "ProductName":"Neomounts by Newstar security lock cable",
      "Brand":"Neomounts by Newstar",
      "BrandID":290,
      "ProductRelatedLocales":[]

Attributes of “ProductRelated” tag in JSON:

  • ID – Icecat ID of a product relation.
  • CategoryID – Icecat category ID of a related product.
  • Preferred – indicates if a Product Relation recommended by a supplier. (0 = NOT recommended / 1= recommended)
  • IcecatID – Icecat Product ID of a related product.
  • ProductCode – Product code of a related product.
  • ThumbPic – Link to the main image of a related product in thumb size. However, It is empty if the image is unavailable.
  • ProductName – Product model description of a related product.
  • Brand – Brand name.
  • BrandID – Icecat brand ID.
  • ProductRelatedLocales – Shows local data for related products.

For example the Product JSON view:

  • ID – Icecat ID of a product relation.
  • Language – identifies a locale which this relation is assigned for. (For example, EN, NL, ES, IT etc.)
  • Preferred – indicates if a Product Relation is recommended by a supplier, but for a specific locale. (0 = NOT recommended / 1 = recommended consequently)
  • StartDate – the date from which this relation is recommended by brand.
  • EndDate – the date till which this relation recommended by brand.


Subscribe to our newsletter and stay updated.
Loading

Leave a Reply

Your email address will not be published.

Icecat xml
 November 3, 2019
 October 4, 2018
Manual

Manual for Icecat Live: Real-Time Product Data in Your App

Icecat Live is a (free) service that enables you to insert real-time produc...
 June 10, 2022
Manual for Icecat CSV Interface

Manual for Icecat CSV Interface

This document describes the manual for Icecat CSV interface (Comma-Separate...
 September 28, 2016
Manual

Manual for Open Icecat JSON Product Requests

JSON (JavaScript Object Notation) is an increasingly popular means of trans...
 September 17, 2018
icecat add ons

Icecat Add-ons including Magento, PrestaShop, Shopify, Magento, Google Shopping. NEW: Pimcore

Icecat has a huge list of integration partners, that make it easy for clien...
 August 1, 2020
Manual

Manual for Personalized Interface File and Catalog from Icecat

With Icecat, you can generate personalized or customized CSV or Excel files...
 May 3, 2022
Manual

Manual: How to Import Free Product Content Into Your Webshop via Icecat

This guide will quickly show you how to import free product content from Ic...
 February 25, 2022