eBay Trading APIVersion 1391
 

SetUserNotesRequestType ( AbstractRequestType )

Enables users to add, modify, or delete a pinned note for any item that is being tracked in the My eBay All Selling and All Buying areas.

Call that uses SetUserNotesRequestType:

Fields



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.
See the Field Index to learn which calls use Action.

ItemID ( ItemIDType (string) ) [0..1]
Unique identifier of the listing to which the My eBay note will be attached. Notes can only be added to items that are currently being tracked in My eBay.
See the Field Index to learn which calls use ItemID.

NoteText ( string ) [0..1]
This field is needed if the Action is AddOrUpdate. The text supplied in this field will completely replace any existing My eBay note for the specified item.
See the Field Index to learn which calls use NoteText.

OrderLineItemID ( string ) [0..1]
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. OrderLineItemID can be used in the input instead of an ItemID/TransactionID pair to identify an order line item.

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 GetMyeBaySellinging.
See the Field Index to learn which calls use OrderLineItemID.

SKU ( SKUType (string) ) [0..1]
SKU value of the item variation to which the My eBay note will be attached. Notes can only be added to items that are currently being tracked in My eBay. A SKU (stock keeping unit) value is defined by 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.

This field can only be used if the Item.InventoryTrackingMethod field (set with the AddFixedPriceItem or RelistFixedPriceItem calls) is set to SKU.

If a specific order line item is targeted in the request with an ItemID/TransactionID pair or an OrderLineItemID value, any specified SKU is ignored by the call.
See the Field Index to learn which calls use SKU.

TransactionID ( string ) [0..1]
Unique identifier for the order line item to which the My eBay note will be 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 GetMyeBaySellinging.

The TransactionID value for auction listings is always 0 since there can be only one winning bidder/one sale for an auction listing.

Note: Beginning in July 2024, non-zero transaction IDs will start being returned for auction listings. If necessary, update code to handle non-zero transaction IDs for auction transactions before this time.
See the Field Index to learn which calls use TransactionID.

VariationSpecifics ( NameValueListArrayType ) [0..1]
Container consisting of name-value pairs that identify (match) one variation within a fixed-price, multiple-variation listing. The specified name-value pair(s) must exist in the listing specified by either the ItemID or SKU values specified in the request. If a specific order line item is targeted in the request with an ItemID/TransactionID pair or an OrderLineItemID value, any specified VariationSpecifics container is ignored by the call.
See the Field Index to learn which calls use VariationSpecifics.