EndFixedPriceItem

Use this call to end the specified fixed-price listing before the date and time at which it would normally end (per the listing duration).

While you can also use EndItem to end fixed-price listings, EndFixedPriceItem has the following differences from EndItem:

• If the seller listed the item with SKU-based inventory tracking, EndFixedPriceItem gives you an option to end the listing by SKU instead of by ItemID.
• The call supports only fixed-price listings (not auctions).
• The call supports the ending of multi-variation listings.
• If needed, you can end listings in bulk using the File Transfer API and the Bulk Data Exchange API.

Only the item's seller can use EndFixedPriceItem to end an item listing. The item can be identified by the ItemID or (in certain cases) the seller's SKU.

You can test this call in the Sandbox environment.

See Ending Items Early.

See also the reference documentation for these calls:

• EndItem - Ends the specified item listing before the date and time at which it would normally end per the listing duration.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

<?xml version="1.0" encoding="utf-8"?>
<EndFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <EndingReason> EndReasonCodeType </EndingReason>
  <ItemID> ItemIDType (string) </ItemID>
  <SKU> SKUType (string) </SKU>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</EndFixedPriceItemRequest>

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<EndFixedPriceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <EndTime> dateTime </EndTime>
  <SKU> SKUType (string) </SKU>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</EndFixedPriceItemResponse>

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Defines and lists items that will be removed from the eBay site with the Large Merchant Services solution. This sample represents a data file that you will zip and then upload using the Bulk Data Exchange Service and the File Transfer Service.

Description

User m****************t wants to remove one of her listings of shoes from the eBay US site, because she has agreed to donate them to the Boys and Girls' Club in her neighborhood. She creates a data file with the information about the listing she wants to remove.

As a result of this call, m****************t has removed one of the SKUs for her Nike Shox on eBay with the details as provided in the call. You can call GetItem with the ItemID found in the EndFixedPriceItem response to confirm that the shoes have been removed.

Input

The following EndFixedPriceItem request sample contains the SKU for the shoes that m****************t's wants to remove, and the reason for removing them from the site. In this sample, we have included a basic EndFixedPricedItem request. However, in a single data file, you can include thousands of listings.

XML format.

<?xml version="1.0" encoding="utf-8"?>
<BulkDataExchangeRequests xmlns="urn:ebay:apis:eBLBaseComponents">
  <Header>
    <Version>583</Version>
    <SiteID>*</SiteID>
  </Header>
 <EndFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Version>583</Version>
    <SKU>1*********-*7</SKU>
    <EndingReason>NotAvailable</EndingReason>
 </EndFixedPriceItemRequest>
</BulkDataExchangeRequests>

Output

The response includes a timestamp, Success or Fail (of the call), the schema version number, the ItemID or SKU and the time that m****************t's listing ended.

XML format.
<?xml version="1.0" encoding="utf-8"?>
<BulkDataExchangeResponses xmlns="urn:ebay:apis:eBLBaseComponents">
  <EndFixedPriceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2008-12-02T01:15:16.008Z</Timestamp>
   <Ack>Success</Ack>
   <Version>583</Version>
   <Build>e583_core_API_7225127_R1</Build>
   <EndTime>2008-12-02T01:15:15.000Z</EndTime>
   <SKU>1*********-*7</SKU>
  </EndFixedPriceItemResponse>
</BulkDataExchangeResponses>

Change History