eBay Trading APIVersion 1131

DisputeType

Contains all information describing a dispute.

Note: 'Item Not Received' or 'Significantly Not As Described' cases, initiated by buyers through the eBay Money Back Guarantee program, are not returned with GetDispute or GetUserDisputes. The getCase method of the Post-Order API is used to retrieve Money Back Guarantee cases programmatically.

Types that use DisputeType:

Calls that use DisputeType:

Fields



BuyerUserID ( UserIDType (string) ) [0..1]
The eBay user ID of the buyer involved in the dispute.
See the Field Index to learn which calls use BuyerUserID.

DisputeCreatedTime ( dateTime ) [0..1]
The date and time the dispute was created, in GMT.
See the Field Index to learn which calls use DisputeCreatedTime.

DisputeCreditEligibility ( DisputeCreditEligibilityCodeType ) [0..1]
A value to indicate whether or not the seller is currently eligible for a Final Value Fee credit. The seller becomes eligible for a Final Value Fee credit after filing and winning an Unpaid Item case. This tag only indicates credit eligibility and does not mean that the case can be closed. The seller can open an Unpaid Item case as soon as two days after the listing ends.
See the Field Index to learn which calls use DisputeCreditEligibility.

DisputeExplanation ( DisputeExplanationCodeType ) [0..1]
The detailed explanation for the dispute. Valid values depend on the value of DisputeReason. See DisputeExplanationCodeList for details.
See the Field Index to learn which calls use DisputeExplanation.

DisputeID ( DisputeIDType (string) ) [0..1]
The unique identifier of an eBay dispute.
See the Field Index to learn which calls use DisputeID.

DisputeMessage ( DisputeMessageType ) [0..*]
A response or message posted to a dispute, either by an application or by a user on the eBay site.
See the Field Index to learn which calls use DisputeMessage.

DisputeModifiedTime ( dateTime ) [0..1]
The date and time the dispute was modified, in GMT.
See the Field Index to learn which calls use DisputeModifiedTime.

DisputeReason ( DisputeReasonCodeType ) [0..1]
The top-level reason for the dispute. The value of DisputeReason determines which values of DisputeExplanation are valid. See DisputeExplanationCodeList for details.
See the Field Index to learn which calls use DisputeReason.

DisputeRecordType ( DisputeRecordTypeCodeType ) [0..1]
A value to indicate the type of dispute.
See the Field Index to learn which calls use DisputeRecordType.

DisputeResolution ( DisputeResolutionType ) [0..*]
The action resulting from the dispute resolution. The action might include a Final Value Fee credit to the seller, a strike to the buyer, a reversal, or an appeal.
See the Field Index to learn which calls use DisputeResolution.

DisputeState ( DisputeStateCodeType ) [0..1]
The internal state of the dispute. The value determines which values of DisputeActivity are valid when responding to a dispute.
See the Field Index to learn which calls use DisputeState.

DisputeStatus ( DisputeStatusCodeType ) [0..1]
The status of the dispute, which provides additional information about the dispute state.
See the Field Index to learn which calls use DisputeStatus.

Escalation ( boolean ) [0..1]
This field is returned as true if the buyer is eligible to appeal a closed Item Not Received dispute.
See the Field Index to learn which calls use Escalation.

Item ( ItemType ) [0..1]
Container consisting of high-level details about the item involved in the dispute.
See the Field Index to learn which calls use Item.

OrderLineItemID ( string ) [0..1]
OrderLineItemID is a unique identifier for an eBay order line item. In the case of GetDispute and GetUserDisputes responses, this value identifies the order line item involved in the dispute.
See the Field Index to learn which calls use OrderLineItemID.

OtherPartyName ( string ) [0..1]
The user name of the person involved in the dispute who is not taking action or requesting information.
See the Field Index to learn which calls use OtherPartyName.

OtherPartyRole ( TradingRoleCodeType ) [0..1]
The role of the person involved in the dispute who is not taking action or requesting information. The role is either Buyer or Seller.
See the Field Index to learn which calls use OtherPartyRole.

PurchaseProtection ( boolean ) [0..1]
This field is returned as true if the buyer used PayPal to pay for the item, and is eligible for PayPal's Standard Purchase Protection.
See the Field Index to learn which calls use PurchaseProtection.

SellerUserID ( UserIDType (string) ) [0..1]
The eBay user ID of the seller involved in the dispute.
See the Field Index to learn which calls use SellerUserID.

TransactionID ( string ) [0..1]
The unique identifier of the order line item (transaction) under dispute. An order line item is created once there is a commitment from a buyer to purchase an item. In the case of GetDispute and GetUserDisputes responses, this value identifies the order line item involved in the dispute.
See the Field Index to learn which calls use TransactionID.

The role of the person involved in the dispute who is taking action or requesting information. The role is either Buyer or Seller.
See the Field Index to learn which calls use UserRole.