ebay api - GetUserDisputes 函数

etUserDisputes

 

http://developer.ebay.com/devzone/xml/docs/Reference/ebay/GetUserDisputes.html#GetUserDisputes

1

得到买家和卖家的争议信息。但是不包括eBay Buyer Protection cases，这个case是： getEBPCaseDetail call of the Resolution Case Management API.

2

过滤：DisputeFilter

DetailLevel -->ReturnAll   返回所有的争议信息，包括DisputeResolution  和DisputeMessage

3

 返回的数据：争议请求者，DisputeID, DisputeRecord, DisputeState, DisputeStatus, DisputeReason, and DisputeExplanation

 

4

相关信息

 Unpaid Item Disputes 
    Buyer Disputes 
    Getting Details About a Dispute

See also the reference documentation for these calls:

· AddDispute- 新建一个Unpaid Item dispute ，针对于买家，或者取消一个订单

Creates an Unpaid Item dispute against a buyer or cancels a single line item order.

· AddDisputeResponse- 回复一个争议，或者关闭这个争议

Adds a response to a dispute, or closes a dispute.

· GetDispute- 通过duspute id得到这个争议的详细信息。

Retrieves the details of a specific eBay dispute corresponding to the supplied dispute ID.

· SellerReverseDispute- 卖家反向争议

Enables a seller to "reverse" an Unpaid Item dispute that has been closed, for example, if buyer and seller reach an agreement. The seller's Final Value Fee credit and the buyer's strike are both reversed. if applicable.

 

GetUserDisputes Input

<?xml version="1.0" encoding="utf-8"?>

<GetUserDisputesRequest xmlns="urn:ebay:apis:eBLBaseComponents">

  <!-- Call-specific Input Fields -->

  <DisputeFilterType> DisputeFilterTypeCodeType </DisputeFilterType>

  <DisputeSortType> DisputeSortTypeCodeType </DisputeSortType>

  <ModTimeFrom> dateTime </ModTimeFrom>

  <ModTimeTo> dateTime </ModTimeTo>

  <Pagination> PaginationType

    <EntriesPerPage> int </EntriesPerPage>

    <PageNumber> int </PageNumber>

  </Pagination>

  <!-- Standard Input Fields -->

  <DetailLevel> DetailLevelCodeType </DetailLevel>

  <!-- ... more DetailLevel values allowed here ... -->

  <ErrorLanguage> string </ErrorLanguage>

  <MessageID> string </MessageID>

  <Version> string </Version>

  <WarningLevel> WarningLevelCodeType </WarningLevel>

</GetUserDisputesRequest>

 

DisputeFilterType：争议的类型，他的值包括为：

AllInvolvedClosedDisputes：所有关闭的争议

AllInvolvedDisputes：所有的争议，包括open和closed类型。

DisputesAwaitingMyResponse：等待回复的争议，也就是说：卖家和买家还在争议处理中，没有解决。如果没有设置DisputeFilterType，默认值为DisputesAwaitingMyResponse，

DisputesAwaitingOtherPartyResponse：等待其他人（other party）回复的争议

EligibleForCredit：(in/out) If used, this filter returns all disputes that involve the caller as a buyer or seller and are eligible for a Final Value Fee credit, regardless of whether or not the credit has been granted.

ItemNotReceivedDisputes：物品未收到纠纷，包括open和closed类型。

UnpaidItemDisputes：返回所有的出价不买纠纷，包括open和closed纠纷。

DisputeSortType：对返回的争议列表进行排序。

DisputeCreatedTimeAscending：通过争议的创建时间进行升序排列

DisputeCreatedTimeDescending：通过争议的创建时间进行降序排列

DisputeCreditEligibilityAscending：(in) Sort by whether the dispute is eligible for Final Value Fee credit, in ascending order. Ineligible disputes are listed before eligible disputes.

DisputeCreditEligibilityDescending

