The eBay Merchant Integration Platform (MIP) is a powerful, easy-to-use application that eBay sellers can use to manage product listings and orders. See Basic description for additional information.
Important! To avoid any unnecessary fees or charges, please refer to the Best practices section of this guide before you begin using the MIP platform.
To use MIP, you should already be familiar with selling on eBay.
This guide explains how to:
-
Set up MIP
-
Create feeds to list your products on eBay
-
Update your listings with price changes, quantity, and other information
-
Retrieve Active Inventory and Order reports
Important! MIP does not detect changes that you make to listings using other tools, such as eBay web flows or Seller Hub. Do not use MIP in conjunction with any other method to make changes to an item listing.
To prevent issues such as duplicate listings, after you begin using MIP do not continue to use eBay web flows, mobile apps, or third-party tools to upload, revise, and manage your active listings and orders.
However, you can continue to use eBay.com web flows for the following tasks: feedback, returns, and responses to buyer cases.
MIP updates
Periodically, new fields are added to MIP feeds. In most cases, new fields in CSV files are appended to the end of changed feed file, and new fields in XML files are added to the end of the request/response payload or to the end of an existing container. Changes are communicated through the What's new section.
Important! All MIP users should monitor this guide to keep current on new and modified fields. For users who are programmatically using MIP, it is recommended that their integrations be coded to accommodate all updates. As a best practice, always reference the fields or columns by their names, and not by their absolute or relative position in a feed.
What’s new
The following updates have been made to the Merchant Integration Platform.
Release Date |
Feature Description |
---|---|
October 2024 |
Removed Economic Operator fields from the Distribution and Combined feed requests. These fields will be ignored and silently dropped if included in feed files. |
August 2024 |
Added the following fields to Distribution and Combined Feed requests to support GPSR-related information:
See Distribution Feed Definitions, Combined Feed Definitions, and Sample feed and response files. |
July 2024 | As a part of implementing enhanced security measures, eBay will migrate from Port 22 to Port 2222 for SFTP connections to MIP Sandbox (mip.sandbox.ebay.com). SFTP connections through Port 22 will start being blocked on July 30, 2024. |
June 2024 |
Added the following fields to Distribution and Combined Feed requests to support eBay auctions:
See Distribution Feed Definitions, Combined Feed Definitions, and Sample feed and response files. |
June 2024 |
A new requirement adding support for EPA approved tuning devices and software products was added to category ID 173651 (Auto Performance Tuning Devices & Software). See Distribution Feed Definitions and Tuning devices and software. |
February 2024 |
Added support for Economic Operator fields. See Distribution Feed Definitions, Combined Feed Definitions, and Sample feed and response files. Added new security algorithms to support enhanced security measures. See Feed Schema for more information. |
January 2024 |
The following CBC mode ciphers and MD5 MACs have been deprecated:
Refer to the Deprecated Ciphers, MACs, and Key Exchange table for a complete list of deprecated ciphers, MACs, and key exchanges. For the list of preferred ciphers and MACs for use with the SFTP server, listed in order of preference, refer to Preferred Ciphers and MACs. |
October 2023 |
New linkedLineItem field added to Order Report. This field will provide data on a line item that is linked to the corresponding order, but not actually a part of the order. This can be used to provide details about a component (purchased from one seller) needed for its installation (purchased from a different seller). Details can identify the linked seller and also include delivery times, item information, and order information. See Pending orders response definitions. |
August 2023 |
This version of the MIP guide supersedes the previous version. Bookmark this page for future reference: https://developer.ebay.com/api-docs/user-guides/static/mip-user-guide-landing.html |
July 2023 |
Condition descriptors for specific trading card categories are now supported on all eBay marketplaces. See Product Feed Definitions, Combined Feed Definitions, and Sample feed and response files. |
June 2023 |
Added support for condition descriptors to specific trading card categories. Currently available only in the United Kingdom (GB), with rollout to all other marketplaces early July 2023. See Product Feed Definitions, Combined Feed Definitions, and Sample feed and response files. |
May 2023 |
Added support for Energy Efficiency Labels, Hazmat information, and Regional Seller Disclosures for the German (DE) marketplace. See Distribution feed definitions, Combined Feed Definitions, and Sample feed and response files. |
January 2022 |
Added support for Extended Producer Responsibility and compliance policies through listing creation and orders. See Distribution feed definitions, Combined Feed Definitions, and Sample feed and response files. Use Extended Producer Responsibility to provide IDs for the producer or importer related to the new item, and compliance policies to specify custom policy IDs. A custom policy ID refers to the relevant policy created for compliance and other purposes. |
August 2021 |
Due to security concerns with Cipher Block Chaining (CBC) and MD5 encryption when using the SFTP server, a number of CBC mode ciphers and MD5 MACs have been deprecated. See the Deprecated Ciphers, MACs, and Key Exchange table in Uploading the sample feed for details. |
July 2021 |
Added a new eBayReferenceName field for describing VAT (Value Added Tax) for sales involving regions where VAT is applicable (see Distribution feed definitions and Sample feed and response files). The field contains an eBay Tax Number and also possesses a Name attribute, which delineates the region for which the VAT is applied. |
May 2021 |
Added support for secondary categories and private listings to the distribution feed type (see Distribution feed definitions and Sample feed and response files).
Other miscellaneous document updates. |
Release Date |
Feature Description |
---|---|
Jan 2021 |
|
Nov 2019 |
|
July 2019 |
|
May 2019 |
|
Oct 2018 |
|
Aug 2018 |
|
Mar 2018 |
|
Feb 2018 |
|
Nov 2017 |
|
Oct 2017 |
|
Aug 2017 |
|
Jul 2017 |
|
May 2017 |
|
Jan 2017 |
|