This type provides details of an offer, and is used by the base request payload of the createOffer and bulkCreateOffer methods.
Type that uses EbayOfferDetailsWithKeys
Calls that use EbayOfferDetailsWithKeys
Fields
1
or more in order for the inventory item to be purchasable, but this field is not necessarily required, even for published offers, if the general quantity of the inventory item has already been set in the inventory item record.For auction listings, this value must be
1
.Note: The availableQuantity field if set here overrides the quantity field set in the inventory item. See the note in Offer fields for details.
Sellers can use the getCategorySuggestions method of the Taxonomy API to retrieve suggested category ID values. The seller passes in a query string like "iPhone 6", and category ID values for suggested categories are returned in the response.
Important!Publish offer note: This field is required before an offer can be published to create an active listing.
Note: When listing in categoryID 173651 (Auto Performance Tuning Devices & Software), use of catalog products is required. For more information, see Tuning devices and software.
Use the getExtendedProducerResponsibilityPolicies method of the Sell Metadata API to retrieve categories that support eco-participation fee for a specified marketplace.
Supported values are
FIXED_PRICE
and AUCTION
.true
if the seller wishes to create a private listing. Sellers may want to use this option when they believe that a listing's potential bidders/buyers would not want their obfuscated user IDs (and feedback scores) exposed to other users.
true
indicates the listing corresponds to the eBay product associated with the provided product identifier. The product identifier is provided in createOrReplaceInventoryItem.Default: true
Note: Though the includeCatalogProductDetails parameter is not required to be submitted in the request, the parameter defaults to true
if omitted.
HTML tags and markup can be used in listing descriptions, but each character counts toward the max length limit.
Note: To ensure that their short listing description is optimized when viewed on mobile devices, sellers should strongly consider using eBay's View Item description summary feature when listing their items. Keep in mind that the 'short' listing description is what prospective buyers first see when they view the listing on a mobile device. The 'full' listing description is also available to mobile users when they click on the short listing description, but the full description is not automatically optimized for viewing in mobile devices, and many users won't even drill down to the full description.
Using HTML div and span tag attributes, this feature allows sellers to customize and fully control the short listing description that is displayed to prospective buyers when viewing the listing on a mobile device. The short listing description on mobile devices is limited to 800 characters, and whenever the full listing description (provided in this field, in UI, or seller tool) exceeds this limit, eBay uses a special algorithm to derive the best possible short listing description within the 800-character limit. However, due to some short listing description content being removed, it is definitely not ideal for the seller, and could lead to a bad buyer experience and possibly to a Significantly not as described (SNAD) case, since the buyer may not get complete details on the item when viewing the short listing description. See the eBay help page for more details on using the HTML div and span tags.
Max length: 500000 (which includes HTML markup/tags)
GTC
, but auction listings support different listing durations.The GTC (Good 'Til Cancelled) listings are automatically renewed each calendar month until the seller decides to end the listing.
Note: If the listing duration expires for an auction offer without a winning bidder, the listing then becomes available as a fixed-price offer and listing duration will be
GTC
.Important!Publish offer note: This field is required before an offer can be published to create an active listing.
It is required that the seller be opted into Business Policies before being able to create live eBay listings through the Inventory API. Sellers can opt-in to Business Policies through My eBay or by using the Account API's optInToProgram call. Payment, return, and fulfillment listing policies may be created/managed in My eBay or by using the listing policy calls of the sell Account API. The sell Account API can also be used to create and manage custom policies. For more information, see the sell Account API.
Important!Publish offer note: This container and a few of its child fields (as noted below) are required before an offer can be published to create an active listing.
For example: 2023-05-30T19:08:00Z.
This field is optional. If this field is not provided, the listing starts immediately after a successful publishOffer method.
To get more information about inventory locations, the getInventoryLocations method can be used.
Note: This field is not initially required upon first creating an offer, but will become required before an offer can be published.
Important!Publish offer note: This field is required before an offer can be published to create an active listing.
Max length: 36
This container is not initially required upon first creating an offer, but the price of the offer will become required before an offer can be published.
Important!Publish offer note: This container and its child container, price, are required before an offer can be published to create an active listing.
5
, each buyer may purchase between one to five of these products, and the purchases can occur in one multiple-quantity purchase, or over multiple transactions. If a buyer attempts to purchase one or more of these products, and the cumulative quantity will take the buyer beyond the quantity limit, that buyer will be blocked from that purchase. Note: You cannot list US eBay Motors vehicles in two categories. However, you can list Parts & Accessories in two categories.
Note: When listing in categoryID 173651 (Auto Performance Tuning Devices & Software), use of catalog products is required. For more information, see Tuning devices and software.
Use the getInventoryItems method to retrieve SKU values.
Max Length: 50
"storeCategoryNames": [
"/Fashion/Men/Shirts",
"/Fashion/Men/Accessories" ],
true
, but a buyer's purchase will not involve sales tax.A sales-tax rate must be set up in the seller's sales-tax table for the buyer's state/tax jurisdiction in order for that buyer to be subject to sales tax. Sales-tax rates for different jurisdictions can be added/modified in the Payment Preferences section of My eBay, or the seller can use the sales tax calls of the Account API.
Note: Sales-tax tables are available only for the US and Canada marketplaces.Refer to Taxes and import charges for more information on setting up and using a sales tax table.