Table of contents
With the interface Billbee Importer you can import orders from the merchandise management system Billbee to Xentral. The importer works exactly like an interface to an online store.
Interface features
- Import jobs
- Feedback of the order status to Billbee
- Feedback of stock figures to Billbee
Installation in xentral
After Billbee, you can enter the necessary data for the connection of the two systems in the next step. This is the username with which you you log in to Billbee and the API password that was assigned in Billbee for the the API.
Find credentials in Billbee
You can enter the user name and the API password in the interface settings. The account to which the username belongs must be an administrator in Billbee. The API password can be found in Billbee under Settings → System → Billbee API.
Check connection data
Once the data has been entered, you can check the connection between the two systems using the "Check Connection" button on the right side of the screen.
As soon as the connection is successful, you will receive the message "success". If the connection is not established successfully, a message will inform you of the cause.
Import orders
In Billbee there are different status messages with associated IDs. By the Billbee ID in the store settings, you can define which type of orders should be addressed via the interface.
To find out which Billbee IDs are hidden behind the status names, you have to use the console of your browser in the Billbee backend. With a Right click → Examine item this can be opened.
The IDs determined must then be entered in the store settings.
Detail settings
Billbee is not an online store, but the settings of the Billbee Importer work analogs to the store importers of xentral. You can find more information in the article OnlineShop connection: Settings.
Shipping Types Mapping
When you click on "Check connection" (Details → Interface) the interface imports all shipping service providers (carriers) that are available in Billbee. In addition mapping with carriers, xentral now also has a mapping for the product. So the shipping providers are displayed and additionally the respective product ID.
Afterwards, the created shipping types must be mapped to the corresponding shipping types in the "Shipping types" tab. More information about the shipping type mapping can be found here. This mapping must be done in each created Billbee interface. There is a new mapping field with the name "Product Outbound". Here you can enter the product ID for the shipping method.
It is necessary that the mapping is done in each Billbee interface so that the feedback of the tracking number of dispatched orders used can be returned to Billbee.
If the shipping provider data changes on the part of Billbee, the data can be updated at any time by clicking the "Check connection" button. button.
In the log file of the store interface, any error messages regarding the shipping type mapping are listed. The message "Carriers have not yet been retrieved from the store" will occur if the carriers have not yet been added using the Check Connection button.