SetUserNotesRequestType

Enables users to add, replace, and delete My eBay notes for items that are being tracked in the My eBay All Selling and All Buying areas.

Fields

Action ( SetUserNotesActionCodeType )
ItemID ( ItemIDType (string) )
NoteText ( string )
OrderLineItemID ( string )
SKU ( SKUType (string) )
TransactionID ( string )
VariationSpecifics ( NameValueListArrayType )

Action ( see SetUserNotesActionCodeType for possible values ) [1]
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 a an existing user note.
See the Field Index to learn which calls use Action.

ItemID ( ItemIDType (string) ) [0..1]
ID of the item 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]
Text of the note. Maximum 250 characters. Required only if the Action is AddOrUpdate. This note text 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, 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.

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, multi- 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 (transaction) 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.
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, multi-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.

Copyright © 2005–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.