Yatego

Market integration will be deactivated

The integration of Yatego will be deactivated on 15 March 2023. This means that PlentyONE will no longer support the market. You cannot sell your items on Yatego with PlentyONE and Yatego orders will no longer be imported into your system. Further information is available in the forum.

With PlentyONE you can offer your items on the Yatego.com sales platform. Yatego offers sellers extensive services with powerful, complete solutions as well as comprehensive technical support.

1. Registering with Yatego

Register with Yatego.com to receive your access data. The access data is required for the settings in PlentyONE.

2. Setting up Yatego in PlentyONE

Once you have registered with Yatego, use the access data that is saved there to set up the market in PlentyONE. To do so, proceed as described below.

Setting up Yatego in PlentyONE:

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

  2. Expand the Basic settings area ().

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

  4. Save () the settings.

Table 1. Basic settings for the market Yatego
Setting Explanation

User name (Yatego store name)

Enter the user name for logging in to Yatego.com.

Password

Enter the password for logging in to Yatego.com.

Item image size

Select Item image (standard), Medium-sized item image, or Preview image.

Item name

Select Name 1, Name 2 or Name 3. The names are entered in the Texts tab of an item.

Shipping costs

  • Add up shipping charges for each item = For every item, PlentyONE transfers the shipping costs (domestic) that are valid for the plentyShop. If a customer purchases two items on Yatego, then the shipping charges of the individual items are added up. In addition, the shipping costs that are saved in Yatego are added to the shipping costs that were transferred by PlentyONE.

  • Add up, but only once for multiple copies of the same item = PlentyONE also transfers the shipping costs (domestic) that are valid for the plentyShop. The shipping charges are added when purchasing various items. When purchasing two or more of the same item, the shipping charge is only calculated once. Finally, this is also added to the extra shipping charges saved for Yatego.

  • Use Yatego table of shipping charges based on the item weight = If you select this option, PlentyONE does not transfer any shipping costs to Yatego. Based on the weight which is saved in PlentyONE and which is also transferred to Yatego, Yatego calculates the shipping costs itself.

Sorting of variations

Select Alphabetical, Surcharge, or No sorting.

Transfer RRP

  • Yes = Transfer value for RRP, if an RRP for Yatego items is entered.

  • No = Do not transfer a value for RRP.

Automatic upload (daily)

Activate in order to automatically transfer item data to Yatego each day.

Sold out variations

  • Visible = Variations that are sold out are displayed on Yatego.

  • Invisible = Variations that are sold out are not displayed on Yatego.

Yatego characteristics

  • Do not export = Characteristics are not exported to Yatego.

  • Place in the upper part of the description = Place characteristics for Yatego items in the upper part of the description.

  • Place in the lower part of the description = Place characteristics for Yatego items in the lower part of the description.

Free text fields 1 to 20

  • Do not export = Free text fields are not exported to Yatego.

  • Place in the upper part of the description = Place the text for Yatego items in the upper part of the description.

  • Place in the lower part of the description = Place the text for Yatego items in the lower part of the description.

  • Export in a separate column = Export the characteristic in a separate column of the CSV file during the item export.
    Note: Only PlentyONE customers who already use the free text field functions in the Yatego settings should use this function. New PlentyONE customers are requested to use the following two options.

Yatego warehouse rights

Select Exactly or Simply if you manage stock with the values -1, 0, 1 or 2.

Item description

Select Standard description, Technical data, or Both.

Short item description

Select whether the preview text or the technical data should be used as the short item description on Yatego.

Warehouse

Select own warehouse, Main item warehouse or Transfer stock quantity of distribution warehouse that currently has the largest stock.

Are you sure you want to delete all item images before importing from the Yatego shop?

  • Yes = All item images that are currently available on Yatego are deleted when importing new images for these items. This prevents errors when importing images. If you do not delete the old images, Yatego does not replace the old image with the new one if they have the same file name.

  • No = Do not delete item images before the import.

Status for all credit card orders

Select status 3 (waiting for payment) or status 5 (cleared for shipping).

Set all credit card orders in status 5 to booked

Select whether or not credit card orders in status 5 should be set to booked.

Status for all Sofortbanking orders

Select status 3 (waiting for payment) or status 5 (cleared for shipping).

Set all Sofortbanking orders in status 5 to booked

Select whether or not Sofortbanking orders in status 5 should be set to booked.

Status for all PayPal orders

Select status 3 (waiting for payment) or status 5 (cleared for shipping).

Set all PayPal orders in status 5 to booked

Select whether or not PayPal orders in status 5 should be set to booked.

Transfer item URL

Select whether or not the item URL should be transferred.

Use all of the images (max. 5) from the long description as the item images

Select whether all item images belonging to an item should be used or not. You can use up to 5 images.

Transfer online store categories

