eBay Trading APIVersion 1279
 

AddDisputeRequestType ( AbstractRequestType )

Enables a seller to create an Unpaid Item case against a buyer.

Note: This call is deprecated and is scheduled for decommission on January 31, 2023. The alternative API to create cancellation requests is the Create Cancellation Request method of the Post-Order API .

Call that uses AddDisputeRequestType:

Fields



DisputeExplanation ( DisputeExplanationCodeType ) [0..1]
This enumerated value gives the explanation of why the seller opened a case. Not all values contained in DisputeExplanationCodeType are allowed in the AddDispute call, and the values that are allowed must match the DisputeReason value.
See the Field Index to learn which calls use DisputeExplanation.

DisputeReason ( DisputeReasonCodeType ) [0..1]
The enumeration value passed into this required field will depend on the action being taken. The seller will pass in BuyerHasNotPaid if the seller is creating an Unpaid Item case against the buyer.
See the Field Index to learn which calls use DisputeReason.

ItemID ( ItemIDType (string) ) [0..1]
Unique identifier of an eBay listing. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless OrderLineItemID is used, this field is required.
See the Field Index to learn which calls use ItemID.

OrderLineItemID ( string ) [0..1]
OrderLineItemID is a unique identifier of an order line item. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless ItemID/TransactionID pair is used, this field is required.
See the Field Index to learn which calls use OrderLineItemID.

TransactionID ( string ) [0..1]
The unique identifier of a buyer's commitment to purchase. A TransactionID is created by eBay once a buyer commits to purchasing an item. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless OrderLineItemID is used, this field is required.

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.