SetUserNotes
Adds, replaces, and deletes My eBay notes for items that are being tracked in the My eBay Selling and Buying areas.
Stored Procedure-Specific Information
To run this stored procedure, enter:EXEC SetUserNotes ItemID = '110371953144', VariationSpecifics = '[{"Name":"Color","Value":"Red"},{"Name":"Size","Value":"Large"}]', NoteText = 'noteExample', Action = 'AddOrUpdate'
Input
| Name | Type | Required | Description |
| Action | String | True | The seller must include this field and set it to 'AddOrUpdate' to add a new user note or update an existing user note, or set it to 'Delete' to delete an existing user note. |
| ItemId | String | False | The unique identifier of the listing to which the My eBay note is attached. Notes can only be added to items that are currently being tracked in My eBay. |
| NoteText | String | False | The text of the My eBay note. This field is needed when the Action is AddOrUpdate. The text supplied in this field completely replaces any existing My eBay note for the specified item. |
| OrderLineItemId | String | False | A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemId and TransactionId, with a hyphen in between these two Ids. OrderLineItemId can be used in the input instead of an ItemId/TransactionId pair to identify an order line item. |
| SKU | String | False | The stock keeping unit (SKU) value of the item variation to which the My eBay note is attached. Notes can only be added to items that are currently being tracked in My eBay. A SKU value is defined and used by the seller to identify a variation within a fixed-price, multiple-variation listing. The SKU value is assigned to a variation of an item through the Variations.Variation.SKU element. |
| TransactionId | String | False | The unique identifier for the order line item to which the My eBay note is attached. Notes can only be added to order line items that are currently being tracked in My eBay. Buyers can view user notes made on order line items in the PrivateNotes field of the WonList container in GetMyeBayBuying, and sellers can view user notes made on order line items in the PrivateNotes field of the SoldList and DeletedFromSoldList containers in GetMyeBaySelling. |
| VariationSpecificName | String | False | A single Variation Specific name. Pair with VariationSpecificValue. To specify multiple, use VariationSpecifics instead. |
| VariationSpecificValue | String | False | A single Variation Specific value, paired with VariationSpecificName. To specify multiple, use VariationSpecifics instead. |
| VariationSpecifics | String | False | Multiple Variation Specifics as a JSON or XML aggregate or a #TEMP table reference. Each row is {Name, Value}; Value may be a scalar, a JSON primitive array, multiple XML Value siblings, or a #TEMP reference. When set, the singular VariationSpecificName and VariationSpecificValue inputs are ignored. |
Result Set Columns
| Name | Type | Description |
| Success | String | Indicates whether the operation completed successfully. |