eBay Trading APIVersion 1349
 

LeaveFeedbackRequestType ( AbstractRequestType )

Enables a buyer and seller to leave Feedback for their order partner at the conclusion of a successful order.

Call that uses LeaveFeedbackRequestType:

Fields



CommentText ( string ) [0..1]
Textual comment that explains, clarifies, or justifies the feedback score specified in CommentType.
See the Field Index to learn which calls use CommentText.

CommentType ( CommentTypeCodeType ) [0..1]
Score for the Feedback being left. May be Positive, Neutral, or Negative.

Note: Sellers can not leave neutral or negative feedback for buyers. In addition, buyers can not leave neutral or negative feedback within 7 days from the completion of the order for active Power Sellers who have been on eBay for 12 months.
See the Field Index to learn which calls use CommentType.

ItemArrivedWithinEDDType ( ItemArrivedWithinEDDCodeType ) [0..1]
This field or the ItemDeliveredWithinEDD field should be included if it is the buyer leaving feedback for the seller. This field will inform eBay about whether or not the buyer received the order line item within the estimated delivery date, which is established once a buyer purchases or commits to buy an item.

Note: A new "Late shipment rate" metric became a new component of Seller Standards beginning in February 2016. On-time shipping means that the seller shipped the item before the "handling time" expired and/or the item was received by the buyer within the estimated delivery date window, which is established once the buyer pays for the order line item. Previously, a seller's account could be dinged just for getting a low rating for the "shippping time" Detailed Seller Rating.
See the Field Index to learn which calls use ItemArrivedWithinEDDType.

ItemDeliveredWithinEDD ( boolean ) [0..1]
This field or the ItemArrivedWithinEDDType field should be included if it is the buyer leaving feedback for the seller. This field will inform eBay about whether or not the buyer received the order line item within the estimated delivery date window, which is established once a buyer purchases or commits to buy an item. The value of this field is set to true if the item did arrive within the estimated delivery date, or false if the item arrived past the estimated delivery date.

Note: A new "Late shipment rate" metric became a new component of Seller Standards beginning in February 2016. On-time shipping means that the seller shipped the item before the "handling time" expired and/or the item was received by the buyer within the estimated delivery date window, which is established once the buyer pays for the order line item. Previously, a seller's account could be dinged just for getting a low rating for the "shippping time" Detailed Seller Rating.
See the Field Index to learn which calls use ItemDeliveredWithinEDD.

ItemID ( ItemIDType (string) ) [0..1]
Unique identifier for an eBay listing. A listing can have multiple order line items, but only one ItemID. Unless an OrderLineItemID is specified in the LeaveFeedback request, the ItemID is required along with the TargetUser to identify an order line item existing between the caller and the TargetUser that requires feedback. A Feedback comment will be posted for this order line item. If there are multiple order line items between the two order partners that still require feedback, the TransactionID will also be required to isolate the targeted order line item. Feedback cannot be left for order line items with creation dates more than 60 days in the past.
See the Field Index to learn which calls use ItemID.

OrderLineItemID ( string ) [0..1]
OrderLineItemID is a unique identifier for an eBay order line item. If an OrderLineItemID is included in the request, the ItemID, TransactionID, and TargetUser fields are not required. Feedback cannot be left for order line items with creation dates more than 60 days in the past.
See the Field Index to learn which calls use OrderLineItemID.

SellerItemRatingDetailArray ( ItemRatingDetailArrayType ) [0..1]
Container for detailed seller ratings (DSRs). If a buyer is providing DSRs, they are specified in this container. Sellers have access to the number of ratings they've received, as well as to the averages of the DSRs they've received in each DSR area (i.e., to the average of ratings in the item-description area, etc.).
See the Field Index to learn which calls use SellerItemRatingDetailArray.

TargetUser ( UserIDType (string) ) [0..1]
Specifies the recipient user about whom the Feedback is being left.
See the Field Index to learn which calls use TargetUser.

TransactionID ( string ) [0..1]
Unique identifier for an eBay order line item. If there are multiple order line items between the two order partners that still require Feedback, the TransactionID is required along with the corresponding ItemID and TargetUser to isolate the targeted order line item. If an OrderLineItemID is included in the response to identify a specific order line item, none of the preceding fields (ItemID, TransactionID, TargetUser) are needed. Feedback cannot be left for order line items with creation dates more than 60 days in the past.

The TransactionID value for auction listings is always 0 since there can be only one winning bidder/one sale for an auction listing.
See the Field Index to learn which calls use TransactionID.