Etsy (Setup via Channel Control Centre)

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

Channel Control Centre

This page explains the setup process for Etsy via the menu Sales Channels » Channel Control Centre. If your system features the Setup » Markets menu instead, then you can find instructions on how to set up Etsy via the menu Setup » Markets here.

1. Registering with Etsy

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

2. Frequency of data exchange

After you have set up Etsy in PlentyONE, 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

once a day
Note: A maximum stock of 999 is exported.

Price synchronisation

once a day

Order import

hourly
Note: Orders are always assigned to the default client (store).

3. Workflow of an order

  • Your products are listed on Etsy.

  • Customers place an order on Etsy.

  • Customers make their payments to Etsy.

  • The order is imported into PlentyONE.
    Note: Customers make their payments to Etsy. As such, orders are imported with Status [5] Cleared for shipping.
    Note: In some cases, it can take 72 hours or longer before Etsy confirms payment. Such orders are imported with the status [3] Waiting for payment. Once Etsy confirms payment, the payment information is imported. The order is automatically moved to status [5] Cleared for shipping.

4. Settings in Etsy back end

Carry out the following settings in your Etsy account before you set up the sales channel in PlentyONE:

  • In the Etsy back end, go to Shop-Manager » Listings » [Open listing] and set the setting Renewal options to Manual. Otherwise, the setup will not work correctly.

  • Create shipping profiles on Etsy.

5. Setting up Etsy in PlentyONE

First, add Etsy as a sales channel in your system and carry out the basic settings to set up the sales channel in PlentyONE. To do so, proceed as described below.

Manual setting for Renewal options on Etsy

Prior to setting up Etsy in PlentyONE, 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 setup will not work correctly. More information can be found here.

5.1. Channel Control Centre

In the Channel Control Centre, you can manage all sales channels that you added to your system.

Table 2 explains the different tiles visible in the Sales Channels » Channel Control Centre menu.

Table 2. Tile components in the Sales Channels » Channel Control Centre menu
Component Explanation

Name

The name of the sales channel.

more_vert More

Click here to display more actions for a sales channel.

list Listings

Opens the overview of the product and offer listings for this sales channel.

settings Settings

Opens the respective Settings menu of the sales channel.

delete Delete sales channel

Deletes the sales channel from the overview.

5.2. Adding the sales channel

First, add Etsy as a sales channel in the Channel Control Centre.

Adding a sales channel:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Click Add sales channel (add).
    → The menu Add sales channel opens.

  3. Click Continue in the tile of Etsy.

  4. Enter a name for the sales channel.

  5. If asked to, select the Client (Shop) from the drop-down list.

  6. Click add Add Etsy.
    → The sales channel for Etsy is added.

5.3. Activating your Etsy account

In the Sales Channels » Channel Control Centre » [Open Etsy sales channel] » OAuth2 menu, you first have to activate the interface for Etsy. This is to grant PlentyONE access to your Etsy account and to enable the data exchange between PlentyONE and Etsy.

Activating the interface:

  1. Navigate to Sales Channels » Channel Control Centre » [Open Etsy sales channel] » OAuth2.

  2. Enter the name of your Etsy shop.

  3. Click Save (save).
    → A new window opens and you are forwarded to Etsy.
    Troubleshooting: You are not redirected?

    • Deactivate your pop-up blocker or try a different browser.

  4. Enter your Etsy access data.

  5. Click on Allow access.
    → plentymarkets can access your Etsy account.
    → You can continue the setup.

5.4. Carrying out the basic settings

The basic settings for Etsy are carried out in the Sales Channels » Channel Control Centre » [Open Etsy sales channel] » Settings menu.

Carrying out the basic settings:

  1. Go to Sales Channels » Channel Control Centre » [Open Etsy sales channel].
    → The menu settings Settings » Settings opens.

  2. Carry out the settings. Pay attention to the explanations given in Table 3.

  3. Click Save (save).

Table 3. Basic settings for Etsy
Setting Explanation

Shop

Select a client (shop) that should be used for Etsy.

Main shop language

Select the shop’s main language from the drop-down list. → This is the main language of your Etsy shop.

