IRP Shopper
Common Tasks (1)
Open
Interventions (1)
Open
Languages (1)
Open
Questions & Answers (1)
Open
Reviews (1)
Open
Site Scripts (1)
Open
Web Services (1)
Open
Training Videos
Peer Support

eBay

You can find this section under Marketplaces > eBay in the IRP Admin left navigation menu.

This is where you view, add, manage and delete eBay Marketplaces on your IRP.

Recommended sequence for setting up and managing eBay marketplaces

Note: For full details of each of the IRP sections referred to below, refer to the How to Configure eBay Marketplaces article later in this section.

1. Configure your eBay Seller account. Ensure in particular that you set up the following on eBay (not on the IRP):

  • Payment Policy
  • Returns Policy
  • Shipping Policy
  • PayPal account email address to receive payments.

2. Create your eBay Developer Account.

Customers wishing to use the IRP eBay Marketplace integration should have one or more existing eBay Seller Accounts. The integration uses eBay's Trading and Large Merchant Services APIs for syncing Stock and Prices as well as downloading and managing Orders placed on eBay.

To integrate with eBay APIs, Customers must sign up to the eBay Developer's program (https://developer.ebay.com/). For more details, see How to Create an eBay Developer Account.

By signing up to the eBay Developer's program, Customers will be allocated Application Keys and will be able to generate Auth Tokens (per Seller Account) which give the IRP access to Seller Listing and Orders through the eBay Trading API.

Note that one Developer Account can link to multiple eBay Seller Accounts. Seller Accounts are differentiated by the Auth Token. We recommend that Customers sign up for one Developer Account regardless of the number of Seller Accounts they have.

eBay Developer Accounts provide Customers with the following Application Access Keys for integrating – these keys are different for Sandbox and Production environments:

  • App ID (Client ID)
  • Dev ID
  • Cert ID (Client Secret)

For more information, see the eBay Developer help topic.

Sandbox and Production eBay Redirect URLs or RuNames are also required so that your IRP can fetch and validate User Tokens. User Tokens are how your eBay Developer Account gains access to each Seller Account.

Note that App ID, Dev ID, Cert ID, RuName and User Token are all credentials that need to be added to your IRP for both Sandbox and Production environments.

For full details, see How to Create an eBay Developer Account later in this help topic.

3. Configure all eBay Application Settings in the IRP.

  • Complete the Production-related details using the info from your eBay account.
  • The Sandbox-related settings apply only to new customers on the IRP.

4. Configure all eBay marketplaces using the MarketplacesEbay.aspx page. The following settings are of particular note:

  • Stock Source – set this as you wish. You may want to demarcate a specific location just for eBay products, or simply use your web stock level. Alternatively you may want to manage your stock levels externally.
  • Update Order Status from eBay Order Status – for most customers this should be disabled, so that you can use the IRP for dispatch and generally so that orders flow completely through the IRP order flow.
  • Ignore Auction Items – Check this box if you don’t want to include auction items in the eBay order downloads to the IRP.
  • User Token – Click the Generate New user Token button and you can then enter your eBay credentials and get new token details. You can manually check this at any time using the Check User Token button however it is normally checked automatically via the Common Task called 'Marketplaces Ebay Check Tokens' (see below for more details).

5. Define the rules for products available to eBay customers using the Inclusion/Exclusion Rules tab.

  • By default everything is available and won’t be removed.
  • Brand rules that you configure here will be replicated on the BrandsEdit.aspx page (Marketplaces tab).
  • Category rules that you configure here will be replicated on the CategoriesEdit.aspx page (Marketplaces tab).
  • Model and Stock rules that you configure here will be replicated on the ModelsEdit.aspx page (Marketplaces tab).

6. Define the product prices and discounts using the Price Rules tab.

  • You can choose simply to use the prices you already have configured for your products in the IRP or you can configure various types of discount specifically for selling on eBay.
  • You can also use the 'eBay Marketplace Stock Allocation (%)' setting for stock items on the ModelsEdit.aspx > StockEdit.aspx page.

