LeaveFeedback

Use this call to leave feedback about another user at the conclusion of a successful order. Both participants in the call (the requestor and the target user) must have been in a successful order within the last 60 days, one as the seller and the other as the buyer.

A user (buyer or seller) may leave just one feedback entry per order line item. LeaveFeedback provides the means for posting a single feedback entry. If an application needs to post multiple feedback entries, call LeaveFeedback repetitively, once for each feedback entry.

Usage Details

LeaveFeedback takes as input the eBay user ID for whom the feedback is being left, as well as the ItemID/TransactionID pair or OrderLineItemID, comment text, and comment type (Negative, Neutral, and Positive). If a buyer is leaving Positive feedback, they should also leave a set of Detailed Seller Ratings (DSRs) in the SellerItemRatingDetailArray.

At a minimum, the request must specify the user about whom the feedback is being left, the item ID for the associated listing, a feedback score, and a feedback comment. If the order line item associated with the feedback was a multi-quantity listing, then the call must also include the TransactionID (or just supply the OrderLineItemID) for that order line item. This is necessary to ensure the feedback is directed at the appropriate user--there may be multiple buyers for such a listing type.

Note that if the seller ends the item early and cancels all bids, prospective buyers cannot leave feedback because there is no completed order line item.

If the LeaveFeedback execution is successful, the response contains only the fields of the abstract response object, there are no call-specific return fields. An ack of Success serves as confirmation that the feedback was successfully submitted.

Testing LeaveFeedback

You can test LeaveFeedback in the Sandbox environment. To test the call, you must have at least two test users, one to act in the capacity of an item seller and the other as a buyer.

Before you can test LeaveFeedback, an order line item must have been created. That is, an item was listed (for example, using AddItem) and successfully sold.

For auction listings, a buyer must place a bid on the item and the listing must end with the sale. You can use the Sandbox UI to place bids on the item and then end it early using EndItem. With EndItem, the seller can end the auction early without canceling the bids, and the listing ends as a successfully concluded auction.

For fixed-price listings, a TransactionID (and OrderLineItemID) is created shortly after the buyer purchases the item(s) from the listing. One order line item is created for each listing where there is a commitment to buy from a buyer. You can call LeaveFeedback for each completed order line item, either as the buyer or the seller.

Use GetItemTransactions or GetSellerTransactions to retrieve a list of the order line items for which you can leave feedback.

To verify the feedback left as a result of this testing, retrieve the feedback data for the target user with GetFeedback. The feedback retrieved should be the same (the same scores and comments) as those left during the testing.

Related Information

See:
    Feedback
    Seller ratings

See also the reference documentation for this call:

• GetItemsAwaitingFeedback - This call retrieves all completed order line items for which the user (buyer or seller) still needs to leave Feedback for their order partner.

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"?>
<LeaveFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <CommentText> string </CommentText>
  <CommentType> CommentTypeCodeType </CommentType>
  <ItemArrivedWithinEDDType> ItemArrivedWithinEDDCodeType </ItemArrivedWithinEDDType>
  <ItemDeliveredWithinEDD> boolean </ItemDeliveredWithinEDD>
  <ItemID> ItemIDType (string) </ItemID>
  <OrderLineItemID> string </OrderLineItemID>
  <SellerItemRatingDetailArray> ItemRatingDetailArrayType
    <ItemRatingDetails> ItemRatingDetailsType
      <Rating> int </Rating>
      <RatingDetail> FeedbackRatingDetailCodeType </RatingDetail>
    </ItemRatingDetails>
    <!-- ... more ItemRatingDetails nodes allowed here ... -->
  </SellerItemRatingDetailArray>
  <TargetUser> UserIDType (string) </TargetUser>
  <TransactionID> string </TransactionID>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</LeaveFeedbackRequest>

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"?>
<LeaveFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <FeedbackID> string </FeedbackID>
  <!-- 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>
</LeaveFeedbackResponse>

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.

Leaves positive feedback for a seller, including a general comment, and scores for Item Description and Shipping/Handling Charges.

Description

A buyer purchased an item from a seller and received excellent service. She wants to leave positive feedback for the order line item.

Input

As a buyer, when you leave Positive feedback for a seller, you should also provide scores for the applicable areas. In this case, the applicable areas are Item Description and Shipping/Handling Charges. Other areas include Communication and Shipping Time.

For each of the categories, leave a rating between 1 and 5, with 5 being the highest (best) rating.

The buyer was extremely pleased with the order line item and felt the shipping charges were very reasonable, so scored the seller a '5' in both of these areas.

XML format.

<?xml version="1.0" encoding="utf-8"?>
<LeaveFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>  
  </RequesterCredentials>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <ItemID>1**********6</ItemID>
  <TransactionID>0</TransactionID>
  <CommentText>
    Great transaction! I love the product!
  </CommentText>
  <TargetUser>b***7</TargetUser>
  <CommentType>Positive</CommentType>
  <SellerItemRatingDetailArray>
    <ItemRatingDetails>
      <RatingDetail>ItemAsDescribed</RatingDetail>
      <Rating>5</Rating>
    </ItemRatingDetails>
    <ItemRatingDetails>
      <RatingDetail>ShippingAndHandlingCharges</RatingDetail>
      <Rating>5</Rating>
    </ItemRatingDetails>
  </SellerItemRatingDetailArray>
</LeaveFeedbackRequest>

Output

If the Feedback submission is successful, an Ack value of 'Success' is returned, along with a unique identifier for the newly submitted Feedback entry.

XML format.
<LeaveFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-06T17:24:42.250Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1119</Version>
  <Build>E1119_CORE_APIFEEDBACK_19038728_R1</Build>
  <FeedbackID>1**********0</FeedbackID>
</LeaveFeedbackResponse>

Change History