Products

Parameters

productType

Required

This must be a valid Amazon product type, corresponding to the product type that you're defining relationships between in the feed. It cannot be the base product type, PRODUCT.

shippingGroupMap

Required if the MerchantShippingGroupName tag is present in the feed file being converted.

This is a mapping of your account's shipping group names to their internal Amazon identifiers. Instructions on how to generate this mapping are here: shippingGroupMap

onUnsupportedField

Optional. Default fail.

This option controls what happens when the feed converter encounters an XML tag that has no direct equivalent in the new JSON format. There are two accepted values:

• ignore: Silently move past un-mappable XML tags.

• fail: The first time an unmappable XML tag is encountered, throw an InvalidFeedException . This is the default.

Usage

To convert a POST_PRODUCT_DATA feed to the newer JSON_LISTINGS_FEED format:

use SellingPartnerApi\FeedTransformer\Transformer;
use SellingPartnerApi\FeedTransformer\FeedTypes\Product;

$feedPath = 'path/to/feed.xml';
$json = Transformer::fromFile(
    Product::$feedType,
    $feedPath,
    'ATVPDKIKX0DER',  // -> US Selling Partner API marketplace ID
    [ /* options */ ]
);

$jsonFeedPath = 'path/to/new/feed.json';
file_put_contents($jsonFeedPath, json_encode($json));

The first time using this feed converter with a particular product type, we recommend running with the onUnsupportedTag option set to fail. That way, you can be sure you know if certain elements of your XML feed aren't able to be mapped to the new format. Once you've successfully generated and submitted a JSON products feed for that product type, be sure to fetch the feed processing results once the feed finishes processing, in case there are any validation errors.

There isn't always 1-to-1 mapping between the XML tags and the attributes that are submitted in the JSON feed, so sometimes certain XML tags won't be able to be mapped to the JSON format. In many cases, it's best to just remove any troublesome tags. If that doesn't work, or if the unmappable tag is a critical data point for your products, email us and we can help you figure out the best plan of action.