7. Configure the automated eBay tasks using the Automation tab:

  • As eBay have API limits for most customers, we recommend that, during initial setup, you have your API verified by eBay (this can be done within the eBay Developer program console – your Account Manager can assist with this) – subsequently this allows you a near-limitless number of API calls. You should then configure the following schedules for automated tasks:
    • Stock and Price Update: we recommend setting this to run every 120 minutes. (This automated task is identical to the Common Task called 'Marketplace Ebay Seller Listing Update'.)
    • Order Download: we recommend setting this to run every 180 minutes. (This automated task is identical to the Common Task called 'Marketplace Ebay Order Download'.)

8. Check the configuration of other eBay Common Tasks:

  • Marketplaces Ebay Check Tokens: we recommend that you run this once a day.
  • Marketplace Ebay Remove Old Service Requests And Feed Submissions: we recommend that you run this once a day.

9. Ensure marketplaces are ACTIVE.

  • Products will be uploaded to eBay (with each stock item being a variation) via the schedule configured for the Stock and Price Update task.
  • Matched Products are synced with eBay based on Stock and Price Rules.
  • Orders will be downloaded to the IRP via the schedule configured for the Order Download task.

10. Check the Seller Listing tab on an ongoing basis. Look for:

  • Items / variations to update.
  • Items that need to be matched (see below for more details).

11. Check for Unmatched items using the Unmatched Items tab.

  • Match where necessary.
  • Bulk update products when needed.

12. View high-level information about the orders that have been placed by eBay customers using the Orders > Marketplace Orders tab.

  • You can link through to the page for managing any order by clicking the Manage button.
  • If for any reason you want to disregard an order, click the Ignore button.
  • To manually download orders, click the Download Orders button (this is normally taken care of automatically by the automated task).

13. Monitor your marketplaces on an ongoing basis using these sections:

  • Seller Listing Actions tab (to view all inventory status updates)
  • Rejected Orders tab (to see a list of orders that have been rejected)
  • Order Downloads tab ( to check that the Order Download task and manual downloads are working as expected)
  • Errors tab (to check eBay API Call errors)
  • The 'Marketplace Errors' alert on the Alerts menu in the top nav (this directs you to the MarketplacesOverview.aspx page)
  • Marketplaces Overview page (MarketplacesOverview.aspx). Here you can see the key statistics about your eBay operation.
  • The eBay Alerts bar at the top of IRP Admin (assuming you have selected this using the 'Edit' menu at the top-right corner of the Admin).
  • Sales tab in the top-left corner of IRP Admin.

MarketplacesEbay.aspx page

The MarketplacesEbay.aspx page appears as follows:

eBay Marketplaces page

This displays the following information for the eBay Marketplaces that you have in your system:

  • ID: The unique IRP identifier for this eBay Marketplace.
  • Active: Indicates whether the marketplace is active or not. Active marketplaces will periodically upload products for sale via Ebay as Fixed Priced Items, with each stock item as a variation. Inactive marketplaces will not schedule product uploads. If an uploading process is in progress when the marketplace is set to inactive, the process will be allowed to complete. If you make a change here, be sure to click the Update eBay Marketplaces button.
  • Admin Name: This is the name of the eBay marketplace.
  • Currency: This is the currency used by the Marketplace. This determines the exchange rate to apply to product prices before upload to the Marketplace.
  • eBay Site: The eBay site this Marketplace relates to. This value is important for Seller Listing and Order Downloads as well as Feed Submissions.
  • Stock Source: What the Stock value should be set to when Seller Listing Updates are processed.
    – Web Stock Level: The value will be pulled directly from the website Stock Level.
    – Externally Managed: The value will not be set allowing for Stock Levels to be updated outside of the IRP.
    – Specific Stock Locations: The value will be made up of the Stock Levels from the Selected Stock Locations.
  • Fulfilment Location: The stock location from which products will be shipped for this Marketplace.
  • SKU Counts: This shows the number of Stock Keeping Units that are associated with each eBay Marketplace.
  • Order Totals: This shows the number and value of all orders associated with each eBay Marketplace.
  • Rejected Orders: This shows the number and value of all rejected orders associated with each eBay Marketplace.
  • Automation Tasks: This indicates the number of Automation Tasks that are enabled for each eBay Marketplace
  • Errors: This indicates the number of errors generated by each eBay Marketplace.
  • Edit: Click this button to make changes to an eBay Marketplace configuration. For more details, see the How To Configure eBay Marketplaces article in this section.

