Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Before you continue, please read this:  FMTC updates DAILY from all integrated networks  (see Update Time). What the merchant does (or doesn't do) related to updating their file(s) in the network(s) is on the merchant (merchants update daily, weekly, or monthly - more to come on this soon). As part of the process, FMTC reviews the files we receive from the networks ensuring that the products from every merchant in our feed are the most up-to-date based on the information made available to FMTC. Please refer any general questions regarding the Product Feed and/or this documentation to your Account Manager or support@fmtc.co - please include in the subject line: Product Feed Inquiry

...

Table of Contents
minLevel1
maxLevel7
classtable-of-contents

Change Log

2021-

...

12-

...

21

CHANGES

  • Updated the definition of the “Other” field in the Merchant Elements responsethe “Price” and “SalePrice” and how we are mapping the values from each of the networks.

UPDATES

  • “Price” and “SalePrice” can now be null. This will occur when the information is not provided by the merchant on the network.

Glossary

Here is the glossary of all terms that are used within this document.

...

Name

Description

CMID

An identifier that can be used across merchants. It can be one of four different identifiers, notated by a prefix.

gtin- The GTIN number.
isbn- The ISBN number.
mpn- The MPN character string.
id- A custom character string generated based on the ID, FeedName, and MerchantId.

ID

An identifier that is unique to the merchant (This is the SKU whenever possible, however, sometimes the SKU is either not unique or not provided. When needed, attributes of the product are appended to the front of the SKU to differentiate products.) 

Brand

The brand associated with the product. The brand names have been standardized to a set format. Please see the section below.

If no Brand or Manufacture is given by the merchant, this is set to NO BRAND 

PrimaryCategory

The main category associated with the product. It is one of our top-level categories from FTMC.

If no category is given by the merchant, this is set to NO CATEGORY 

Categories

All of the categories related to the product by the merchant. Separated by a ','

NOTE: Sometimes, the delineator is | or ~~, this is due to network inconsistencies and is being worked on.

ProductName

The name of the product at this merchant

MerchantName

The name of the merchant selling this version of the product

MerchantID

The merchant's identification number.

FeedName

The name of the feed that this product is related to. Generally the name of the Network the feed is part of.

Available

Shows if the product is available at this merchant

Possible values 

● 1, the product is available 

● 0, the product is not available 

Price

The price of the product at this merchant.

This value can be null. This will occur when the Price is not provided by the merchant.

SalePrice

The discounted price from the merchant. This price will be equal to or less than the price, if provided.

This value can be null. This will occur when a Sale Price is not provided by the merchant.

Currency

The currency that this merchant is selling the product in

AffiliateUrl

The Affiliated URL of the product for this merchant. This URL will be either an affiliate URL with a place holder for an affiliate id or your affiliate id set within your FMTC account. The place holder is AFFILIATE_ID.

Shipping

The shipping available for this product. The possible fields of this element are: 

● Country 

● Service 

● Currency 

● Price

If no shipping is given by the merchant, this field is empty

GroupID

The item_group_id from the google shopping fields if provided by the merchant. 

If the group id is not given by the merchant, this is set to NULL.

GTIN

The Global Trade Item Number (UPC, EAN, etc). It will always be 15 numbers long to indicate that it needs to be processed. If it is not provided, this field is set to NULL.

Description

The description of the product provided by the merchant

ProductImage

A link to the image of the product provided by the merchant

Other

A set of fields that are not standardized across products. This could include: color, size, dimensions, custom fields, etc. 

If this field is null or empty, this means the merchant has not put any additional values for the product.

If a subfield is null or empty, that is the value provided from the merchant/network. FMTC does not change any of these values upon ingesting them into the feed.

FreshReach

The FreshReach™ URL for the merchant of the product. This will only be provided for users that provide their user key and if they are signed up for FreshReach™.

Note: Not all FreshReach™ merchants support DeepLinking. This link may go to the product page or the merchant's homepage. 

LastUpdate

The last time (as a Unix timestamp) the product was updated by the merchant that our system obtained.

ProcessedTime

The last time (as a Unix timestamp) the product was confirmed by our system.

...

There are some brand names that have their own standard capitalization that we have decided to honor. Here is a link to the table of brand names and how they are formatted in our Product Feed API: Canonical Brands

Setting the merchant parameter

...