Select All, Only the default category, or No.
The Default category is selected in the Categories tab of an item. If you select the Only the default category option for Yatego, then check which default category was saved for the item in its Categories tab. If you did not select a category there, then the default category is selected automatically. If you have multiple category links, then the first category link is treated as the default category.

Online store category levels

Select which category levels you wish to transfer. You can select any 3 consecutive levels. Note that all the levels must be set up and linked for all of the relevant Yatego items.

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

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option Yatego.

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

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

  6. Click on Save (save).
    → The referrer is active.

4. Setting the variation availability

You need to activate the variations that you want to sell on Yatego. This is done in the Availability and visibility section of a variation within the Item » Items » [Open item] » [Open variation] menu.

  • For one variation

  • Using variation group function

  • Using batch processing

Making a variation available for Yatego:

  1. Go to Item » Items » [Open item] » [Open variation].
    Tip: To sell all variations of an item on Yatego, 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, activate the option Active.

  3. In the Sales channels section, click Add sales channels (add).
    → The window Add sales channels opens.

  4. In the drop-down list Sales channels, select the option Yatego.

  5. Select WEB API.

  6. Click Apply.
    → The sales channel is added.

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

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 Yatego 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. In the drop-down list Sales channels, select the option Yatego.

  7. Select WEB API.

  8. Select the action Active from the drop-down list Actions.
    → The action is added to the lower part of the window.

  9. Activate the option Active.

  10. Navigate to the area Availability.

  11. Click 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 Yatego 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 Yatego.

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

  7. Activate the checkbox to the left of the option Web API.

  8. Activate the checkbox to the right of the option Web API.

  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 Apply to apply the settings to the variations.

5. Optional: Saving SKU

SKU are generated automatically when your variations are exported. However, you can also save market specific SKU for variations that you want to sell on this market instead.

  • Manually adding an SKU

  • Importing SKU

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

  2. Expand the SKU section (keyboard_arrow_down).

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

  4. Select the referrer Yatego from the drop-down list.

  5. Click Apply.

  6. Enter the SKU.

  7. Enter the Parent SKU, if necessary.

  8. Save () the settings.

Only the most important settings for the import are described here. Is this your first time working with the import tool? Then get familiar with how data imports work in PlentyONE first.

  • Create a CSV file with at least the columns described in Table 2.

  • Create an import with the following settings:

    • Select the type Item.

    • Select the matching field Variation ID.

    • Map the PlentyONE data fields as described in Table 2.

Table 2. Recommended columns of the import file
Column in CSV file Explanation PlentyONE data field for mapping

Variation ID

Enter the variation ID in this column.

Variation ID

Marketplace ID

Enter the referrer ID 5 in this column.

SKU > Marketplace ID

Account ID

This market does not require a marketplace account. As such, enter the number 0 in this column.

SKU > Account ID

SKU

Enter the SKU that you want to save for the variation for this market in this column.

SKU > SKU

6. Defining a sales price

To sell variations on Yatego, you need a sales price in which the order referrer Yatego is activated. The price that you save for this sales price is the price that will be shown on Yatego.

What is a sales price?

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. For example, you can sell your items at a lower price in your webshop than on Amazon. Or you can sell products cheaper to B2B customers than to B2C customers.

Two default sales prices are already configured in your PlentyONE system. However, you can also create new sales prices and edit them individually. In addition to default sales prices, you can also create RRPs, special offers, and set prices.

Defining a sales price for Yatego:

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

  2. Open the Settings tab.

  3. Activate the referrer Yatego.

  4. Save () the settings.

7. Linking categories

First, import the official Yatego categories.

Importing Yatego categories:

  1. Go to Setup » Markets » Yatego » Category link.

  2. Click on Update Yatego categories.
    Tip: The Yatego categories appear in the Category link area.

Link your PlentyONE categories to the Yatego categories in order to have your items displayed in these categories. Further items from the linked category are assigned automatically.

Linking categories:

  1. Go to Setup » Markets » Yatego » Category link.

  2. Click on the gear-wheel icon under Yatego link.

  3. Select a category in the Official Yatego categories area.
    Or: As an alternative, you can enter the category ID under Yatego category ID link.

  4. Save () the settings.

Then export your PlentyONE categories in Yatego format.

Exporting PlentyONE categories in Yatego format:

  1. Go to Setup » Markets » Yatego » Category link.

  2. Click on Export online store categories in Yatego format.
    → A new window opens.

  3. Click on OK to save the CSV file.

  4. Import the CSV file at Yatego.
    → The PlentyONE categories are now available at Yatego.

8. Activating characteristics for the market

To use characteristics for Yatego, each characteristic must be activated for the market.

Activating characteristic for the market:

  1. Go to Setup » Item » Characteristics.

  2. Expand the characteristic ().

  3. Activate the option Yatego.

  4. Save () the settings.

  5. Repeat this for all characteristics that you need for the market.

9. Automatically transmitting items

