With this interface you can connect Xentral to the online marketplace Manomano to import orders from there into Xentral.
-
Import sales orders
-
Report order status to Manomano
-
Feedback of bearing numbers
-
Article export from Xentral to Manomano (via process starter generated CSV file)
You can check which functions are possible in detail under Administration → Shop interface → Overview → Shop functions.
Under Administration → Shop interface → Overview → NEW you can search for Manomano search.
After you have selected Manomano, you can enter the necessary data for connecting the two systems in the next step.
This is how to fill the fields:
-
Login → Username of the API user from Manomano
-
Password → API password from Manomano
-
Article feed path → Path of the location on your server where the CSV file of your Manomano articles created by the process launcher is to be stored
Note
API user and API password must be requested directly from the account manager at Manomano.
Prerequisite for the connection of Xentral Cloud customers is an external web space that must be made accessible to Xentral via FTP. The generated article feeds are then stored here and can be made available to ManoMano. The FTP passive mode must normally be activated.
The local path for the article feed for cloud customers is: /home/ubuntu/xentral/userdata/tmp/xentral
Once the data has been entered, you can check the connection between both systems via the "check connection" button on the right side of the screen.
Once the connection is successful, you will receive the message "success". If the connection was not established successfully, then you will be informed by a message.
For information on the interface settings, check this article: Online shops.
The Manomano interface does not allow automated article export from Xentral to the marketplace.
Instead, you can enter a path for a local directory on the server or similar. The process starter "Provision article feed Manomano" (parameter: articlefeed_manomano) will generate a CSV file in the set period. Which will later contain all articles that have a Manomano link. under Article → Online Shop Options, allow the stock number sync and are not deleted or locked.
Manomano must then be able to access this path externally in order to fetch the article feed from there.
In order for articles to be exported to ManoMano via the article feed, the following requirements are necessary:
-
Online store link and sales price maintained
-
Subshop mapping in the ManoMano importer.
The export for the individual languages is set up via the subshop mapping. In the example only Germany is set.
In the identification under point 1 you can choose the name freely - it could be e.g. only the country code DE.
Under point 2 you have to enter a project. But this is not relevant, because it is neither evaluated nor used later. It is only not possible to save without a project.
Under point 3 you set the language of the subshop.
You can say that the subshop displays the respective article feed in the set language.
-
In order to export files, they must be transferred once to the store via the export arrow, which is also acknowledged accordingly.
-
After that, the manomano cronjob must run through, which first generates the article file and then transfers it to the FTP.
-
On the FTP is then the file that you can provide ManoMano in whatever form it wishes.
To import sales orders, Xentral makes the following two API calls:
-
get_orders
Imports the sales orders to your Xentral instance.
-
accept_orders
After the import, this API call sets the status of the imported sales order to In preparation in your shop. Sales orders with status In preparation will not be imported.
Note
If a sales order is not imported correctly, please check the sales order status in your shop.