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] » Tab: Settings.

  2. Open the variation that you want to sell on Etsy.
    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.

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

  4. Click on the Availability tab.

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

  6. Activate the option Etsy.

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

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

  9. Open the main variation of the item.

  10. Click on the Availability tab.

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

  12. Activate the option Etsy.

  13. 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 data fields in the catalogue:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab with the market data fields opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).

  3. 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.

  4. Map the field:

    • Alternative 1: Map a plentymarkets data field + optional fallback data fields

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

      2. Click on the plus to the right of the plentymarkets data field you want to select.

      3. Optional: Add one or more fallback data fields. To do so, click on the plus to the right of the plentymarkets data field you want to select.
        → The fallback data field is exported when the first data field does not exist or is empty.
        Note: Even if you assign a fallback data field to a market data field, only one value is exported. The fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value, the first fallback data field is exported etc.

      4. Click on Confirm.

    • Alternative 2: Always export the same value for a market data field

      1. 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.

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

  5. Continue to map all data fields of the market for which you want to export product information.

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

Optional: 1:n mappings - 1 marketplace data field, several plentymarkets data fields
  1. Map a plentymarkets data field or an own value to the marketplace data field as described above.

  2. 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.

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

  4. Click on Confirm.

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

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

  7. Save the settings.

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

12.2.2. Notes on mapping data fields

Every market structures item data differently. As such, there are some particularities for each market when mapping data fields. Table 2 contains mapping information for important data fields for Etsy.

Table 2. Notes on mapping data fields
Marketplace data field plentymarkets data field

Shop sections

For this marketplace data field, all shop sections that you created on Etsy are available.

Occasion;
Recipient

If you only use the export language "German", export the values in German. If you use other export languages, either in addition to or instead of German, export the values in English.

Who made it? (who_made);
When was it made? (when_made);
A supply or tool to make things? (is_supply)

The combination of these three marketplace data fields determines if a product can be sold on Etsy:

  • Products must be either made by you, vintage (older than 20 years) or they must be supply/tools.

This results in the following rules for the export:

  • If who_made is "someone_else" and is_supply is "false", then when_made must be at least 20 years ago.

  • If who_made is "someone_else" and when_made is less than 20 years ago, then is_supply must be "true".

12.2.3. Recommendations for data field mappings

To help you with mapping your data fields for the Etsy catalogue, we have created a list of recommended data field mappings for Etsy. Note that these mappings are recommendations only. Depending on how you manage your item data, other mappings may be more appropriate than the recommendation given here.

List of recommended data field mappings for Etsy

12.3. Activating the catalogue

You have set up Etsy and created a catalogue for exporting your item data? Then start the export of your item data.

Activating the catalogue export to Etsy:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the Etsy catalogue.

  3. In the Active/Inactive column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to Etsy once a day during the night{if-active}.

13. Check list: Requirements for exporting variations

To export a variation to Etsy, this variation has to meet the following requirements:

Is the market availability active?

The variation must be available for the market.

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

  2. Open the variation that you want to sell on Etsy.

  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. Save () the settings.

Is the market availability active for the main variation?

For Etsy, you 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.

  1. Go to Item » Edit item » [Open item].
    → The main variation of the item opens.

  2. Click on the Availability tab.

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

  4. Activate the option Etsy.

  5. Save () the settings.

Have you activated the variation?
  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Open the variation that you want to sell on Etsy.

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

  4. Save () the settings.

Does the variation have positive net stock?
  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Open the variation that you want to sell on Etsy.

  3. Click on the Stock tab.
    → The net stock of each warehouse is listed in the Net column.

Are the sales price settings correct?

Check the sales price:

  1. Go to Setup » Item » Sales prices.

  2. For the filter Referrer, select Etsy.

  3. Click on Search ().
    → The sales price that is active for the referrer is shown.

  4. Check the settings of the sales price.

  5. Make any necessary corrections.

Check the price:

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The sales prices are listed in the tab Settings.

  2. Check the following settings:

    • Is the sales price for the referrer linked?

    • Does the price for the referrer have the correct price?

  3. Make any necessary corrections.

Does the variation have at least one image?
  1. Go to Item » Edit item » [Open item] » [Open variation].

  2. In the lower menu bar, click on the Images tab.

  3. Confirm that at least one image is linked to the variation.
    Tip: Linked images have a green border. Images that are not linked are greyed out.

  4. Save () the settings.

  5. In the upper menu bar, click on the Images tab.

  6. Expand the drop-down list Availability and confirm that the option Etsy is checked.

  7. Save () the settings.

Did you map all mandatory fields of the market in the catalogue?

As a minimum, plentymarkets data fields must be mapped to all mandatory fields of the market. In the catalogue, mandatory fields are marked with an asterisk.

Is the catalogue active?

The catalogue that the variation is associated with must be activated.

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the Etsy catalogue.

  3. In the Active/Inactive column, move the toggle button () to the right.

Couldn’t find any errors?

You have confirmed that the above settings are correct but the variation is still not exported? Then check the data log.

  1. Go to Data » Log.

  2. Use the following filters:

    • Etsy

  3. Click on Search ().

  4. Check all entries for the levels warning and error.

  5. Open the logs containing the message Variation invalid.
    → The the variation ID and the reason for the rejection or the missing characteristic are shown.

  6. Correct the variation data.

14. Automating order processing

The following event procedures are available for automating order processing:

  • Automatically send payment confirmations (How?)

  • Automatically send shipping confirmations (How?)

14.1. Automatically sending payment confirmations

Set up an event procedure to automatically send payment confirmations to Etsy when incoming payment is booked.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the Event according to Table 3.

  5. Save () the settings.

  6. Carry out the further settings according to Table 3.

  7. Activate the option Active ().

  8. Save () the settings.

Table 3. Automatically sending payment confirmations to Etsy
Setting Option Selection

Event

Payment: Complete

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

Etsy

Procedure

Plugin > Send payment confirmation to Etsy

14.2. Automatically sending shipping confirmations

Set up an event procedure to automatically send shipping confirmations to Etsy when the outgoing items are booked.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the Event according to Table 4.

  5. Save () the settings.

  6. Carry out the further settings according to Table 4.

  7. Activate the option Active ().

  8. Save () the settings.

Table 4. Automatically sending shipping confirmations to Etsy
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

Etsy

Procedure

Plugin > Send shipping confirmation to Etsy

15. Assigning user rights

Users with Back end access need rights to use the Etsy plugin. Open the Setup » Settings » User » Rights » User menu to assign rights.

Assigning user rights for back end users:

  1. Go to Setup » Settings » User » Rights » User.

  2. Use the search function and open the account that you want to edit.

  3. Expand the Authorisation: Markets menu.

  4. Select the option Credentials.

  5. Save () the settings.

16. Error messages

Cannot set is_customizable flag for shops that do not accept custom orders

Reason for the error message:

You have not activated the option Accept custom orders in the Etsy back end. However, in the catalogue you mapped a plentymarkets data field to the marketplace data field Customizable.

Solution:

  • Activated the option Accept custom orders in the Etsy back end.

or

  • In the catalogue, delete the mapping for the marketplace data field Customizable.

shipping template does not exist

Reason for the error message:

In the catalogue, shipping profiles are not mapped or mapped incorrectly.

Solution:

Map the shipping profiles correctly.

17. Brand and licensing information

The term “Etsy” is a trademark of Etsy, Inc. The plentymarkets Etsy plugin uses the Etsy API. However, the plugin is not endorsed or certified by Etsy, Inc.

This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE. Find further information in the file LICENSE.md .

To top