Enter the user name for logging in to Yatego.com.
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:
-
Go to Setup » Markets » Yatego » Settings.
-
Expand the Basic settings area ().
-
Carry out the settings. Pay attention to the explanations given in Table 1.
-
Save () the settings.
Setting | Explanation |
---|---|
User name (Yatego store name) |
|
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 |
|
Sorting of variations |
Select Alphabetical, Surcharge, or No sorting. |
Transfer RRP |
|
Automatic upload (daily) |
Activate in order to automatically transfer item data to Yatego each day. |
Sold out variations |
|
Yatego characteristics |
|
Free text fields 1 to 20 |
|
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? |
|
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. |
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:
-
Go to Setup » Orders » Order referrer.
-
Activate the option Yatego.
-
Save () the settings.
4. Setting the variation availability
You need to activate all 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] » Tab: Variation ID menu.
Use group function or batch processing
You can edit the availability of several variations at once by using either the variation group function or batch processing. |
Setting the variation availability for Yatego:
-
Go to Item » Edit item » [Open item] » Tab: Variation ID » Tab: Settings.
-
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. -
In the Availability area, activate the option Active.
-
Click on the Availability tab.
-
In the Markets area, click in the selection field.
→ A list of all available markets is displayed. -
Activate the option Yatego.
-
Activate the option Web API.
-
Click on Add ().
→ The market is added. -
Save () the settings.
→ The variation is available for Yatego.
5. Saving SKU
If necessary, save market specific SKU for those variations that you want to sell on this market.
-
Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.
-
Click on the Availability tab.
-
In the SKU area, click on Add ().
→ The New SKU window opens. -
Select the referrer Yatego.
-
Enter the SKU.
-
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. |
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
Proceed as described below to define a sales price for the order referrer Yatego. This price is displayed on Yatego.
Defining a sales price for Yatego:
-
Go to Setup » Item » Sales prices » [Open sales price] » Tab: Settings.
-
Activate the referrer Yatego.
-
Save () the settings.
7. Linking categories
First, import the official Yatego categories.
Importing Yatego categories:
-
Go to Setup » Markets » Yatego » Category link.
-
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:
-
Go to Setup » Markets » Yatego » Category link.
-
Click on the gear-wheel icon under Yatego link.
-
Select a category in the Official Yatego categories area.
Or: As an alternative, you can enter the category ID under Yatego category ID link. -
Save () the settings.
Then export your plentymarkets categories in Yatego format.
Exporting plentymarkets categories in Yatego format:
-
Go to Setup » Markets » Yatego » Category link.
-
Click on Export online store categories in Yatego format.
→ A new window opens. -
Click on OK to save the CSV file.
-
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:
-
Go to Setup » Item » Characteristics.
-
Expand the characteristic ().
-
Activate the option Yatego.
-
Save () the settings.
-
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:
-
Go to Setup » Markets » Yatego » Settings.
-
Expand the submenu Item exchange yatego.com (FTP) ().
-
Click on the corresponding preview icon to check the data that is made available as a CSV file.
-
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
Activate the payment method Yatego invoice as described below.
Activating the payment method Yatego invoice:
-
Go to Setup » Orders » Payment » Methods.
-
Activate the option Also show inactive.
-
Open the folder DE.
-
Click on Yatego invoice.
→ The Settings tab opens. -
Carry out the settings. Pay attention to the information given in [table-payment-method].
-
Place a check mark next to the option Active.
-
Save () the settings.
Setting | Explanation |
---|---|
Language |
The following options are saved for the language selected: Name, Info page, Info page (internal), Logo, and Upload logo. This enables you to enter values for these options in various languages. The values for a language are activated as soon as a buyer selects the language in the plentyShop. |
Name |
Enter the name that should be displayed in the plentyShop and on invoices etc. |
Info page |
Select a category page of the type content or enter the URL of a website to provide information about the payment method. |
Info page (external) |
If you selected the Info page (external) option under Info page, then enter the URL of the info page here. |
Countries of delivery |
Do not select a country of delivery. |
Logo |
Select one of the following options for displaying the logo:
|
Logo view |
If Show upload logo was selected from the Logo drop-down list, then the logo that was uploaded is displayed here. |
Upload logo |
If Show upload logo was selected from the Logo drop-down list, then upload an external logo here. |
Priority |
Select the priority for displaying the payment method in the plentyShop. |
Costs: Flat rate or percentage |
If the payment method results in additional costs, enter the percentage value or flat rate value. The selection depends on the conditions of your contract. |
Permitting the payment method in customer classes
Go to Setup » CRM » Classes to activate or deactivate permitted payment methods. |
For further information, refer to the Managing payment methods page.
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:
-
Go to Data » API log » Tab: API log.
-
Select a format from the Process drop-down list.
-
Select a date if you only want to see entries for a specific day.
-
Click on Search ().
→ The processes are displayed. -
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] » Tab: Variation ID » 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.