Zedonk eBay Integration Manual

Octopus Bridge Intro

Octopus Bridge is an application that enables brick & mortar retailers to connect their ERP system with their e-commerce website and online marketplaces.

The flowchart below shows Octopus Bridge linking Zedonk data to online stores and marketplaces. It also shows the item information uploaded from ERP to E-commerce and order quantity pushed back to Zedonk from the e-commerce platform so that the stock can be in Sync.

After you sign-up with Octopus Bridge, you will be given the login details. Login details are your username and Password. You can login to your account at http://gui.octopusbridge.com/octopus

Once you login to Octopus Bridge using your login details, you are automatically redirected to the Product Management tab where you will be able to see all the items uploaded from the ERP.

My Products

When ERP items are uploaded into Octopus Bridge, they show up under ‘My Products’ tab in the Product Management module. This is where a user can further modify the products before they are pushed to an E-commerce platform.

The topmost item or the first item displayed on this page is the last item uploaded from the ERP. Example shown below: The item with Product SKU number ‘7909510673809’ is the last item uploaded from the ERP.

In the product management module, a user can perform the following actions:

1. Advance Search: To view advance search, click on the + button on top right corner of the screen.

2. Push Products to Shopping Cart: To push products to the shopping cart.

3. Select All Pages:This will Select all the products listed under the Product Management module

4. Items Per Page: This will allow selecting the no. of items you want to display per page.

5. Select All Items on the Current Page: Clicking on this checkbox will allow you to select all products on the current page.

6. Edit Product: Click on Product SKU or Product Title to edit product information.

7. Delete Product: To delete a product, click on the checkbox in front of that particular product and click on the “Delete” icon located on the right side of the screen.

8. Archive Product: To archive a product, click on the product(s), you want to archive and click on the delete button below.

9. Select Item(s): To select one or multiple items, click on the checkbox in front of it.

Advance Search

You can search for a specific item with the following search criteria:

• Source Category
• Item SKU
• Item Description
• Item Keyword
• Parent SKU
• Brand
• Marketplace
• Item Status
• Location
• Style
• In stock?
• Supplier
• Date Added
• Price Range
• Stock Level
• Image Status
• Custom Fields
• Store

If Product items are not shown after doing a search, it means that the product item is not yet synced from the ERP. Also, make sure that in searching items, you are using the correct Item SKU or Parent SKU. Example below shows that the item is not yet found in Octopus Bridge.

Edit Product

Clicking on Product SKU or Item Name will redirect you to the ‘Edit product’ page. This is where you can edit products’ information that are linked from the ERP to Octopus Bridge. You can perform the following actions in Edit Product page:

1. Edit Product Name: You can create new product name to be displayed in your E-commerce platform. Make sure to click on the box to prevent over-writing Product Name from the ERP.
2. Create Parent SKU: Make sure to create a Parent SKU for creating matrix items.
3. Create Product Description: If you want to create a new description to be displayed in your E-commerce platform, make sure to check this box to prevent ERP description from over-writing description in your E-commerce platform.
4. Matrix item attributes: If you are creating a matrix item, make sure to input Style Name and Style Value.
5. Upload Product Images: You can upload up to five images per item in Octopus. Make sure to reload page after uploading image/s.

Import Products

If you do have a point-of-sale system or want to quickly edit items by Exporting / Importing multiple items, Import Products is a great option.
1. Click Add New Template to start.
2. Click History to select a file previously uploaded on Octopus Bridge.
3. Click Import New to import a new template after it has been created.

4. Actions:

• Notify– you can type in your email to get notifications if modifications are being made in the file.
• Modify– click to update files.
• Delete– delete existing files from the list.

Add New Template

You can view the past import activities in the channel by clicking on Import History.

1. File Type: Select the File Type from the dropdown.
2. File Name: Type in the name of the file you wish to create.
3. Column Delimiter and Text Qualifier: Use only if file type is a text file.
4. Save file after choosing the file type and the file name.

POS Code Mapping

You can use POS code mapping if you want to map ERP values to octopus bridge values. ERP values are commonly in a coded format. For example,blk. You need to set blk into black which is more understandable for users viewing the website. You can also map multiple values at the same time using a spreadsheet format.

