Magento 2 Etsy Integration – User Manual

1.0 Introduction

Etsy Magento 2 Integrator offered by Knowband is the fastest means to integrate the store with the marketplace. The Etsy Magento 2 Integration extension offers a bi-direction synchronization between the store and the marketplace.

If you own a Magento 2 eCommerce site and are looking to expand the reach of your business that listing your products on the popular marketplaces is inevitable. The Magento 2 Etsy marketplace Integration extension automates the process of store integration. The admin can easily list the products along with their details and make changes in the same from the back-end of the Magento 2 Etsy integration module. The orders received from the marketplace can be synced with the orders of the store by executing cron in the admin interface of the Magento 2 Etsy integrator by Knowband.

Note: “The term ‘Etsy‘ is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.

1.1 Merchant Benefits of Magento 2 Etsy integration:

  • Magento 2 Etsy Integration plugin offers automatic synchronization.
  • The profile-based listing of the Etsy Magento 2 integration module allows the admin to list the products in bulk.
  • The Magento 2 Etsy connector offers an option of secondary language to the admin. The multi-lingual compatibility adds to the ease of trading.
  • The Magento2 Etsy integration extension offers multi-currency compatibility as well.
  • The admin can add shipping methods as per their convenience and sync the same with the marketplace with the help of Magento 2 Etsy API integration plugin.
  • The Etsy Magento 2 API integration extension even allows the admin to add N number of shipping entries with each shipping templates.
  • Profile-based listing of Etsy Magento 2 integration plugin allows the admin to upload and the edit the products in bulk.
  • The real-time synchronization of theEtsy Magento 2 Integrator allows the admin to manage the inventory with ease.
  • The admin can easily upload the product variation, renew, edit or remove the products with the help of Etsy Magento 2 integration extension.
  • The Magento 2 Etsy integration module creates order in the store as per the orders received from the marketplace. The orders can be processed from the single interface.
  • Even the order status can be changed and synced with Magento 2 Etsy integrator.
  • The error occurred while product listing or cron execution can be easily tracked from the back-end of the Magento 2 Etsy integration module.

1.2 Installation

Follow the following steps in order to install Magento 2 Etsy integration extension in your store:

1. Download the Magento 2 Etsy Integration module package from Knowband store.

