ReturnCreated

The ReturnCreated notification is sent to the subscribed buyer and seller when an eBay managed return is created.

At the time this notification is sent, the buyer or seller will want to look at the ReturnStatus field to see if their response is due or the other party's response is due. Buyers and sellers can look at the status field of the getUserReturns response to see what type of response is due.

Alternatively, sellers can call getActivityOptions to get the next action to take in the case. For more information about these Return Management API calls, refer to the Return Management API Call Index.

These notifications are set in the SetNotificationPreferences call.

Before using these notifications, be sure that you have read and understood the information in Platform Notifications.

Data Fields Returned

API Call that displays this notification: getReturnDetail

ExternalUserData is pulled from the SetNotificationPreferences request. Refer to the SetNotificationPreferences call reference for more information about this field.

For information about other fields in the payload, refer to the getReturnDetail call reference documentation in the Return Management API documentation set.

Refer to SOAP Message Body for information about the standard elements returned for all notifications.

Example

Sample ReturnCreated Notification

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://
www.ebay.com/marketplace/resolution/v1/services">
  <soapenv:Header/>
  <soapenv:Body>
    <NotificationEvent>
      <NotificationEventName>ReturnCreated</NotificationEventName>
      <RecipientUserID>c********3</RecipientUserID>
      <ExternalUserData>A********C</ExternalUserData>
      <ReturnId>5********8</ReturnId>
      <CreationDate>2011-12-05T16:36:10.000Z</CreationDate>
      <OtherPartyId>c********3</OtherPartyId>
      <OtherPartyRole>BUYER</OtherPartyRole>
      <ReturnStatus>2009-09-07T12:50:06.333Z</ReturnStatus>
      <ReturnStatus>MY_RESPONSE_DUE</ReturnStatus>
      <ReturnGlobalId>EBAY-US</ReturnGlobalId>
    </NotificationEvent>
  </soapenv:Body>
</soapenv:Envelope>