Product Integration | eBay

Product Integration | eBay

This article has been created to show how to setup the Product Integration that Kornit X has built to connect to eBay. 
The product Integration can ONLY be set once the eBay Sales Channel Integration has been set and all products are fully configured.

Product Functionality Setup

There are multiple product pre-requisites that must be set for the Integration to work.
Currently eBay ONLY supports text personalisation with 1 line of text. 
These include the following,
  1. The text area should be named "Text".

  1. The Text area should have a Maximum Character value set.

  1. Each product must have valid Retail or RRP pricing added to the pricing tab. The currency should match that set within the eBay account and your seller should be set to "Any".

For more information on some FAQs relating to product setup with the eBay product integration, click here

Product Category Configuration

Products must be categorised in a specific way to work within the eBay product integration. A break down of the exact category setup can be found below. 
  1. Each product must be added to the Top-level category folder. We suggest setting up a new category just for eBay products to be able to work with this. 
To note, the category selected will later be used to setup integration so make sure these match. 
  1. On top of being in the top level category, products should also be added to a sub category of your eBay category. Within this integration the category name will be mapped to the appropriate eBay category ID and will determine which category the product is pushed to on eBay. 
  2. For example, with a selection of products, users could make sub categories for the product types such as Mugs, Plates etc. 
  3. A suggestion for category setup would be to use unique names to ensure the integration does not conflict with any similarly named categories. 
An example of the ideal product category setup can be found below, this is unique for one item. 

Products can ONLY be pushed to one category in eBay
Category names should not contain any special characters. Examples of this include "?", "!" or "&".

Attribute & Ecommerce Data Setup

Products must have attributes set to work with the specific product integration. eBay requirements include EAN, Brand, Material, Colour, Size etc. A current list of the requirements can be found here - Link

Some of the data can be set within the Ecommerce and Data Tab. These include the following options.
  1. EAN number is taken from the Ecommerce/Barcode.
  2. Brands is taken from the Ecommerce/Brand Name.
  3. Condition will automatically be added as New. 
The remaining product data should be added to the products as Attributes. To set these please take the name from the example file linked, the value can be taken from the "normalised tag" row (3). 

To specifically target a marketplace, users need to add the country prefix to the start of the attribute name like the following examples
  1. gb_colour (UK Marketplace)
  2. de_colour (DE Marketplace)
 The above marketplace prefix does not apply to these following attributes as these are universal around the globe - EAN, ISBN, MPN & Brand.
For more information on how to add attributes, click here

Product Field Mapping Setup

Products can be set with field mapping, this is not a necessity but should be set if users have products that do not contain purpose built text areas. 
Within orders, eBay will always submit the personalisation over to Kornit X as "Text". To ensure auto-convert to print job is working, where possible users should always name Text Areas as "Text". If this however, not possible users should add Field Mapping at a product level. There are 2 methods to set field mapping and these include the following. 
  1. Manually adding the field mapping into the Ecommerce & Data/ Field Mapping tab. 
For more information on how to add individual field mapping please refer to the article linked here
  1. Importing the field mapping via the purpose built Field Map Import. 
For more information on the import, please refer to the following article linked here. 

Basic Integration Setup

To setup the eBay integration, please head to the category and within the advanced settings cog wheel head to "Integrations" and click to enable the "eBay" option. 
The category this eBay integration is set on must be the "Top Level" category, where all configured products should be stored. 
To be able to access this integration, users must have their "App ID", "Dev ID", "Cert ID" and "Redirect URL Name" which they need to enter into the integration setup page. 

Once this information has been provided users must click the "Get OAuth User Access Token" option. Clicking this will take users to their eBay Account Log in page. Users must then enter their eBay login details.

Once logged into the eBay account users can then input the following unto the integration set up window.
  1. User Access Token
  2. User Access Token Expiry
  3. Refresh Token 
  4. Refresh Token Expiry

Once all of the above has been followed, users can click save and the eBay product integration will be enabled. 

Enabling Advanced Settings
The eBay Product integration requires some specific Business Police Profile IDs and this part of the article will explain what to add, and where to get this information from the users eBay account. These have been listed below. 
  1. Within the Configuration page, select your Market (site ID) country from the available list. 

  1. The Seller Location should also be filled in, this location should be find within a users eBay Seller Account. 

  1. Users should then enter their Payment Profile ID, Return Profile ID, Shipping Profile ID and Currency which should all match what is set within their eBay seller account. Without matching what in the seller account this will not work. 

To locate these settings, head to My eBay > Account >Selling and select Business Policies. The relevant policies will be seen and users should copy and past the ID numbers into the integration. 

Category Mapping Setup

The eBay Integration required a Category Map which needs to map the Category Name to the appropriate eBay category ID. The category map determines which category the Products are pushed to on eBay.
Please note, products can only be pushed to one category in eBay.
The format of the mapping should be set like the following example - "Catalog Product Category Name": "EBAY CATEGORY ID". 
The exact eBay Category ID needed can be found within the category charts sheet found under column D here.

Text Personalisation Template

The text personalisation template is set up to control what will appear on the eBay website above the Personalisation Box. This has been shown below within the eBay website.

This message can be copied from the Kornit X example or users can enter their own message to the customer. This message is to be set to prompt their customers to only enter up the the max character limit. Below is an example that can be copied, just needs a numerical value added to the {characters} section.
  1. "Make it their own and personalise now! (Max {characters} characters)"
Please note, customers will be allowed to enter up to 250 characters as that is the limit controlled by eBay directly. If a customer exceeds the max character limit the order will arrive into Order Manager as QC Query which will allow users to either change the text or contact the customer. 
    • Related Articles

    • Sales Channel Integration | eBay

      Introduction This article has been created to show how to setup the sales channel integration Kornit X has built to connect to eBay.  What can be achieved with the eBay Sales Channel Integration The eBay Sales Channel Integration has been set to make ...
    • New Integration Type: Product Integrations

      Introduction Here at Kornit X we have developed a new type of integration to send your products to other marketplaces and API channels connected via the category structure.  What Are Product Integrations? The point of product integrations is that if ...
    • Product Integration | Salesforce

      Introduction This article has been created to show how to setup the Product Integration that Kornit X has built to connect to the Import Only Salesforce integration.  Setup To setup the Salesforce (Import Only) integration, please head to your ...
    • Product Integration | Generic API

      Introduction This article has been created to show how to setup the Product integration Kornit X has built to connect to Generic API.  Setup To setup the Generic API integration, please head to your category and within and within the advanced ...
    • Product Integration | Channel Advisor

      Introduction This article has been created to show how to setup the Product Integration that Kornit X has built to connect to Export Only Channel Advisor integration.  Setup To setup the Channel Advisor (Export Only) integration, please head to your ...