POST/bulk_create_or_replace_inventory_item
Note: Please note that any eBay listing created using the Inventory API cannot be revised or relisted using the Trading API calls.
Note: Each listing can be revised up to 250 times in one calendar day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar day.
This call can be used to create and/or update up to 25 new inventory item records. It is up to sellers whether they want to create a complete inventory item records right from the start, or sellers can provide only some information with the initial bulkCreateOrReplaceInventoryItem call, and then make one or more additional bulkCreateOrReplaceInventoryItem calls to complete all required fields for the inventory item records and prepare for publishing. Upon first creating inventory item records, only the SKU values are required.
Important!Publish offer note: Fields may be optional or conditionally required when calling this method, but become required when publishing the offer to create an active listing. For this method, see Inventory item fields for a list of fields required to publish an offer.
Note: In addition to the
authorization
header, which is required for all eBay REST API calls, this call also requires the Content-Language
and Content-Type
headers. See the HTTP request headers section for more information.In the case of updating existing inventory item records, the bulkCreateOrReplaceInventoryItem call will do a complete replacement of the existing inventory item records, so all fields that are currently defined for the inventory item record are required in that update action, regardless of whether their values changed. So, when replacing/updating an inventory item record, it is advised that the seller run a 'Get' call to retrieve the full details of the inventory item records and see all of its current values/settings before attempting to update the records. Any changes that are made to inventory item records that are part of one or more active eBay listings, a successful call will automatically update these active listings.
The key information that is set with the bulkCreateOrReplaceInventoryItem call include:
- Seller-defined SKU value for the product. Each seller product, including products within an item inventory group, must have their own SKU value.
- Condition of the item
- Product details, including any product identifier(s), such as a UPC, ISBN, EAN, or Brand/Manufacturer Part Number pair, a product description, a product title, product/item aspects, and links to images. eBay will use any supplied eBay Product ID (ePID) or a GTIN (UPC, ISBN, or EAN) and attempt to match those identifiers to a product in the eBay Catalog, and if a product match is found, the product details for the inventory item will automatically be populated.
- Quantity of the inventory item that is available for purchase
- Package weight and dimensions, which is required if the seller will be offering calculated shipping options. The package weight will also be required if the seller will be providing flat-rate shipping services, but charging a weight surcharge.
For those who prefer to create or update a single inventory item record, the createOrReplaceInventoryItem method can be used.
Input
Resource URI
This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com
root URI with api.sandbox.ebay.com
URI parameters
This method has no URI parameters.
HTTP request headers
All requests made to eBay REST operations require you to provide the Authorization
HTTP header for authentication authorization.
The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.
Header | Type | Description |
---|---|---|
Content-Language | string | This header sets the natural language that will be used in the field values of the request payload. For example, the value passed in this header should be en-US for English or de-DE for German.For more information on the Content-Language header, refer to HTTP request headers. Occurrence: Required |
Content-Type | string | This header indicates the format of the request body provided by the client. Its value should be set to application/json. For more information, refer to HTTP request headers. Occurrence: Required |
OAuth scope
This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
https://api.ebay.com/oauth/api_scope/sell.inventory
See OAuth access tokens for more information.
Request payload
Copy complete valid JSON to clipboardRequest fields
Input container/field | Type | Description |
---|---|---|
requests | array of InventoryItemWithSkuLocale | The details of each inventory item that is being created or updated is passed in under this container. Up to 25 inventory item records can be created and/or updated with one bulkCreateOrReplaceInventoryItem call. Occurrence: Required |
requests.availability | Availability | This container is used to specify the quantity of the inventory item that are available for purchase. Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability | array of PickupAtLocationAvailability | This container consists of an array of one or more of the merchant's physical store locations where the inventory item is available for In-Store Pickup orders. The merchant's location, the quantity available, and the fulfillment time (how soon the item will be ready for pickup after the order takes place) are all in this container. In-Store Pickup is only available to large merchants selling on the US, UK, Germany, and Australia sites. Occurrence: Optional |
requests.availability.pickupAtLocationAvailability.availabilityType | AvailabilityTypeEnum | The enumeration value in this field indicates the availability status of the inventory item at the merchant's physical store specified by the pickupAtLocationAvailability.merchantLocationKey field. This field is required if the pickupAtLocationAvailability container is used, and is always returned with the pickupAtLocationAvailability container. Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability.fulfillmentTime | TimeDuration | This container is used to indicate how soon an In-Store Pickup order will be available for pickup by the buyer after the order takes place. This container is required if the pickupAtLocationAvailability container is used, and is always returned with the pickupAtLocationAvailability container. Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability.fulfillmentTime.unit | TimeDurationUnitEnum | This enumeration value indicates the time unit used to specify the fulfillment time, such as Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability.fulfillmentTime.value | integer | The integer value in this field, along with the time unit in the unit field, will indicate the fulfillment time. Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability.merchantLocationKey | string | The unique identifier of a merchant's store where the In-Store Pickup inventory item is currently located, or where inventory will be sent to. If the merchant's store is currently awaiting for inventory, the availabilityType value should be Occurrence: Conditional |
requests.availability.pickupAtLocationAvailability.quantity | integer | This integer value indicates the quantity of the inventory item that is available for In-Store Pickup at the store identified by the merchantLocationKey value. The value of quantity should be an integer value greater than Occurrence: Conditional |
requests.availability.shipToLocationAvailability | ShipToLocationAvailability | This container specifies the quantity of the inventory item that are available for purchase across one or more eBay marketplaces. Occurrence: Optional |
requests.availability.shipToLocationAvailability.availabilityDistributions | array of AvailabilityDistribution | This container is used to set the available quantity of the inventory item at one or more warehouse locations. Occurrence: Optional |
requests.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime | TimeDuration | This container is used to indicate the expected fulfillment time if the inventory item is shipped from the warehouse location identified in the corresponding merchantLocationKey field. The fulfillment time is the estimated number of business days after purchase that the buyer can expect the item to be delivered. Occurrence: Optional |
requests.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | TimeDurationUnitEnum | This enumeration value indicates the time unit used to specify the fulfillment time, such as Occurrence: Conditional |
requests.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer | The integer value in this field, along with the time unit in the unit field, will indicate the fulfillment time. Occurrence: Conditional |
requests.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string | The unique identifier of an inventory location where quantity is available for the inventory item. This field is conditionally required to identify the inventory location that has quantity of the inventory item. Occurrence: Conditional |
requests.availability.shipToLocationAvailability.availabilityDistributions.quantity | integer | The integer value passed into this field indicates the quantity of the inventory item that is available at this inventory location. This field is conditionally required. Occurrence: Conditional |
requests.availability.shipToLocationAvailability.quantity | integer | This container is used to set the total 'ship-to-home' quantity of the inventory item that will be available for purchase through one or more published offers. This field is not immediately required, but 'ship-to-home' quantity must be set before an offer of the inventory item can be published. Occurrence: Conditional |
requests.condition | ConditionEnum | This enumeration value indicates the condition of the item. Supported item condition values will vary by eBay site and category. To see which item condition values that a particular eBay category supports, use the getItemConditionPolicies method of the Metadata API. This method returns condition ID values that map to the enumeration values defined in the ConditionEnum type. The Item condition ID and name values topic in the Selling Integration Guide has a table that maps condition ID values to ConditionEnum values. The getItemConditionPolicies call reference page has more information. Important!For trading card listings in Non-Sport Trading Card Singles (183050), CCG Individual Cards (183454), and Sports Trading Card Singles (261328) categories, sellers must use either LIKE_NEW (2750) or USED_VERY_GOOD (4000) item condition. No other item conditions will be accepted. Use of these item conditions require the seller to use the conditionDescriptors array to provide one or more applicable Condition Descriptor name-value pairs. See the conditionDescriptors field description for more information. If these requierments are not followed, publishOffer, updateOffer, bulkPublishOffer, and publishOfferByInventoryItemGroup methods will fail when trying to create new listings. Important!Publish offer note: This field is required before an offer can be published to create an active listing. Occurrence: Conditional |
requests.conditionDescription | string | This string field is used by the seller to more clearly describe the condition of a used inventory item, or an inventory item whose condition value is not Occurrence: Conditional |
requests.conditionDescriptors | array of ConditionDescriptor | Important!For trading card listings in Non-Sport Trading Card Singles (183050), CCG Individual Cards (183454), and Sports Trading Card Singles (261328) categories, sellers must use either LIKE_NEW (2750) or USED_VERY_GOOD (4000) item condition. No other item conditions will be accepted. Use of these item conditions require the seller to use the conditionDescriptors array to provide one or more applicable Condition Descriptor name-value pairs. See the conditionDescriptors field description for more information. If these requierments are not followed, publishOffer, updateOffer, bulkPublishOffer, and publishOfferByInventoryItemGroup methods will fail when trying to create new listings. This container is used by the seller to provide additional information about the condition of an item in a structured format. Condition descriptors are name-value attributes that can be either closed set or open text inputs. To retrieve all condition descriptor numeric IDs for a category, use the getItemConditionPolicies method of the Metadata API. Occurrence: Conditional |
requests.conditionDescriptors.additionalInfo | string | This string provides additional information about a condition descriptor. Open text is passed in this field. Occurrence: Optional |
requests.conditionDescriptors.name | string | This string provides the name of a condition descriptor. A numeric ID is passed in this field. This numeric ID maps to the name of a condition descriptor. Condition descriptor name-value pairs provide more information about an item's condition in a structured way. Occurrence: Conditional |
requests.conditionDescriptors.values | array of string | This array provides the value(s) associated with a condition descriptor. One or more numeric IDs is passed in this field. Commas are used as delimiters between successive name/value pairs. These numeric IDs map to the values associated with a condition descriptor name. Condition descriptor name-value pairs provide more information about an item's condition in a structured way. Occurrence: Conditional |
requests.locale | LocaleEnum | This request parameter sets the natural language that was provided in the field values of the request payload (i.e., en_AU, en_GB or de_DE). Occurrence: Required |
requests.packageWeightAndSize | PackageWeightAndSize | This container is used if the seller is offering one or more calculated shipping options for the inventory item, or if the seller is offering flat-rate shipping but is including a shipping surcharge based on the item's weight. This container is used to specify the dimensions and weight of a shipping package. Occurrence: Conditional |
requests.packageWeightAndSize.dimensions | Dimension | This container is used to indicate the length, width, and height of the shipping package that will be used to ship the inventory item. The dimensions of a shipping package are needed when calculated shipping is used. Occurrence: Conditional |
requests.packageWeightAndSize.dimensions.height | number | The actual height (in the measurement unit specified in the unit field) of the shipping package. All fields of the dimensions container are required if package dimensions are specified. Occurrence: Conditional |
requests.packageWeightAndSize.dimensions.length | number | The actual length (in the measurement unit specified in the unit field) of the shipping package. All fields of the dimensions container are required if package dimensions are specified. Occurrence: Conditional |
requests.packageWeightAndSize.dimensions.unit | LengthUnitOfMeasureEnum | The unit of measurement used to specify the dimensions of a shipping package. All fields of the dimensions container are required if package dimensions are specified. If the English system of measurement is being used, the applicable values for dimension units are Occurrence: Conditional |
requests.packageWeightAndSize.dimensions.width | number | The actual width (in the measurement unit specified in the unit field) of the shipping package. All fields of the dimensions container are required if package dimensions are specified. Occurrence: Conditional |
requests.packageWeightAndSize.packageType | PackageTypeEnum | This enumeration value indicates the type of shipping package used to ship the inventory item. The supported values for this field can be found in the PackageTypeEnum type. Occurrence: Conditional |
requests.packageWeightAndSize.shippingIrregular | boolean | A value of Occurrence: Optional |
requests.packageWeightAndSize.weight | Weight | This container is used to specify the weight of the shipping package that will be used to ship the inventory item. The weight of a shipping package are needed when calculated shipping is used, or if flat-rate shipping rates are used, but with a weight surcharge. Occurrence: Conditional |
requests.packageWeightAndSize.weight.unit | WeightUnitOfMeasureEnum | The unit of measurement used to specify the weight of a shipping package. Both the unit and value fields are required if the weight container is used. If the English system of measurement is being used, the applicable values for weight units are Occurrence: Conditional |
requests.packageWeightAndSize.weight.value | number | The actual weight (in the measurement unit specified in the unit field) of the shipping package. Both the unit and value fields are required if the weight container is used. If a shipping package weighed 20.5 ounces, the container would look as follows: "weight": { Occurrence: Conditional |
requests.product | Product | This container is used to define the product details, such as product title, product description, product identifiers (eBay Product ID, GTIN, or Brand/MPN pair), product aspects/item specifics, and product images. Note that an eBay Product ID (ePID) or a Global Trade Item Number (GTIN) value can be used in an attempt to find a matching product in the eBay Catalog. If a product match is found, the inventory item record will automatically pick up all product details associated with the eBay Catalog product. 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. Occurrence: Conditional |
requests.product.aspects | string | This is a collection of item specifics (aka product aspects) name-value pairs that provide more information about the product and might make it easier for buyers to find. To view required/recommended product aspects/item specifics names (and corresponding values) for a specific eBay category, sellers can use the getItemAspectsForCategory method of the Taxonomy API. Alternatively, sellers can view similar items on eBay.com in the same category to get an idea of what other sellers are using for product aspects/item specifics.
Note that inventory items that will become part of an inventory item group and multiple-variation listing should have the same attributes that are defined for the inventory item group. This container will be returned if one or more item specific pairs are defined for the inventory item. Important!Publish offer note: This field is required before an offer can be published to create an active listing. Max Length for Aspect Name: 40 Max Length for Aspect Value: 50 Occurrence: Conditional |
requests.product.brand | string | The brand of the product. This field is often paired with the mpn field to identify a specific product by Manufacturer Part Number. This field is conditionally required if the eBay category requires a Manufacturer Part Number (MPN) value. If eBay is able to find a product match in the eBay Catalog when an eBay Product ID (ePID) or GTIN value (UPC, ISBN, or EAN) is supplied, all product details of that eBay Catalog product is picked up by the inventory item record (including brand) if the createOrReplaceInventoryItem call is successful. Occurrence: Conditional |
requests.product.description | string | The description of the product. The description of an existing inventory item can be added or modified with a createOrReplaceInventoryItem call. The description of an inventory item is automatically populated if the seller specifies an eBay Product ID (ePID) or a Global Trade Item Number (GTIN) and eBay is able to find a matching product in the eBay Catalog.
This field is returned if defined for an inventory item. If one of the GTIN types (e.g. UPC) was passed in when the inventory item was created/modified and a product match was found in the eBay catalog, product description is one of the details that gets picked up from the catalog product. Important!Publish offer note: This field is required before an offer can be published to create an active listing. Max Length: 4000 Occurrence: Conditional |
requests.product.ean | array of string | The European Article Number/International Article Number (EAN) for the product. Although an ePID value is preferred when trying to find a product match in the eBay Catalog, this field can also be used in an attempt to find a product match in the eBay Catalog. If a product match is found in the eBay Catalog, the inventory item is automatically populated with available product details such as a title, a product description, product aspects (including the specified EAN value), and a link to any stock image that exists for the catalog product. Occurrence: Optional |
requests.product.epid | string | The eBay Product Identifier (ePID) for the product. This field can be used to directly identify an eBay Catalog product. Based on its specified ePID value, eBay will search for the product in the eBay Catalog, and if a match is found, the inventory item is automatically populated with available product details such as product title, product description, product aspects, and a link to any stock image that exists for the catalog product.
This field is returned if defined for an inventory item. Occurrence: Conditional |
requests.product.imageUrls | array of string | An array of one or more links to images for the product. URLs must use the "HTTPS" protocol. Images can be self-hosted by the seller, or sellers can use the UploadSiteHostedPictures call of the Trading API to upload images to an eBay Picture Server. If successful, the response of the UploadSiteHostedPictures call will contain a full URL to the image on an eBay Picture Server. This is the URL that will be passed in through the imageUrls array. Before an offer can be published, at least one image must exist for the inventory item. In almost any category at no cost, sellers can include up to 24 pictures in one listing. For inventory items that are a part of an inventory item group/multiple-variation listings, a maximum of 12 pictures may be used per inventory item in the group. Motor vehicle listings are an exception. The number of included pictures in motor vehicle listings depend on the selected vehicle package (see Fees for selling vehicles on eBay Motors). Important!Publish offer note: This array is required and at least one image URL must be specified before an offer can be published to create an active listing. Occurrence: Conditional |
requests.product.isbn | array of string | The International Standard Book Number (ISBN) value for the product. Although an ePID value is preferred when trying to find a product match in the eBay Catalog, this field can also be used in an attempt to find a product match in the eBay Catalog. If a product match is found in the eBay Catalog, the inventory item is automatically populated with available product details such as a title, a product description, product aspects (including the specified ISBN value), and a link to any stock image that exists for the catalog product. Occurrence: Optional |
requests.product.mpn | string | The Manufacturer Part Number (MPN) of a product. This field is paired with the brand field to identify a product. Some eBay categories require MPN values. The getItemAspectsForCategory method in the Taxonomy API can be used to see if a category requires an MPN. The MPN value for a product may automatically be populated for an inventory item if the seller specifies an eBay Product ID (ePID) or a Global Trade Item Number (GTIN) and eBay is able to find a matching product in the eBay Catalog. Occurrence: Conditional |
requests.product.subtitle | string | A subtitle is an optional listing feature that allows the seller to provide more information about the product, possibly including keywords that may assist with search results. An additional listing fee will be charged to the seller if a subtitle is used. For more information on using listing subtitles on the US site, see the Adding a subtitle to your listings help page. The subtitle of an existing inventory item can added, modified, or removed with a createOrReplaceInventoryItem call. Occurrence: Optional |
requests.product.title | string | The title of an inventory item can be added or modified with a createOrReplaceInventoryItem call. Although not immediately required, a title will be needed before an offer with the inventory item is published. The title of an inventory item is automatically populated if the seller specifies an eBay Product ID (ePID) or a Global Trade Item Number (GTIN) and eBay is able to find a matching product in the eBay Catalog. If the inventory item will become part of a single-variation offer, and the listing is not a product-based listing, the text in this field will become the actual listing title for the published offer. However, if the inventory item will become part of a multiple-variation offer, the text in title field of the inventory item group entity will actually become the listing title for the published offer instead, although a title can still be provided for the inventory item, and it will actually become the title of the variation. Important!Publish offer note: This field is required before an offer can be published to create an active listing. Max Length: 80 Occurrence: Conditional |
requests.product.upc | array of string | The Universal Product Code (UPC) value for the product. Although an ePID value is preferred when trying to find a product match in the eBay Catalog, this field can also be used in an attempt to find a product match in the eBay Catalog. If a product match is found in the eBay Catalog, the inventory item is automatically populated with available product details such as a title, a product description, product aspects (including the specified UPC value), and a link to any stock image that exists for the catalog product. Occurrence: Optional |
requests.product.videoIds | array of string | An array of one or more videoId values for the product. A video ID is a unique identifier that is automatically created by eBay when a seller successfully uploads a video to eBay using the uploadVideo method of the Media API. Occurrence: Optional |
requests.sku | string | This is the seller-defined SKU value of the product that will be listed on the eBay site (specified in the marketplaceId field). Only one offer (in unpublished or published state) may exist for each sku/marketplaceId/format combination. This field is required. Occurrence: Required |
Output
HTTP response headers
This call has no response headers.
Response payload
Response fields
Output container/field | Type | Description |
---|---|---|
responses | array of InventoryItemResponse | This is the base container of the bulkCreateOrReplaceInventoryItem response. The results of each attempted inventory item creation/update is captured under this container. Occurrence: Always |
responses.errors | array of ErrorDetailV3 | This container will be returned if there were one or more errors associated with the creation or update to the inventory item record. Occurrence: Conditional |
responses.errors.category | string | This string value indicates the error category. There are three categories of errors: request errors, application errors, and system errors. Occurrence: Conditional |
responses.errors.domain | string | The name of the domain in which the error or warning occurred. Occurrence: Conditional |
responses.errors.errorId | integer | A unique code that identifies the particular error or warning that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. Occurrence: Conditional |
responses.errors.inputRefIds | array of string | An array of one or more reference IDs which identify the specific request element(s) most closely associated to the error or warning, if any. Occurrence: Conditional |
responses.errors.longMessage | string | A detailed description of the condition that caused the error or warning, and information on what to do to correct the problem. Occurrence: Conditional |
responses.errors.message | string | A description of the condition that caused the error or warning. Occurrence: Conditional |
responses.errors.outputRefIds | array of string | An array of one or more reference IDs which identify the specific response element(s) most closely associated to the error or warning, if any. Occurrence: Conditional |
responses.errors.parameters | array of ErrorParameterV3 | Various warning and error messages return one or more variables that contain contextual information about the error or waring. This is often the field or value that triggered the error or warning. Occurrence: Conditional |
responses.errors.parameters.name | string | This type contains the name and value of an input parameter that contributed to a specific error or warning condition. Occurrence: Conditional |
responses.errors.parameters.value | string | This is the actual value that was passed in for the element specified in the name field. Occurrence: Conditional |
responses.errors.subdomain | string | The name of the subdomain in which the error or warning occurred. Occurrence: Conditional |
responses.locale | LocaleEnum | This field returns the natural language that was provided in the field values of the request payload (i.e., en_AU, en_GB or de_DE). Occurrence: Always |
responses.sku | string | The seller-defined Stock-Keeping Unit (SKU) of the inventory item. The seller should have a unique SKU value for every product that they sell. Occurrence: Always |
responses.statusCode | integer | The HTTP status code returned in this field indicates the success or failure of creating or updating the inventory item record for the inventory item indicated in the sku field. See the HTTP status codes table to see which each status code indicates. Occurrence: Always |
responses.warnings | array of ErrorDetailV3 | This container will be returned if there were one or more warnings associated with the creation or update to the inventory item record. Occurrence: Conditional |
responses.warnings.category | string | This string value indicates the error category. There are three categories of errors: request errors, application errors, and system errors. Occurrence: Conditional |
responses.warnings.domain | string | The name of the domain in which the error or warning occurred. Occurrence: Conditional |
responses.warnings.errorId | integer | A unique code that identifies the particular error or warning that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. Occurrence: Conditional |
responses.warnings.inputRefIds | array of string | An array of one or more reference IDs which identify the specific request element(s) most closely associated to the error or warning, if any. Occurrence: Conditional |
responses.warnings.longMessage | string | A detailed description of the condition that caused the error or warning, and information on what to do to correct the problem. Occurrence: Conditional |
responses.warnings.message | string | A description of the condition that caused the error or warning. Occurrence: Conditional |
responses.warnings.outputRefIds | array of string | An array of one or more reference IDs which identify the specific response element(s) most closely associated to the error or warning, if any. Occurrence: Conditional |
responses.warnings.parameters | array of ErrorParameterV3 | Various warning and error messages return one or more variables that contain contextual information about the error or waring. This is often the field or value that triggered the error or warning. Occurrence: Conditional |
responses.warnings.parameters.name | string | This type contains the name and value of an input parameter that contributed to a specific error or warning condition. Occurrence: Conditional |
responses.warnings.parameters.value | string | This is the actual value that was passed in for the element specified in the name field. Occurrence: Conditional |
responses.warnings.subdomain | string | The name of the subdomain in which the error or warning occurred. Occurrence: Conditional |
HTTP status codes
This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.
Status | Meaning |
---|---|
200 | Success |
207 | Multi-Status |
400 | Bad Request |
500 | Internal Server Error |
Error codes
For more on errors, plus the codes of other common errors, see Handling errors.
Code | Domain | Category | Meaning |
---|---|---|---|
25001 | API_INVENTORY | APPLICATION | Any System error. {additionalInfo} |
25002 | API_INVENTORY | REQUEST | Any User error. {additionalInfo} |
25003 | API_INVENTORY | REQUEST | Invalid price. {additionalInfo} |
25004 | API_INVENTORY | REQUEST | Invalid quantity. {additionalInfo} |
25005 | API_INVENTORY | REQUEST | Invalid category. {additionalInfo} |
25006 | API_INVENTORY | REQUEST | Invalid listing option. {additionalInfo} |
25007 | API_INVENTORY | REQUEST | Invalid Shipping policy information. {additionalInfo} |
25008 | API_INVENTORY | REQUEST | Invalid Payment policy information. {additionalInfo} |
25009 | API_INVENTORY | REQUEST | Invalid Return policy information. {additionalInfo} |
25011 | API_INVENTORY | REQUEST | Invalid tax information. {additionalInfo} |
25012 | API_INVENTORY | REQUEST | Invalid location. {additionalInfo} |
25013 | API_INVENTORY | REQUEST | Invalid InventoryItemGroup information. {additionalInfo} |
25014 | API_INVENTORY | REQUEST | Invalid pictures. {additionalInfo} |
25015 | API_INVENTORY | REQUEST | Invalid picture URL. {additionalInfo} |
25016 | API_INVENTORY | REQUEST | Invalid {fieldName}. {additionalInfo} |
25017 | API_INVENTORY | REQUEST | Missing field {fieldName}. {additionalInfo} |
25018 | API_INVENTORY | REQUEST | Incomplete account information. {additionalInfo} |
25019 | API_INVENTORY | REQUEST | Cannot revise listing. {additionalInfo} |
25020 | API_INVENTORY | REQUEST | Invalid package details. {additionalInfo} |
25021 | API_INVENTORY | REQUEST | Invalid condition information. {additionalInfo} |
25022 | API_INVENTORY | REQUEST | Invalid attribute. {fieldName} |
25023 | API_INVENTORY | REQUEST | Invalid compatibility information. {additionalInfo} |
25025 | API_INVENTORY | APPLICATION | Concurrent access of Inventory or InventoryItemGroup. Please try again later |
25026 | API_INVENTORY | REQUEST | Selling limits exceeded. {additionalInfo} |
25097 | API_INVENTORY | REQUEST | This listing is on hold due to a policy violation, and revisions are not possible. Please check your email for more information. |
25098 | API_INVENTORY | REQUEST | {replaceable_value} transaction is not possible as the parent listing is on-hold. Please check your email for further information. |
25501 | API_INVENTORY | REQUEST | Invalid picture. {additionalInfo} |
25502 | API_INVENTORY | REQUEST | Invalid attribute information. {additionalInfo} |
25503 | API_INVENTORY | REQUEST | Invalid product information. {additionalInfo} |
25601 | API_INVENTORY | REQUEST | Invalid attribute. {fieldName} |
25604 | API_INVENTORY | REQUEST | Input error. {additionalInfo} |
25701 | API_INVENTORY | REQUEST | These SKU(s) are not in the system |
25702 | API_INVENTORY | REQUEST | SKU {additionalInfo} is not available in the system |
25707 | API_INVENTORY | REQUEST | Invalid sku. sku has to be alphanumeric with upto 50 characters in length |
25708 | API_INVENTORY | REQUEST | Invalid sku |
25709 | API_INVENTORY | REQUEST | Invalid request. Invalid value for field {additionalInfo} |
25710 | API_INVENTORY | REQUEST | We didn't find the resource/entity you are requesting. Please verify the request |
25713 | API_INVENTORY | REQUEST | This Offer is not available : {additionalInfo}. |
25715 | API_INVENTORY | REQUEST | Invalid Dimension and Weight |
25727 | API_INVENTORY | REQUEST | The number of InventoryItems in the request cannot exceed {additionalInfo}. |
25728 | API_INVENTORY | REQUEST | InventoryItems should be unique in the request. |
25733 | API_INVENTORY | REQUEST | Valid SKU and locale information are required for all the InventoryItems in the request. |
25759 | API_INVENTORY | REQUEST | shipToLocationAvailability quantity value should be greater than or equal to auction allocation. Please provide valid quantity or unpublish auction offers of the sku. |
Warnings
For more on warnings, plus the codes of other common warnings, see Handling errors.
Code | Domain | Category | Meaning |
---|---|---|---|
25096 | API_INVENTORY | REQUEST | This listing is on hold due to a policy violation. You may revise it to resolve the situation. Please check your email for more information. |
25401 | API_INVENTORY | APPLICATION | Invalid listing options removed. {additionalInfo} |
25402 | API_INVENTORY | APPLICATION | System warning. {additionalInfo} |
25504 | API_INVENTORY | APPLICATION | {additionalInfo} |
25753 | API_INVENTORY | REQUEST | listingStartDate is in the past or the offer is live. Value is not updated on the listing. |
Samples
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
Sample 1: Bulk Create Inventory Items
This example will create two inventory items.
Input
This call creates two inventory items. A seller-defined SKU value must be provided for each inventory item. Other details provided for these inventory items include listing title, listing description, item condition, product aspects, URL to item images, and quantity available.
POSThttps://api.ebay.com/sell/inventory/v1/bulk_create_or_replace_inventory_item
Output
If an inventory item record is successfully retrieved, a statusCode value of 200
is returned for the SKU. For each SKU, all of the details currently defined for the inventory item record are returned.