7.6 Online store settings

Setting up new online stores

To set up a new interface for an online store in gFM-Business 4.0, navigate in the main menu or in the internal navigation to the mask [Settings > Online stores].

gFM-Business 4.0 supports the use of any number of online stores from the following systems:

  • Gambio GX3 (API v2.1.0)
  • Shopware (Shopware 5.x REST API)
  • WooCommerce for WordPress (API v3)

Create a new online store

To connect an online store to the gFM-Business ERP software, click on the add icon on the right above the list of set up and available online stores [+]. You can switch between different online stores simply by clicking on the corresponding line. In gFM-Business free and Basic you can start setting up your online store straight away. Simply select the desired store type and enter the corresponding server data as described below.

Set up online store interfaces

Enter the following data in the popover dialog:

  • External system: Unique name of the external system, freely selectable
  • Store typeSelection of the store system (Gambio GX3, Shopware or WooCommerce)
  • API URLURL to the RESTful API of your online store. The URL must contain the domain of your online store and the extension for the REST API.
    • Gambio GX3: http://www.ihrshop.de/api.php/v2
    • Shopware: http://www.ihrshop.de/api
    • WooCommerce: http://ihrshop.de/wc-api/v3
  • Consumer keyLogin with rights to the RESTful API. You can find information on how to set up such a user if necessary in the documentation for your online store.
  • Consumer SecretPassword to login

All data can be taken from the backend of your store system. Please note that the REST API must be activated in your online store. The user entered in the [Consumer key] must have read and write permissions for the REST API of your online store.

After confirming the dialog with the [New] a new interface to your online store is created and all default values for your online store are automatically entered. You can adapt all values to your requirements if necessary.

  • Start objectObject name of the transferred JSON file, separately for articles, customers and orders. These values are entered automatically during creation and generally do not need to be changed.
  • Endpoint/parameterEnd point and optional parameter for controlling the interface, separately for items, customers and orders. These values are entered automatically during creation and generally do not need to be changed.

Import settings

For data import via the online store interfaces, separate settings can be made for each online store set up:

  • Import methodTwo different import methods are available in gFM-Business for the transfer of customers, orders and article data. With the option [Import selection] a selection window is displayed before the import, which shows all customers, orders and articles available in the online store before the import. The user can then select which data records are to be imported into gFM Business. With the option [Import automatically] all new customers, orders or articles since the last import are automatically imported. Please note that the automatic import may also import fake, test or spam orders.
  • Customer type: Specify here which customer type should be assigned to the data records imported from the online store.
  • Path article images (only for Gambio GX3): Specify the path under which item images are saved here. This option is only required for the interface to Gambio GX3 online stores. The default path is: [http://ihr-onlineshop.de/images/product_images/popup_images/).
  • Fixed categorySince not all online stores provide information on categories in their interfaces, you can specify here whether newly imported items from this online store should be assigned to a fixed item category.
  • Storage locationSpecify here whether newly imported items from this online store should be automatically assigned to a storage location. Imported stock from the online store is then automatically posted to the specified storage location.
  • Stock: If the option [Stock] is set to "Add", the stock of the item is automatically added to the specified storage location during import and a corresponding entry is created in the stock log.
  • Document address/delivery addressWith these options you can specify which address type newly imported customers from orders should receive with the distinction between the billing and delivery address.
  • Paid" status: Specify here which status is active for an order if the order has been paid for (e.g. via PayPal). If an order with this status is imported as an invoice, the payment is automatically entered in the invoice during the import.
  • Completed" status: Enter the status of a completed order here.
  • Stock bookings: With the option [Check stock] the stock of the online store is automatically replaced by the stock from gFM-Business when the item is posted in or out of the invoice.
  • Status: The selected online store interface can be activated or deactivated here. Only active interfaces can be selected for data import.

Perform connection test

After setting up an online store, the function [Connection test] which can be used to test the connection to the online store. If the connection is successful, a corresponding message appears on the screen.