Skip to main content
  2. Markets and price search engines
  3. Yatego

Yatego

With plentymarkets 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 plentymarkets.

2. Setting up Yatego in plentymarkets

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

Setting up Yatego in plentymarkets:

  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, plentymarkets 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 plentymarkets.

  • Add up, but only once for multiple copies of the same item = plentymarkets 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, plentymarkets does not transfer any shipping costs to Yatego. Based on the weight which is saved in plentymarkets 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 plentymarkets customers who already use the free text field functions in the Yatego settings should use this function. New plentymarkets 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

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 Yatego. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for Yatego:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the option Yatego.

  3. Save () the settings.

4. Setting the variation availability

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

Making a variation available for Yatego:

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

  2. Open the variation that you want to sell on Yatego.
    Tip: To sell all variations of an item on Yatego, 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 Yatego.

  7. Activate the option Web API.

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

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

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

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

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

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

  11. Navigate to the area Availability.

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

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

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

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

  5. Enter the SKU.

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

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 plentymarkets 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 plentymarkets data fields as described in Table 2.

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

Variation ID

Enter the variation ID in this column.

Variation ID

Market 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 > Marketplace 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

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

Defining a sales price for Yatego:

  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 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 plentymarkets 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 plentymarkets categories in Yatego format.

Exporting plentymarkets 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 plentymarkets 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. plentymarkets 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 plentymarkets, 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 plentymarkets 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 plentymarkets system with an SSL certificate was booked. The transfer of orders from Yatego to plentymarkets 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. Activating the payment method

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

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Classes.

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

  3. For the setting Permitted 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 plentymarkets 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. plentymarkets 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 plentymarkets?

Yes. If a Yatego order is manually transferred to plentymarkets 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 plentymarkets. Why are my orders not transferred?

The first time that an online shop activates the Yatego order process for plentymarkets, it is common that the first two to three orders will not be automatically transferred to plentymarkets. 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 plentymarkets 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.

To top