Export languages

Select which export languages you want to use for Etsy. The export languages are used for translating your offers.

Processes

In the Processes section, you activate the data exchange with Etsy.

  • Item export = Activate to export items to Etsy once per day.

  • Stock synchronisation = Activate to update stock once per day.

  • Order import = Activate to import Etsy order into PlentyONE once per hour.

5.5. Adjusting the general settings

In the menu General settings you can rename the sales channel. To do so, proceed as follows.

Renaming a sales channel:

  1. Go to Sales Channels » Channel Control Centre.

  2. Open the sales channel for Etsy.
    → The Settings menu opens.

  3. Switch to the menu General settings.

  4. Enter a new Channel name.

  5. Click Save (save).
    → The new channel name is saved.

5.6. Activating the order referrer

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for Etsy:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option Etsy with the ID 156.00.

  4. On the right of the referrer’s line, click Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click SAVE (save).
    → The referrer is active.

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 Sales Channels » Channel Control Centre » [Open Etsy sales channel] » Legal information.

  2. Select the language in which you want to save legal information from the drop-down list.

  3. Enter the text.

  4. Click Save (save).

5.8. Creating processing profiles

Etsy requires processing profiles to be transferred. These processing profiles contain information about whether your item is ready to ship or made to order, and the minimum and maximum processing time you need before you can ship the order.
In PlentyONE, you can create processing profiles and transfer them to Etsy in two steps. First, create the processing profiles, and then map them in your Etsy catalogues.

5.8.1. Step 1: Creating a processing profile

Creating a processing profile:

  1. Go to*Sales Channels » Channel Control Centre » [Open Etsy sales channel] » Processing profiles*.

  2. Click add New processing profile.

  3. Enter a name for the processing profile.

  4. Select the processing state.

  5. Select the minimum processing time.

  6. Select the maximum processing time.

  7. Select the unit for processing time.

  8. Click Save (save).

5.8.2. Step 2: Mapping a processing profile in the catalogue

Mapping a processing profile in the catalogue:

  1. Go to Data » Catalogues.

  2. Open your Etsy catalogue.

  3. In the Processing profiles section, select the desired processing profile in the Export as field.

  4. Click add Add data source next to the Export as field.

  5. Select the desired PlentyONE data source.
    Tip: Create a property of the type Selection and save it on your variations. Enter the names of the processing profiles you created as selection values.

  6. Click Save (save).

6. Preparing variations

Now, prepare your variations.

6.1. Setting the variation availability

