Fruugo

Fruugo is a global market, which allows customers to shop in their own country’s language and currency. Item descriptions are automatically translated into the target language and prices are converted into the local currency. This strengthens your international presence without major expenditure in terms of time or money.

1. Registering with Fruugo

You need to register with Fruugo before setting up Fruugo in plentymarkets.

2. Setting up Fruugo in plentymarkets

Set up Fruugo in plentymarkets first in order to offer items on the market. To do so, proceed as follows.

Setting up Fruugo in plentymarkets:

Go to System » Markets » Fruugo » Settings.
Carry out the settings. Pay attention to the explanations given in table 1.
Save the settings.

Table 1. Basic settings for the market Fruugo
Setting	Explanation
Activate automatic data exchange	Activate the data exchange. If the data exchange is activated, then an order import is carried out once an hour.
User name Password	Enter the access data that you received from Fruugo.
Language	Choose the language in which texts should be transferred to Fruugo. Important: Item texts must be entered in the same language as chosen here in order to transfer the item to Fruugo.
Item name	Select Name 1, Name 2 or Name 3. This item name is transferred to Fruugo.
Item description	Select the Item text, Preview text or Technical data saved in the item’s Texts tab or select one of the free text fields saved in the item’s Fields tab. This item description is transferred to Fruugo.
Warehouse selection	Select one of the following options: Transfer stock quantity of distribution warehouse that currently has largest stock Use item’s main warehouse Transfer sum of stock quantities from all distribution warehouses
Barcode exemption	Select one of the following options: Yes: Items without a barcode are transferred to Fruugo. No: Items without a barcode are not transferred to Fruugo. You must have the permission granted by Fruugo to list items without the barcode before you can select Yes here.
Data export URL	Is automatically generated after the user name and password have been saved. Send Fruugo this URL via email. It is not transferred automatically.

Connecting to this market allows for the following automatic processes to take place:

hourly order import
Automatic creation of a new customer data record during the order import. This assumes no customer data record has yet been saved in the database.

Currency may differ for import and export

The store’s standard currency is transferred to Fruugo when exporting the item information. However, when orders are imported, the sum is in whichever currency the customer paid with.

No interface for stock and price synchronisation

Fruugo does currently not provide an interface for automatic stock and price synchronisation. Instead, Fruugo exports data from plentymarkets via the data export URL which must be transferred to Fruugo after registration and setup. Fruugo decides how often the data export takes place depending on the data Fruugo receives from your sales on the market.

Only items with stock are exported to Fruugo.

3. Activating an order referrer

In order to link items, properties etc. with Fruugo, you have to activate the order referrer Fruugo in the menu System » Orders » Order referrer.

Activating the order referrer Fruugo:

Go to System » Orders » Order referrer.
Place a check mark next to the option Fruugo.
Save the settings.

4. Setting the item availability

Items have to be available for Fruugo. This is done in the Availability tab of an item within the Item » Edit item » Tab: Variation ID menu.

Setting the item availability for Fruugo:

Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.
Activate the main variation in the Availability section.
Click on the Availability tab.
Click in the selection field in the Markets section.
→ A list with all available markets is displayed.
Place a check mark next to the option Fruugo.
Place a check mark next to the option Web API.
Click on Add.
→ The market is added.
Save the settings.
→ The item is available on Fruugo.

The availability for variations can be individually edited in the Item » Edit item » Open item » Tab: Variations » Open variation » Tab: Variation ID » Tab: Availability menu.

5. Defining a sales price

Proceed as described below to define a sales price for the order referrer Fruugo. This price is displayed on Fruugo.

Defining a sales price for Fruugo:

Open the menu System » Item » Sales prices » Open sales price » Tab: Settings.
Place a check mark next to the referrer Fruugo.
Save the settings.

6. Linking attributes

If you have created the attributes Colour and/or Size in your plentymarkets system, you have to link these attributes with Fruugo. Proceed as described below to link the attribute Colour with Fruugo. Then link the attribute Size the same way.

Linking the attribute Colour:

Go to System » Item » Attributes.
→ An overview of all existing attributes opens.
Expand the attribute Colour.
Open the Market variation tab.
Select the option Fruugo from the Market drop-down list.
→ The Fruugo drop-down list is displayed.
Select the attribute Colour from the Fruugo drop-down list.
Save the settings.
If needed, repeat this procedure for the attribute Size.

7. Sending shipping costs

Fruugo requires a list of shipping costs from each seller. This list cannot be transferred via the API. Therefore, upload a file which includes shipping information directly on Fruugo. Further information and a file template are availablehere.

8. Activating the payment method

