SapientPro\EbayInventorySDK\Api\OfferApi

All URIs are relative to https://api.ebay.com/sell/inventory/v1

Method	HTTP request	Description
bulkCreateOffer	POST /bulk_create_offer
bulkPublishOffer	POST /bulk_publish_offer
createOffer	POST /offer
deleteOffer	DELETE /offer/{offerId}
getListingFees	POST /offer/get_listing_fees
getOffer	GET /offer/{offerId}
getOffers	GET /offer
publishOffer	POST /offer/{offerId}/publish/
publishOfferByInventoryItemGroup	POST /offer/publish_by_inventory_item_group/
updateOffer	PUT /offer/{offerId}
withdrawOffer	POST /offer/{offerId}/withdraw
withdrawOfferByInventoryItemGroup	POST /offer/withdraw_by_inventory_item_group

bulkCreateOffer

SapientPro\EbayInventorySDK\Models\BulkOfferResponse bulkCreateOffer($body, $contentLanguage)

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

Other information that will be required before a offer can be published are highlighted below:

Inventory location
Offer price
Available quantity
eBay listing category
Referenced listing policy profiles to set payment, return, and fulfillment values/settings

Note: Though the includeCatalogProductDetails parameter is not required to be submitted in the request, the parameter defaults to true if omitted.

If the call is successful, unique offerId values are returned in the response for each successfully created offer. The offerId value will be required for many other offer-related calls. Note that this call only stages an offer for publishing. The seller must run either the publishOffer, bulkPublishOffer, or publishOfferByInventoryItemGroup call to convert offer(s) into an active single- or multiple-variation listing.

In addition to the authorization header, which is required for all eBay REST API calls, the bulkCreateOffer call also requires the Content-Language header, that sets the natural language that will be used in the field values of the request payload. For US English, the code value passed in this header should be en-US. To view other supported Content-Language values, and to read more about all supported HTTP headers for eBay REST API calls, see the <a href="/api-docs/static/rest-request-components.html#HTTP">HTTP request headers topic in the Using eBay RESTful APIs document.

For those who prefer to create a single offer per call, the createOffer method can be used instead.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\BulkEbayOfferDetailsWithKeys;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = BulkEbayOfferDetailsWithKeys::fromArray([
//
]);

