Synch your Etsy shop

Synch your Etsy store in a few clicks. 

How to Get Etsy Credentials

Etsy App registration

For creating app at Etsy end visit this link https://www.etsy.com/developers/register and register as developers.

Here provide some basic information like Name, Email, Password, and Username. You can also register for Etsy developer account using your  Facebook or Google account.

After submitting the details you will receive a confirmation email which you will need to verify to get access of developer account.

After verification, you will be redirected to the app page, where you can register your app for getting Access key and Secret key.

While creating the app fill the following details:

• Application Name- Enter the name of the application, it will be visible to the user while authenticating for getting OAuth Token and OAuth Secret.
• Describe your Application- Enter the description for your app, it will be visible to the user during authentication.
• Application Website- In this field, you have to enter the URL of your HellaBlack website.
• What type of Application are you building?- In this field, you have to select Seller Tools option.
• Who will be the users of this application?- Select Just myself or colleagues option.
• Is your application commercial?- Select No in this field.
• Will your app do any of the following?- You have to select all the three options i.e Upload or edit listings, Read sales data and Send email.

Finally, verify the reCaptcha and click on Read Terms and Create App button.

Here mark the terms and conditions and then click on Create App.

Etsy API Credentials

After completing the above-mentioned steps, your app will get created in Etsy developer account for accessing your Etsy data using REST API.

To get the shop name, please go to the shop settings of your developer account as shown below.

Etsy Connector Configuration

Go To your HellaBlack Admin dashboard. In the toolbar, go to Website-> Etsy Connector. Here the admin can manage the products and orders of multiple merchant accounts.

Admin can add/edit numerous Etsy shops & manage their products, orders separately. List of all the shops will be here in the Manage Accounts tab.  Click on the + button to add a new Etsy shop.

Here are some fields of your Etsy account credentials which you require for adding/editing Etsy shop. These Etsy fields include:

• API Key
• Secret Key
• Shop Name

Just enter these credentials and authenticate.

After authenticating, the shop will be added successfully, where you can manage all the shop products. There are certain settings to manage the import/export of the shop’s products and orders.

Let’s start with the Product Settings. There are separate setting fields for product import and export.

1. Product Import Settings:

• Choose the default category of your HellaBlack store to import the Etsy Products.

1. Product Export Settings:

• Choose the default category of Etsy to export the HellaBlack Products. There is also an option to map categories. We will check the functionality later in this documentation. If no category is mapped with Etsy Category, then the product will be exported to this default category.
• Select the default shipping template for the exported products. You can add/import and manage the Etsy shipping templates and cost from HellaBlack itself. There is a separate manage page for shipping templates as shown below.
• Select the default state (Draft/Active) of the exported product.
• Select from the drop-down who actually made the item being listed.
• Set Yes if the product is a supply.

Real-time Settings:

• Check the box if you want to update the imported product in real time.
• Check the box if you want to update the Exported product in real time.
• If you want to update the product inventory in real time whenever an order is placed then you can check the third checkbox. If you have not checked the fields for Update Imported Product/Update Exported Product, then it will not work. So even if you have checked this box but have not checked any of the aforementioned, the inventory will not be updated on order placement.

Download: 

This tab provides an option to download all the Etsy Countries. You can simply click on download button for the same. Also, there is an option to map Etsy Categories with HellaBlack Categories. Please check the image below.

View Countries:

Map Etsy Categories:

On clicking the option to map Etsy categories, you will be able to add & manage the category mapping. Click on + button to add a new mapping.

Select the HB Category from the dropdown and the corresponding Etsy Category to be mapped with as shown.

How To Import Products From Etsy?

Click on Manage Products of the desired shop as shown. You get the list of the imported products here (If any) & also can manage the real-time sync of the individual products or bulk products. Click on Import Products to import.

You can import the Etsy products on the basis of Listing Id or Listing Status as shown below. Either add the comma separated listing ids or select the status of the listing & click on import button.

How To Import Order Details From Etsy?

Go to Manage Orders section to import the orders & click on the + button as shown below.

You can import the orders from Etsy based on various parameters ie;

• Import Orders By Date:

1. Import orders placed within a specific date range.
2. Check the boxes if you want to import the paid or shipped orders.

• Import Orders By Receipt Id:

1. Option to import individual order by order id.

• Import Orders By Order Status:

1. Option to import orders with specific order status.

Just set the desired parameter and click Import Order to import.

The imported orders list will then be available on the manage order page. You can just click on the Etsy order id to view & manage the order via HellaBlack.

Manage Shipping Templates

You can also add, import, & manage shipping templates and costs from HellaBlack admin panel itself. 

Click on the + button to add new shipping templates & fill the below-mentioned General parameters.

• Title- The name of this shipping template
• Origin Country- The country from which the listing will be shipped.
• Destination Country- The country to which the listing will be shipped.
• Primary Cost- The shipping fee for the item, if shipped alone.
• Secondary Cost- The shipping fee for the item, if shipped with another item.
• Processing Days- The minimum & maximum number of days for processing the listing.

Shipping Entry:

For different destination countries, you can add the different shipping cost here. Simply add & save.

How To Export Products To Etsy?

You can export HellaBlack products to your Etsy shop individually as well as in bulk. Go To Products details page from your Admin dashboard to export individual products.  Click on Etsy Connector tab & enter the mandatory fields.

• Choose Etsy Shop you want to export the product to.
• Select the shipping template for this particular product.
• Set the state of the product.
• Set the other mandatory fields related to the listing which includes :

1. Who made the item being listed
2. When was the item made
3. True if the listing is a supply
4. What is the occasion for this listing
5. Who is this listing for

After filling in these details, clcik on export button to export this product to Etsy shop.

If the product is already, available at Etsy shop & you simply need to sync and update the product details with the already existing product then click on the Sync Product With Etsy Product. 

• Select the shop where the product is available.
• Enter the listing id of the shop.
• If you want to update the product details as per the details at the HellaBlack end then check the box provided & click to sync.

To export/update the products in bulk, just open the product list page, select the products and click to export as shown below.

Just enter the parameters corresponding to each product and Export as shown below.