Listings Management Workflow Migration

❗

Important

Feeds API support for XML and flat file product listings feeds is deprecated. For more information about the affected feeds and migration guidelines, refer to the deprecation announcement.

This guide explains how to migrate listings management workflows from XML and flat file listings submissions to the Listings Items API and JSON_LISTINGS_FEED. This is necessary to prepare for the deprecation of legacy feed types.

Review the Building Listing Management Workflows Guide prior to this migration guide.

Benefits

The guidance offered here describes the following benefits for both sellers and vendors:

• Full data requirements in product schemas
• Availability of pre-submission validation rules
• Sync and async feedback mechanisms
• Up-to-date product type data requirements that ensure you are using the latest version, unlike XMLs
• Uniformity in schemas across data requirements, unlike XML in the past that led to errors for developers uploading multiple categories
• Reducing the effort required to map flat file or XML attributes to Listings APIs and the JSON_LISTINGS_FEED
• Reducing human/manual input errors leading to submission errors and abandoned selections
• Easier management of large catalogs and sending of full selections with no upload constraints

API versions

This guide references operations in the following Selling Partner API sections. For more detailed information about building workflows using these sections, refer to the Building Listings Management Workflows Guide. For more detailed information about the individual API sections, follow the referenced links.

Feed types

This guide references the following feed types used with the Feeds API. For more detailed information about feed types, refer to Listings Feed Type Values.

❗

Important

Feeds API support for XML and flat file product listings feeds is deprecated. For more information about the affected feeds and migration guidelines, refer to the deprecation announcement.

To learn more about the terms that are used on this page, refer to Terminology.

Migration tutorial

The steps to migrate your listings workflow depend on your use case and business needs. Follow these steps to determine the strategy appropriate for you:

1. Understand your use cases and review the iterative workflow migration strategies.
2. Select the migration workflow that helps you migrate your use case:
   • Iterate on the migration by data type. For example: product, inventory, or images.
   • Onboarding to new API and notification features.
   • Create offer-only workflows.
   • Expand to product types and marketplaces.
3. Review and navigate to the individual workflows that apply to the Feed type you are planning to migrate. Legacy Product Feeds types can be XML-based or flat file based:
   • For XML-based Feeds type migration, follow the appropriate workflow:
     • Migrating product feeds workflows: This guide helps you migrate from POST_PRODUCT_DATA feed type.
     • Migrating inventory feeds workflows: This guide helps you migrate from POST_INVENTORY_AVAILABILITY_DATA feed type.
     • Migrating pricing feeds workflows: This guide helps you migrate from POST_PRODUCT_PRICING_DATA feed type.
     • Migrating image feeds workflows: This guide helps you migrate from POST_PRODUCT_IMAGE_DATA feed type.
     • Migrating relationship feeds workflows: This guide helps you migrate from POST_PRODUCT_RELATIONSHIP_DATA feed type.
     • Migrating shipping override feeds workflows: This guide helps you migrate from POST_PRODUCT_OVERRIDES_DATA feed type.
   • For flat file based Feeds type migration, follow the Migrating flat file feeds workflows. This guide helps you migrate from flat file based POST_FLAT_FILE_LISTINGS_DATA and POST_FLAT_FILE_INVLOADER_DATA feed types.
4. Create a mapping file to map product attributes from category and flat file feed types to Listings Items API and JSON-based feeds using the data mappings provided in Mapping product attributes to the Listings Items API.