1. POS Code Upload Format: You can download the excel format by clicking on the “POS Code Upload Format” link.

2. Choose File: Once you have made changes in the excel format, select spreadsheet file to upload.

Click on upload after selecting file.

Select Field Name.

3. Replace All Value: Click to replace value after selecting Field Name.

4. Item per Page: Clicking this will create a drop-down box where you can select how many product items to be displayed per page.

5. Search: You can search specific value using the search bar.

6. Channel Value: Edit Channel value here.

Publish Items to Shopping Cart/Marketplace

After you update item information under ‘Edit Item’ page, you can go ahead and publish this item/s to a specific Shopping cart or Marketplace. Please follow the steps below to publish.

1. First you need to select which item/s you want to publish. In the example below shows we are selecting three items.

2. Next, select which Shopping cart or Marketplace you want to publish the item. In the example below we are selecting Shopify as our shopping cart.

3. Then click on the Add icon on the right to publish. Once you are done, items can now be viewed under the Shopify ‘bucket’

Note: Only Shopping carts and Marketplaces that you signed up for, will be shown in My Products page.

Shopping Cart Module

Once you have selected and added your product items to a specific Shopping cart module or Marketplace module ‘bucket’, they will start appearing under the respective bucket. Images are shown below.

Marketplace Tab:-

Shopping Carts tab:-

 

Logs

You will be able to view all the Octopus Bridge activities and errors in the ‘Logs’ tab.

1. You can search logs on a specific date period or search using a keyword in the search tab at the top.
2. You can export logs to a CSV in your local drive.
3. You can view Log details by clicking on the ‘view’ button on the right-hand side of the screen.

Log Details is where you can view the log activities or the error details in the channel.

Generating eBay API Keys

A eBay API Key is necessary to connect your eBay store to Octopus. Please follow the steps below to create an API key.

• Sign in to your eBay Developers Program account.
• Go to the Application Keys page.

• In the Application name , enter Octopus.
• Click on Create a Keyset.
• Keyset will be generated and will be displayed like below:

• Click on Generate Tokens.
• In the Generate Tokens screen, select Production in Environment and click on the Sign in to Production button and login to your eBay seller account.

• The token will be generated and displayed here:

Connect Octopus to eBay

• Go to https://gui.octopusbridge.com/octopus
• Login using user octopus account credentials.
• Once you have logged in, go to Marketplace/eBay.

• Click on Settings.

• In the API ID field, enter the eBay API ID from the keyset Window.
• In the Dev ID field, enter the eBay Dev ID from the keyset Window.
• In the user token field, enter the eBay user Token.
• In the Credential field, enter the eBay Certificate ID from the Keyset Window.
• PayPal Email ID: Enter the PayPal email ID of mentioned in the eBay seller account.
• Sync Status: Select Enable.
• Download Order Date: Enter the date from which you want the orders to be downloaded to Octopus.

eBay Products

In Product Management, when an Item is selected to be published to a Marketplace platform, it is first sent to the specific Marketplace. SCM for each supported shopping cart, including marketplaces such as eBay, Amazon and eBay, gives users the ability to define shopping cart specific rules.

These rules may vary based on the eCommerce platform that you are using. For example, Items being sent to eBay may have a different Product Name, Prices, and Quantity as compared to items being sent to eBay.

Whereas ‘Product Management’ module shows all the products uploaded from the POS, eBay Product module shows only those items that are actively synchronizing with eBay.

• Hover your mouse to the Marketplace tab.
• Select eBay under the dropdown menu
• Click on eBay products.

• This screen shows items that have been enabled to sync with eBay and should already be in sync. To manually publish items to eBay, Select All Pages and Publish.
• You can also use Check Boxes to select a specific item to publish.
• Product SKU: The dot is an indicator if a product is successfully synchronizing with the website. Green means successfully added while red means it is not successfully synced. If Red, you can use the Log files to troubleshoot.
• Add Product to eBay: This button allows you to add products to an eBay website.
• Search tab: This tab allows you to search for a specific item by entering the product SKU or keyword.
• Item per Page: Clicking this will create a drop-down box where you can select how many product items to be displayed per page.

Master Categories