The MarketplacesEbay.aspx page has the following buttons at the top of the page:

  • eBay Logo: Click this link to go to the eBay Account login page.
  • Orders Last 30 Days: Click this button to go to the Orders.aspx?MarketplaceType=2&Last30Days=true page in the Orders section of IRP Admin. From here you can manage eBay orders in the same way that you manage any other type of order in the IRP.
  • Errors: Click this button to go to the MarketplacesEbayErrors.aspx page.
  • Rejected Orders: Click this button to go to the MarketplacesEbayRejectedOrders.aspx page.
  • Add New Marketplace: Click this button to add a new eBay Marketplace. You will then be redirected to the MarketplaceEbayEdit.aspx page. For more information, see the How to Configure eBay Marketplaces article in this section.

eBay Alerts bar

(This is visible only if eBay Integration is enabled on your the IRP.) You can see at-a-glance information about your eBay Marketplaces using the eBay bar at the top of your IRP Admin screen:

Amazon alert bar

The bar shows the following details:

  • Marketplaces: This shows the number of eBay Marketplaces that you have configured in the system. Click this button to take you to the MarketplacesEbay.aspx page in IRP Admin. For more information, see the eBay Marketplaces help topic.
  • Orders Last 30 Days: This shows the number of eBay Orders that have been placed in the last 30 days. Click this button to take you to the Orders.aspx?MarketplaceType=2 page in IRP Admin. For more information, see the Orders help topic.
  • Total Last 30 Days: This shows the total value of all eBay Orders that have been placed in the last 30 days. Click this button to take you to the Orders.aspx?MarketplaceType=2&Last30Days=true page in IRP Admin. For more information, see the Orders help topic.
  • Orders Overall: This shows the total number of eBay Orders that have been placed on your website. Click this button to take you to the Orders.aspx?MarketplaceType=2 page in IRP Admin. For more information, see the Orders help topic.
  • Total Overall: This shows the total value of all eBay Orders that have been placed on your website. Click this button to take you to the Orders.aspx?MarketplaceType=2 page in IRP Admin. For more information, see the Orders help topic.
  • Products: This shows the number of models and stock items that you are selling on eBay. This is for reference only (you cannot click through to a specific page).

How To Guides (2)

Close
Close
How to Configure eBay Marketplaces

To add or edit an eBay Marketplace, follow these steps:

  1. Ensure that you follow the sequence described in the main topic above entitled Recommended sequence for setting up and managing eBay marketplaces on the IRP.
  2. Go to Marketplaces > eBay in the IRP Admin left navigation menu.
  3. Click the Add New Marketplace button at the top of the screen. Alternatively, to edit an eBay Marketplace, click the Edit button beside the eBay Marketplace that you want to edit.
  4. The Add / Edit New eBay Marketplace screen appears (MarketplaceEbayEdit.aspx) containing several tabs as shown in the sections that follow. Work through each tab and enter the details as described below. Note that you will see all of these tabs ONLY if you are editing an existing eBay Marketplace; if you are creating a new one, only the initial 'Marketplace Settings' tab will be visible until you click the 'Insert eBay Marketplace' button.

Marketplace Settings tab

Click the Marketplace Settings tab and you will see the following details:

Marketplace Settings
SettingDescription
Marketplace Settings
Marketplace ID This is the unique IRP identifier for this eBay Marketplace. This is added automatically by the IRP.
Active Check this box to activate or deactivate a marketplace. Active marketplaces will periodically sync matched Stock IDs Stock Level and Price. Inactive marketplaces will not schedule seller listing updates. If an uploading process is in progress when the marketplace is set to inactive, the process will be allowed to complete.
Name Enter the name of the eBay Marketplace to identify it to you in IRP Admin.
Currency Select the currency used by the marketplace. This will determine the prices that are calculated via Price Rules or the exchange rate of ordered items (in order to translate them into the base website currency where necessary).
Language Select the primary language used in this marketplace.
Country Select the primary country served by this marketplace.
eBay Site Select the eBay site this Marketplace relates to. This value is important for Seller Listing and Order Downloads as well as Feed Submissions.
Fulfilment Location Select the stock location from which products will be shipped for this Marketplace. If set to 'Any Location', orders will not be assigned to a specific Stock Location, otherwise downloaded orders will be auto-assigned to the selected location.
Stock Source Select what the Stock value should be set to when Seller Listing Updates are processed:
– Allow Manual Set: Values can be entered manually from the Products > Seller Listing tab.
– Web Stock Level: The value will be pulled directly from the website Stock Level.
– Externally Managed: The value will not be set, allowing for Stock Levels to be updated outside of the IRP. Stock Levels will not be editable via the Products > Seller Listing tab and no Stock level will be sent via the Seller Listing update task, thus allowing for full control by an external stock system.
– Specific Stock Locations: The value will be made up of the Stock Levels from the Selected Stock Locations (see below).
Stock Locations Select the Stock Locations used to make up the Stock value uploaded in Seller Listing Feeds.
Traffic Partner Select the correct Traffic Partner for this marketplace. If you need to, you can select the Add New Traffic Partner option if you have not yet created one. This will automatically create a Traffic Partner and set it against the marketplace.
Use Sandbox Check this box to ensure that Seller Listing Downloads, Seller Listing Feed Submissions and Order Downloads are processed from the registered Sandbox environment using the Sandbox eBay User Token.
Update Order Status from eBay Order Status If checked, Order Statuses returned by eBay will be mapped to their IRP equivalent:
– Canceled > Cancelled
– CanceledPending > Cancelled
– Completed > New
– Shipped > Complete
– Invalid > OnHold
– Inactive > OnHold
– InProcess > OnHold
If you leave this unchecked:
– Orders marked as Shipped on eBay will remain at their current IRP Order Status if the Order has been previously downloaded into the IRP. If a new Order, Shipped Orders will be marked as 'New' so they can flow through the full IRP Order process.
– Orders marked as Cancelled or Canceled Pending on eBay will be marked as 'Cancelled' regardless if the Order has been previously downloaded into the IRP.
Update eBay Order Status and Tracking Details When enabled, orders will be completed/cancelled on eBay when they are processed on your IRP. Also, tracking information will be added on eBay when set in the IRP. If disabled, none of this information will be set on eBay and any processing will need to be carried out on the eBay portal.
Ignore Auction Items If checked, any Auction Items will be ignored in the Seller Listing Download and any Orders containing solely Auction items will also be ignored in the Order Download.
Application Keys and User Tokens
Enter the following details for either the Sandbox or the Production instance:
ebay User Tokens

App ID (Client ID) Unique identifier for the application – see How to Create an eBay Developer Account for further information.
Dev ID Unique identifier for the developer's (or company's) account – see How to Create an eBay Developer Account for further information.
Cert ID (Client Secret) Certificate that authenticates the application when making API calls. Not to be confused with user-level authentication tokens – see How to Create an eBay Developer Account for further information.
RuName eBay services require a custom RuName (eBay Redirect URL name) value that eBay generates and assigns to your application for granting permissions to your eBay account – see How to Create an eBay Developer Account for further information.
User Token buttons Application User Tokens link your eBay Developer Account to your eBay Seller Account and grant access for invoking API calls relating to the Seller Account. Each Application User Token is generated based on your App ID and typically expires after 18 months. You can update your Auth 'n' Auth User Token or, (if it has expired) create a new token by logging into eBay again via the Generate New User Token button below. To check the validity of the token, click the Check User Token button.

Note: User Tokens are normally looked after automatically by the Marketplaces Ebay Check Tokens Common Task. It is recommended that you have this configured to run every day.

If you are creating an eBay Marketplace for this first time, click the Insert eBay Marketplace button. If you are editing an existing marketplace, click Update eBay Marketplace.

Products tab

Click the Products tab and you will see the following details:

Seller Listing