try {
    $result = $apiInstance->bulkCreateOffer($body, LocaleEnum::de_AT);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->bulkCreateOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\BulkEbayOfferDetailsWithKeys	Details of the offer for the channel
contentLanguage	SapientPro\EbayInventorySDK\Enum\LocaleEnum	Language of the content

Return type

SapientPro\EbayInventorySDK\Models\BulkOfferResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

bulkPublishOffer

SapientPro\EbayInventorySDK\Models\BulkPublishResponse bulkPublishOffer($body)

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 is used to convert unpublished offers (up to 25) into published offers, or live eBay listings. The unique identifier (offerId) of each offer to publlish is passed into the request payload. It is possible that some unpublished offers will be successfully created into eBay listings, but others may fail. The response payload will show the results for each offerId value that is passed into the request payload. The errors and warnings containers will be returned for an offer that had one or more issues being published.

For those who prefer to publish one offer per call, the publishOffer method can be used instead. In the case of a multiple-variation listing, the publishOfferByInventoryItemGroup call should be used instead, as this call will convert all unpublished offers associated with an inventory item group into a multiple-variation listing.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\BulkOffer;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = BulkOffer::fromArray([
//
]);

try {
    $result = $apiInstance->bulkPublishOffer($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->bulkPublishOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\BulkOffer	The base request of the <strong>bulkPublishOffer</strong> method.

Return type

SapientPro\EbayInventorySDK\Models\BulkPublishResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

createOffer

SapientPro\EbayInventorySDK\Models\OfferResponse createOffer($body, $contentLanguage)

This call creates an offer for a specific inventory item on a specific eBay marketplace. It is up to the sellers whether they want to create a complete offer (with all necessary details) right from the start, or sellers can provide only some information with the initial createOffer call, and then make one or more subsequent updateOffer calls to complete the offer and prepare to publish the offer. Upon first creating an offer, the following fields are required in the request payload: sku, marketplaceId, and (listing) format.

Other information that will be required before an offer can be published are highlighted below. These settings are either set with createOffer, or they can be set with a subsequent updateOffer call:

Inventory location
Offer price
Available quantity
eBay listing category
Referenced listing policy profiles to set payment, return, and fulfillment values/settings

Note: Though the includeCatalogProductDetails parameter is not required to be submitted in the request, the parameter defaults to true if omitted.

If the call is successful, a unique offerId value is returned in the response. This value will be required for many other offer-related calls. Note that this call only stages an offer for publishing. The seller must run the publishOffer call to convert the offer to an active eBay listing.

In addition to the authorization header, which is required for all eBay REST API calls, the createOffer call also requires the Content-Language header, that sets the natural language that will be used in the field values of the request payload. For US English, the code value passed in this header should be en-US. To view other supported Content-Language values, and to read more about all supported HTTP headers for eBay REST API calls, see the <a href="/api-docs/static/rest-request-components.html#HTTP">HTTP request headers topic in the Using eBay RESTful APIs document.

For those who prefer to create multiple offers (up to 25 at a time) with one call, the bulkCreateOffer method can be used.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\BulkOffer;
use SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithKeys;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);

$body = EbayOfferDetailsWithKeys::fromArray([]);


try {
    $result = $apiInstance->createOffer($body, \SapientPro\EbayInventorySDK\Enums\LocaleEnum::en_US);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->createOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithKeys	Details of the offer for the channel
contentLanguage	\SapientPro\EbayInventorySDK\Enums\LocaleEnum	This request header sets the natural language that will be provided in the field values of the request payload.

Return type

SapientPro\EbayInventorySDK\Models\OfferResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deleteOffer

deleteOffer($offerId)

If used against an unpublished offer, this call will permanently delete that offer. In the case of a published offer (or live eBay listing), a successful call will either end the single-variation listing associated with the offer, or it will remove that product variation from the eBay listing and also automatically remove that product variation from the inventory item group. In the case of a multiple-variation listing, the deleteOffer will not remove the product variation from the listing if that variation has one or more sales. If that product variation has one or more sales, the seller can alternately just set the available quantity of that product variation to 0, so it is not available in the eBay search or View Item page, and then the seller can remove that product variation from the inventory item group at a later time.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new Api\OfferApi(
    config: $config
);
$offerId = "offerId_example"; // string | The unique identifier of the offer to delete. The unique identifier of the offer (<strong>offerId</strong>) is passed in at the end of the call URI.

try {
    $apiInstance->deleteOffer($offerId);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->deleteOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
offerId	string	The unique identifier of the offer to delete. The unique identifier of the offer (<strong>offerId</strong>) is passed in at the end of the call URI.

Return type

void (empty response body)

Authorization

api_auth

HTTP request headers

Content-Type: Not defined
Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getListingFees

SapientPro\EbayInventorySDK\Models\FeesSummaryResponse getListingFees($body)

This call is used to retrieve the expected listing fees for up to 250 unpublished offers. An array of one or more offerId values are passed in under the offers container.

In the response payload, all listing fees are grouped by eBay marketplace, and listing fees per offer are not shown. A fees container will be returned for each eBay marketplace where the seller is selling the products associated with the specified offers.

Errors will occur if the seller passes in offerIds that represent published offers, so this call should be made before the seller publishes offers with the publishOffer.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\OfferKeysWithId;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = OfferKeysWithId::fromArray([]);

try {
    $result = $apiInstance->getListingFees($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->getListingFees: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\OfferKeysWithId	List of offers that needs fee information	[optional]

Return type

SapientPro\EbayInventorySDK\Models\FeesSummaryResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getOffer

SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithAll getOffer($offerId)

This call retrieves a specific published or unpublished offer. The unique identifier of the offer (offerId) is passed in at the end of the call URI.

The authorization header is the only required HTTP header for this call. See the HTTP request headers section for more information.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$offerId = "offerId_example"; // string | The unique identifier of the offer that is to be retrieved.

try {
    $result = $apiInstance->getOffer($offerId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->getOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
offerId	string	The unique identifier of the offer that is to be retrieved.

Return type

SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithAll

Authorization

api_auth

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getOffers

SapientPro\EbayInventorySDK\Models\Offers getOffers($format, $limit, $marketplaceId, $offset, $sku)

This call retrieves all existing offers for the specified SKU value. The seller has the option of limiting the offers that are retrieved to a specific eBay marketplace, or to a listing format.

Note: At this time, the same SKU value can not be offered across multiple eBay marketplaces, and the only supported listing format is fixed-price, so the marketplace_id and format query parameters currently do not have any practical use for this call.

The authorization header is the only required HTTP header for this call. See the HTTP request headers section for more information.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);

$limit = "5"; // string | The value passed in this query parameter sets the maximum number of records to return per page of data. Although this field is a string, the value passed in this field should be a positive integer value. If this query parameter is not set, up to 100 records will be returned on each page of results.
$offset = "0"; // string | The value passed in this query parameter sets the page number to retrieve. Although this field is a string, the value passed in this field should be a integer value equal to or greater than <code>0</code>. The first page of records has a value of <code>0</code>, the second page of records has a value of <code>1</code>, and so on. If this query parameter is not set, its value defaults to <code>0</code>, and the first page of records is returned.
$sku = "sku_example"; // string | The seller-defined SKU value is passed in as a query parameter. All offers associated with this product are returned in the response.<br/><br/> <strong>Max length</strong>: 50.

try {
    $result = $apiInstance->getOffers($sku, FormatTypeEnum::FIXED_PRICE, MarketplaceEnum::EBAY_AT, $limit, $offset);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->getOffers: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
format	\SapientPro\EbayInventorySDK\Enums\FormatTypeEnum	This enumeration value sets the listing format for the offer. This query parameter will be passed in if the seller only wants to see offers in this specified listing format.	[optional]
limit	string	The value passed in this query parameter sets the maximum number of records to return per page of data. Although this field is a string, the value passed in this field should be a positive integer value. If this query parameter is not set, up to 100 records will be returned on each page of results.	[optional]
marketplaceId	\SapientPro\EbayInventorySDK\Enums\MarketplaceEnum	The unique identifier of the eBay marketplace. This query parameter will be passed in if the seller only wants to see the product's offers on a specific eBay marketplace.<br /><br /><span class="tablenote"><strong>Note:</strong> At this time, the same SKU value can not be offered across multiple eBay marketplaces, so the <strong>marketplace_id</strong> query parameter currently does not have any practical use for this call.</span>	[optional]
offset	string	The value passed in this query parameter sets the page number to retrieve. Although this field is a string, the value passed in this field should be a integer value equal to or greater than <code>0</code>. The first page of records has a value of <code>0</code>, the second page of records has a value of <code>1</code>, and so on. If this query parameter is not set, its value defaults to <code>0</code>, and the first page of records is returned.	[optional]
sku	string	The seller-defined SKU value is passed in as a query parameter. All offers associated with this product are returned in the response.<br/><br/> <strong>Max length</strong>: 50.

Return type

SapientPro\EbayInventorySDK\Models\Offers

Authorization

api_auth

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

publishOffer

SapientPro\EbayInventorySDK\Models\PublishResponse publishOffer($offerId)

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 is used to convert an unpublished offer into a published offer, or live eBay listing. The unique identifier of the offer (offerId) is passed in at the end of the call URI.

For those who prefer to publish multiple offers (up to 25 at a time) with one call, the bulkPublishOffer method can be used. In the case of a multiple-variation listing, the publishOfferByInventoryItemGroup call should be used instead, as this call will convert all unpublished offers associated with an inventory item group into a multiple-variation listing.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$offerId = "offerId_example"; // string | The unique identifier of the offer that is to be published.

try {
    $result = $apiInstance->publishOffer($offerId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->publishOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
offerId	string	The unique identifier of the offer that is to be published.

Return type

SapientPro\EbayInventorySDK\Models\PublishResponse

Authorization

api_auth

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

publishOfferByInventoryItemGroup

SapientPro\EbayInventorySDK\Models\PublishResponse publishOfferByInventoryItemGroup($body)

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 is used to convert all unpublished offers associated with an inventory item group into an active, multiple-variation listing.

The unique identifier of the inventory item group (inventoryItemGroupKey) is passed in the request payload. All inventory items and their corresponding offers in the inventory item group must be valid (meet all requirements) for the publishOfferByInventoryItemGroup call to be completely successful. For any inventory items in the group that are missing required data or have no corresponding offers, the publishOfferByInventoryItemGroup will create a new multiple-variation listing, but any inventory items with missing required data/offers will not be in the newly-created listing. If any inventory items in the group to be published have invalid data, or one or more of the inventory items have conflicting data with one another, the publishOfferByInventoryItemGroup call will fail. Be sure to check for any error or warning messages in the call response for any applicable information about one or more inventory items/offers having issues.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\PublishByInventoryItemGroupRequest;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = PublishByInventoryItemGroupRequest::fromArray([]);

try {
    $result = $apiInstance->publishOfferByInventoryItemGroup($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->publishOfferByInventoryItemGroup: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\PublishByInventoryItemGroupRequest	The identifier of the inventory item group to publish and the eBay marketplace where the listing will be published is needed in the request payload.

Return type

SapientPro\EbayInventorySDK\Models\PublishResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

updateOffer

SapientPro\EbayInventorySDK\Models\OfferResponse updateOffer($body, $contentLanguage, $offerId)

This call updates an existing offer. An existing offer may be in published state (active eBay listing), or in an unpublished state and yet to be published with the publishOffer call. The unique identifier (offerId) for the offer to update is passed in at the end of the call URI.

The updateOffer call does a complete replacement of the existing offer object, so all fields that make up the current offer object are required, regardless of whether their values changed.

Other information that is required before an unpublished offer can be published or before a published offer can be revised include:

Inventory location
Offer price
Available quantity
eBay listing category
Referenced listing policy profiles to set payment, return, and fulfillment values/settings

Note: Though the includeCatalogProductDetails parameter is not required to be submitted in the request, the parameter defaults to true if omitted from both the updateOffer and the createOffer calls. If a value is specified in the updateOffer call, this value will be used.

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.

For published offers, the listingDescription field is also required to update the offer/eBay listing. For unpublished offers, this field is not necessarily required unless it is already set for the unpublished offer.

In addition to the authorization header, which is required for all eBay REST API calls, the updateOffer call also requires the Content-Language header, that sets the natural language that will be used in the field values of the request payload. For US English, the code value passed in this header should be en-US. To view other supported Content-Language values, and to read more about all supported HTTP headers for eBay REST API calls, see the <a href="/api-docs/static/rest-request-components.html#HTTP">HTTP request headers topic in the Using eBay RESTful APIs document.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithId;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = EbayOfferDetailsWithId::fromArray([]); // SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithId | Details of the offer for the channel
$offerId = "offerId_example"; // string | The unique identifier of the offer that is being updated. This identifier is passed in at the end of the call URI.

try {
    $result = $apiInstance->updateOffer($body, LocaleEnum::en_US, $offerId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->updateOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description
body	SapientPro\EbayInventorySDK\Models\EbayOfferDetailsWithId	Details of the offer for the channel
contentLanguage	\SapientPro\EbayInventorySDK\Enums\LocaleEnum	This request header sets the natural language that will be provided in the field values of the request payload.
offerId	string	The unique identifier of the offer that is being updated. This identifier is passed in at the end of the call URI.

Return type

SapientPro\EbayInventorySDK\Models\OfferResponse

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

withdrawOffer

SapientPro\EbayInventorySDK\Models\WithdrawResponse withdrawOffer($offerId)

This call is used to end a single-variation listing that is associated with the specified offer. This call is used in place of the deleteOffer call if the seller only wants to end the listing associated with the offer but does not want to delete the offer object. With this call, the offer object remains, but it goes into the unpublished state, and will require a publishOffer call to relist the offer.

To end a multiple-variation listing that is associated with an inventory item group, the withdrawOfferByInventoryItemGroup method can be used. This call only ends the multiple-variation listing associated with an inventory item group but does not delete the inventory item group object, nor does it delete any of the offers associated with the inventory item group, but instead all of these offers go into the unpublished state.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$offerId = "offerId_example"; // string | The unique identifier of the offer that is to be withdrawn. This value is passed into the path of the call URI.

try {
    $result = $apiInstance->withdrawOffer($offerId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->withdrawOffer: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
offerId	string	The unique identifier of the offer that is to be withdrawn. This value is passed into the path of the call URI.

Return type

SapientPro\EbayInventorySDK\Models\WithdrawResponse

Authorization

api_auth

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

withdrawOfferByInventoryItemGroup

withdrawOfferByInventoryItemGroup($body)

This call is used to end a multiple-variation eBay listing that is associated with the specified inventory item group. This call only ends multiple-variation eBay listing associated with the inventory item group but does not delete the inventory item group object. Similarly, this call also does not delete any of the offers associated with the inventory item group, but instead all of these offers go into the unpublished state. If the seller wanted to relist the multiple-variation eBay listing, they could use the publishOfferByInventoryItemGroup method.

Example

<?php
use SapientPro\EbayInventorySDK\Configuration;
use SapientPro\EbayInventorySDK\Api\OfferApi;
use SapientPro\EbayInventorySDK\Models\WithdrawByInventoryItemGroupRequest;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new OfferApi(
    config: $config
);
$body = WithdrawByInventoryItemGroupRequest::fromArray([]); // SapientPro\EbayInventorySDK\Models\WithdrawByInventoryItemGroupRequest | The base request of the <strong>withdrawOfferByInventoryItemGroup</strong> call.

try {
    $apiInstance->withdrawOfferByInventoryItemGroup($body);
} catch (Exception $e) {
    echo 'Exception when calling OfferApi->withdrawOfferByInventoryItemGroup: ', $e->getMessage(), PHP_EOL;
}
?>

Parameters

Name	Type	Description	Notes
body	SapientPro\EbayInventorySDK\Models\WithdrawByInventoryItemGroupRequest	The base request of the <strong>withdrawOfferByInventoryItemGroup</strong> call.

Return type

void (empty response body)

Authorization

api_auth

HTTP request headers

Content-Type: application/json
Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

Files

OfferApi.md

Latest commit

History

OfferApi.md

File metadata and controls

SapientPro\EbayInventorySDK\Api\OfferApi

bulkCreateOffer

Example

Parameters

Return type

Authorization

HTTP request headers

bulkPublishOffer

Example

Parameters

Return type

Authorization

HTTP request headers

createOffer

Example

Parameters

Return type

Authorization

HTTP request headers

deleteOffer

Example

Parameters

Return type

Authorization

HTTP request headers

getListingFees

Example

Parameters

Return type

Authorization

HTTP request headers

getOffer

Example

Parameters

Return type

Authorization

HTTP request headers

getOffers

Example

Parameters

Return type

Authorization

HTTP request headers

publishOffer

Example

Parameters

Return type

Authorization

HTTP request headers

publishOfferByInventoryItemGroup

Example

Parameters

Return type

Authorization

HTTP request headers

updateOffer

Example

Parameters

Return type

Authorization

HTTP request headers

withdrawOffer

Example

Parameters

Return type

Authorization

HTTP request headers

withdrawOfferByInventoryItemGroup

Example

Parameters

Return type

Authorization

HTTP request headers