Product Integration | eBay

Product Integration | eBay

Introduction

This article has been written to aide with setting up the Kornit X Product integration with the Ebay platform. This This type of integration allows you to send products from the platform to Ebay connected via the advanced settings of your product categories. 

An existing account with Ebay will be needed to enable this integration, without this the integration is not going to work, To enquire with using Ebay please refer to the following link - Click Here

How To Prepare Categories For Integration Setup

The first step here is to locate the category of which you want to set this integration, naming the parent category "Ebay Integration" would be a good starting point so its clear what the category is. To set the integration simply click the category and the menu below will be shown.

The category this eBay integration is set on must be the "Top Level" category, where all configured products should be stored. 
With the integrations simply click into the integrations and select "Ebay" from the list as shown below. 

We would advise creating a category structure exclusively for the product you are planning to send to Ebay, with this sorting it will be easier within Platform to add products to the relevant categories. For more information on perfect category management within the Kornit X platform please refer to this article - Click Here

Details Needed To Enable Integration

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. 
We would advise creating a category structure exclusively for the product you are planning to send to Ebay, with this sorting it will be easier within Platform to add products to the relevant categories. For more information on perfect category management within the Kornit X platform please refer to this article - Click Here

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. 

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.
  2. The Seller Location should also be filled in, this location should be find within a users eBay Seller Account.
  3. 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.