eBay Trading APIVersion 1235

DisputeType

Contains all information describing an Unpaid Item case.

Note: The GetDispute and GetUserDisputes calls now only retrieve Unpaid Item cases. They are no longer used to retrieve Item not Received (INR) disputes created through PayPal, since this is no longer an option for eBay buyers. eBay buyers must create an INR case through eBay's Resolution Center, and these calls do not support eBay Money Back Guarantee cases.

To respond to an eBay Money Back Guarantee case, the seller should use the Case Management calls of the Post-Order API or manage/respond to cases manually through the eBay Resolution Center.

Types that use DisputeType:

Calls that use DisputeType:

Fields



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

DisputeCreatedTime ( dateTime ) [0..1]
The date and time the Unpaid Item case 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]
This enumeration value provides more details about why the Unpaid Item case was created. See DisputeExplanationCodeList type for explanation of values.
See the Field Index to learn which calls use DisputeExplanation.

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

DisputeMessage ( DisputeMessageType ) [0..*]
This field will contain a response or message related to the Unpaid Item case, posted by either the buyer or the seller.
See the Field Index to learn which calls use DisputeMessage.

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

DisputeReason ( DisputeReasonCodeType ) [0..1]
The reason for the Unpaid Item case. Since GetDispute and GetUserDisputes calls now only retrieve Unpaid Item cases, this value should always be BuyerHasNotPaid.
See the Field Index to learn which calls use DisputeReason.

DisputeRecordType ( DisputeRecordTypeCodeType ) [0..1]
A value to indicate the type of dispute.

Note: The GetDispute and GetUserDisputes calls now only retrieve Unpaid Item cases, so the enumeration value returned here should always be UnpaidItem.
See the Field Index to learn which calls use DisputeRecordType.

DisputeResolution ( DisputeResolutionType ) [0..*]
This container provides more details about the results of an Unpaid Item case once it is resolved. Results could possibly include a Final Value Fee credit to the seller and an Unpaid Item strike to the buyer. This container will only be returned after the Unpaid Item case is resolved.
See the Field Index to learn which calls use DisputeResolution.

DisputeState ( DisputeStateCodeType ) [0..1]
The state of the dispute. The value determines which values of DisputeActivity are valid when responding to an Unpaid Item case with an AddDisputeResponse.
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 Unpaid Item case.
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 Unpaid Item case.
See the Field Index to learn which calls use Item.

OrderLineItemID ( string ) [0..1]
The unique identifier of the order line item with an Unpaid Item case filed against it.
See the Field Index to learn which calls use OrderLineItemID.

OtherPartyName ( string ) [0..1]
The user name of the person involved in the Unpaid Item case 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 Unpaid Item case 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 no longer applicable, and if it is returned, it can be ignored.
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 Unpaid Item case.
See the Field Index to learn which calls use SellerUserID.

TransactionID ( string ) [0..1]
The unique identifier of the sales transaction with an Unpaid Item case filed against it.

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.

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