You need to activate the variations you want to sell on Etsy and enable them for the relevant sales channel. This is done in the Item » Items » [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.

  • For one variation

  • Using variation group function

  • Using batch processing

Making a variation available for Etsy:

  1. Go to Item » Items » [Open variation].
    Tip: To sell all variations of an item on Etsy, carry out the settings for the item’s main variation. If the inheritance function is active for the variations, then this activates the availability of all variations of the item.

  2. In the Availability and visibility section, enable the option Active (toggle_on).

  3. Click the Sales channels tab.

  4. In the Sales channels section, activate the sales channel Etsy in the Status column (toggle_on).
    Tip: You can activate multiple sales channels at once. To do so, activate the checkboxes to the left of the desired sales channels. Then activate the toggle above the checkbox column (toggle_on). Click ACTIVATE to confirm the activation.

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

  6. Open the main variation of the item.

  7. Click the Multichannels tab.

  8. In the Sales channels section, activate the sales channel Etsy in the Status column (toggle_on).

  9. Save (save) the settings.

Use the variation group function to edit multiple 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 » Items.

  2. Set search filters as needed and start the search.

  3. Select () the variations to be edited.

  4. In the toolbar, click on layers » layers Variation group function.
    → The Variation group function window opens.

  5. Select the action Sales channels from the drop-down list Actions.
    → The action is added to the lower part of the window.

  6. Select (check_box) the option Etsy from the drop-down list Sales channels.
    → The sales channel is added below the drop-down list Sales channels.

  7. Activate (toggle_on) the toggles to the left of the sales channels.

  8. Click EXECUTE & CLOSE 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. Navigate to the area Market availability.

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

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

  4. Navigate to the area Availability.

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

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

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

6.2. _Optional:_Saving existing Etsy listing IDs

Do you already sell a variation on Etsy? Save the Etsy listing ID as an SKU for the referrer Etsy. Variations are then assigned to the variations that are already listed on Etsy during the export. This prevents overselling.

Saving an Etsy listing-ID:

  1. Go to Item » Items » [Open variation].

  2. Switch to the Sales channels tab.

  3. Expand the SKU section (arrow_forward_ios).

  4. Click Add SKU (add).
    → The Add SKU window opens.

  5. Select the referrer Etsy.

  6. Select the account, if required.

  7. Click APPLY.
    → A new line for the SKU is added.

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

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

  10. Click Save (save).

6.3. Check list: Requirements for exporting variations

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

Unresolved include directive in modules/sales-channels/pages/etsy-centralised.adoc - include::partial$checklist-variations.adoc[]

7. Exporting offer data

Offer data is exported to Etsy using catalogues. Catalogues are usually managed via the Data » Catalogues menu. However, you can create catalogues for Etsy via the Channel Control Centre as well.

What is a catalogue?

Catalogues are used to export data from your PlentyONE system. There are two different catalogue formats:

  • Marketplace formats are used to export item data to markets.

  • Standard formats are used to export data from your PlentyONE system into a file.

Catalogues with marketplace formats allow you to tailor your item information exactly to the needs of the market. Because here, you assign a suitable PlentyONE data field to each of the data fields of the market. When your variation data is exported to the market, the market’s data fields are then filled with the correct PlentyONE data.

7.1. Creating an offer catalogue

Offer data is exported to Etsy via a catalogue. You can create offer catalogues for Etsy directly in the Channel Control Centre. Afterwards, link the Etsy data fields to offer data saved in PlentyONE in the catalogue you created. If you have activated the catalogue, the account, the listing, and the variations, the offer data will be exported to Etsy automatically every 15 minutes.

Creating a catalogue:

  1. Go to Sales Channels » Channel Control Centre.

  2. Click on the Etsy tile.

  3. Go to Mapping » Offer mapping.

  4. Click Create catalogue (add).

  5. Enter a name for the catalogue.

  6. In the drop-down list Marketplace, select the option Listing.

  7. In the drop-down list Export type, select the option Item.

  8. In the drop-down list Category, select Etsy.

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

Other catalogue settings

Other catalogue settings are optional. Once you carried out the settings described on this page, your catalogue is automatically exported to Etsy. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

The Format settings, Export settings, and Download settings allow you to create a file with the variation data contained in the catalogue. However, this file does not contain information about whether the data export to Etsy was successful.

Do not change the format in the catalogue’s Format settings. To ensure that the export to the sales channel works, all required settings are already configured when you create a catalogue. If you change the settings, errors might occur during the export.

7.1.1. Mapping data fields in the offer catalogue

After you have created an offer catalogue, map the channel’s data fields to item data saved in PlentyONE. This chapter describes how you map data fields and what particularities apply for offer exports to Etsy.

  • The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats
catalogue menu colours
Availability Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

  • Switch to other views of the catalogue.

  • Open the catalogue settings.

  • Use filters that limit the data that is exported.

  • Go back to the list of catalogues.

  • Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
Tip: Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions (more_vert).

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

  1. Go to Sales Channels » Channel Control Centre.

  2. Click on the tile of your Etsy Sales Channel.

  3. Click on the catalogue you want to edit.
    → 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 PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.

  4. Map suitable PlentyONE data fields to the market data fields.
    For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.

    • Simple 1:1 mapping

    • Simple 1:1 mapping with properties

    • Complex 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping

    • Own value mapping

    • Mapping with mathematical calculations

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

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. If no suitable setting exists in PlentyONE. you can map a property instead.

As such, simple 1:1 mappings allow you to:

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

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

Creating a simple 1:1 mapping:

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

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

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

  4. Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

gif catalogue mapping simple en
Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Reminder: In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. However, what can you do if PlentyONE does not offer a suitable data field? Then it’s the properties' moment to shine. Properties allow you to save any kind of information in your properties.

Creating a property:

  1. Create a property with the necessary values.
    Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

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

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. Click on Confirm.
    → The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

Like with the simple 1:1 mappings, you map a PlentyONE setting or property to a marketplace data field. Complex mappings are necessary whenever a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you map individual values of these data fields. For example, you cannot simply map the PlentyONE data field Shipping profile to the marketplace data field Shipping method. Why? The market cannot know which of your shipping profiles in PlentyONE corresponds to which of their shipping methods.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

You can recognise complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings

Examples for complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping setting

Important: For complex mappings, do not map own values or properties of the type None.

Creating a complex 1:1:n mapping:

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

  3. Next to the marketplace data field, click on + Add data field.
    → To the left, the available PlentyONE data fields are listed in groups.

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. Click on the PlentyONE data field for which you want to map values.
    Important: Do not map own values or properties of the type None.

  6. Your next steps depend on the PlentyONE data field you selected:

    • Alternative 1: The available values for the PlentyONE data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The PlentyONE data field is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped PlentyONE data field.

      • Click on Confirm.

    • Alternative 3: The PlentyONE data field is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.
        → The value of the marketplace data field is exported, not the value of the PlentyONE data field.
        Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

gif catalogue mapping complex en
1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

In a 1:1 mapping with one or more fallback data fields, you map a PlentyONE 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 PlentyONE data field is missing or empty.

So this mapping specifies:

  • I want to fill the marketplace data field with the data from the selected PlentyONE setting.

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

  • If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

  • SKU

  • Barcodes

  • Sales prices

  • Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

  • PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped PlentyONE 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.

Creating a 1:1 mapping with fallback data fields:

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

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

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

  4. In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
    → The fallback data field is added with the fallback condition "null".

  5. Alternative 1: To add the fallback data field with the fallback condition "null":

    1. Click on Confirm.
      → The fallback data field is exported if the data field above is not linked to the variation.

  6. Alternative 2: To add the fallback data field with the fallback condition "empty":

    1. To the left of the fallback data field, click on the cog ().
      → The window Data column settings is shown.

    2. For the setting Fallback condition, select the option Empty.

    3. Click on Save.
      → The fallback data field is added with the fallback condition "empty".

    4. Click on Confirm.
      → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

This GIF shows you the mapping for the OTTO Market marketplace data field SKU. The PlentyONE data field SKU is mapped to this marketplace data field. The PlentyONE data field Variation ID is mapped as the fallback data field. The fallback condition "null" is applied automatically.

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

gif catalogue mapping fallback en
1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE 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 PlentyONE data fields during export so that the marketplace data field is filled with the data of these two or more PlentyONE 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 PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

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

  4. Click on Confirm.

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

  6. Map one or several additional PlentyONE 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. Click on Save.

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

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

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. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE 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.

This is an example of how you can map an own value for the diameter unit:

gif catalogue own value en
Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

Mathematical calculations allow you to change numerical values automatically during the export.

  • This function only works for data fields that contain numerical values.

  • This functionality is new and not available for all catalogue formats.

So this mapping specifies:

  • I want the numerical value of a PlentyONE data field to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Recalculating numerical values:

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

  2. At the very top of the list, click on the plus icon next to Formula (calculate).
    → The data field Formula is added to the field on the right.

  3. Click into the data field.
    → The window Modify value is shown.

  4. Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation (add).
    Tip: Use the search function. This helps you to find data fields quickly.

  5. Optional: If the symbol more_vert is shown in the data field, select the correct assignment for the data field.
    Tip: A number tells you how many assignments are necessary for the data field.

    1. Click on the icon more_vert.

    2. In the window shown, select the assignments from the drop-down list.

    3. Save the settings.

  6. Enter numbers and mathematical operators with the on-screen calculator or the keyboard.

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

7.1.1.1. 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 4 contains mapping information for important data fields for Etsy.

Table 4. Notes on mapping data fields
Marketplace data field PlentyONE data field

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

Occasion;
Receiver

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, save the values in English.

Price information

You cannot export any strikethrough prices to Etsy using PlentyONE. In other words: You cannot visualise price reductions on Etsy where the old price is shown but crossed out.

Processing profiles

For this data field, you have to create processing profiles first. Once you have created processing profiles, you can select them under Export as.
As the PlentyONE data source, we recommend a property of the type selection with the names of your processing profiles as selection values.

Shop sections

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

If an item can be customised, then the item can, for example, be engraved or a name can be added.
If you want to offer your customers the possibility to customise an item, then you have to activate the option Accept custom orders on Etsy.
Additionally, you have to link the sales channel’s data field Customizable (is_customizable) to a property of the type Selection in your Etsy catalogue.

Possible selection values for the property:

  • If the item cannot be customised: 0 or false or n

  • If the item can be customised: 1 oder true or y

Note: Your customers' requests for customisation are imported as order notes.

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

  • Need more information about the PlentyONE data fields? All data fields are described on the manual page for the standard format Item (new).

List of recommended data field mappings

7.1.2. Activating the catalogue export

You have set up Etsy in PlentyONE and created a catalogue for exporting your offer data? Then activate the catalogues you want to export to Etsy in the Data » Catalogues menu and continue with creating offer listings.
Once you have activated the offer catalogue, the data exchange, the offer listing and the variations, the offer data will be automatically exported to Etsy once a day.

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 column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to Etsy once a day.
    Tip: Go to Data » Catalogue export status for information about the status of the export.

8. Managing listings

You create and manage offers for Etsy via listings. You can access the product and offer listings for Etsy by navigating to Sales Channels » Channel Control Centre » [Open Etsy sales channel] and then opening the Offer listings or Product listings menu.

Right now, product listings cannot be created for Etsy. Instead create offer listings.

8.1. Offer listings

In the list Offer listings menu of the account you gain an overview of your offer listings.

Tip: You can switch between specific views of offers and the listing group view via the menu button and folder.

  • menu gives you an overview of all the offer listings.

  • folder shows you the listing groups of the offer listings. Extend a listing group by clicking chevron_right, to see all listings within the group.

Applying search filters
If you only want to take a look at certain offer listings, apply filters and narrow down the listings which are displayed. To do so, click on Filters (tune) at the top of the menu.

Applying filters:

  1. Go to Sales Channels » Channel Control Centre » [Open sales channel] » Offer listings.

  2. Click Filters (tune) at the top of the menu.

  3. Select one or multiple filters.

  4. Click Search (search).
    → The selected filters are applied and the appropriate offer listings are displayed.
    → The filters that were applied are displayed at the top of the menu.

Tip: You can also reset (refresh) the selected filters. Then all offer listings will be displayed again.

  • Single listing view

  • Group view

Table 5 offers an overview of the single listing view of offer listings.

Table 5. Offer listings overview
Column Explanation

Data sync

This column indicates whether data exchange for the offer listing is active or paused.
Tip: You can activate the data exchange in the listing’s line via more_vert » toggle_on Activate data sync .

Group ID

The ID of the listing group to which the offer listing is assigned. By clicking on the ID, you can open the listing group view.

Listing Name

Name of the offer listing.

SKU

SKU of the offer listing.
Note: You can edit the SKU. To do so, click Activate editing mode (edit). Make the changes and click Save (save) to apply them. If you want to exit the editing mode, click Deactivate editing mode (edit_off).

Variation ID

ID of the variation.

Channel

The sales channel to which the listing is exported.

Status on Channel

Displays the listing status on the sales channel, for example if the listing is already listed on the sales channel. Possible status are:

  • help = Unknown

  • progress_activity = Outstanding

  • progress_activity = Creation pending

  • cancel = Failed (before creation)

  • check_circle = Online

  • cancel = Failed (on update)

  • pause_circle = Paused

  • unpublished = Offline

Note: For platforms with multiple sales channels, the number after the status icon indicates on how many sales channels the offer listing has this status.

List on

The sales channels on which the offer listing is to be offered are displayed here.
Click the pencil icon (edit) to add or remove sales channels.

Errors

Indicates whether the listing is incorrect. Click to open the overview of listing errors.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing.

Catalogue

The catalogue selected for the listing.

Creation date

The date and time on which the listing was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data transfer between the sales channel and the listing.
Note: Even if the Activate data sync option is activated, the listing will not be immediately listed on the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when a listing is online.

delete Delete listing

delete Delete listing

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.

Table 6 offers an overview of the group view of offer listings.

Table 6. Group view of the offer listings
Column Explanation

Data sync

This column indicates whether data exchange for the listing group is active or paused.
Tip: You can activate the data exchange in the listing group’s line via more_vert » toggle_on Activate data sync.

Group name

Name of the listing group

SKU

SKU of the listing group.

Channel

The sales channel to which the listing group is exported.

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing group.

Catalogue

The catalogue selected for the listing group.

Creation date

The date and time on which the listing group was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data transfer between the sales channel and the listing group.
Note: The data sync must also be activated for the single listing to list an offer listing on a sales channel.
Even if the Activate data sync option is activated in a listing group, the listings in this group will not be immediately listed on the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when the listings are online.

delete Delete listing group

Delete listing group.

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.

8.2. Creating listings

Offers are transferred to Etsy as listings. Carry out the following steps to create listings for Etsy.

What are product listings and offer listings used for?

  • If the item you want to sell is not listed on the sales channel yet you will need to create a product listing for it first. Creating a product listing sends the product data to the sales channel and allows for the item to be listed.
    In order to actually be able to sell the item on the sales channel you will need to additionally create an offer listing. The offer listing contains data related to the sale of the item, such as its price and stock. In other words, a product listing allows you to list an item on a sales channel that did not previously exist on that sales channel, but in order to sell that item on that sales channel you also need an offer listing for that item.

  • If the item you want to sell is already listed on the sales channel you only need to create an offer listing. Offer listings send the data related to your offer, such as the price, stock, shipping costs etc., to the sales channel.
    In most cases you will only need an offer listing in order to offer a product on a sales channel. Many sales channels do not differentiate between product and offer listings. You only need to send offer listings to these kinds of sales channels.

8.2.1. Creating offer listings

Offer listings are created in three steps:

  • First, you enter listing details, meaning you select the platform, template, and catalogue for the listing.

  • Next, you select the variations from which the offer listings are created.

  • Lastly, check and confirm your selection and create the listings.

You can also create offer listings directly from your product listings. Here you can learn how to do that.

Step 1: Specify listing details:

  1. Go to Sales Channels » Channel Control Centre.

  2. Open the account for Etsy.
    → The Settings menu opens.

  3. Open the menu format_list_bulleted Offer listings.

  4. Click add arrow_drop_down and select Create offers.
    → The Create offers view opens.

  5. Select the platform Etsy.

  6. Select the template for the catalogue.
    Tip: Only templates that are available for the platform Etsy are displayed.

  7. Select a catalogue with your mappings for offer data.
    Tip: If you have no fitting catalogue yet, click on add Create catalogue. You will be forwarded to the Data » Catalogues menu and can create a catalogue.

  8. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Etsy after the listing is created.

  9. Click arrow_forward NEXT.
    → The Select variations view opens. Next, select the variations you want to add to the listing.

Step 2: Select variations:

  1. Select the variations you want to create the offer listing for.
    Tip: Use the search to filter for variations.
    Note: Only variations that are linked to Etsy in the Item » Items » [Open item] » [Open variation] menu are displayed.
    Tip: If you want to create offer listings for all available variations, click on Click here to create listings for all [] variations above. You will be automatically redirected to the Preview and confirmation step. Offer listings can be created for a maximum of 50,000 variations at a time.

  2. Click add ADD TO SELECTED VARIATIONS.
    → The selected variations are displayed in the Selected variations section.
    Note: If you check a variation in the Selected variations section, you can remove the variation from the selection by clicking Remove from list.

  3. Click arrow_forward NEXT.
    → The selected variations will be displayed in a new view. In the last step, you preview and confirm your selection.

Step 3: Preview and confirm selection:

  1. Preview your settings in the Listing details section.

  2. Preview your selected variations in the Listing preview section. The listings are grouped by items. Extend a listing group (chevron_right) to see which variations are contained in the respective listing group.

  3. If everything is set and done, click save CREATE OFFER LISTINGS.
    Note: If you activated Automatically activate listings after creation a window with a summary of your settings opens. Click check CONFIRM to create the offer listings.

8.2.2. Activating offer listings

After you have created the offer listings, you have to activate the listings so that they can be transferred to Etsy.
To do so, activate the individual listings and the listing group. The listing can only be transferred to the sales channel if both the listing and the listing group are activated.

Note: You can also activate listings immediately after creation by activating the option Automatically activate listings after creation. If you activate the option to automatically activate listings after creation, you still have to activate the data exchange for the listing group.

Activating offer listings:

  1. Go to Sales Channels » Channel Control Centre » [Open Etsy].
    → The Settings menu opens.

  2. Open the Offer listings menu.

  3. In the line of the offer listing you want to activate, click more_vert.

  4. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple offer listings at once, place a check mark next to the desired offer listings and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing is activated. The listing can only be transferred to the sales channel if the listing group is also activated.

Activating a listing group:

  1. Go to Sales Channels » Channel Control Centre » [Open Etsy].
    → The Settings menu opens.

  2. Open the Offer listings menu.

  3. Open the listing group view (folder).

  4. In the line of the listing group you want to activate, click more_vert.

  5. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple listing groups at once, place a check mark next to the desired listing groups and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing group is activated.

9. Automating order processing

Create event-based flows to automatically inform Etsy about changes to the order status. The following actions are available for Etsy in the PlentyONE Flow Studio:

  • Automatically inform Etsy that an order has been paid. (How?)

  • Send shipping confirmations to Etsy. (How?)

Returns, credit notes and cancellations cannot be processed in PlentyONE. Process them in your Etsy account instead.
What is PlentyONE Flow?

With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:

  • In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three flow types: event-based, time-based or manual.

  • In the Flow Tracker, you can monitor running or completed workflows.

The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.

9.1. Notify Etsy that an order was paid

Create an event-based Flow to automatically inform Etsy that an order has been paid.

Creating an event-based flow

  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 7.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save () the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 7.

  4. Save () the settings.

Note: The selected statuses, controls and filters in Table 7 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.

Table 7. .Event-based Flow to send a payment confirmation to Etsy
Setting Option Selection

Trigger selection

Select a trigger, for example:

  • Payment status > Complete

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:
    Note: If you want to use multiple filters, add the additional filters as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order type

Is in (IN)

Sales order

Order > Order referrer

Is in (IN)

Etsy

Actions

Plugin (Legacy) > Etsy

Send payment confirmation to Etsy

9.2. Send shipping confirmations to Etsy

Create an event-based flow to automatically inform Etsy that an item related to an order was shipped.

Creating an event-based flow

  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 8.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save () the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 8.

  4. Save () the settings.

Note: The selected statuses, controls and filters in Table 8 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.

Table 8. Event-based flow for sending shipping confirmations to Etsy
Setting Option Selection

Trigger selection

Select a trigger, for example:

  • Order > Order status changed

or

  • Order > Book outgoing items

Select an order status, for example:

  • [7] Outgoing items booked

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:
    Note: If you want to use multiple filters, add the additional filters as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order referrer

Is in (IN)

Etsy

Actions

Plugin (Legacy) > Etsy

Send shipping confirmation to Etsy

10. Deleting the sales channel

You can delete the Etsy sales channel in the account overview of the Channel Control Centre. Before deleting the sales channel, make sure that no orders exist anymore and that the data exchange is deactivated.

Deleting the sales channel:

  1. Go to Sales Channels » Channel Control Centre.

  2. In the tile of your Etsy sales channel, first click on More (more_vert), then on Delete sales channel (delete).
    → A pop-up for deleting the account opens. If you want to delete the account, confirm the pop-up by clicking delete Delete account.
    → The account is deleted.

11. Brand and licensing information

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