Skip to main content

Etsy

Etsy is an American online market focused on handmade and vintage items.

1. Overview of automatic data exchange with Etsy

After you have set up Etsy in plentymarkets, data is exchanged with the market in the intervals described in Table 1:

Table 1. Frequency of data exchange
Data Interval

Item export

once a day

Stock synchronisation

Hourly
A maximum stock of 999 is exported.

Price synchronisation

once a day

Order import

Hourly

2. Registering with Etsy

Register as an Etsy seller before you set up Etsy in your plentymarkets system.

3. Installing the Etsy plugin in plentymarkets

You need a plugin to link plentymarkets to Etsy. To connect to limango in plentymarkets, install the Etsy plugin in your plentymarkets system. You can download the plugin in the plentyMarketplace .

Adding and installing the plugin Etsy in your plentymarkets system

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin Etsy.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set in which you want to install the plugin.
    → The plugin set opens.

  3. Click on Add new plugin.

  4. Select Etsy from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

4. Activating the interface

First, the interface has to be activated in the Setup » Markets » Etsy » Authentication menu. This grants plentymarkets access to your Etsy account.

Activating the interface:

  1. Go to Setup » Markets » Etsy » Authentication.

  2. Click on the globe icon ().
    → A new window opens and you are forwarded to Etsy.
    Troubleshooting: You are not redirected? Then deactivate your pop-up blocker or try a different browser.

  3. Enter your Etsy access data.

  4. Click on Allow access.
    → plentymarkets can access your Etsy account.
    → You can continue the setup.
    Troubleshooting: Are you redirected to the start page of your plentyShop? Then your plentyShop is probably locked.
    Go to Setup » Client » Standard » Online store » Lock store to unlock your plentyShop. Unlock the store. Once the authentication is completed, go back to lock the store.

5. Setting up Etsy in plentymarkets

Pay attention to the Renewal options at Etsy

Prior to setting up Etsy in plentymarkets, you have to set the setting Renewal options to Manual in the Shop-Manager » Listings » [Open listing] menu of the Etsy back end. Otherwise, the Etsy plugin will not work correctly.

Go to Setup » Markets » Etsy » Settings to activate the data exchange.

Activating the data exchange:

  1. Go to Setup » Markets » Etsy » Settings.

  2. In the Processes area, activate the Item export, Stock update, and Order import.

  3. Save () the settings.

6. Setting up export languages

In the Export languages area, you carry out settings for export languages. The Shop language is exported by default. Other languages are used for translations of your offers.

Setting up export languages:

  1. Go to Setup » Markets » Etsy » Settings.

  2. Activate the languages that you want to export for your offers. The following languages are available:

    • English

    • German

    • French

  3. Save () the settings.
    Note: The Shop language that you set is exported irrespective of these settings.

7. Activating the order referrer

An order referrer tags an order with the sales channel on which the order was generated. You also need to activate the order referrer in order to link items, characteristics etc. with Etsy. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for Etsy:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the option Etsy.

  3. Save () the settings.

8. Setting the variation availability

You need to activate the variations that you want to sell on Etsy. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » [Open variation] menu. For Etsy, you also need to activate the main variation of the item for the market. This is because the main variation data is needed to create the listing. Variations can only be added once the listing has been created.

Making a variation available for Etsy:

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The tab Settings of the variation is shown.
    Tip: To sell all variations of an item on Etsy, carry out the settings for the item’s main variation. This activates the availability of all variations of the item.

  2. In the Availability area, activate the option Active.

  3. Click on the Availability tab.

  4. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  5. Activate the option Etsy.

  6. Click on Add ().
    → The market is added.

  7. Save () the settings.
    → The variation is available for Etsy.

  8. Open the main variation of the item.

  9. Click on the Availability tab.

  10. In the Markets area, click in the selection field.

  11. Activate the option Etsy.

  12. Save () the settings.

The variation group function allows you to edit several variations at once. You select the variations that you want to edit.