Activate the payment method Fruugo as described below.

Activating the Fruugo payment method:

Go to System » Orders » Payment » Methods.
Click on the folder International > Fruugo.
→ The settings for the Fruugo payment method are displayed.
Carry out the settings. Pay attention to the information given in table 2.
Place a check mark next to the option Active.
Save the settings.

Table 2. Settings for the payment method
Setting	Explanation
Language	The following options are saved for the language selected: Name, Info page, Info page (internal), Logo and Upload logo. This makes it possible 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 online store.
Name	Enter the name that should be displayed in the online store 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 have selected the option Info page (external) under Info page, then enter the URL of the info page here.
Countries of delivery	Do not select a country of delivery. You cannot use the payment method in your online store. Therefore, this payment method is only activated in plentymarkets. It is not completely set up.
Logo	Select one of the following options for displaying the logo: Show standard logo = The logo that is saved in plentymarkets for this payment method is displayed. Do not show a logo = The logo that is saved in plentymarkets for this payment method is not displayed. Show upload logo = The options Logo view and Upload logo are displayed.
Logo view	If Show upload logo has been selected from the Logo drop-down list, then the logo that has been uploaded is displayed here.
Upload logo	If Show upload logo has been selected from the Logo drop-down list, upload an external logo here. Click on Upload files and select the logo that you want to upload for the payment method. Permitted data formats: GIF, PNG and JPG.
Priority	Select the priority for displaying the payment method in the online store.
Costs: Flat rate or percentage	If the payment method results in additional costs, enter the percentage value or flat rate value. The choice depends on the conditions of your contract. Important: Do not enter a value into both fields. For further information, refer to the Statistics page of the manual. For an example of flat rate and percentage costs, refer to the Managing payment methods page of the manual.

Permitting the payment method in customer classes

Go to System » CRM » Classes to activate or deactivate Permitted payment methods.
For further information, refer to the Permitting the payment method in a customer class chapter of the manual.

For further information, refer to the Payment methods page of the manual.

9. Automatically sending order confirmations

Set up an event procedure to automatically send an order confirmation to Fruugo.

Setting up an event procedure

Go to System » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in table 3.
Save the settings.
Carry out the settings. Pay attention to the explanations given in table 3.
Place a check mark next to the option Active.
Save the settings.

Table 3. Event procedure for sending automatic order confirmations to Fruugo
Setting	Option	Selection
Event	Order generation: New order
Filter 1	Order > Order type	Order
Filter 2	Order > Referrer	Fruugo
Procedure	Order > Send order confirmation to Fruugo

10. Automatically sending shipping confirmations

Set up an event procedure to automatically send a shipping confirmation to Fruugo when the outgoing items have been booked.

Setting up an event procedure

Go to System » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in table 4.
Save the settings.
Carry out the settings. Pay attention to the explanations given in table 4.
Place a check mark next to the option Active.
Save the settings.

Table 4. Event procedure for sending automatic shipping confirmations to Fruugo
Setting	Option	Selection
Event	Order change: Outgoing items booked
Filter 1	Order > Order type	Order
Filter 2	Order > Referrer	Fruugo
Procedure	Shipping > Send shipping confirmation to Fruugo

11. Automatically sending cancellations

Set up an event procedure to automatically inform Fruugo of cancellations.

Setting up an event procedure

Go to System » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in table 5.
Save the settings.
Carry out the settings. Pay attention to the explanations given in table 5.
Place a check mark next to the option Active.
Save the settings.

Table 5. Event procedure for sending automatic cancellations to Fruugo
Setting	Option	Selection
Event	Status change: [8] Cancelled
Filter 1	Order > Order type	Order
Filter 2	Order > Referrer	Fruugo
Procedure	Order > Send cancellation to Fruugo

12. Automatically sending returns

Set up an event procedure to automatically inform Fruugo about returns.

Setting up an event procedure

Go to System » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in table 6.
Save the settings.
Carry out the settings. Pay attention to the explanations in table 6.
Place a check mark next to the option Active.
Save the settings.

Table 6. Event procedure for sending automatic returns to Fruugo
Setting	Option	Selection
Event	Order generation: New return
Filter 1	Order > Order type	Return
Filter 2	Order > Referrer	Fruugo
Procedure	Return > Send return to Fruugo

13. Viewing the API log

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

Fruugo (order import)
FruugoGetOrders (cancellations, Order confirmation)

Viewing the API log:

Go to Data » API log » Tab: API log.
Select a format from the drop-down list Process.
Select a date if you only want to see entries for a specific day.
Click on Search to carry out the search.
→ The processes are displayed.