Activate the data exchange. If the data exchange is activated, then an order import is carried out hourly.
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 Setup » Markets » Fruugo.
-
Carry out the settings as desired. Pay attention to the explanations given in table Table 1.
-
Save () the settings.
Setting | Explanation |
---|---|
Active |
|
User name |
Enter the access data that you received from Fruugo. |
Language |
Select the language in which texts should be transferred 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: |
Barcode exemption |
Select one of the following options:
|
Data export URL |
Is automatically generated after the user name and password have been saved. Send Fruugo this URL via email as it is not transferred automatically. |
Connecting to this market allows for the following automatic processes to take place:
-
hourly order import
-
Automatically create a new customer data record during the order import. This is assuming no customer data record has yet been saved in the database.
The currency may differ for import and export
The store’s standard currency is transferred to Fruugo when exporting the item’s information. However, when orders are imported, the amount will be 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 has to 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 the order referrer
In order to link items, properties etc. with Fruugo, you have to activate the order referrer Fruugo in the Setup » Orders » Order referrer menu.
Activating the order referrer Fruugo:
-
Go to Setup » Orders » Order referrer.
-
Activate the referrer Fruugo.
-
Save () the settings.
4. Setting the variation availability
You need to activate all variations that you want to sell on Fruugo. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » Tab: Variation ID menu.
Selling all variations of an item on Fruugo
If you want to sell all variations of an item on Fruugo, carry out the settings below for the item’s main variation. All other variations of the item then inherit the settings of the main variation. |
Activating the variation availability for Fruugo:
-
Go to Item » Edit item » [Open item] » Tab: Variation ID » Tab: Settings.
-
Open the variation that you want to sell on Fruugo.
-
In the Availability area, active 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 Fruugo.
-
Activate the option Web API.
-
Click on Add ().
→ The market is added. -
Save () the settings.
5. Defining a sales price
Proceed as described below to define a sales price for the order referrer {referrer}. This price is displayed on {referrer}.
Defining a sales price for {referrer}:
-
Go to Setup » Item » Sales prices » [Open sales price] » Tab: Settings.
-
Activate the referrer {referrer}.
-
Save () the settings.
6. Linking attributes
If you 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 Setup » Item » Attributes.
→ An overview of all existing attributes opens. -
Expand the attribute colour.
-
Click on 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 process 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 this information directly on Fruugo. Further information and a file template are available here .
8. Activating the payment method
Activate the payment method Fruugo as described below.
Activating the Fruugo payment method:
-
Go to Setup » 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 explanations given in Table 2.
-
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. Important: Do not enter a value into both fields. |
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.
9. Automatically sending order confirmations
Set up an event procedure to automatically send an order confirmation to Fruugo.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 3.
-
Save () the settings.
-
Carry out the settings according to Table 3.
-
Place a check mark next to the option Active ().
-
Save () the settings.
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.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 4.
-
Save () the settings.
-
Carry out the settings according to Table 4.
-
Place a check mark next to the option Active ().
-
Save () the settings.
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.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 5.
-
Save () the settings.
-
Carry out the settings according to Table 5.
-
Place a check mark next to the option Active ().
-
Save () the settings.
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.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 6.
-
Save () the settings.
-
Carry out the settings according to Table 6.
-
Place a check mark next to the option Active ().
-
Save () the settings.
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 Data » API log menu 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 Process drop-down list.
-
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.