Migrating Listings to Inventory API Objects

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:

  • Listing type must be Fixed-Price.
  • Listing duration must be 'GTC' (Good 'til Cancelled)
  • 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:

  • Best Offer settings, including the Best Offer Auto Accept and Auto Reject price thresholds
  • Any listing-level Buyer Requirements
  • Charity donations from sale proceeds
  • Listing Designer Template applied to the listing
  • Listing enhancements like a bold listing title or Gallery Plus
  • Listing in two categories (secondary category)

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 true, as all Inventory API listings must be immediate payment.

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.LinkedPayPalAccount

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.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; None --> NONE, DuringCheckout --> DURING_CHECKOUT, and PreCheckout --> PRE_CHECKOUT.

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 true in Trading API, the value of the pricingSummary.originallySoldForRetailPriceOn field of the Offer object is set to OFF_EBAY.

DiscountPriceInfo.SoldOneBay

Strikethrough Pricing

pricingSummary.originallySoldForRetailPriceOn

Offer

If SoldOneBay field is set to true in Trading API, the value of the pricingSummary.originallySoldForRetailPriceOn field of the Offer object is set to ON_EBAY.

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 SKU, the migration will fail. The seller must revise the listing and set the value to ItemID instead. So, each product in a listing must have a defined SKU, but the listing must be tracked by Item ID.

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 GTC since the Inventory API only supports fixed-price, GTC listings. If the value for the ListingDuration field is anything other than GTC, the migration will fail.

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 FixedPriceItem since the Inventory API only supports fixed-price, GTC listings. If the value for the ListingType field is anything other than FixedPriceItem, the migration will fail.

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. The only accepted payment method for listings created through the Inventory API is PayPal, since listings created through the Inventory API must be immediate payment, and immediate payment's only accepted payment method is PayPal.

PayPalEmailAddress in Trading, but this setting must be made in Payment policy; paymentProfile.paymentInfo.paypalEmailAddress in Business Policies API.

Payment

No equivalent in Inventory API, but the equivalent in the Payment Policy object of Account API is the paymentMethods.recipientAccountReference container.

Payment Policy

The PayPal email address must be set in the paypalEmailAddress field of the legacy Payment Business Policy, or in the recipientAccountReference.referenceId field of the Payment policy in the Account API; the recipientAccountReference.referenceType enum field must be set to PAYPAL_EMAIL.

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 true to enable a listing for Click and Collect. Click and Collect is currently only available on the UK and Australia sites.

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 true, the seller can revise the listing to turn off this setting (change to false or just remove the PrivateListing field in a ReviseFixedPriceItem call), and then the seller should be able to migrate the listing.

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

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 ReturnsAccepted or ReturnsNotAccepted to control whether returns are accepted or not, and in the Account API, the returnsAccepted boolean field controls whether returns are accepted or not.

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 INTERNATIONAL

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 INTERNATIONAL.

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 English, the value of dimensions.unit will be set to INCH and the value of weight.unit will be set to OUNCE, and if the enumeration value in the ShippingDetails.CalculatedShippingRate.MeasurementUnit field is Metric, the value of dimensions.unit will be set to CENTIMETER and the value of weight.unit will be set to GRAM.

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 DOMESTIC

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 DOMESTIC.

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 DOMESTIC or INTERNATIONAL shipping service.

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 DOMESTIC

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 true and the optionType value would be set to DOMESTIC.

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 INTERNATIONAL.

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 true and the optionType value would be set to INTERNATIONAL.

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 INTERNATIONAL.

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 INTERNATIONAL.

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 INTERNATIONAL.

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 INTERNATIONAL.

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 INTERNATIONAL.

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 true.

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 true.

ShippingDetails.SalesTax.SalesTaxState. Any sales tax rates are only applicable if the UseTaxTable boolean field in Trading is set to true.

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 true.

ShippingDetails.SalesTax.ShippingIncludedInTax. Any sales tax rates are only applicable if the UseTaxTable boolean field in Trading is set to true.

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 true.

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 1 for that shipping service). The optionType value would be set to DOMESTIC.

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 DOMESTIC.

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 DOMESTIC.

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 DOMESTIC.

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 DOMESTIC.

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 DOMESTIC.

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 DOMESTIC for domestic shipping and to INTERNATIONAL for international shipping.

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 (Domestic or International) will get mapped to the listingPolicies.shippingCostOverrides.shippingServiceType field in Inventory 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 DOMESTIC for domestic shipping and to INTERNATIONAL for international shipping.

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 2 since a 0-based index is used. 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.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 0 since a 0-based index is used. 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.

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 true, the tax.applyTax field will also be set to true.

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 Color the values in the variesBy.specifications.values array will be the colors in which the product is available.

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; None --> NONE , DuringCheckout --> DURING_CHECKOUT, and PreCheckout --> PRE_CHECKOUT.

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 true in Trading API, the value of the pricingSummary.originallySoldForRetailPriceOn field of the Offer object in the Inventory API is set to OFF_EBAY.

Variation.DiscountPriceInfo.SoldOneBay

Multiple Variations/Strikethrough Pricing

pricingSummary.originallySoldForRetailPriceOn

Offer

If Variation.DiscountPriceInfo.SoldOneBay field is set to true in Trading API, the value of the pricingSummary.originallySoldForRetailPriceOn field of the Offer object in the Inventory API is set to ON_EBAY.

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.