Making several variations available for Etsy using the variation group function:

  1. Go to Item » Edit item.

  2. Set the filter Table type to Variations.

  3. Choose additional filters on the left if needed and click on Search ().

  4. Select () the variations to be edited from the overview on the right.

  5. Click on Variation group function.
    → The Variation group function window opens.

  6. Navigate to the area Market availability.

  7. Activate the checkbox to the left of the option Etsy.

  8. Activate the checkbox to the right of the option Etsy.

  9. Navigate to the area Availability.

  10. Activate the checkbox to the left of the option Active.

  11. Activate the checkbox to the right of the option Active.

  12. Click on Execute to apply the settings.

Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.

Making several variations available for Etsy using batch processing:

  1. Go to Item » Batch processing.

  2. Click on the tab Variations in the upper left corner.

  3. Use the filters on the left to specify which variations should be processed.

  4. Navigate to the area Market availability.

  5. Activate the checkbox to the left of the option Etsy.

  6. Activate the checkbox to the right of the option Etsy.

  7. Navigate to the area Availability.

  8. Activate the checkbox to the left of the option Active.

  9. Activate the checkbox to the right of the option Active.

  10. Click on Apply to apply the settings to the variations.

9. _Optional:_Saving existing Etsy listing IDs

If you already sell a variation on Etsy, save the Etsy listing ID as an SKU for the referrer Etsy. By doing so, variations will be assigned to the variations already listed on Etsy during the item export. This is to prevent overselling.

Saving an Etsy listing-ID:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Click on the Availability tab.

  3. In the SKU area, click on Add ().
    → The New SKU window opens.

  4. Select the referrer Etsy.

  5. Enter the SKU in the following format:
    [Etsy listing ID]-[plentymarkets variation ID]
    Example: 708093072-3467

  6. Enter the Parent SKU in the following format:
    [Etsy Listing-ID]
    Example: 708093072

  7. Click on Add ().
    → The SKU is saved and displayed.

10. Defining a sales price

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. That means that to sell variations on Etsy, you need a sales price in which the order referrer Etsy is activated. The price that you save for this sales price is the price that will be shown on Etsy.

Defining a sales price for Etsy:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a new sales price first.

  2. Open the Settings tab.

  3. Activate the referrer Etsy.

  4. Save () the settings.

11. Saving legal information

The item texts for Etsy offers must contain specific legal information, for example relating to delivery time and cancellation rights. Save this in formation in all languages in which you offer your products. The legal information is automatically added to the item description during the export.

Saving legal information:

  1. Go to Setup » Markets » Etsy » Legal information.
    → The window Legal information opens.

  2. Select the language in which you want to save legal information.

  3. Enter the text.

  4. Save () the settings.

12. Setting up the item export

Item data is exported to Etsy via catalogues. The marketplace format Listing - Etsy creates a catalogue for exporting data for all Etsy product categories.

12.1. Creating a catalogue

Item data is exported to Etsy via catalogue using the marketplace format Listing - Etsy. To export your items to Etsy, create a catalogue in the Data » Catalogue menu. Link the Etsy data fields with item data saved in plentymarkets in the marketplace format afterwards. The catalogue data is automatically exported to Etsy once a day if you have activated the Item export in the Setup » Markets » Etsy » Settings menu. Is this your first time working with catalogues? Then read up on the basic concept of the plentymarkets catalogues first.

You can create only one catalogue for Etsy. Multiple catalogues are currently not supported for Etsy.

Creating a catalogue:

  1. Go to Data » Catalogues.

  2. Click on Create catalogue.

  3. Enter a name for the catalogue.

  4. In the drop-down list Export type, select the option Listing - Etsy.

  5. In the drop-down list Format type, select the option Item.

  6. In the drop-down list Format, select the option Listing - Etsy.
    Tip: You can only create one catalogue for this market. Thus, the only format you can select is the name of the market.

  7. Save () the settings.
    → The catalogue is created.
    → The catalogue is opened for editing.

Other catalogue settings are optional