• Hover on Categories and click on Master Categories.

From this page, you can search for any eBay category and save it to the octopus database by clicking on the checkbox adjcent to it.

Map Categories

When items are uploaded from a POS into Channel, they are uploaded with POS Department & Category structure. At the Channel level, it’s called Source Categories.

POS Category structure may or may not be the same as eBay Categoy structure.

This option allows to map POS category structure to eBay Categories so that POS items are placed in the right category when loaded into eBay platform.

• The Left hand side shows the POS category structure.
• Department & Categories downloaded from eBay are shown on the right hand side with a drop-down box.
• The drop-down menu shows mapped and unmapped categories. To map additional categories, click unmapped categories from the drop-down menu, then select which category to map.

Orders

You can manually download orders from eBay on a specific date period. Just type in the ‘Date From’ and ‘Date To’ then click the Download Order button.

Categories

Categories tab is where you can add categories, assign categories to products and map categories with POS categories. It has four subsections: Master categories, Map categories, Update Product Categories, and Ebay Category Fields.

Master Categories

You can search for a specific category and set certain categories or subcategories in the Octopus. Once you select and click in the box, the category will be added to Map Categories section under Ebay categories.

Map Categories

Before items can be published on ebay, we must map source department/category structure to that of ebay category structure. Some ebay categories have unique requirements. So, they must be met before items can be published.

1. Source Categories: Left hand side shows POS category structure.

2. eBay Categories: Right side shows Ebay categories added from the Master categories.

3. You can show number of entries by clicking on the drop-down menu.

4. Click on the Mapped Categories drop-down menu to select Unmapped Categories. This will show a list of all Source Categories that need to be mapped with ebay. For each Source Category on left hand side, choose an appropriate ebay Category from the drop down.

Update Product Categories

1. You can search product item by typing in Name, SKU and Parent SKU.
2. Select Category available categories on the drop-down menu then Click Update Products Category.
3. Check the box to select item/s to update.

Shipping Profile- Master Settings

• Hover on Shipping>> Master Settings.

In this page, you will be able to:

• Select your domestic and international shipping providers
• exclude any locations from Shipping
• Select Shipping package type
• Add Shipping weight details and originating post code
• Add Tax and Shipping charges

Return Policy Profile- Master Settings

• Hover on Return Policy Profile and Click on Master Settings.

Here, you can set the return policy.

Templates

Here you can select the eBay product listing template. Just enter your template name, select your relevant product category and check the box and then press on save template button.

Map Attributes

• Merchants using various POS systems may use any of the fields within a POS while creating items.
• Map Fields option allows a merchant to map eBay Price field with their own POS Price fields.
• The left-hand side shows the eBay Price field whereas the right-hand side shows the POS fields.

Custom Rules

In the Custom Rules tab, product-specific rules should be defined before the items are set up to sync with eBay. Once done, all items synchronizing with eBay will inherit these rules. rule(s) set here will be applied to all the products being uploaded from Channel to eBay.

Custom Title: This feature allows you to create a search engine-friendly Product Name by combining multiple fields. For example, you may want to use Product Name and Brand fields from POS to create a unique eCommerce product name, resulting in Product Name by Brand.

• Click on Add Fields.
• Select a field, such as Product Name
• Enter Separator, such as, By
• Click on Add
• Once again, click on Add Fields
• Select another field, for example, Brand
• Remember to remove the ‘Enter Separator’ from before
• Hit Add

Going forward, before an item is sent to eBay, this rule will combine the fields to create a unique name. If left blank, Custom Title does not apply.

Safety Net Rule: The quantity inserted in this box is reduced from the Product Management stock. For example, if a Product Management item quantity is 50 and you insert 10 in the ‘Enter Value’ field; in eBay, the quantity of the item will be shown as 40.

Extended Description: This custom rule will be used to used to add extended description to the products.

Payment Instructions: This custom rule will be used to add Payment instructions for the customer.

SKU pre-checking: Select this rule, if you want to check if the SKU already exists in eBay before creating a new product. This will slightly slow down the process.

Currency Type: Use this custom rule to select your Currency Type.

Country: Use this custom rule to select your country.

Item Location: Select this custom rule to select default item location.