AddSecondChanceItem

Use this call to create a Second Chance Offer (that is, an offer for an unsold item) for one of that item's non-winning bidders.

AddSecondChanceItem creates a special type of listing in which only the specified Second Chance Offer recipient may purchase the item. The recipient who is chosen by the seller must be one of the non-winning bidders from the ended listing. The listing must have ended with a winning bidder, but the item did not sell for some reason. For example, the winning bidder, for whatever reason, did not purchase the item. Alternately, the seller may offer an item that is similar to the one previously listed as a Second Chance Offer item. In this case, the specified recipient may be either one of the non-winning bidders, or the winning bidder in the ended listing.

Use GetAllBidders to retrieve a list of bidders from the item that ended. The seller needs to select the recipient for the Second Chance Offer from this list.

For general information on Second Chance Offers and more detailed information on using AddSecondChanceItem, see Making Second Chance Offers for Items.

Usage Details

To call AddSecondChanceItem, the requestor must be the one who listed the original item and the item must meet the Second Chance Offer eligibility requirements (see Determining Item Eligibility for a Second Chance Offer).

AddSecondChanceItem takes as input the following values:

• ItemID - The original listing's item ID.
• RecipientBidderUserID - The eBay user ID for the recipient of the offer.
• Duration - The length of time the offer is valid.
• SellerMessage - Optionally, a message to the buyer.

If the call is successful, it returns the following information:

• ItemID - The new listing's item ID.
• StartTime - The start date and time for the listing.
• EndTime - The date and time the listing ends.

When you create a Second Chance Offer, eBay sends the recipient a message letting them know that the offer has been made. The price of the offer is normally set to the highest bid the recipient made on the original item.

Note that sending a Second Chance Offer, a new listing is not created on the eBay site. Instead, a special item is created for the targeted buyer. If you want to relist an item, use RelistItem, this can help to save on relisting fees.

Use VerifyAddSecondChanceItem to test an item's definition before calling AddSecondChanceItem. This can reduce the number of item listing errors the application needs to handle.

Testing AddSecondChanceItem

You can test AddSecondChanceItem in the Sandbox environment. To test the call, you need three or more test users. One test user is needed to act as the seller, the others act as bidders.

1. List an auction item using a test user account.
2. Have two or more other test users submit bids on the item. This can be done in the Sandbox UI (http://sandbox.ebay.com).
3. Have the seller end the item early using EndItem with EndingReason set to SellToHighBidder, which results in the listing ending as a successfully concluded auction with a winning bidder.
4. Call AddSecondChanceItem to extend a Second Chance Offer to one of the non-winning test users that bid on the item.
5. Use an item data retrieval call (like GetSellerList or GetItem) to retrieve the data for the Second Chance Offer you just created. Verify that the listing has all of the desired values, including the value in the Item.ListingDetails.SecondChanceOriginalItemID property: it should contain the item ID for the original listing.

   Optionally perform a search using findItemsAdvanced (Finding API). This search should use criteria that would definitely find the item.

Related Information

See Second chance offers.

See also the reference documentation for this call:

• VerifyAddSecondChanceItem - Simulates the creation of a new Second Chance Offer listing of an item without actually creating a listing.

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.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<AddSecondChanceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
 <!-- Call-specific Input Fields -->
 <BuyItNowPrice> AmountType (double) </BuyItNowPrice>
 <Duration> SecondChanceOfferDurationCodeType </Duration>
 <ItemID> ItemIDType (string) </ItemID>
 <RecipientBidderUserID> UserIDType (string) </RecipientBidderUserID>
 <SellerMessage> string </SellerMessage>
 <!-- Standard Input Fields -->
 <ErrorLanguage> string </ErrorLanguage>
 <MessageID> string </MessageID>
 <Version> string </Version>
 <WarningLevel> WarningLevelCodeType </WarningLevel>
</AddSecondChanceItemRequest>

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"?>
<AddSecondChanceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
 <!-- Call-specific Output Fields -->
 <EndTime> dateTime </EndTime>
 <ItemID> ItemIDType (string) </ItemID>
 <StartTime> dateTime </StartTime>
 <!-- Standard Output Fields -->
 <Ack> AckCodeType </Ack>
 <Build> string </Build>
 <CorrelationID> string </CorrelationID>
 <DuplicateInvocationDetails> DuplicateInvocationDetailsType
 <DuplicateInvocationID> UUIDType (string) </DuplicateInvocationID>
 <InvocationTrackingID> string </InvocationTrackingID>
 <Status> InvocationStatusType </Status>
 </DuplicateInvocationDetails>
 <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>
</AddSecondChanceItemResponse>

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

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.

Extends a Second Chance Offer to a bidder that did not win the auction.

Description

The prospective buyer (b************r) bid on a book, but did not win the auction. The seller (M*****l B********r) came across another copy of the book in the same condition and decided to offer the second copy to the second-highest bidder, b************r.

When a Second Chance Offer is created, the recipient is given a chance to purchase the item at the highest price that they bid on the original item. eBay sends the buyer a message stating that the Second Chance Offer has been made, along with any message the seller included in the offer.

Input

XML format.
<?xml version="1.0" encoding="utf-8"?>
<AddSecondChanceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
 <RequesterCredentials>
 <eBayAuthToken>A*******3</eBayAuthToken>
 </RequesterCredentials>
 <!-- The user ID of an user who made a bid on the auction item. The GetAllBidders call can be used to get bidders on a listing -->
 <RecipientBidderUserID>b************r</RecipientBidderUserID>
 <!-- The offer duration must be one of the values defined in SecondChanceOfferDurationCodeType -->
 <Duration>Days_3</Duration>
 <ItemID>1**********1</ItemID>
 <SellerMessage>
 I just got another copy of the book in stock, would
 you be interested in purchasing the copy?
 </SellerMessage>
</AddSecondChanceItemRequest>

Output

XML format.
<AddSecondChanceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
 <Timestamp>2015年12月22日T17:45:31.032Z</Timestamp>
 <Ack>Success</Ack>
 <Version>967</Version>
 <Build>E967_CORE_BUNDLED_10284414_R1</Build>
 <ItemID>1**********4</ItemID>
 <StartTime>2015年12月22日T17:45:30.000Z</StartTime>
 <EndTime>2015年12月25日T17:45:30.000Z</EndTime>
</AddSecondChanceItemResponse>

Change History