eBay Trading APIVersion 1111

ReviseSellingManagerSaleRecordRequestType ( AbstractRequestType )

Request type containing the input fields for the ReviseSellingManagerSaleRecord call. The standard Trading API deprecation process is not applicable to this call. The user must have a Selling Manager Pro subscription to use this call.

Call that uses ReviseSellingManagerSaleRecordRequestType:

Fields



ItemID ( ItemIDType (string) ) [0..1]
Unique identifier for an eBay listing. A listing can have multiple order line items, but only one ItemID value. An ItemID can be paired up with a corresponding TransactionID and used as an input filter for ReviseSellingManagerSaleRecord. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call.

Unless an OrderLineItemID is used to identify an order line item, or the OrderID is used to identify an order, the ItemID/TransactionID pair must be specified. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request.
See the Field Index to learn which calls use ItemID.

OrderID ( OrderIDType (string) ) [0..1]
A unique identifier that identifies a single line item or multiple line item order associated with the Selling Manager sale record(s).

If an OrderID is used in the request, the OrderLineItemID and ItemID/TransactionID pair are ignored if they are specified in the same request.

Note: Starting in June 2019, eBay will start changing the format of order identifier values. The new format will be a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. These order identifiers will be automatically generated after buyer payment, and unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support.

For developers and sellers who are already integrated with the Trading API's order management calls, this change shouldn't impact your integration unless you parse the existing order identifiers (e.g., OrderID or OrderLineItemID), or otherwise infer meaning from the format (e.g., differentiating between a single line item order versus a multiple line item order). Because we realize that some integrations may have logic that is dependent upon the identifier format, eBay is rolling out this Trading API change with version control to support a transition period of approximately 9 months before applications must switch to the new format completely.

During the transition period, developers/sellers will use the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header in API calls to control whether the new or old OrderID format is returned in all Trading API call response payloads. The compatibility version is expected to be Version 1113. During the transition period and even after, the new and old OrderID formats will still be supported in all Trading API call request payloads. After the transition period (which will be announced), only the new OrderID format will be returned in all Trading API call response payloads, regardless of the Trading WSDL version used or specified compatibility level.
See the Field Index to learn which calls use OrderID.

OrderLineItemID ( string ) [0..1]
A unique identifier for an eBay order line item. This identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call).

Unless an ItemID/TransactionID pair is used to identify an order line item, or the OrderID is used to identify an order, the OrderLineItemID must be specified. For a multiple line item order, OrderID should be used. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request.
See the Field Index to learn which calls use OrderLineItemID.

SellingManagerSoldOrder ( SellingManagerSoldOrderType ) [0..1]
Container consisting of order costs, shipping details, order status, and other information. The changes made under this container will update the order in Selling Manager.
See the Field Index to learn which calls use SellingManagerSoldOrder.

TransactionID ( string ) [0..1]
Unique identifier for an eBay order line item. An order line item is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). Since an auction listing can only have one order line item during the duration of the listing, the TransactionID for auction listings is always 0.

The ItemID/TransactionID pair can be used to identify an order line item in a ReviseSellingManagerSaleRecord call. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call.

Unless an OrderLineItemID is used to identify an order line item, or the OrderID is used to identify an order, the ItemID/TransactionID pair must be specified. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request.
See the Field Index to learn which calls use TransactionID.