eBay Create Offer
*Summary of Changes:* (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)
Date | Version | Name | Applied changes |
---|---|---|---|
17.02.2025 | v1.0 | Bogomil Pavlov | First Published |
his call creates multiple offers (up to 25) for specific inventory items on a specific eBay marketplace. Although it is not a requirement for the seller to create complete offers (with all necessary details) right from the start, eBay recommends that the seller provide all necessary details with this call since there is currently no bulk operation available to update multiple offers with one call. The following fields are always required in the request payload: sku, marketplaceId, and (listing) format.
URL: POST [https://api.ebay.com/sell/inventory/v1/bulk_create_offer](https://api.ebay.com/sell/inventory/v1/bulk_create_offer)
Documentation: https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/bulkCreateOffer
Sample Request:
{
"requests": [
{
"sku": "S********F",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE",
"categoryId": "30120",
"pricingSummary": {
"price": {
"value": "100",
"currency": "USD"
},
"originalRetailPrice": {
"value": "120",
"currency": "USD"
},
"minimumAdvertisedPrice": {
"value": "95",
"currency": "USD"
},
"pricingVisibility": "PRE_CHECKOUT",
"originallySoldForRetailPriceOn": "ON_EBAY"
},
"storeCategoryNames": [
"shirts",
"accessories"
],
"listingPolicies": {
"fulfillmentPolicyId": "7********1",
"returnPolicyId": "6********1",
"paymentPolicyId": "6********1",
"shippingCostOverrides": [
{
"shippingCost": {
"value": "0",
"currency": "USD"
},
"additionalShippingCost": {
"value": "0",
"currency": "USD"
},
"priority": 1,
"shippingServiceType": "DOMESTIC"
}
]
},
"tax": {
"applyTax": true
},
"listingDescription": "With a stunning 5.7 inch Quad HD display and a powerful octa-core processor, it's the Lumia you've been waiting for. Get the phone that works like your PC and push the limits of what's possible.",
"quantityLimitPerBuyer": 5,
"merchantLocationKey": "S****1",
"includeCatalogProductDetails": false
},
{
"sku": "S********L",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE",
"categoryId": "30120",
"pricingSummary": {
"price": {
"value": 100,
"currency": "USD"
},
"originalRetailPrice": {
"value": 120,
"currency": "USD"
},
"minimumAdvertisedPrice": {
"value": 95,
"currency": "USD"
},
"pricingVisibility": "PRE_CHECKOUT",
"originallySoldForRetailPriceOn": "ON_EBAY"
},
"listingPolicies": {
"fulfillmentPolicyId": "7********1",
"returnPolicyId": "6********1",
"paymentPolicyId": "6********1",
"shippingCostOverrides": [
{
"shippingCost": {
"value": 0,
"currency": "USD"
},
"additionalShippingCost": {
"value": 0,
"currency": "USD"
},
"priority": 1,
"shippingServiceType": "DOMESTIC"
}
]
},
"taxDetails": {
"applyTax": true
},
"listingDescription": "With a stunning 5.7 inch Quad HD display and a powerful octa-core processor, it's the Lumia you've been waiting for. Get the phone that works like your PC and push the limits of what's possible.",
"quantityLimitPerBuyer": 5,
"merchantLocationKey": "S****1",
"includeCatalogProductDetails": true
}
]
}
Request Mapping:
eBay Field | Hemi Field | Required | Comment | |
---|---|---|---|---|
Sample Response:
{
"responses": [
{
"statusCode": 200,
"sku": "S********F",
"offerId": "3********6",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE"
},
{
"statusCode": 200,
"sku": "S********L",
"offerId": "3********7",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE"
}
]
}