Seller Listing
SettingDescription
Seller Listing Summary
Items / Variations to Update This shows the number of Matched Seller Listing Items to Update on eBay the next time Seller Listing is updated. These are items that are currently active on eBay and:
– The eBay Quantity value does not match the IRP Stock Level based on the configured Stock Source.
– The eBay Price does not match the IRP Price based on the Price Rule set for the Item.
Click the Refresh Count button to update the figure that is shown here.
Bulk Update Inventory Items Click the Browse button to find the items and then click the Bulk Update Items button to perform the update. if you want to export the data, click the Export Items button.
NOTE: For the values shown below, click the Download Seller Listing button to download the data or click the Update Items / Variations button to update the data.
Active Items / Variations This shows the Number of individual Inventory Items that are Active on eBay, i.e. the Listing Period has not been exceeded.
Inactive Items / Variations This shows the Number of individual Inventory Items that are not Active on eBay, i.e. we are currently outside the Listing Period.
Matched Items This shows the Number of Items within this eBay Inventory that have been matched to Stock Items on your IRP.
Unmatched Items This shows the Number of Items within this eBay Inventory that have not been matched to Stock Items on your IRP.
Last Seller Listing Update This shows the last date and time when the Seller Listing was updated on this eBay Marketplace.
Last Seller Listing Download This shows the last date and time when a Seller Listing Download was performed on this eBay Marketplace.
Results
In the lower part of the screen you can search for inventory items and, if you expand 'Other Options' under the search bar, you can filter the search results according to whether they are Active, Inactive or both. The results are shown in the main grid.
You can adjust the Quantity Thresholds and either Unmatch ALL Items or, after checking the specific boxes for each item, Unmatch Selected Items by clicking either of those buttons.

Unmatched Items

Unmatched Items
SettingDescription
Unmatched Items
Automatic SKU Match Type Select the IRP field to try and match unmatched eBay Seller Listing Items to IRP Stock items. Set to 'None' if you wish to manually match unmatched Seller Listing Items to IRP Stock items. Fields include: IRP Stock ID, Part Code, External Stock ID, EAN 13 Part Code, UPCA Part Code and ISBN Number. Click the 'Attempt Match' button to carry out the matching attempt. To export the data, click the 'Export Items' button.
Upload Matching Template Upload a completed template of unmatched items downloaded from the 'Export Items' button. Only two columns are required in this file, 'ID' and 'StockID'. use the 'Browse' button to locate a template and then click the 'Upload Template' button to upload the file.

In the lower part of the screen you can see the items.

Inclusion / Exclusion Rules

Inclusion / Exclusion Rules
SettingDescription
Inclusion / Exclusion Rules
Type Use the drop-down list to select the appropriate Inclusion / Exclusion Type: Brand Only, Category Only, Brand-Category, Model or Stock. Depending on the choice you make here, you can proceed to enter details for the settings described below.
Brand Select the Brand associated with the Brand Rule.
Category Select the Category associated with the Category Rule.
Model ID Enter the Model ID associated with the Model Rule.
Stock ID Enter the Stock ID associated with the Stock Rule.
Inclusion Status Select either 'Exclude' or 'Include'.

Price Rules

Price Rules
SettingDescription
Add New Price Rule
Rule Name Enter the Name by which to identify this Price Rule.
Rule Type Select the Type of this Price Rule. Select from: IRP Price, IRP RRP, Discount(£) Off IRP RRP, Discount(%) Off IRP RRP, Discount(£) Off IRP Price, Discount(%) Off IRP Price, Minimum Margin, Allow Manual Set and Externally Managed.
Click the 'Add Price Rule' button when you are ready to save your configuration.
Price Rules
Here you can see the Price Rules that are currently configured. If you make any changes here, click the 'Update Price Rules' button.

In the lower part of the screen you can see the items.

Seller Listing Actions

Seller Listing Actions

Here you can search by date range and process type (Download Seller Listing and/or Revise Items). The results are shown in the lower part of the screen.

To see the details of an action, click the Details button. This will open a new window for the MarketplaceEbayServiceRequestDetails.aspx page, for example:

Inventory Details

Orders tab

