The bulkMigrateListings call is used to convert existing eBay Listings to the corresponding Inventory API objects. If an eBay listing is successfully migrated to the Inventory API model, new Inventory Location, Inventory Item, and Offer objects are created. For a multiple-variation listing that is successfully migrated, in addition to the three new Inventory API objects just mentioned, an Inventory Item Group object will also be created. If the eBay listing is a motor vehicle part or accessory listing with a compatible vehicle list (ItemCompatibilityList container in Trading API's Add/Revise/Relist/Verify calls), a Product Compatibility object will also be created.
Migration Requirements
An eBay listing must have the following settings/characteristics to be eligible for migration to the Inventory API model:
- Business Polices (Payment, Return Policy, and Shipping) must be used on the listing, as legacy payment, return policy, and shipping fields will not be accepted, and the migration will be blocked. In the Trading API, Business Policies are referenced through the SellerProfiles container
- The item(s) in the listings must have seller-defined SKU values associated with them, and in the case of a multiple-variation listing, each product variation must also have its own SKU value. For single-variation listings, the SKU value is set in the Item.SKU field of the Add/Revise call in Trading API, and for multiple-variation listings, the SKU value for each product variation in the listing is set in the Item.Variations.Variation.SKU field of the Add/Revise call. Each SKU value for the product variations must be unique
- The postal/zip code (PostalCode field in Trading's ItemType) or city (Location field in Trading's ItemType) must be set in the listing; the country is also needed, but this value is required in Trading API, so it will always be set for every listing
Unsupported Listing Features
Some eBay listing features are not yet supported in the Inventory API, but listings with these features can still be migrated, and the features will remain on the listings. The downside to this is that these features/settings cannot be modified once the migration takes place. The seller should take this into consideration, and where it makes sense, perhaps do some revisions to some listings before migration.
The following features are not supported by the Inventory API, but will not block the migration and will remain on the listing after migration:
- Any listing-level Buyer Requirements
- Listing enhancements like a bold listing title
Setting the eBay Listings to Migrate
The bulkMigrateListings call allows a seller to convert one to five eBay listings per call. Each eBay listing to migrate is specified through separate requests.listingId fields. The value used in these fields is the ItemID value of the listing. Each listing in a call should be listings from the same eBay Marketplace.
Migration Results
The response payload of the bulkMigrateListings call will show the results of each attempted listing migration. These results include an HTTP status code to indicate the success or failure of each listing migration, the SKU value associated with each item, and if the migration is successful, an Offer ID value. The SKU value will be used in the Inventory API to manage the Inventory Item object, and the Offer ID value will be used in the Inventory API to manage the Offer object. errors and/or warnings containers will be returned for each listing where an error and/or warning occurred with the attempted migration.
If a multiple-variation listing is successfully migrated, along with the Offer and Inventory Location objects, an Inventory Item object will be created for each product variation within the listing, and an Inventory Item Group object will also be created, grouping those variations together in the Inventory API platform. For a motor vehicle part or accessory listing that has a specified list of compatible vehicles, in addition to the Inventory Item, Inventory Location, and Offer objects that are created, a Product Compatibility object will also be created in the Inventory API platform.
Mapping Trading Fields to Inventory API Fields
To enable the conversion of an eBay listing to the Inventory API model, fields in Trading API's ItemType are mapped to fields in the Inventory API objects, which include Inventory Item, Inventory Location, Offer, Inventory Item Group (for multiple-variation listings), and Product Compatibility (for motor vehicle part or accessory listings with compatible vehicles list).
The following table gives a detailed look at the Trading API's ItemType fields and how these fields are mapped to the fields in the Inventory API objects. Some fields in ItemType are not applicable and/or are ignored.
Legacy Field/Container | Feature/Purpose | Equivalent REST API Field | Affected Inventory/Account API Object(s) | Note |
---|---|---|---|---|
AutoPay in Trading API, but this setting must be made in Payment policy; paymentProfile.paymentInfo.immediatePay in Business Policies API | Immediate Payment | No equivalent in Inventory API, but equivalent in the Payment Policy object of Account API is immediatePay | Payment Policy | Whether this field is set in the Account API or Business Policies API, its value must be set to |
BestOfferDetails.BestOfferEnabled | Best Offer | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
BuyerProtection | eBay Money Back Guarantee | N/A | None | There is no equivalent field in the Inventory API that will indicate if the item is eligible for the eBay Money Back Guarantee. |
BuyerRequirementDetails.MaximumBuyerPolicyViolation | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.MaximumItemRequirements | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.MaximumUnpaidItemStrikesInfo | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.MinimumFeedbackScore | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.ShipToRegistrationCountry | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.VerifiedUserRequirements | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
BuyerRequirementDetails.ZeroFeedbackScore | Buyer Requirements | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any listing-level Buyer Requirements after migration. The seller will just not be able to modify these Buyer Requirements once the listing is migrated. |
Charity.CharityID | eBay for Charity | N/A | None | There are no equivalent fields in the Inventory API to support charitable donations, but the active eBay listing will actually retain any charity information after migration. The seller will just not be able to modify this charity information once the listing is migrated. |
Charity.CharityNumber | eBay for Charity | N/A | None | There are no equivalent fields in the Inventory API to support charitable donations, but the active eBay listing will actually retain any charity information after migration. The seller will just not be able to modify this charity information once the listing is migrated. |
Charity.DonationPercent | eBay for Charity | N/A | None | There are no equivalent fields in the Inventory API to support charitable donations, but the active eBay listing will actually retain any charity information after migration. The seller will just not be able to modify this charity information once the listing is migrated. |
ConditionDescription | Item Condition | conditionDescription | Inventory Item | If ConditionDescription field is set in Trading API, the text in this field is mapped to the conditionDescription field of the Inventory Item object in the Inventory API. |
ConditionID | Item Condition | condition | Inventory Item | The integer value set in ConditionID field in Trading API is mapped to the corresponding enumeratino value in the condition field of Inventory Item object in the Inventory API. |
Country | Listing Country | marketplaceId | Offer | The Country field set for the listing in Trading API is mapped to the marketplaceId field of Offer object in the Inventory API. The value for the Country field is also used to create the identifier for the Location object. |
CrossBorderTrade | Cross-Border Trade | N/A | None | Cross-Border Trade (same listing across multiple eBay sites) is not yet supported in the Inventory API, so this field will actually have no effect/be ignored when the listing is migrated. |
Currency | Listing Currency | currency | Offer | The Currency value set for the listing in Trading API is mapped to all currency fields in the Offer object, including the currency field in the pricingSummary.price container. |
Description | Item/Listing Description | product.description, description, listingDescription | Inventory Item, Offer, Inventory Item Group | For a single-variation listing, the text in the Description field of Trading API is mapped to the product.description field of the Inventory Item object and by the listingDescription field of the Offer object. For a multiple-variation listing, the text in the Description field of Trading is mapped to the description field of the Inventory Item Group object and by the listingDescription field of the Offer object. |
DigitalGoodInfo.DigitalDelivery | Digital Gift Cards | N/A | None | Digital Gift Card listings are not supported in Inventory API, so Digital Gift Card listings in Trading can not be migrated to the Inventory API. |
DisableBuyerRequirements | Buyer Requirements | N/A | None | This field is used at add/revise/relist time and disable listing and account level Buyer Requirements. If this field was used at add/revise/relist time, all Buyer Requirements will be turned off and will remain off after migration, and the seller will not be able to change this setting once the listing is migrated. |
DiscountPriceInfo.MadeForOutletComparisonPrice | eBay Outlets | N/A | None | eBay Outlet listings are not supported with the Inventory API, so this field will actually have no effect/be ignored when the listing is migrated. |
DiscountPriceInfo.MinimumAdvertisedPrice | Minimum Advertised Price | pricingSummary.minimumAdvertisedPrice | Offer | If MinimumAdvertisedPrice field is set in Trading API, the price in this field is mapped to the pricingSummary.minimumAdvertisedPrice field of the Offer object. |
DiscountPriceInfo.MinimumAdvertisedPriceExposure | Minimum Advertised Price | pricingSummary.pricingVisibility | Offer | If MinimumAdvertisedPriceExposure field is set in Trading API, the enumeration value in this field is mapped to the pricingSummary.pricingVisibility field of the Offer object; |
DiscountPriceInfo.OriginalRetailPrice | Strikethrough Pricing | pricingSummary.originalRetailPrice | Offer | If OriginalRetailPrice field is set in Trading API, the price in this field is mapped to the pricingSummary.originalRetailPrice field of the Offer object. |
DiscountPriceInfo.SoldOffeBay | Strikethrough Pricing | pricingSummary.originallySoldForRetailPriceOn | Offer | If SoldOffeBay field is set to |
DiscountPriceInfo.SoldOneBay | Strikethrough Pricing | pricingSummary.originallySoldForRetailPriceOn | Offer | If SoldOneBay field is set to |
DispatchTimeMax in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.dispatchTimeMax field in Business Policies API | Handling Time | No equivalent in Inventory API, but the equivalent in the Fulfillment Policy object of the Account API is the handlingTime container | None | The seller's handling time is set in the Shipping/Fulfillment policy. This setting can be made/revised through My eBay, through the Business Policies API, or through the Account API Fulfillment Policy object. |
eBayNowEligible | eBay Scheduled Delivery | N/A | None | eBay Scheduled Delivery listings are not supported with the Inventory API, so this field will have no effect/be ignored when the listing is migrated. |
eBayPlus | eBay Plus Program | N/A | None | The eBay Plus Program is not supported with the Inventory API, so this field will have no effect/be ignored when the listing is migrated. |
GiftIcon | Gift Services | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any gift services after migration. The seller will just not be able to modify these gift services once the listing is migrated. |
GiftServices | Gift Services | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any gift services after migration. The seller will just not be able to modify these gift services once the listing is migrated. |
HitCounter | Visit Counter | N/A | None | There is no equivalent field in the Inventory API to customize the Visit Counter, but the active eBay listing will actually retain any customization of this counter after migration. The seller will just not be able to modify the counter once the listing is migrated. |
InventoryTrackingMethod | Inventory | N/A | None | By default, eBay listings are tracked by Item/Listing ID, so if the InventoryTrackingMethod field is set in Trading API, but its value is set to |
ItemCompatibilityList.Compatibility.CompatibilityNotes | Parts Compatibility | compatibleProducts.notes | Compatible Products | If Parts Compatibility is used for a motor vehicle part/accessory listing in Trading API, a Parts Compatibility list object for the product is created through the Create or Replace Product Compatibility call, and if the CompatibilityNotes field exists for a corresponding compatible vehicle, the text in this field is mapped to the compatibleProducts.notes field of the Compatible Products object. |
ItemCompatibilityList.Compatibility.NameValueList | Parts Compatibility | compatibleProducts.productFamilyProperties | Compatible Products | If Parts Compatibility is used for a motor vehicle part/accessory listing in Trading API, a Parts Compatibility list object for the product is created through the Create or Replace Product Compatibility call, and each NameValueList pair is mapped to the appropriate vehicle aspect (like year, make, model, engine, and trim) in the productFamilyProperties container. |
ItemSpecifics.NameValueList | Item Specifics | product.aspects or aspects | Inventory Item or Inventory Item Group | For a single-variation listing, all item specific name-value pairs in the ItemSpecifics.NameValueList container in Trading API will be mapped to the new Inventory Item object under the product.aspects array. For a multiple-variation listing, all item specific name-value pairs in the ItemSpecifics.NameValueList container in Trading API will be mapped to the new Inventory Item Group object under the aspects array. |
ListingDesigner.LayoutID | Listing Designer Templates | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain styles/formatting of a Listing Designer Template after migration. The seller will just not be able to modify the Listing Designer Template once the listing is migrated. |
ListingDesigner.OptimalPictureSize | Listing Designer Templates | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain styles/formatting of a Listing Designer Template after migration. The seller will just not be able to modify the Listing Designer Template once the listing is migrated. |
ListingDesigner.ThemeID | Listing Designer Templates | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain styles/formatting of a Listing Designer Template after migration. The seller will just not be able to modify the Listing Designer Template once the listing is migrated. |
ListingDetails.BestOfferAutoAcceptPrice | Best Offer Auto Accept | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ListingDetails.LocalListingDistance | Motors Local Listings | N/A | None | Motors Local Listings are not supported in the Inventory API and this field will have no effect/be ignored once the listing is migrated. |
ListingDetails.MinimumBestOfferPrice | Best Offer Auto Decline | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ListingDuration | Listing Durations | N/A | None | The value for the ListingDuration field in Trading API can only be |
ListingEnhancement | Listing Enhancements | N/A | None | There are no equivalent listing enhancements fields (like 'Bold Title' or 'Pro Pack Bundle') in the Inventory API, but the active eBay listing will actually retain any listing enhancement after migration. The seller will just not be able to modify these enhancements once the listing is migrated. |
ListingType | Selling Formats | N/A | None | The value for the ListingType field in Trading API can only be |
Location | Item Location | location.address.city, location.address.stateOrProvince | Location | The string in the Location field in Trading API will generally be a city and a state. Upon a successful migration, this city and state value will be picked up by the location.address container in the newly created Location object. The value for the Location field is also used to create the identifier for the Location object (merchantLocationKey). |
PaymentMethods in Trading, but this setting must be made in Payment policy; paymentProfile.paymentInfo.acceptedPaymentMethod in Business Policies API. | Payment | No equivalent in Inventory API, but equivalent in the Payment Policy object of Account API is paymentMethods.paymentMethodType. | Payment Policy | Accepted payment methods are handled by Payment listing policies. If seller is using the legacy Business Policies API to manage business policy, accepted payment methods are set in the acceptedPaymentMethod field, and the equivalent field in the Account API is paymentMethods.paymentMethodType. |
PayPalEmailAddress |
| This field is deprecated. | ||
PickupInStoreDetails.EligibleForPickupDropOff in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.EligibleForPickupDropOff in Business Policies API. | Click and Collect | No equivalent in Inventory API, but the equivalent in the Fulfillment Policy object of Account API is the pickupDropOff field. | Fulfillment Policy | The boolean value of these fields in the Business Policies API and Account API must be set to |
PickupInStoreDetails.EligibleForPickupInStore in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.EligibleForPickupInStore in Business Policies API. | In-Store Pickup | N/A | None |
|
PictureDetails.GalleryDuration | Picture Gallery | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any picture/gallery details after migration. The seller will just not be able to modify these picture/gallery details once the listing is migrated. |
PictureDetails.GalleryType | Picture Gallery | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any picture/gallery details after migration. The seller will just not be able to modify these picture/gallery details once the listing is migrated. |
PictureDetails.PhotoDisplay | Pictures | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any picture/gallery details after migration. The seller will just not be able to modify these picture/gallery details once the listing is migrated. |
PictureDetails.PictureSource | Pictures | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any picture/gallery details after migration. The seller will just not be able to modify these picture/gallery details once the listing is migrated. |
PictureDetails.PictureURL | Pictures | product.imageUrls, imageUrls | Inventory Item, Inventory Item Group | Any URLs to pictures specified through one or more PictureDetails.PictureURL fields in Trading API will be mapped to the product.imageUrls array of the Inventory Item object (for single-variation listings), or to the imageUrls array of the Inventory Item Group object (for multiple-variation listings) |
PostalCode | Item Location | location.address.postalCode | Location | The postal/zip code (in string format) in the PostalCode field in Trading API will be mapped to the location.address.postalCode field in the newly created Location object. The value for the postalCode field is also used to create the identifier for the Location object (merchantLocationKey). |
PrimaryCategory.CategoryID | eBay Category | categoryId | Offer | The eBay Category ID in the PrimaryCategory.CategoryID field in Trading API will be mapped to the categoryId field of the Offer object. |
PrivateListing | Private Listings | N/A | None | Private listings are not supported in the Inventory API, so an attempt to migrate one of these listings will be blocked. If the PrivateListing field is set to |
PrivateNotes | Item Notes | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any private notes after migration. The seller will just not be able to modify these private notes once the listing is migrated. |
ProductListingDetails.BrandMPN | Product Identifiers | product.brand, product.mpn, product.aspects | Inventory Item | The Brand and MPN values set in the ProductListingDetails.BrandMPN container in Trading API will be mapped to the product.brand and product.mpn fields in the Inventory Item object; these name-value pairs will also be picked up by the product.aspects array for the Inventory Item object |
ProductListingDetails.EAN | Product Identifiers | product.ean, product.aspects | Inventory Item | The EAN value set in the ProductListingDetails.EAN field in Trading API will be mapped to the product.ean field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object |
ProductListingDetails.IncludeeBayProductDetails | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. |
ProductListingDetails.IncludeStockPhotoURL | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. however, if a product match is found in the eBay catalog based on a GTIN, the URL to a stock photo (if available) will be picked up by the Inventory Item object |
ProductListingDetails.ISBN | Product Identifiers | product.isbn, product.aspects | Inventory Item | The ISBN value set in the ProductListingDetails.ISBN field in Trading API will be mapped to the product.isbn field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object. |
ProductListingDetails.NameValueList | Product Identifiers | product.aspects, product.brand, product.ean, product.isbn, product.mpn, product.upc | Inventory Item | The ProductListingDetails.NameValueList container is currently only available in Sandbox environment, but once it is fully enabled, any GTIN name-value pairs that are input through this container will be mapped to the corresponding product container fields in the Inventory Item object. |
ProductListingDetails.ProductReferenceID | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. |
ProductListingDetails.ReturnSearchResultOnDuplicates | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. |
ProductListingDetails.TicketListingDetails.EventTitle | Event Listings | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any Ticket Listing Details after migration. The seller will just not be able to modify these Ticket Listing Details once the listing is migrated. |
ProductListingDetails.TicketListingDetails.PrintedDate | Event Listings | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any Ticket Listing Details after migration. The seller will just not be able to modify these Ticket Listing Details once the listing is migrated. |
ProductListingDetails.TicketListingDetails.PrintedTime | Event Listings | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any Ticket Listing Details after migration. The seller will just not be able to modify these Ticket Listing Details once the listing is migrated. |
ProductListingDetails.TicketListingDetails.Venue | Event Listings | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain any Ticket Listing Details after migration. The seller will just not be able to modify these Ticket Listing Details once the listing is migrated. |
ProductListingDetails.UPC | Product Identifiers | product.upc, product.aspects | Inventory Item | The UPC value set in the ProductListingDetails.UPC field in Trading API will be mapped to the product.upc field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object |
ProductListingDetails.UseFirstProduct | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. |
ProductListingDetails.UseStockPhotoURLAsGallery | Product Identifiers | N/A | None | There is no equivalent field in the Inventory API, and this field will have no effect/be ignored when the listing is migrated. |
Quantity | Listing Quantity/Inventory | availability.shipToLocationAvailability.quantity, availableQuantity | Inventory Item, Offer | The value in the Quantity field in Trading API will get mapped to the availability.shipToLocationAvailability.quantity field in the Inventory Item object and in the availableQuantity field of the Offer object. The availability.shipToLocationAvailability.quantity field represents the total quantity of the item that is available, while the availableQuantity field represents the available quantity in the marketplace specified within the offer. |
QuantityInfo.MinimumRemnantSet | Event Listings | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain Minimum Remnant Set value after migration. The seller will just not be able to modify this value once the listing is migrated. |
QuantityRestrictionPerBuyer.MaximumQuantity | Inventory | quantityLimitPerBuyer | Offer | The value in the MaximumQuantity field in Trading API will get mapped to the quantityLimitPerBuyer field of the Offer object. |
ReturnPolicy.Description in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.description in Business Policies API | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is description. | Return Policy | The description of the Return Policy is set in the returnPolicyProfile.returnPolicyInfo.description field in the Business Policies API, and in the description field of the Return Policy object in the Account API. |
ReturnPolicy.ExtendedHolidayReturns in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.holidayReturns in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is extendedHolidayReturnsOffered. | Return Policy | The holiday returns boolean value of the Return Policy is set in the returnPolicyProfile.returnPolicyInfo.holidayReturns field in the Business Policies API, and in the extendedHolidayReturnsOffered field of the Return Policy object in the Account API. |
ReturnPolicy.RefundOption in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.refundOption in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is refundMethod. | Return Policy | The refund option of the Return Policy is set in the returnPolicyProfile.returnPolicyInfo.refundOption field in the Business Policies API, and in the refundMethod field of the Return Policy object in the Account API. |
ReturnPolicy.RestockingFeeValueOption in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.restockingFeeValue in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is restockingFeePercentage. | Return Policy | The restocking fee percentage of the Return Policy is set in the returnPolicyProfile.returnPolicyInfo.restockingFeeValue field in the Business Policies API, and in the restockingFeePercentage field of the Return Policy object in the Account API. |
ReturnPolicy.ReturnsAcceptedOption in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.returnsAcceptedOption in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is returnsAccepted. | Return Policy | In the Business Policies API, the returnPolicyProfile.returnPolicyInfo.returnsAcceptedOption field is set to either |
ReturnPolicy.returnsWithinOption in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.returnsWithinOption in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is returnPeriod container. | Return Policy | The return period of the Return Policy is set in the returnPolicyProfile.returnPolicyInfo.returnsWithinOption field in the Business Policies API, and in the returnPeriod container of the Return Policy object in the Account API. |
ReturnPolicy.ShippingCostPaidByOption in Trading, but this setting must be made in Return listing policy; returnPolicyProfile.returnPolicyInfo.shippingCostPaidByOption in Business Policies API. | Return Policy | No equivalent in Inventory API, but equivalent in the Return Policy object of Account API is returnShippingCostPayer. | Return Policy | The shipping cost payer for a Return is set in the returnPolicyProfile.returnPolicyInfo.shippingCostPaidByOption field in the Business Policies API, and in the returnShippingCostPayer field of the Return Policy object in the Account API. |
ReturnPolicy.WarrantyDurationOption in Trading, and returnPolicyProfile.returnPolicyInfo.warrantyDurationOption in Business Policies API. | Return Policy | N/A | None | There is no equivalent field in the Inventory API or Account API, but the active eBay listing will actually retain any Warranty settings after migration. The seller will just not be able to modify Warranty settings once the listing is migrated. |
ReturnPolicy.WarrantyOfferedOption in Trading, and returnPolicyProfile.returnPolicyInfo.warrantyOfferedOption in Business Policies API. | Return Policy | N/A | None | There is no equivalent field in the Inventory API or Account API, but the active eBay listing will actually retain any Warranty settings after migration. The seller will just not be able to modify Warranty settings once the listing is migrated. |
ReturnPolicy.WarrantyTypeOption in Trading, and returnPolicyProfile.returnPolicyInfo.warrantyTypeOption in Business Policies API. | Return Policy | N/A | None | There is no equivalent field in the Inventory API or Account API, but the active eBay listing will actually retain any Warranty settings after migration. The seller will just not be able to modify Warranty settings once the listing is migrated. |
ScheduleTime | Listing Start Time | N/A | None | This field is not applicable because it is only used at Add/Revise/Relist time, and the Inventory API does not allow for scheduled listings. Once an Offer is successfully published with a Publish Offer call, the eBay listing goes live. |
SecondaryCategory.CategoryID | Secondary Listing Category | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain a Secondary eBay Category after migration. The seller will just not be able to modify this Secondary eBay Category once the listing is migrated. And a Secondary eBay Category cannot be used for any offers created through the Inventory API |
SellerProfiles.SellerPaymentProfile.PaymentProfileID | Payment Listing Policy | listingPolicies.paymentPolicyId | Offer | The payment policy ID used in the PaymentProfileID field in Trading API is mapped to the listingPolicies.paymentPolicyId field in the Offer object of Inventory API, and this particular payment policy is the one that is controlling the payment-related settings. |
SellerProfiles.SellerPaymentProfile.PaymentProfileName | Payment Listing Policy | N/A | Offer | The Offer object in the Inventory API only accepts a Profile ID, so the PaymentProfileName field in Trading API is not applicable with the Inventory API, and has no effect/is ignored; however, even if only a PaymentProfileName is provided in an Add/Revise/Relist Trading API call, this name is always matched to a profile ID, so this profile ID is always matched to the listingPolicies.paymentPolicyId field in the Inventory API. |
SellerProfiles.SellerReturnProfile.ReturnProfileID | Return Listing Policy | listingPolicies.returnPolicyId | Offer | The return policy ID used in the ReturnProfileID field in Trading APIis mapped to the listingPolicies.returnPolicyId field in the Offer object of Inventory API, and this particular return listing policy is the one that is controlling the Return Policy-related settings. |
SellerProfiles.SellerReturnProfile.ReturnProfileName | Return Listing Policy | N/A | Offer | The Offer object in the Inventory API only accepts a Profile ID, so the ReturnProfileName field in Trading API is not applicable with the Inventory API, and has no effect/is ignored; however, even if only a ReturnProfileName is provided in an Add/Revise/Relist Trading API call, this name is always matched to a profile ID, so this profile ID is always matched to the listingPolicies.returnPolicyId field in the Inventory API. |
SellerProfiles.SellerShippingProfile.ShippingProfileID | Fulfillment Listing Policy | listingPolicies.fulfillmentPolicyId | Offer | The shipping policy ID used in the ShippingProfileID field in Trading API is mapped to the listingPolicies.fulfillmentPolicyId field in the Offer object of Inventory API, and this particular fulfillment listing policy is the one that is controlling the fulfillment-related settings. |
SellerProfiles.SellerShippingProfile.ShippingProfileName | Fulfillment Listing Policy | listingPolicies.fulfillmentPolicyId | Offer | The Offer object in the Inventory API only accepts a Profile ID, so the ShippingProfileName field in Trading API is not applicable with the Inventory API, and has no effect/is ignored; however, even if only a ShippingProfileName is provided in an Add/Revise/Relist Trading API call, this name is always matched to a profile ID, so this profile ID is always matched to the listingPolicies.fulfillmentPolicyId field in the Inventory API. |
SellingStatus.CurrentPrice | Item Price | pricingSummary.price | Offer | The current price of a fixed-price listing can be found in the SellingStatus.CurrentPrice field of the Trading API, and this price is mapped to the pricingSummary.price container of the Offer object in the Inventory API. |
SellerProvidedTitle | Listing Title (Motors listing only) | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingDetails.CalculatedShippingRate.InternationalPackagingHandlingCosts in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.internationalPackagingHandlingCosts in Business Policies API. | Handling Costs (International) | No equivalent in Inventory API, but the equivalent in the Fulfillment Policy object of Account API is the shippingOptions.packageHandlingCosts field, and the value of the corresponding shippingOptions.optionType field must be set to | Fulfillment Policy | The handling cost for an international shipment is set in the shippingPolicyInfo.internationalPackagingHandlingCosts field in the Business Policies API, and in the shippingOptions.packageHandlingCosts and shippingOptions.optionType fields of the Fulfillment Policy object in the Account API. The optionType value must be set to |
ShippingDetails.CalculatedShippingRate.MeasurementUnit | Calculated Shipping | packageWeightAndSize.dimensions.unit, packageWeightAndSize.weight.unit | Inventory Item | The enumeration value in the ShippingDetails.CalculatedShippingRate.MeasurementUnit field will determine the measurement units that are set in the dimensions.unit and weight.unit fields in the Inventory Item object. If the enumeration value in the ShippingDetails.CalculatedShippingRate.MeasurementUnit field is |
ShippingDetails.CalculatedShippingRate.OriginatingPostalCode | Calculated Shipping | location.address.postalCode | Location | Although the values of ShippingDetails.CalculatedShippingRate.OriginatingPostalCode and location.address.postalCode may be the same, the value of location.address.postalCode will actually pick up the value of the PostalCode field in Trading API instead. |
ShippingDetails.CalculatedShippingRate.packagingHandlingCosts in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.packagingHandlingCosts in Business Policies API. | Handling Costs (Domestic) | No equivalent in Inventory API, but the equivalent in the Fulfillment Policy object of Account API is the shippingOptions.packageHandlingCosts field, and the value of the corresponding shippingOptions.optionType field must be set to | Fulfillment Policy | The handling cost for a domestic shipment is set in the shippingPolicyInfo.packagingHandlingCosts field in the Business Policies API, and in the shippingOptions.packageHandlingCosts and shippingOptions.optionType fields of the Fulfillment Policy object in the Account API. The optionType value must be set to |
ShippingDetails.CalculatedShippingRate.ShippingIrregular | Calculated Shipping | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingDetails.CODCost in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.codFee and shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.codFee in Business Policies API. | Cash on Delivery/Pay Upon Pickup | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is shippingOptions.shippingServices.cashOnDeliveryFee and shippingOptions.optionType. | Fulfillment Policy | The COD fee for a domestic shipment and international shipment is set in the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.codFee and shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.codFee fields in the Business Policies API, respectively. In the Account API, the COD fee for both domestic and international shipments is set in the shippingOptions.shippingServices.cashOnDeliveryFee field of the Fulfillment Policy object, and the optionType value controls whether the fee is for a |
ShippingDetails.ExcludeShipToLocation in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.excludeShipToLocation in Business Policies API. | Excluded Shipping Locations | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shipToLocations.regionExcluded array. | Fulfillment Policy | In the Business Policies API, the excluded shipping locations are set in one or more shippingPolicyProfile.shippingPolicyInfo.excludeShipToLocation fields. In the Account API, the excluded shipping locations are set in the shipToLocations.regionExcluded container of the Fulfillment Policy object. |
ShippingDetails.GlobalShipping in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.GlobalShipping in Business Policies API. | Global Shipping Program | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the globalShipping field. | Fulfillment Policy | The Global Shipping Program is enabled through the shippingPolicyProfile.shippingPolicyInfo.GlobalShipping field in the Business Policies API, and through the globalShipping field of the Fulfillment Policy object in the Account API. |
ShippingDetails.InsuranceDetails.InsuranceFee in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.insurance.domesticInsuranceFee in Business Policies API. | Shipping Insurance (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.insuranceFee and shippingOptions.optionType fields. | Fulfillment Policy | The shipping insurance fee for domestic shipments is set in the shippingPolicyProfile.shippingPolicyInfo.insurance.domesticInsuranceFee field in the Business Policies API, and in the shippingOptions.insuranceFee and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InsuranceDetails.InsuranceOption in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.insurance.domesticInsuranceOption in Business Policies API. | Shipping Insurance (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.insuranceOption and shippingOptions.optionType fields. | Fulfillment Policy | Whether shipping insurance is offered or not for domestic shipments is controlled in the shippingPolicyProfile.shippingPolicyInfo.insurance.domesticInsuranceOption field in the Business Policies API, and in the shippingOptions.insuranceOffered and shippingOptions.optionType field of the Account API. The insuranceOffered boolean value should be |
ShippingDetails.InternationalInsuranceDetails.InsuranceFee in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.insurance.intlInsuranceFee in Business Policies API. | Shipping Insurance (International) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.insuranceFee and shippingOptions.optionType fields. | Fulfillment Policy | The shipping insurance fee for international shipments is set in the shippingPolicyProfile.shippingPolicyInfo.insurance.intlInsuranceFee field in the Business Policies API, and in the shippingOptions.insuranceFee and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InternationalInsuranceDetails.InsuranceOption in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.insurance.intlInsuranceOption in Business Policies API. | Shipping Insurance (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.insuranceOffered and shippingOptions.optionType fields. | Fulfillment Policy | Whether shipping insurance is offered or not for domestic shipments is controlled in the shippingPolicyProfile.shippingPolicyInfo.insurance.intlInsuranceOption field in the Business Policies API, and in the shippingOptions.insuranceOffered and shippingOptions. The insuranceOffered boolean value should be |
ShippingDetails.InternationalPromotionalShippingDiscount in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.applyIntlPromoShippingProfile in Business Policies API. | Shipping Discounts (Intl) | N/A | None | The promotional shipping discount rule (set up in My eBay Shipping Preferences or through the SetShippingDiscountProfiles call in Trading API) can be applied through the shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.applyIntlPromoShippingProfile boolean field in the Business Policy API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the promotional shipping discount rule after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingDetails.InternationalShippingDiscountProfileID in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.intlFlatCalcDiscountProfileId in Business Policies API. | Shipping Discounts (Intl) | N/A | None | A specific international shipping discount rule (set up in My eBay Shipping Preferences or through the SetShippingDiscountProfiles call in Trading API) can be applied through the shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.intlFlatCalcDiscountProfileId field in the Business Policy API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the shipping discount rule after migration. The seller will just not be able to modify this rule once the listing is migrated. |
ShippingDetails.InternationalShippingServiceOption.ShippingService in Trading, but all international shipping services must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingService in Business Policies API. | Shipping Service Metadata (Intl) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.shippingServiceCode and shippingOptions.optionType fields. | Fulfillment Policy | An international shipping service option is specified through the shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingService field in the Business Policies API, and in the shippingOptions.shippingServices.shippingServiceCode and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InternationalShippingServiceOption.ShippingServiceAdditionalCost in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingServiceAdditionalCost in Business Policies API. | Shipping Service Metadata (Intl) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.additionalShippingCost and shippingOptions.optionType fields. | Fulfillment Policy | The additional cost to ship each additional item (in a multiple-quantity order) is specified through the shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingServiceAdditionalCost field in the Business Policies API, and in the shippingOptions.shippingServices.additionalShippingCost and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InternationalShippingServiceOption.ShippingServiceCost in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingServiceCost in Business Policies API. | Shipping Service Metadata (Intl) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.shippingCost and shippingOptions.optionType fields. | Fulfillment Policy | The shipping cost of the shipping service is specified through the shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shippingServiceCost field in the Business Policies API, and in the shippingOptions.shippingServices.shippingCost and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InternationalShippingServiceOption.ShippingServicePriority in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.sortOrderId in Business Policies API. | Shipping Service Metadata (Intl) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.sortOrder and shippingOptions.optionType fields. | Fulfillment Policy | The order in which the shipping services appear in the listing is set through the shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.sortOrderId field in the Business Policies API, and in the shippingOptions.shippingServices.sortOrder and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.InternationalShippingServiceOption.ShipToLocation in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shipToLocation array in Business Policies API. | Shipping Service Metadata (Intl) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.shipToLocations.regionIncluded and shippingOptions.shippingServices.shipToLocations.regionExcluded containers, and the shippingOptions.optionType field. | Fulfillment Policy | The shipping locations covered by the shipping service is set through one or more shippingPolicyProfile.shippingPolicyInfo.intlShippingPolicyInfoService.shipToLocation fields in the Business Policies API, and in the shippingOptions.shippingServices.shipToLocations.regionIncluded and shippingOptions.shippingServices.shipToLocations.regionExcluded containers, and the shippingOptions.optionType field of the Account API. The optionType value would be set to |
ShippingDetails.PaymentInstructions in Trading, but this setting must be set up in Payment policy; paymentProfile.PaymentInfo.paymentInstructions in Business Policies API. | Payment | No equivalent in Inventory API, but equivalent in the Payment Policy object of Account API is the paymentInstructions field. | Payment Policy | Payment instructions are set up in the paymentProfile.PaymentInfo.paymentInstructions field in Business Policies API, and in the paymentInstructions field of the Account API. |
ShippingDetails.PromotionalShippingDiscount in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.applyDomesticPromoShippingProfile in Business Policies API. | Shipping Discounts (Domestic) | N/A | None | The promotional shipping discount rule (set up in My eBay Shipping Preferences or through the SetShippingDiscountProfiles call in Trading API) can be applied through the shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.applyDomesticPromoShippingProfile boolean field in the Business Policy API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the promotional shipping discount rule after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingDetails.RateTableDetails.DomesticRateTable in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticRateTable in Business Policies API. | Shipping Rate Tables (Domestic) | N/A | None | The domestic shipping rate table (set up in My eBay Shipping Preferences) can be applied through the shippingPolicyProfile.shippingPolicyInfo.domesticRateTable field in Business Policies API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the domestic shipping rate table settings after migration. The seller will just not be able to modify these settings once the listing is migrated. |
ShippingDetails.RateTableDetails.InternationalRateTable in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.intlRateTable in Business Policies API. | Shipping Rate Tables (International) | N/A | None | The international shipping rate table (set up in My eBay Shipping Preferences) can be applied through the shippingPolicyProfile.shippingPolicyInfo.intlRateTable field in Business Policies API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the international shipping rate table settings after migration. The seller will just not be able to modify these settings once the listing is migrated. |
ShippingDetails.SalesTax.SalesTaxPercent. Any sales tax rates are only applicable if the UseTaxTable boolean field in Trading is set to | Sales Tax | salesTaxPercentage in Sales Tax object in Account API. | Sales Tax, Offer | The ShippingDetails.SalesTax.SalesTaxPercent field in Trading API and the salesTaxPercentage field in the Sales Tax object of Account API are only used to create/update the sales tax for one state or jurisdiction. Any sales tax rates that are set up are only applicable if the tax.applyTax boolean field in Offer object is set to |
ShippingDetails.SalesTax.SalesTaxState. Any sales tax rates are only applicable if the UseTaxTable boolean field in Trading is set to | Sales Tax | jurisdictionId in the Create a Sales Tax Table Entry URI. | Sales Tax, Offer | The ShippingDetails.SalesTax.SalesTaxState field in Trading API and the jurisdictionId value in the Create a Sales Tax Table Entry URI in the Sales Tax object of Account API are only used to create/update the sales tax for one state or jurisdiction. Any sales tax rates that are set up are only applicable if the tax.applyTax boolean field in Offer object is set to |
ShippingDetails.SalesTax.ShippingIncludedInTax. Any sales tax rates are only applicable if the UseTaxTable boolean field in Trading is set to | Sales Tax | shippingAndHandlingTaxed in Sales Tax object in Account API. | Sales Tax, Offer | The ShippingDetails.SalesTax.ShippingIncludedInTax field in Trading API and the shippingAndHandlingTaxed in Sales Tax object in Account API are only applied to one state or jurisdiction. Any sales tax information that is set up is only applicable if the tax.applyTax boolean field in Offer object is set to |
ShippingDetails.ShippingDiscountProfileID in Trading, but this setting must be made in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.domesticFlatCalcDiscountProfileId in Business Policies API. | Shipping Discounts (Domestic) | N/A | None | A specific domestic shipping discount rule (set up in My eBay Shipping Preferences or through the SetShippingDiscountProfiles call in Trading API) can be applied through the shippingPolicyProfile.shippingPolicyInfo.shippingProfileDiscountInfo.domesticFlatCalcDiscountProfileId field in the Business Policy API. There is no equivalent field in the Inventory API, but the active eBay listing will actually retain the shipping discount rule after migration. The seller will just not be able to modify this rule once the listing is migrated. |
ShippingDetails.ShippingServiceOptions.FreeShipping in Trading, but free domestic shipping must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.freeShipping in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.freeShipping, shippingOptions.shippingServices.sortOrder, and shippingOptions.optionType fields. | Fulfillment Policy | Free shipping should only be applied to one domestic shipping service in the Account API's fulfillment policy, and that shipping service should be the number one priority service (shippingOptions.shippingServices.sortOrder set to |
ShippingDetails.ShippingServiceOptions.ShippingService in Trading, but all international shipping services must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingService in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.shippingServiceCode and shippingOptions.optionType fields. | Fulfillment Policy | A domestic shipping service option is specified through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingService field in the Business Policies API, and in the shippingOptions.shippingServices.shippingServiceCode and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.ShippingServiceOptions.ShippingServiceAdditionalCost in Trading, but this cost must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingServiceAdditionalCost in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.additionalShippingCost and shippingOptions.optionType fields. | Fulfillment Policy | The additional cost to ship each additional item (in a multiple-quantity order) is specified through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingServiceAdditionalCost field in the Business Policies API, and in the shippingOptions.shippingServices.additionalShippingCost and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.ShippingServiceOptions.ShippingServiceCost in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingServiceCost in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.shippingCost and shippingOptions.optionType fields. | Fulfillment Policy | The shipping cost of the shipping service is specified through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingServiceCost field in the Business Policies API, and in the shippingOptions.shippingServices.shippingCost and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.ShippingServiceOptions.ShippingServicePriority in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.sortOrderId in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.sortOrder and shippingOptions.optionType fields. | Fulfillment Policy | The order in which the shipping services appear in the listing is set through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.sortOrderId field in the Business Policies API, and in the shippingOptions.shippingServices.sortOrder and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.ShippingServiceOptions.ShippingSurcharge in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingSurcharge in Business Policies API. | Shipping Service Metadata (Domestic) | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.shippingServices.surcharge and shippingOptions.optionType fields. | Fulfillment Policy | The shipping surcharge for a domestic shipping service is set through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingPolicyInfoService.shippingSurcharge field in the Business Policies API, and in the shippingOptions.shippingServices.surcharge and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingDetails.ShippingType in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingType and shippingPolicyProfile.shippingPolicyInfo.intlShippingType in Business Policies API. | Shipping Method | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.costType and shippingOptions.optionType fields. | Fulfillment Policy | The shipping cost type for domestic or international shipping is set through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingType and shippingPolicyProfile.shippingPolicyInfo.intlShippingType fields in the Business Policies API, and in the shippingOptions.costType and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShippingPackageDetails.MeasurementUnit | Shipping Package Details | packageWeightAndSize.dimenstions.unit (for dimensions) and packageWeightAndSize.weight.unit (for weight). | Inventory Item | In Trading API, the ShippingPackageDetails.MeasurementUnit field controls whether the Imperial (used in US) or Metric sytem is used for measurements. In the Inventory API, the LengthUnitOfMeasureEnum type defines the units of measurement used in the packageWeightAndSize.dimenstions.unit field, and the WeightUnitOfMeasureEnum type defines the units of measurement used in the packageWeightAndSize.weight.unit field. |
ShippingPackageDetails.PackageDepth | Shipping Package Details | packageWeightAndSize.dimenstions.height | Inventory Item | In Trading API, the ShippingPackageDetails.PackageDepth field sets the depth/height of shipping package. In the Inventory API, packageWeightAndSize.dimenstions.height sets the depth/height of shipping package. |
ShippingPackageDetails.PackageLength | Shipping Package Details | packageWeightAndSize.dimenstions.length | Inventory Item | In Trading API, the ShippingPackageDetails.PackageLength field sets the length of shipping package. In the Inventory API, packageWeightAndSize.dimenstions.length sets the length of shipping package. |
ShippingPackageDetails.PackageWidth | Shipping Package Details | packageWeightAndSize.dimenstions.width | Inventory Item | In Trading API, the ShippingPackageDetails.PackageWidth field sets the length of shipping package. In the Inventory API, packageWeightAndSize.dimenstions.width sets the width of shipping package. |
ShippingPackageDetails.ShippingIrregular | Shipping Package Details | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingPackageDetails.ShippingPackage | Shipping Package Details | packageWeightAndSize.packageType | Inventory Item | The ShippingPackageDetails.ShippingPackage field value in Trading API will get mapped to the packageWeightAndSize.packageType field in Inventory API. |
ShippingPackageDetails.WeightMajor | Shipping Package Details | packageWeightAndSize.weight.value | Inventory Item | The ShippingPackageDetails.WeightMajor and ShippingPackageDetails.WeightMinor field values in Trading API will get mapped to the packageWeightAndSize.weight.value field in Inventory API. The value of the ShippingPackageDetails.MeasurementUnit field in Trading API will control what the value of the packageWeightAndSize.weight.unit field in Inventory API will be. |
ShippingPackageDetails.WeightMinor | Shipping Package Details | packageWeightAndSize.weight.value | Inventory Item | The ShippingPackageDetails.WeightMajor and ShippingPackageDetails.WeightMinor field values in Trading API will get mapped to the packageWeightAndSize.weight.value field in Inventory API. The value of the ShippingPackageDetails.MeasurementUnit field in Trading API will control what the value of the packageWeightAndSize.weight.unit field in Inventory API will be. |
ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceAdditionalCost | Shipping Service Cost Overrides | listingPolicies.shippingCostOverrides.additionalShippingCost | Offer | The cost in the ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceAdditionalCost field in Trading API will get mapped to the listingPolicies.shippingCostOverrides.additionalShippingCost field in Inventory API. |
ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceCost | Shipping Service Cost Overrides | listingPolicies.shippingCostOverrides.shippingCost | Offer | The cost in the ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceCost field in Trading API will get mapped to the listingPolicies.shippingCostOverrides.shippingCost field in Inventory API. |
ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServicePriority | Shipping Service Cost Overrides | listingPolicies.shippingCostOverrides.priority | Offer | The priority (integer value) of the corresponding shipping service option set in the ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServicePriority field in Trading API will get mapped to the listingPolicies.shippingCostOverrides.priority field in Inventory API. |
ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceType | Shipping Service Cost Overrides | listingPolicies.shippingCostOverrides.shippingServiceType | Offer | The value set in the ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingServiceType field in Trading API ( |
ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingSurcharge | Shipping Service Cost Overrides | listingPolicies.shippingCostOverrides.surcharge | Offer | The cost set in the ShippingServiceCostOverrideList.ShippingServiceCostOverride.ShippingSurcharge field in Trading API will get mapped to the listingPolicies.shippingCostOverrides.surcharge field in Inventory API. Note that surcharges cannot be set for international shipping options. |
ShippingTermsInDescription | Listing Description | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
ShippingDetails.ShippingType in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.domesticShippingType and shippingPolicyProfile.shippingPolicyInfo.intlShippingType in Business Policies API. | Shipping Method | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shippingOptions.costType and shippingOptions.optionType fields. | Fulfillment Policy | The shipping cost type for domestic or international shipping is set through the shippingPolicyProfile.shippingPolicyInfo.domesticShippingType and shippingPolicyProfile.shippingPolicyInfo.intlShippingType fields in the Business Policies API, and in the shippingOptions.costType and shippingOptions.optionType fields of the Account API. The optionType value would be set to |
ShipToLocations in Trading, but this setting must be set up in Shipping/Fulfillment policy; shippingPolicyProfile.shippingPolicyInfo.shipToLocations in Business Policies API. | Ship-To Locations | No equivalent in Inventory API, but equivalent in the Fulfillment Policy object of Account API is the shipToLocations.regionIncluded container. | Fulfillment Policy | All ship-to locations set up through ShipToLocations fields in Trading API will get mapped to the shipToLocations.regionIncluded container in Inventory API. The name of each shipping location is mapped to the shipToLocations.regionIncluded.regionName field and the type of region (e.g. Country, State, Region, etc.) is mapped to the shipToLocations.regionIncluded.regionType field. |
Site | eBay Site | marketplaceId | Offer | The Site value in Trading API will get mapped to the marketplaceId in Inventory API. |
SKU | Inventory | sku | Inventory Item | The SKU value in Trading API will become the unique identifer (SKU) of the newly created Inventory Item object in Inventory API. |
StartPrice | Item Price | N/A | None | Although The StartPrice and SellingStatus.CurrentPrice values in Trading API will be the same for a fixed-price listing unless the price was modified with a Revise action, the StartPrice field in Trading API is not used for the migration. |
Storefront.StoreCategory2ID | eBay Store Categories | storeCategoryNames array | Offer | A seller has the option of loading an item under one or two of their eBay Store Categories. The Storefront.StoreCategory2ID value in Trading API sets the root level for the secondary eBay Store Category. So, if the secondary eBay Store Category is at the third tier of the seller's Store Category hierarchy, the Storefront.StoreCategory2ID value would be |
Storefront.StoreCategory2Name | eBay Store Categories | storeCategoryNames array | Offer | A seller has the option of loading an item under one or two of their eBay Store Categories. The Storefront.StoreCategory2Name value in Trading API specifies the name for the secondary eBay Store Category, and this category must exist at the level that is specified through the Storefront.StoreCategory2ID field. During the migration, both the Storefront.StoreCategory2ID and Storefront.StoreCategory2Name will be used to create the full path to the eBay Store Category in the storeCategoryNames array of the Offer object in the Inventory API. |
Storefront.StoreCategoryID | eBay Store Categories | storeCategoryNames array | Offer | A seller has the option of loading an item under one or two of their eBay Store Categories. The Storefront.StoreCategoryID value in Trading API sets the root level for the primary eBay Store Category. So, if the primary eBay Store Category is at the first tier of the seller's Store Category hierarchy, the Storefront.StoreCategoryID value would be |
Storefront.StoreCategoryName | eBay Store Categories | storeCategoryNames array | Offer | A seller has the option of loading an item under one or two of their eBay Store Categories. The Storefront.StoreCategoryName value in Trading API specifies the name for the primary eBay Store Category, and this category must exist at the level that is specified through the Storefront.StoreCategoryID field. During the migration, both the Storefront.StoreCategoryID and Storefront.StoreCategoryName will be used to create the full path to the eBay Store Category in the storeCategoryNames array of the Offer object in the Inventory API. |
SubTitle | Subtitle Listing Upgrade | product.subtitle in Inventory Item object and subtitle in Inventory Item Group object. | Inventory Item, Inventory Item Group | For a single-variation listing, the value in the SubTitle field in Trading API will be mapped to the product.subtitle field in the Inventory Item object of the Inventory API. For a multiple-variation listing, the value in the SubTitle field in Trading API will be mapped to the product.subtitle field in the Inventory Item object, and to the subtitle field in the Inventory Item Group object of the Inventory API. |
TaxCategory | Premium Sales Tax | tax.thirdPartyTaxCategory | Offer | The tax category code in the TaxCategory field of the Trading API is mapped to the tax.thirdPartyTaxCategory field in the Inventory API. |
Title | Listing Title | product.title in Inventory Item object and title in Inventory Item Group object. | Inventory Item, Inventory Item Group | For a single-variation listing, the value in the Title field in Trading API will be mapped to the product.title field in the Inventory Item object of the Inventory API. For a multiple-variation listing, the value in the Title field in Trading API will be mapped to the product.title field in the Inventory Item object, and to the title field in the Inventory Item Group object of the Inventory API. |
UseTaxTable | Sales Tax Table | tax.applyTax in Offer object | Offer | If the UseTaxTable in Trading Map is set to |
Variations.Pictures.VariationSpecificName | Multiple Variations/Pictures | variesBy.aspectsImageVariesBy in Inventory Item Group object | Inventory Item Group | The aspect in Variations.Pictures.VariationSpecificName is mapped to the variesBy.aspectsImageVariesBy field in the Inventory Item Group object. |
Variations.Pictures.VariationSpecificPictureSet.PictureURL | Multiple Variations/Pictures | imageUrls in Inventory Item Group object | Inventory Item Group | Each Variations.Pictures.VariationSpecificPictureSet.PictureURL value is mapped to the imageUrls array in Inventory Item Group object. |
Variations.Pictures.VariationSpecificPictureSet.VariationSpecificValue | Multiple Variations/Pictures | variesBy.specifications.values in Inventory Item Group object | Inventory Item Group | Variations.Pictures.VariationSpecificPictureSet.VariationSpecificValue value is mapped to the variesBy.specifications.values array in Inventory Item Group object. Each of these values correspond to the Variations.Pictures.VariationSpecificName value. So, if the Variations.Pictures.VariationSpecificName is |
Variation.DiscountPriceInfo.MadeForOutletComparisonPrice | Multiple Variations/eBay Outlets | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
Variation.DiscountPriceInfo.MinimumAdvertisedPrice | Multiple Variations/Minimum Advertised Price | pricingSummary.minimumAdvertisedPrice | Offer | If Variation.DiscountPriceInfo.MinimumAdvertisedPrice field is set in Trading API, the price in this field is mapped to the pricingSummary.minimumAdvertisedPrice field of the Offer object in the Inventory API. |
Variation.DiscountPriceInfo.MinimumAdvertisedPriceExposure | Multiple Variations/Minimum Advertised Price | pricingSummary.pricingVisibility | Offer | If Variation.DiscountPriceInfo.MinimumAdvertisedPriceExposure field is set in Trading API, the enum value in this field is mapped to the pricingSummary.pricingVisibility field of the Offer object in the Inventory API; |
Variation.DiscountPriceInfo.OriginalRetailPrice | Multiple Variations/Strikethrough Pricing | pricingSummary.originalRetailPrice | Offer | If Variation.DiscountPriceInfo.OriginalRetailPricefield is set in Trading API, the price in this field is mapped to the pricingSummary.originalRetailPrice container of the Offer object in the Inventory API. |
Variation.DiscountPriceInfo.SoldOffeBay | Multiple Variations/Strikethrough Pricing | pricingSummary.originallySoldForRetailPriceOn | Offer | If Variation.DiscountPriceInfo.SoldOffeBay field is set to |
Variation.DiscountPriceInfo.SoldOneBay | Multiple Variations/Strikethrough Pricing | pricingSummary.originallySoldForRetailPriceOn | Offer | If Variation.DiscountPriceInfo.SoldOneBay field is set to |
Variation.Quantity | Multiple Variations/Inventory | availability.shipToLocationAvailability.quantity in Inventory Item object and availableQuantity field in Offer object | Inventory Item, Offer | The Variation.Quantity value will be mapped to the availability.shipToLocationAvailability.quantity field in Inventory Item object and the availableQuantity field in Offer object. |
Variation.SKU | Multiple Variations/Inventory | sku in Inventory Item and Offer objects | Inventory Item, Offer | The Variation.SKU value in Trading API will become the unique identifer (SKU) of the newly created Inventory Item object in Inventory API and will also get picked by the sku field in the Offer object. |
Variation.StartPrice | Multiple Variations/Price | pricingSummary.price | Offer | The Variation.StartPrice value is mapped to the pricingSummary.price container in Offer object for the corresponding SKU. |
Variation.VariationProductListingDetails.EAN | Multiple Variations/Product Identifiers | product.ean, product.aspects | Inventory Item | The EAN value set in the Variation.VariationProductListingDetails.EAN field in Trading API will be mapped to the product.ean field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object. |
Variation.VariationProductListingDetails.ISBN | Multiple Variations/Product Identifiers | product.isbn, product.aspects | Inventory Item | The ISBN value set in the Variation.VariationProductListingDetails.ISBN field in Trading API will be mapped to the product.isbn field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object. |
Variation.VariationProductListingDetails.NameValueList | Multiple Variations/Product Identifiers | product.aspects, product.brand, product.ean, product.isbn, product.mpn, product.upc | Inventory Item | The Variation.VariationProductListingDetails.NameValueList container is currently only available in Sandbox environment, but once it is fully enabled, any GTIN name-value pairs that are input through this container will be mapped to the corresponding product container fields in the Inventory Item object. |
Variation.VariationProductListingDetails.UPC | Multiple Variations/Product Identifiers | product.upc, product.aspects | Inventory Item | The UPC value set in the Variation.VariationProductListingDetails.UPC field in Trading API will be mapped to the product.upc field in the Inventory Item object; this name-value pair will also be picked up by the product.aspects array for the Inventory Item object. |
Variation.VariationSpecifics.NameValueList.Name | Multiple Variations/Item Specifics | product.aspects array in Inventory Item object | Inventory Item | Each Aspect/Item Specific for a product variation that is defined in the Variation.VariationSpecifics.NameValueList.Name field in Trading API is mapped to the product.aspects array in Inventory Item object. The product.aspects array pairs together Item Specifics and their values, using this syntax: "Storage Capacity": ["128GB"]. |
Variation.VariationSpecifics.NameValueList.Value | Multiple Variations/Item Specifics | product.aspects array in Inventory Item object | Inventory Item | Each value for an Aspect/Item Specific for a product variation that is defined in the Variation.VariationSpecifics.NameValueList.Value field in Trading API is mapped to the product.aspects array in Inventory Item object. The product.aspects array pairs together Item Specifics and their values, using this syntax: "Storage Capacity": ["128GB"]. |
VariationSpecificsSet.NameValueList.Name | Multiple Variations/Shared Aspects | variesBy.specifications.name field in Inventory Item Group object | Inventory Item Group | Each aspect that is shared among all variations within a group is defined in the Variation.VariationSpecifics.NameValueList.Name field in Trading API, and is mapped to a variesBy.specifications.name field in Inventory Item Group object. |
VariationSpecificsSet.NameValueList.Value | Multiple Variations/Shared Aspects | variesBy.specifications.values array in Inventory Item Group object | Inventory Item Group | The values of each aspect that is shared among all variations within a group is defined in the corresponding Variation.VariationSpecifics.NameValueList.Value fields in Trading API, and is mapped to the variesBy.specifications.values array in Inventory Item Group object. |
VATDetails.BusinessSeller | Business Seller | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
VATDetails.RestrictedToBusiness | Business Seller | N/A | None | There is no equivalent field in the Inventory API, but the active eBay listing will actually retain this setting after migration. The seller will just not be able to modify this setting once the listing is migrated. |
VATDetails.VATPercent | VAT | tax.vatPercentage | Offer | The VAT percentage value set in the VATDetails.VATPercent field in Trading API is mapped to the tax.vatPercentage field in the Offer object. |
VIN | Motor Vehicle Listings | N/A | None | The VIN field is only used when a listing is created/revised/relisted, so this field is not applicable to the migration. |
VRM | Motor Vehicle Listings | N/A | None | The VRM field is only used when a listing is created/revised/relisted, so this field is not applicable to the migration. |