Go to Setup » Markets » Yatego » Settings to carry out the item exchange with Yatego. The functions in this menu are only available after having entered the access data. The preview function allows you to check the data before the transfer takes place. The Yatego import can take a long time. PlentyONE has no control over this.

In order to ensure a smooth item export, make sure that the access data for the Yatego shop are correct and valid.

Full Yatego import

With PlentyONE. you always need to transfer entire data sets to Yatego. This means that all items already existing in Yatego have to be deleted before a new import is carried out. If you already have items in your Yatego account, make sure that you create the same items in PlentyONE first before you allow for the items to be exported to Yatego.

Transmitting items to Yatego:

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

  2. Expand the submenu Item exchange yatego.com (FTP) ().

  3. Click on the corresponding preview icon to check the data that is made available as a CSV file.

  4. After checking the data, click on Transmit data to transfer the data to Yatego.

10. Importing orders

Orders are transferred directly from Yatego if the PlentyONE system with an SSL certificate was booked. The transfer of orders from Yatego to PlentyONE takes place with an encoded connection only. An SSL certificate is necessary for this. If no SSL certificate was booked, this has to be done later.

Tipp: Book SSL certificate

To book an SSL certificate, go to Setup » Client » [Open client] » SSL. In the row Order new SSL for domain: [domain name], click on the down arrow to the right.

11. Permitting payment method in customer classes

The payment method Yatego invoice is automatically available in your PlentyONE system as soon as an active Yatego account exists. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

What are customer classes?

Customer classes allow you to divide your customer base according to specific criteria. Examples of use for customer classes are:

  • Create two separate customer classes for end customers (B2C) and business customers (B2B) respectively. Depending on the customer class, customers either see net prices or gross prices in your plentyShop.

  • Give discounts to specific customer classes.

For more information about customer classes, head over to the to the Managing contacts page.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Allowed payment methods, activate the option Yatego invoice.

  4. Save () the settings.

12. Viewing the API log

The Data » API log menu contains a history of processes that run via the idealo interface. The following formats are available for Yatego:

  • Yatego(new) (item catalogue, variations, attributes)

  • OrdersYatego (order import)

  • Writer_OrdersYatego_Execution (Export)

Viewing the API log:

  1. Go to Data » API log » Tab: API log.

  2. Select a format from the Process drop-down list.

  3. Select a date if you only want to see entries for a specific day.

  4. Click on Search ().
    → The processes are displayed.

  5. Click on the folder in the Process column.
    → The Yatego tab opens and error messages for this process are displayed.

13. FAQ

How does PlentyONE transmit variations that are not limited to stock to Yatego?

The stock limitation is set in the Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Area: Visibility menu. Variations for which the option Limitation is set to None or Do not administer stock for this variation are also transferred to Yatego. PlentyONE sends a value of -1 for these variations, so that Yatego knows that these variations can be bought without limitation.

Can I manually import orders from Yatego to PlentyONE?

Yes. If a Yatego order is manually transferred to PlentyONE from Yatego, then Yatego does not send an item ID or variation ID (attribute_value_set_id). This makes it impossible for the item to be assigned and the item is imported with the item ID -2 (unknown item). Unassigned items are flagged by a green plus icon in the order. The item then has to be assigned manually.

How do I know that the customer has already paid the order?

Yatego neither sends a transaction ID for payments nor other information that indicates whether the order was paid for or not. Therefore, the Yatego settings include an option that allows you to set orders to be booked for some payment methods: Set all orders in status 5 to booked. Select this option if the payment method ensures that payment was already made when the order is booked.

The link for the item in the order does not work. What can I do?

Yatego sends a link for the orders, which directly connects to the item on the Yatego platform. Usually, this link doesn’t work, because Yatego adds "yatego.com" to the name of the online shop. Delete "yatego.com" from the link and then it will work correctly.
Example: http://www.yatego.com/SHOPNAME.yatego.com/p,4fcaaf8c8292c,461e2919becf22_4
The correct format is: http://www.yatego.com/SHOPNAME/p,4fcaaf8c8292c,461e2919becf22_4

I set up Yatego in PlentyONE. Why are my orders not transferred?

The first time that an online shop activates the Yatego order process for PlentyONE. it is common that the first two to three orders will not be automatically transferred to PlentyONE. These orders have to be manually triggered again from within the Yatego system.

I would like to offer an item with attributes. Why does Yatego not display the stock correctly?

Yatego is not able to process the warehouse data records that PlentyONE sends for items if there are more than 999 possible combinations of attributes. As such, all possible combinations of variations are activated for the item and set to endless stock (meaning that stock doesn’t exist for Yatego). If you need to use a large number of attributes, contact Yatego before exporting the corresponding items.

Why does Yatego not immediately edit the CSV files I transferred?

The CSV files that are transferred to Yatego each day are not imported and edited immediately, but rather have to wait in line to be processed. Therefore, the import and editing process can take several hours. You can go to Yatego and check where your file is in line.