(in) Sort by whether the dispute is eleigible for Final Value Fee credit, in descending order. Eligible disputes are listed before i(ineligible disputes.

DisputeStatusAscending：通过dispute status,进行升序排序

DisputeStatusDescending：通过dispute status,进行降序排序

None：争议创建的时间，降序排列

ModTimeFrom：通过DisputeModifiedTime这个时间属性过滤，格式为GMT，如果不执行ModTimeTo，默认为现在的时间。

ModTimeTo：和上面的from对应。

Pagination：分页。

Pagination.EntriesPerPage：每页的个数。指定为200

Pagination.PageNumber：页数

 

DetailLevel：ReturnAll

ReturnSummary

 

GetUserDisputes Output

<?xml version="1.0" encoding="utf-8"?>

<GetUserDisputesResponse xmlns="urn:ebay:apis:eBLBaseComponents">

  <!-- Call-specific Output Fields -->

  <DisputeArray> DisputeArrayType

    <Dispute> DisputeType

      <DisputeCreatedTime> dateTime </DisputeCreatedTime>

      <DisputeCreditEligibility> DisputeCreditEligibilityCodeType </DisputeCreditEligibility>

      <DisputeExplanation> DisputeExplanationCodeType </DisputeExplanation>

      <DisputeID> DisputeIDType (string) </DisputeID>

      <DisputeMessage> DisputeMessageType

        <MessageCreationTime> dateTime </MessageCreationTime>

        <MessageID> int </MessageID>

        <MessageSource> DisputeMessageSourceCodeType </MessageSource>

        <MessageText> string </MessageText>

      </DisputeMessage>

      <!-- ... more DisputeMessage nodes allowed here ... -->

      <DisputeModifiedTime> dateTime </DisputeModifiedTime>

      <DisputeReason> DisputeReasonCodeType </DisputeReason>

      <DisputeRecordType> DisputeRecordTypeCodeType </DisputeRecordType>

      <DisputeResolution> DisputeResolutionType

        <DisputeResolutionReason> DisputeResolutionReasonCodeType </DisputeResolutionReason>

        <DisputeResolutionRecordType> DisputeResolutionRecordTypeCodeType </DisputeResolutionRecordType>

        <ResolutionTime> dateTime </ResolutionTime>

      </DisputeResolution>

      <!-- ... more DisputeResolution nodes allowed here ... -->

      <DisputeState> DisputeStateCodeType </DisputeState>

      <DisputeStatus> DisputeStatusCodeType </DisputeStatus>

      <Item> ItemType

        <ItemID> ItemIDType (string) </ItemID>

      </Item>

      <OrderLineItemID> string </OrderLineItemID>

      <OtherPartyName> string </OtherPartyName>

      <OtherPartyRole> TradingRoleCodeType </OtherPartyRole>

      <TransactionID> string </TransactionID>

      <UserRole> TradingRoleCodeType </UserRole>

    </Dispute>

    <!-- ... more Dispute nodes allowed here ... -->

  </DisputeArray>

  <DisputeFilterCount> DisputeFilterCountType

    <DisputeFilterType> DisputeFilterTypeCodeType </DisputeFilterType>

    <TotalAvailable> int </TotalAvailable>

  </DisputeFilterCount>

  <!-- ... more DisputeFilterCount nodes allowed here ... -->

  <EndingDisputeID> DisputeIDType (string) </EndingDisputeID>

  <ItemsPerPage> int </ItemsPerPage>

  <PageNumber> int </PageNumber>

  <PaginationResult> PaginationResultType

    <TotalNumberOfPages> int </TotalNumberOfPages>

  </PaginationResult>

  <StartingDisputeID> DisputeIDType (string) </StartingDisputeID>

  <!-- Standard Output Fields -->

  <Ack> AckCodeType </Ack>

  <Build> string </Build>

  <CorrelationID> string </CorrelationID>

  <Errors> ErrorType

    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>

    <ErrorCode> token </ErrorCode>

    <ErrorParameters ParamID="string"> ErrorParameterType

      <Value> string </Value>

    </ErrorParameters>

    <!-- ... more ErrorParameters nodes allowed here ... -->

    <LongMessage> string </LongMessage>

    <SeverityCode> SeverityCodeType </SeverityCode>

    <ShortMessage> string </ShortMessage>

  </Errors>

  <!-- ... more Errors nodes allowed here ... -->

  <HardExpirationWarning> string </HardExpirationWarning>

  <Timestamp> dateTime </Timestamp>

  <Version> string </Version>

</GetUserDisputesResponse>

 

DisputeArray：dispute数组容器

DisputeArray.Dispute:dispute的详细信息，包括买家的名字，交易号，争议状态，争议是否解决，争议的消息。

DisputeArray.Dispute.DisputeCreatedTime 争议的创建时间

DisputeArray.Dispute.DisputeCreditEligibility：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 a UPI case as soon as two days after the listing ends. 

Eligible

(out) The seller is eligible for a Final Value Fee credit.

•   InEligible

(out) The seller is not currently eligible for a Final Value Fee credit.

DisputeArray.Dispute.DisputeExplanation:争议的内容是什么，Valid values depend on the value of DisputeReason. See DisputeExplanationCodeList for details. 

BuyerHasNotResponded：购买者没有支付order，也没有对付款问题联系过卖家，当disputeReason的值为BuyerHasNotPaid的时候（This value is allowed when the DisputeReason value is BuyerHasNotPaid.）

BuyerNoLongerRegistered：已经被弃用。

BuyerNoLongerWantsItem：买家不想要这个产品了。This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.

BuyerNotClearedToPay：买家没有支付，ebay还没有清除。This value is allowed when the DisputeReason value is BuyerHasNotPaid.

BuyerNotPaid：买家没有支付。This value is allowed when the DisputeReason value is BuyerHasNotPaid.

BuyerPaymentNotReceivedOrCleared：(in/out) This value indicates that the buyer has not paid the seller for the order line item, or has paid the seller but the payment has not cleared. This value is allowed when the DisputeReason value is BuyerHasNotPaid.

等等，其他的属性值请参看网站。

 

DisputeArray.Dispute.DisputeID：ebay 争议的id

DisputeArray.Dispute.DisputeMessage：争议的回复或者消息，either by an application or by a user on the eBay site. 

 

DisputeArray.Dispute.DisputeMessage.MessageCreationTime：消息创建的时间，GMT格式

DisputeArray.Dispute.DisputeMessage.MessageID ：message id

DisputeArray.Dispute.DisputeMessage.MessageSource：发送消息的一方，Applicable values: Buyer，eBay，Seller

DisputeArray.Dispute.DisputeMessage.MessageText：消息的内容

DisputeArray.Dispute.DisputeModifiedTime：争议修改的时候，也就是争议被更新的时间，GMT格式

 

DisputeArray.Dispute.DisputeReason：争议的原因，BuyerHasNotPaid

ItemNotReceived（没收到货物），NoRefund（没有退款），ReturnPolicyUnpaidItem（买家把货寄回，但是卖家没有退款），SignificantlyNotAsDescribed（物品和描述不符，这个不能用到AddDispute），TransactionMutuallyCanceled（交易相互取消）

DisputeArray.Dispute.DisputeRecordType：HalfDispute（One type come from Half.com.），  ItemNotReceived（没有收到货物），UnpaidItem（没有支付）

DisputeArray.Dispute.DisputeResolution：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. 

DisputeArray.Dispute.DisputeResolution.DisputeResolutionReason：The reason for the resolution. The DisputeResolutionReason results in the action described by the DisputeResolutionRecordType. 

BuyerPaidAuctionFees（买方偿还卖方的拍卖费），CameToAgreement（通过协议解决），ClaimPaid（赔付金额），ComputerTechnicalProblem（电脑技术问题），FamilyEmergency（家庭应急），FirstInfraction（买家首先违规），ItemReturned（退货），NoContact（买卖双方没有联系，按照ebay默认处理），OtherResolution（其他），ProofGivenInFeedback（买方提供付款的反馈证明。）ProofOfPayment买方提供付款的反馈证明。），SellerReceivedPayment（卖家收到付款），Unresolved（争端仍未解决。）

DisputeArray.Dispute.DisputeResolution.DisputeResolutionRecordType：The action resulting from the resolution, affecting either the buyer or the seller. 

DisputeArray.Dispute.DisputeResolution.ResolutionTime：争议解决的时间

DisputeArray.Dispute.DisputeState：dispute状态

DisputeArray.Dispute.DisputeStatus：dispute额外状态

DisputeArray.Dispute.Item：item容器

 

DisputeArray.Dispute.Item.ItemID：ItemID

DisputeArray.Dispute.OrderLineItemID：ItemID and TransactionID，中间加一个连字符，使用于GetDispute 和 GetUserDisputes

DisputeArray.Dispute.OtherPartyName：The user name of the person involved in the dispute who is not taking action or requesting information. 

DisputeArray.Dispute.OtherPartyRole：不提供回复的用户角色。Buyer

Or Seller

DisputeArray.Dispute.TransactionID:交易号

DisputeArray.Dispute.UserRole：用户角色。Buyer or Seller

DisputeFilterCount：The number of disputes that involve the requester as buyer or seller and match a given filter type. 

DisputeFilterCount.DisputeFilterType：具体想看网站

DisputeFilterCount.TotalAvailable：The number of disputes that match the filter.

EndingDisputeID：最后的争议id（当前分页）

ItemsPerPage：分页值。默认200

PageNumber：分页数

PaginationResult：容器

PaginationResult.TotalNumberOfPages：

Indicates the total number of pages of data that could be returned by repeated requests. Returned with a value of 0 if no pages are available.

 

StartingDisputeID：开始的争议id