In addition to the basic settings, the catalogue settings also contain options for Format settings, Export settings and Download settings. These optional settings allow you to create a file with the item data that is exported to the market at regular intervals. If you do not want to create such a file, you can ignore the settings. These settings do not impact the export to the market.

12.2. Mapping catalogue fields

After you have created a catalogue, map the market’s data fields to item data saved in plentymarkets. This chapter describes how you map data fields and what particularities apply for item exports to Etsy. In addition, we provide recommendations for suitable mappings. This information is structured as follows:

12.2.1. Mapping data fields in the catalogue

After you have created a catalogue, map the market’s data fields to item data saved in plentymarkets. Check the documentation of the sales channel to find out what data the market expects for the individual data fields.

Using properties

Use properties to export values for marketplace data fields that have no corresponding field in plentymarkets.

Mapping catalogue fields:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).
    → In the right column, you map the plentymarkets data fields. Any plentymarkets data fields that are already assigned are also shown in the right column.

  3. Now, map suitable plentymarkets data fields to the market data fields.
    You can choose from the following mappings which are described in the info boxes below:

    • 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping = Map 1 marketplace data field to several plentymarkets data fields

    • Own value mapping

  4. Save () the catalogue.
    → The mappings are saved.

*1:1 mapping:*Map 1 marketplace data field to 1 plentymarkets data field

In a 1:1 mapping, you map a plentymarkets data field to the marketplace data field.

So this mapping specifies:

  • I want to fill this marketplace data field with the data from this plentymarkets setting.

  • If the data field is empty for a variation, no value is exported for this variation.

Creating a 1:1 mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. Click on Confirm.

1:1 mapping with fallback data fields: Map 1 marketplace data field to 1 plentymarkets data field

In a 1:1 mapping with a fallback data field, you map a plentymarkets data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first plentymarkets data field is empty or contains an invalid value.

So this mapping specifies:

  • I want to fill this marketplace data field with the data from this plentymarkets setting.

  • If the data field is empty or invalid for a variation, the first fallback data field is checked and the value of that fallback data field is exported instead.

  • If the first fallback data field also is empty or invalid for a variation, the value of the second fallback data field is exported and so on.

Creating a 1:1 mapping with a fallback data field:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. In the list of plentymarkets data fields, click on the plus icon next to the plentymarkets data field that you want to map.
    → The fallback data field is exported when the first data field does not exist or is empty.
    Note: Even if you map one or more fallback data fields to a marketplace data field, only one value is exported for each variation. For each variation, the plentymarkets data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

  5. Click on Confirm.

1:n mapping: Map several plentymarkets data fields to 1 marketplace data field

In a 1:n mapping, you map several plentymarkets data fields to the marketplace data field. You can link these data fields with a separator.

So this mapping specifies:

  • I want to combine these plentymarkets data fields during export so that the marketplace data field is filled with the data of these two or more plentymarkets settings.

Creating a 1:n mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. Click on Confirm.

  5. To the right of the mapped plentymarkets data field, click on Add data field ().
    → To the left, the list of available plentymarkets data fields again are shown in groups.

  6. Map one or several additional plentymarkets data fields to the marketplace data field as described above.

  7. Click on Confirm.

  8. To the very right of the row, click on Settings ().

  9. Select a separator from the drop-down list Separator or add a custom separator.

  10. Save the settings.

  11. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the plentymarkets data fields is combined and exported as one field.

Own value mapping: Map the same value for all variations to 1 marketplace data field

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on the plus next to Own value at the top of the list.
    → The field for the own value is added to the view.

  3. Enter a value into the input field.
    → This value is exported for all variations.

Example: Diameter information

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to the variations, you can enter the own value cm.

13. Activating the catalogue export to XXXX

Unresolved directive in _textblocks/catalogues/instructions/catalogue-activation.adoc - include::../_textblocks/catalogues/instructions/catalogue-activation.adoc[]

Unresolved directive in _textblocks/explanations/plugin-license.adoc - include::../_textblocks/explanations/plugin-license.adoc[]

To top