Deutsch Français Italiano

Abacus REST

Inhaltsverzeichnis

Introduction

Link your PepperShop e-commerce and POS system directly with your Abacus order processing. Benefit from automated processes and the wide range of functions of both platforms.

Let’s go

To prepare your integration of Abacus and PepperShop, you can start with these steps:

Install the app via the Abacus Marketplace. Obtain the following information:

  • API URL
  • Client number
  • Client ID
  • Client Secret

Instruction video link Abacus - PepperShop

Configuration module

The module is installed by our technicians. After successful installation, you will find it in the store administration under “Modules -> Abacus”.

The following steps should help you to configure the module successfully and use the Abacus API effectively

We now go to the module and check the box “Use Abacus API”. Save your settings below, this will make additional tabs visible.

Figure 1: Aktivieren Abacus REST

General configuration

Switch to the “Configuration” tab and enter the ClientID and Client Secret under “Abacus API”, which you can find in Abacus. Also fill in the URL base and the client before saving the settings.

  • Client ID & Client Secret: Come from the Abacus Q910
  • Token Endpoint: Endpoint to get token, this usually does not need to be changed
  • URL Base: Domain of the Abacus server
  • Client: Client which should be connected

Figure 2: Abacus-API Konfigurieren

Abacus-API

Various jobs can now be executed in the “Abacus API” tab. For example, we open the full import by clicking on the small arrow to the right. You can either automate this job or run it manually. The same applies to other jobs that you can set up as required.

Figure 3: Vollimport

Configuration

Various setting options are available to you in the “Configuration” tab.

  • Display Abacus API receipts: The customer has the option of retrieving their receipts from Abacus via the customer account.

  • Use Abacus E-Business API: With the E-Business interface, Abacus connects to the PepperShop API.

  • Use Abacus API: With the Abacus API, PepperShop connects to the Abacus API.

  • Abacus e-mail address: E-mail address to which, for example, details of payments are sent.

Live price query (Abacus Price API)

Figure 4: Live price query

Force query: The order can only be completed if the prices of all items linked in the shopping cart have been obtained directly from the Abacus real-time price API.

Query sub-item prices in category: Should the prices for all sub-items already be queried in the category display? Performance can deteriorate considerably if this is activated, especially if the number of sub-items per item is large.

Problem notification

Figure 5:

for live price query (Abacus Price API)

  • Recipient: Enter one or more e-mail addresses (comma separated).
  • Interval in hours: Waiting time before new notification is sent.

for order export

  • Recipient: Enter one or more e-mail addresses (comma separated).
  • Tolerance in seconds: Waiting time before new notification is sent.

Abacus-API

Figure 6:

Save dimensions and weights as characteristics: With this setting, the dimensions and weights can be displayed in the store, and the variants can also be created with these. However, if this field is active, the amount of data in the store is increased and slows down the import and the store in general.

Business area: Select your business area here. These are pulled from Abacus. The customers are filtered accordingly.

Order settings

Figure 7:

Shipping costs The shipping costs can either be transferred as an item, in which case the code and product must be defined. Or the shipping costs are transferred as a special shipping costs item. The special shipping costs item always has the VAT code AUT and the VAT is allocated accordingly to the order items.

Discount settings Corresponding articles must be configured for both total article discounts and total total discounts. If a discount item relates to several items with different VAT codes, the item is transferred in split form. This is because an item cannot have multiple VAT rates in Abacus. Alternatively, the total discounts can also be transferred as document discounts. This has the advantage that the items do not have to be split. However, it has the disadvantage that the discounts are always calculated as a percentage (only to 2 decimal places) and there can be a maximum of 4 document discounts. To use the document discounts, the total correction in Abacus must match that of PepperShop.

Mapping

In the mapping tab, we discover existing assignments and have the option of adding more. Choose between different categories such as articles, customers, orders, etc. Here you can see already linked data and can link additional data records.Figure 8:

Status

In the status tab, we have an insight into the system status information. Here you can view the current log file or clear the file cache. Any errors or warnings are displayed here.

Figure 9:

Figure 10:

Instruction video Abacus REST-API functions

Further help

Do you need further support? PepperShop provides you with different options.

🌶️
🔥
🌶️