Click the Orders tab and you will see the following details:

Marketplace Orders

Orders Summary
SettingDescription
Orders Summary
To populate the screen, click the Download Orders button.
Date of Last Order This shows the date and time when the last eBay order was placed.
Order Count This shows the total number of eBay orders that have been placed.
Rejected Orders This shows the total number of rejected eBay orders.
Sales Total This shows the total value of all eBay orders that have been placed.
Average Order Value This shows the AOV of all eBay orders that have been placed.
Tracking Updates (Orders) This shows the total number of tracking updates on eBay orders that have occurred.
Note that you can click the Update Tracking Details button where there are orders or items to update tracking details for.
Tracking Updates (Items) This shows the total number of tracking updates on eBay items that have occurred.
Note that you can click the Update Tracking Details button where there are orders or items to update tracking details for.
Order History
All the orders are listed at the bottom of the screen. To manage any order, click the Manage button.
If you want to ignore or un-ignore any of the orders, check the box on the right side of the row and click the Ignore / Unignore Selected button.

Rejected Orders

Rejected Orders

Here you can search by eBay Order ID or error detail. The results are shown in the lower part of the screen. You can see the eBay Order ID, Order Total, when the Order was placed and the Order rejection details.

Order Downloads

Here you see a list of orders that have been downloaded:

Order Downloads

The main grid shows the order ID, the date/time when the download was started and completed and whether or not the download was successful.

To see the details of any order download request, click the View Details button. This will open a new window for the MarketplaceEbayServiceRequestDetails.aspx?ServiceRequestID=XX page, for example:

Order Download Details

Automation tab

Click the Automation tab and you will see the following details:

Automation Tasks
SettingDescription
Stock and Price Update This task downloads the latest Seller Listing from the eBay Marketplace and updates the Price and Stock based on the configured Price Rules and Stock Source setting. Items that are no longer Active on your IRP will be Ended. Ended items that are Active on your IRP will be Relisted. Active items that are still Active on your IRP will be Revised. We recommend that you run this every 120 minutes.
Seller Listing Sync This task downloads the latest Seller Listing from the eBay Marketplace and syncs with the values in the IRP Inventory Items table. This helps to determine whether or not updates are required and should be performed once a day. The IRP assumes that if a successful Seller Listing Update has been performed, the changes are committed immediately to eBay therefore this task will pick up any instances where the Prices or Stock Levels have become out of sync.
Order Download This task downloads the latest Orders from the configured eBay Marketplace and updates or inserts them into your IRP. We recommend that you run this every 180 minutes.
Tracking Update This task synchronises tracking codes and carriers used for orders from this marketplace. It will either update order line items or overall orders depending on what has been set within your IRP. A 'Carrier Name - eBay' will need to be set within 'Shipping > Shipping Methods' for each shipping method used in eBay orders. Note that eBay tracking details will only be uploaded for orders or order items where there is a tracking code and the shipping method used has its 'Carrier Name - eBay' set.

Select the appropriate Repeat setting, check the Enable box and finally click the Update Automation Tasks button to save your configuration of the Automation Tasks.

You can see in the grid when the tasks were last attempted and completed. If you want to run a task right now, click the Run Task button.

Errors tab

You can view errors encountered with this eBay Marketplace by clicking the Errors tab. You will see the following details:

Errors

The main grid shows the error ID, Title / eBay API Call, message text and the date/time when the error occurred. You can search for any error and, if you expand 'Other Options' under the search bar, you can filter the results by Date Range. You also have the option to 'Delete Service Requests Older Than x Days Old' by entering the number of days and clicking the Delete Service Requests button.

Open
How to Create an eBay Developer Account

Copyright © 2020 IRP Commerce. Use of this website constitutes acceptance of the IRP World Terms of Use, IRP Reporting and Data Agreement, IRP Privacy Policy and IRP Cookie Policy

IRP Commerce Limited, Concourse 3, Catalyst, BT3 9DT, UK. Company Number: NI 041856. VAT Number: GB 888249658
A Deloitte Fast 50 Company eight times: 2010, 2011, 2012, 2013, 2014, 2018, 2019 & 2020