Working With Selling Manager

Selling Manager and Selling Manager Pro are tools with advanced functionality for managing listings. The Trading API includes many calls that take advantage of this functionality. In the Trading API, each Selling Manager call has "SellingManager" as part of the name of the call.

Subscribing a User to Selling Manager

Selling Manager Concepts

Retrieving Selling Manager Inventory and Templates

Using Selling Manager Automation Rules

Retrieving and Modifying Data About Sold Items

The Selling Manager calls are subject to change without notice; the normal process for deprecating features and functionality in calls in the Trading API may not apply to the Seller Manager calls.

For the information about Selling Manager and Selling Manager Pro, see the following locations.

Selling Manager

Selling Manager Pro

Subscribing a User to Selling Manager

Selling Manager calls can be made on behalf of a user, as long as the user has a subscription to Selling Manager (free) or to Selling Manager Pro. For many calls, a subscription to Selling Manager Pro is required. For information about specific Selling Manager calls, including subscription requirements, see the Trading API Reference:

Trading API Reference

Selling Manager Concepts

You can use Selling Manager calls to help sellers manage listings based on sellers' folders, products, templates, and automation rules.

For the input and output fields of all the calls (including calls for revise and delete operations), see the Trading API Reference.

Here is an overview of the concepts used in many of the calls:

Retrieving Selling Manager Inventory and Templates

You can retrieve a seller's existing folders, inventory, and templates before presenting the seller with custom options for managing their listings.

Retrieving Inventory Folders

You can use the GetSellingManagerInventoryFolder call to retrieve a seller's current folder hierarchy. Your application should store the folder hierarchy, and the FolderID-FolderName pairs, in order to present folder-related options to the seller.

Retrieving Inventory

You can use the GetSellingManagerInventory call to retrieve a seller's current product, template, and inventory data. Your application needs this data to present inventory-related options to the seller.

Retrieving Templates

After obtaining at least one SaleTemplateID, e.g. using GetSellingManagerInventory, you can use the GetSellingManagerTemplates call to retrieve the data for one or more of a seller's templates. This data enables your application to present template-related options to a seller.

Adding, Revising, and Deleting Products and Templates

Your application can perform add, revise, and delete operations on products and templates. For a list of the calls available for these operations, see the Trading API Reference.

Adding a Product

If a seller wants a new type of merchandise, i.e. a new product, use AddSellingManagerProduct.

Adding a Template

Use AddSellingManagerTemplate when a seller wants to create a new set of listing data for a new kind of listing. When you use AddSellingManagerTemplate, specify the product for which the template will be used by specifying a ProductID.

Using Selling Manager Automation Rules

A seller can use automation rules to automatically list and relist items that are based on a specific template. For example, a seller can specify that a set of items is automatically relisted unless the product inventory is at or below a certain level.

Retrieving Current Automation Rules

If you want to retrieve a template's automation rules, use GetSellingManagerTemplateAutomationRule, specifying the template ID in the SaleTemplateID field.

Adding New Automation Rules

Using SetSellingManagerTemplateAutomationRule, you can add an automation rule to an existing template. After you retrieve the seller's templates using the GetSellingManagerTemplates call, you specify the template ID (in SaleTemplateID) of the template to which you want to associate a rule. The rule is added to existing rules. To delete a rule, use DeleteSellingManagerTemplateAutomationRule.

See the input fields for SetSellingManagerTemplateAutomationRule (see SetSellingManagerTemplateAutomationRule) to see the available rules and the available settings for each rule.

Retrieving Selling Manager Alerts and Email Logs

A Selling Manager Application can provide a seller with alerts and email logs.

Retrieving Alerts

Use GetSellingManagerAlerts to retrieve up-to-date data about listings. The types of data you can retrieve are:

Retrieving Email Logs

Use GetSellingManagerEmailLog to retrieve a log of emails that a seller sent, or is scheduled to send, to a buyer. The log includes emails regarding the buyer's payment and feedback. For each email, the log indicates the state of the email (successful, pending, or failed).

Retrieving and Modifying Data About Sold Items

When an item is sold, Selling Manager generates a sale record. A sale record is displayed in the Sold view in Selling Manager.

The sale record has a sale record ID (also referred to as a sale record number) for each order line item. In the following calls, the value for the sale record ID is in the SellingManagerSalesRecordNumber field: GetOrders, GetOrderTransactions, GetItemTransactions, and GetSellerTransactions.

In the Selling Manager calls, the value for the sale record ID is in the SaleRecordID field.

Retrieving the Data for the Items Sold

Using a time-range or other filter in GetSellingManagerSoldListings, you can get a list of a seller's sold items. This list includes comprehensive information about each item sold.

Retrieving and Revising a Record of Sale

You can use GetSellingManagerSaleRecord to retrieve a detailed, individual sale record for an item that was sold. You can use ReviseSellingManagerSaleRecord to revise many fields of a record, e.g. the pay date, sales tax, and shipping address and date.

Copyright © 2005–2016 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.