2. You’ll receive a zipped file containing the user manual and the source code of Magento 2 Etsy Integration plugin. Unzip the package.
3. Create a folder {Magento root}/app/code/Knowband/Etsy
4. Upload the extracted content in the above folder via FTP manager (like Filezilla or WinSCP – download here: http://filezilla-project.org/).
5. Now run below commands to install the plugin:

  • php -f bin/magento module:enable –clear-static-content Knowband_Etsy
  • php -f bin/magento setup:upgrade
  • php -f bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy

6. In Admin Panel go to the main menu -> Knowband -> Etsy.
7.The Magento 2 Etsy Marketplace integration extension is now ready for use.
This User Manual will guide the users through the Etsy Magento2 Integration extension configuration and settings.

2.0 Etsy Marketplace Integration- Seller Account Setup

To start selling on Etsy Marketplace you need to have a seller account on Etsy. In this section, we are listing all the steps to create a seller account on Etsy. Please find them below –

  • Go to the link
  • Click on the “Open your Etsy Shop” button on the page you are visiting now by following the link given in the first step above or you can refer the screenshot given below.

  • It would open a Pop-up as shown below. Click on the “Register” tab.

  • After filling up the registration form, click on “Register” button. It would create your seller account and send a verification email to the provided email address. It would also redirect you to another page as shown below.

Now, it is asking for setup your shop preferences. Complete all the highlighted sections – Shop Preferences and Name your shop, Stock your shop, How you will get paid and Set up Billing.

That is it.

2.2.1 Etsy Marketplace Integration- Setup an App

To start communication between Magento Store and Etsy Seller Account, you need to create an App on Etsy Marketplace. Following are the steps to create an App on Etsy –

  • Go to the link
  • It would open a page where a form will be shown with few input fields as shown below.

um-etsy

  • Fill up the form and click on “Read Terms and Create App”. Please make sure that you left the “Inventory Management Compatibility” checkbox is checked.
  • It would ask to accept “terms and conditions”. Accept and click on “Create App” button.
  • It would register your App on Etsy Marketplace and provide API details as shown below.

3.0 Admin Interface

The admin Panel of Magento 2 Etsy Integration module contains the 9 tabs for settings.

  1. General Settings
  2. Shipping Templates
  3. Shipping Templates Entries
  4. Profile Management
  5. Product Listing
  6. Order Setting
  7. Order Listing
  8. Synchronization
  9. Audit Log

magento-2-etsy

3.1. General Settings

The connection between the Etsy marketplace and the Magento 2 store is established in the General Settings tab of the Magento 2 Etsy API integration extension. The various input fields are discussed below:

General Setting

1. Enable the Extension
Toggle this button in order to enable the Etsy Magento 2 API integration extension. If enabled, the module and all its settings will be working on the store.

2. Etsy API Key
Enter the obtained Etsy API Key in this section. This will authenticate the connection between the Magento 2 store and Etsy Marketplace.

3. Etsy API Secret
Enter Etsy API Secret Key here. It is mandatory for authenticating the integration between the site and the marketplace.

4. Etsy Default Language
Select the default language from the drop down menu. In order to retrieve the language in this section execute the ‘Language Synchronization’ cron. (See Section 3.8)

5. Languages to Sync
Magento 2 Etsy Integration extension is multi-lingual compatible and offers an option to choose the secondary language. Choose the language used for synchronizing the product. The selected language should be anything other than the default language.

Once you have filled all the required fields, click on the ‘Save Settings’. A ‘Connect’ button will appear once the changes are saved. In order to establish the connection between the site and the marketplace, click on “Connect” button. It would redirect admin to Etsy Marketplace to allow the App Access to the store. Click on the “Allow Access” button as shown below.

Follow the above-mentioned steps and the connection will be established between the store and the Etsy Marketplace.

The user will then be redirected to the admin interface of the Magento 2 Etsy Marketplace Integration module. The ‘Connect’ button will be replaced with “Disconnect” button.

Note: Once the connection is set-up, execute the Country/Region cron in the synchronization tab of the Magento 2 Etsy Integrator. The cron job will sync the country list in the database. (See section 3.8.)

3.2 Shipping Template Settings

Magento 2 Etsy Connector allows the sellers to add shipping templates as per their requirement. The admin can manage, edit or add new shipping options in the Shipping Templates tab of Magento 2 Etsy Synchronization extension.

3.2.1 How to add Shipping Templates?

Click on ‘Add New’ in order to create new shipping templates as shown below:

etsy-shipping

The shipping template creation page of Magento 2 Etsy integration includes the following input fields:

shipping

Shipping Template Title: Enter a unique name or title for the Shipping Template.

Origin Country: Choose a country from the list that you want to set as an origin country of the shipment.

Primary Cost: Enter the primary cost for the order shipment. You can set it only once.

Secondary Cost: Secondary cost will be changed on every additional item that is to be shipped. Enter the shipping cost for each additional item. You can set it only once.

Minimum Processing Days: Enter the minimum number of days after the order is placed when the shipment will be initiated.

Maximum Processing Days: Enter the maximum number of days after the order is placed when the shipment will be initiated.

3.2.2 How to Edit/Delete the existing Shipping Templates?

The admin can edit or delete the shipping templates from this tab of the Magento 2 Etsy Integration module. The created shipping templates will be listed as shown below. Click on the Edit or Delete button corresponding to each shipping template for performing the respective action.

edit-shipping

3.2.3 How to Add the Shipping Entries?

Each shipping template can have multiple shipping entries. In order see the shipping entries in a particular shipping template, click on the ‘View Shipping Entries’ button.

view-entries

This will redirect you to the shipping entries page as shown below.

shipping-entries

The admin can even add new shipping template entries by clicking on the ‘Add Shipping Template Entry’ button.

Click on the Add New Entries button in order to create new entries.

add-entries

This will redirect you to the shipping entry creation page of the Magento 2 Etsy Integration module.

etsy-entries

Shipping Template Title: The template title in which you want to add the entries will be displayed in this section.

Origin Country: It will remain same as selected in the shipping template.

Destination Type: Select destination type of the shipment. It can be a Country or a Region.

Destination Country: Select the destination place of the shipment here.

Primary Cost: Enter the primary cost of the shipment.

Secondary Cost: Enter the secondary cost that will be charged for each additional item.

3.3 Shipping Template Entry

The admin gets an option to see all the shipping entries in the shipping templates in this tab of Etsy Magento 2 integration extension.

shipping-entry

In order to edit or delete the shipping entries, click on the Edit or Delete button respectively corresponding to each shipping template.

edit-template

3.4 Profile Management

Magento 2 Etsy integrator allows the admin to list the products in bulk with the help of profiles. The admin can create profiles in this tab of the Magento 2 Etsy connector. The profile-based listing allows easy attribute and category mapping.

3.4.1 How to add a new profile?

In order to add new profiles, click on the ‘Add New’ link as shown in the image below.

add-profile

The link will redirect you to profile creation page. The various fields are discussed below:

Profile Title: Enter a unique name for the profile.

Etsy Category: Select an Etsy Marketplace Category to list the attributes. The Magento 2 Etsy Marketplace integration allows the admin to map a single category of Etsy with multiple category of the store.

Attribute Mapping: Map the selected Etsy Marketplace attributes to the store’s attributes in order to list the variations on the marketplace.

Store Categories: Check the category of the store that you want to map with selected category of the Etsy Marketplace.

Shipping Template: Choose a Shipping Template from the drop-down list. The customer can avail the selected shipping options. In order to list the shipping templates execute cron job in the Synchronization tab of the Etsy Magento 2 Integration extension.

Etsy Currency: This currency should be same as the currency of your Etsy Admin panel, you can check the Etsy currency in Finances -> Payment Settings -> Currency.

Customized Product Title: Customize the product title by using the following place-holders. Place-holders like {sample} will be replaced by dynamic content at the time of execution.

  • {id_product} for Product ID
  • {product_title} for Product title
  • {country_of_manufacture} for Country of Manufacturer
  • {sku} for Product SKU
  • {weight} for Product Weight
  • {short_description} for Product Short Description
  • {price} for Product Price

Sync Property: Select the properties to sync with the Etsy Marketplace. This will work while updating the product and its variations.

Enable to enter minimum quantity: If enabled, the item will not be listed if the quantity is below the specified limit.

Enable to enter maximum quantity: If enabled, the quantity of the item will be displayed as the specified limit even if it’s higher.

etsy-profile

Is product a customizable product?: Enable if the product is customizable.

Who Made: Specify who made the products. The options are listed in the drop-down list.

When Made: Select when this product was made.

Is Supply?: Specify if the product is the product is supply product or not.

Recipient: Select the Recipient of the product

Occasion: Specify the Occasion (if any) for which the product is intended.

profile

3.4.2 How to Edit/delete a new profile?

edit-profile

The admin can edit or delete the profile from this section of the Magento 2 Etsy Integration module by clicking on the Edit or Delete button respectively.

3.5 Product Listing

This section of the Magento 2 Etsy Integration plugin shows the list of all the products listed on Etsy Marketplace with their statuses. In order to sync the product in the Etsy Marketplace, execute the Product Synchronization Cron in the Synchronization tab (See section 3.8.). The variations of the products can be synced with the marketplace by executing Product variations Synchronization.

product-listing

Along with the listed product, this section offers a number other options to the store admin. They are discussed below:

Renew the Products

The admin can renew the expired products from by clicking on the “Renew” action corresponding to each product.

After setting up a product for renewal, action “Renew” will be replaced with “Halt” action. This action is used to stop product renewal in case needed.

Delete the Products

Click on “Delete” action given corresponding to each product listing in order to remove the product from the listing. After setting up a product for deletion, action “Delete” will be replaced with “Relist” action.

View Error

The admin can view the error occurred in listing the product. For this, click on ‘View Error’ action. If any error is encountered while product listing, then, the same is shown in the popup. Otherwise, the message, ‘No Listing Error Found’ will be flashed.

error-message

3.6 Order Settings

Order Settings tab of the Etsy Magento 2 Integration extension allows the admin to map the order statuses with Etsy Marketplace order statuses. The admin can select the order statuses and sync the same with the marketplace by executing the Order Status cron in the Synchronization tab. (See section 3.8)

The various fields are discussed below:

Order Default State: Choose a order default status from the drop-down menu.
Order Paid State: Choose the order state for the paid orders placed on Etsy marketplace. The selected option will be displayed in the marketplace as well.
Order Shipped Status: Choose an order state for the shipped orders on Etsy marketplace.

Note –

  • Default status is the first status of the order when it is placed on the store.
  • Paid status means that payment for the order has been made and accepted.
  • Shipped status means that ordered items have been shipped.

order-status

3.7 Order Listing

The order listing tab of Magento 2 Etsy displays the list of orders placed received from the marketplace. To obtain the list of the order, execute the Order Synchronization cron. (See Section 3.8)

order-listing

In order to check the order, click on ‘View Order’.

The admin gets to see the following details of each order.

It offers the basic information like order date, status, billing and shipping address, payment information, gift options, item ordered, comments history.

The default order view page is shown below:

order-detail

  1. Invoice: The admin can generate the invoice for the orders received from here. This will initiate the processing of the order. Execute the Update Order Status on Etsy cron and the status of that order will be updated in the Etsy Marketplace.
  2. Credit Memos: Change the status of the credit here.
  3. Shipments: The admin can update the shipment details, that is, the name of the name of the shipment, date and the quantity of Shipment.

3.8 Synchronization

Magento 2 Etsy Synchronization extension offers a bi-directional connection between the store and the marketplace. The products, shipping options and their details can be listed on the marketplace. The admin can sync the order from the marketplace to Magento 2 eCommerce site.

This section of Magento 2 Etsy API integration module offers various cron options. The store synchronization can be carried out by executing cron.

The various jobs to synchronize content between Store and Etsy Marketplace are shown below –

synchronization

3.8.1 How to sync Countries/Region?

Follow the steps below to synchronize Countries/Region on Etsy Marketplace –

  • Goto the Etsy Marketplace -> Synchronization tab (Main Menu)
  • Click on “Sync Countries/Region” button shown below.

country-sync

It would perform following actions –

  • The cron will get all the countries with their country ID and ISO code and save into database.
  • Once the cron is executed, the countries and regions in the database and the admin can select the countries accordingly.

3.8.2 How to sync Shipping Template on Etsy Marketplace?

Follow the steps mentioned below to synchronize Shipping Templates on Etsy Marketplace –

  • Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
  • Click on “Shipping Template Synchronization” button shown below.

shipping-sync

It would perform following actions –

  • It will sync new shipping templates along with their Entries on Etsy.
  • It will update the modifications made in the Shipping Templates and their entries on Etsy
  • It will remove the deleted shipping templates and their entries from Etsy.

3.8.3    How to sync Products on Etsy Marketplace?

Following are the steps to synchronize Products on Etsy Marketplace –

  • Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
  • Click on “Sync Products” button shown below.

product-sync

It would perform following actions –

  • The cron will update the profile-based product listing.
  • It will add products on the Etsy Marketplace with the respective product details (e.g. Price, Quantity, Image etc.).
  • It will update the changes made in the products that are already listed on Etsy marketplace.
  • It will renew the expired products on Etsy Marketplace for the items in which ‘Renew’ action is initiated.
  • It will remove the products from Etsy Marketplace which are marked deleted on Store.
  • It updates Listing Status of each product listed on Etsy Marketplace.

3.8.4    How to sync Products Variation on Etsy Marketplace?

Following are the steps to synchronize Products Variation on Etsy Marketplace –

  • Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
  • Click on “Sync Products Variation Listing” button shown below.

variation-sync

It would perform following actions –

  • The cron execution will add Products Variations on Etsy Marketplace.
  • It will update Products Variations which are already listed on Etsy Marketplace.
  • It will remove the Products Variations on Etsy Marketplace that are marked as deleted on the Store.

3.8.5    How to sync Orders received from Etsy Marketplace?

Follow the steps below to synchronize Orders from Etsy Marketplace –

  • Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
  • Click on “Sync Orders” button shown below.

order-sync

It would perform following actions –

  • The orders and their details received from the marketplace is synced with the Magento 2 store by executing this cron.
  • It creates Shipping Carrier options into the store as per the details of the order coming from Etsy Marketplace.
  • It creates Orders into the store as per the details coming from the Etsy Marketplace.
  • In addition, it sets the order status as per the configuration settings updated in “Order Settings” tab of this Magento 2 Etsy Marketplace Integration module.

3.8.6    How to sync Order Status with Etsy Marketplace?

In order to sync the order status, follow the steps below:

  • Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
  • Click on “Update Order Status on Etsy” button shown below.

order-status-sync
It would perform following actions –

  • The action syncs the order statuses as specified by the admin with the marketplace.
  • The cron checks if there is any status update recorded by the Magento 2 Etsy Integration plugin for any Etsy Order. The updates are then synchronized accordingly.

3.8.7    How to sync Language on Etsy Marketplace?

Following are the steps to synchronize Language to Etsy Marketplace:

Goto the Etsy Marketplace ->Synchronization tab (Main Menu)
Click on “Sync Translations” button shown below.

lang-sync

It would perform following actions:

In case there is any product or category details in different languages, then, the same will be synchronized in the Etsy marketplace. The Magento 2 Etsy Integration offers multi-lingual support.

Note:

Once the synchronization is completed successfully, then, a message will be display – “Synchronization completed” else “Synchronization failed” will be flashed.

3.9    Audit Log

The Audit Log section of the Magento 2 Etsy integration extension contains the list of the tasks. The status of the same can be viewed here. The errors (if any) occurred while executing the jobs can be checked here.

audit-log

 

Module Link: https://www.knowband.com/magento-2-etsy-marketplace-integration

Admin Demo Link: 

https://ma2demo1.knowband.com/manager/admin/index/index/key/f750a985d241938d38ba1a07759566336f3ef3c27b6a61a5d4db84d6e0914e18/

Joe Parker

We boast of the best in the industry plugins for eCommerce systems and has years of experience working with eCommerce websites. We provide best plugins for platforms like - Magento, Prestashop, OpenCart and Shopify . We also provide custom module development and customization services for the website and modules..

Leave a Reply

Your email address will not be published. Required fields are marked *