eBay Feedback API Call Reference Version 1.0.1 Support     Knowledge Base     Forums     All Tutorials     All Code Samples Users Guide Call Reference Making an API Call Tutorials Release Notes

List of All Calls Field Index Enumeration Index Type Index Errors by Number Input Output Samples Change History User Notes

Creates a Detailed Seller Ratings (DSR) summary report based on the category or categories items were listed in and a date range. Specified categories can be either leaf categories or parent categories. Date range can be by transaction end date or by listing date

Related calls:

• getDSRSummary - Retrieves a specific type of DSR report which can be filtered by Transaction, Period, Category, or Shipping Details.

Back to top

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<createDSRSummaryByCategoryRequest xmlns="http://www.ebay.com/marketplace/services">
  <categoryId> string </categoryId>
  <!-- ... more categoryId nodes here ... -->
  <dateRange> DateRange 
    <dateFrom> dateTime </dateFrom>
    <dateTo> dateTime </dateTo>
  </dateRange>
  <dateRangeEventType> token </dateRangeEventType>
</createDSRSummaryByCategoryRequest>

Back to top

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<createDSRSummaryResponse xmlns="http://www.ebay.com/marketplace/services">
  <!-- Standard Output Fields -->
  <ack> AckValue </ack>
  <errorMessage> ErrorMessage 
    <error> ErrorData 
      <category> ErrorCategory </category>
      <domain> string </domain>
      <errorId> long </errorId>
      <exceptionId> token </exceptionId>
      <message> string </message>
      <parameter name="string"> ErrorParameter (string) </parameter>
      <!-- ... more parameter nodes here ... -->
      <severity> ErrorSeverity </severity>
      <subdomain> string </subdomain>
    </error>
    <!-- ... more error nodes here ... -->
  </errorMessage>
  <timestamp> dateTime </timestamp>
  <version> string </version>
  <!-- Call-specific Output Fields -->
  <jobId> string </jobId>
</createDSRSummaryResponse>

Back to top

New to making API calls? Please see Making an API Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Creates a DSR summary report for a specific time period based upon the category in which the sold items were listed.

Description

User magicalbookseller has been listing some books in the Wholesale & Bulk Lots category. She wants to know how the DSR scores left for books listed in this category compare to DSRs for books listed in other categories, such as Fiction Books or Children's Books. For comparison purposes, she is going to use a standard date range, the month of January.

Input

The categoryId field specifies that only transactions for items listed in the specified category (29399) will be considered for aggregating DSR scores.

XML format (HTTP POST). Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="UTF-8"?>
<createDSRSummaryByCategoryRequest xmlns="http://www.ebay.com/marketplace/services">
  <dateRange>
    <dateFrom>2009-01-01</dateFrom>
    <dateTo>2009-01-31</dateTo>
  </dateRange>
  <dateRangeEventType>TransactionEndDate</dateRangeEventType>
  <categoryId>29399</categoryId>
</createDSRSummaryByCategoryRequest>

Output

The response includes a jobId, which is used with the getSummaryReport call to retrieve the DSR summary report when it is ready. Most reports are ready within an hour of sending the requests to create them.

XML format. Also available are the .txt version of this XML and the SOAP equivalent.

<createDSRSummaryResponse xmlns:sct="http://www.ebay.com/soaframework/common/types" xmlns="http://www.ebay.com/marketplace/services">
  <ack>Success</ack>
  <version>1.0.0</version>
  <timestamp>2009-02-18T22:37:44.142Z</timestamp>
  <jobId>68352539771487201092</jobId>
</createDSRSummaryResponse>

Back to top

Back to top

This document was generated with a customized version of the apireferencedocs tool [0.5M zip].

© 2009 eBay, Inc. All rights reserved.