Skip to main content
Published: October 14 2008, 5:29:00 PMUpdated: November 28 2020, 4:57:10 PM

I see an EndOfAuction notification.  How do I receive notifications when my StoresFixedPrice item ends?

Here's how to receive notifications when a FixedPriceTransaction item expires (end time reached) or when the item is ended via the EndItem API call.

Call SetNotificationPreferences at the application level

<?xml version="1.0" encoding="utf-8"?>

<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>581</Version>
<ApplicationDeliveryPreferences>
<ApplicationURL>mailto:you@example.com</ApplicationURL> (or an http address)
<ApplicationEnable>Enable</ApplicationEnable>
</ApplicationDeliveryPreferences>
<RequesterCredentials>
<eBayAuthToken>-</eBayAuthToken>
</RequesterCredentials>
</SetNotificationPreferencesRequest>

Call SetNotificationPreferences at the user level

<?xml version="1.0" encoding="utf-8"?>

<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<ErrorLanguage>en_US</ErrorLanguage>
<Version>581</Version>
<WarningLevel>High</WarningLevel>
<UserDeliveryPreferenceArray>
<NotificationEnable>
<EventType>ItemUnsold</EventType>
<EventEnable>Enable</EventEnable>
</NotificationEnable>
</UserDeliveryPreferenceArray>
<RequesterCredentials>
<eBayAuthToken>-</eBayAuthToken> (Application will notify user for this token at the ApplicationURL)
</RequesterCredentials>
</SetNotificationPreferencesRequest>

Notification payload upon EndItem API call (or natural end of item)

From: notification@ebay.com [mailto:notification@ebay.com]

Sent: Tuesday, October 14, 2008 5:13 PM
To: you@example.com
Subject: eBay Notification (ItemUnsold)

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<ebl:RequesterCredentials soapenv:mustUnderstand="0" xmlns:ns="urn:ebay:apis:eBLBaseComponents" xmlns:ebl="urn:ebay:apis:eBLBaseComponents">
<ebl:NotificationSignature xmlns:ebl="urn:ebay:apis:eBLBaseComponents">8CMe3tRQqdMrpCESPr15UA==</ebl:NotificationSignature>
</ebl:RequesterCredentials>
</soapenv:Header>
<soapenv:Body>
<GetItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
<Timestamp>2008-10-15T00:13:03.517Z</Timestamp>
<Ack>Success</Ack>
<CorrelationID>292717320</CorrelationID>
<Version>585</Version>
<Build>e585_core_Bundled_7370699_R1</Build>
<NotificationEventName>ItemUnsold</NotificationEventName>
<RecipientUserID>ebay_userid</RecipientUserID> (eBay UserID of token holder for above SetNotificationPreference call)
<Item>
<AutoPay>false</AutoPay>
...
(further data from GetItem call on the item that ended) How is ItemUnsold handled for multi-quantity listings? CASE 1
ListingType = FixedPriceItem
Quantity = 1
Buy => Receive FixedPriceTransaction


CASE 2
ListingType = FixedPriceItem
Quantity = 2
Buy one then issue EndItem call =>
Receive one FixedPriceTransaction
Do not receive ItemUnsold notification

In Case 2, we did not receive a "ItemUnsold" notification although we still had one piece still for sale under that ItemID. We had one sale, but we also had one unsold piece for that ItemID
.

How well did this answer your question?
Answers others found helpful