Configuring shipping rates via plugin API
In this article, you will learn how to offer the shipping costs automatically calculated by your shop system in your app.
Getting started
To have the shipping costs for your app customers calculated directly by your shop system, your shop must meet both of the following requirements:
| 1. Your shop system is connected to the Shopgate backend | |
|
The shipping costs configured in your shop system are imported via an API method provided by the Shopgate plugin. It is therefore necessary that the Shopgate plugin has been installed in your shop system beforehand and that there is a connection to the Shopgate backend. ☞ To check whether the connection to your shop system has been set up correctly, follow How to check the connection of your plugin
☞ To install the plugin for your shop system, please click the corresponding entry below. |
|
| 2. Your shop system is listed below: | |
| Magento 2 | OXID |
| Self-developed shop system* | |
|
* For this, you need to implement the check-cart function.
|
|
If both requirements are met, continue. If you need to set up the shipping costs for your app manually, please follow the instructions in the article Managing your manual shipping rates.
Setting up shipping costs
- Log in to your Shopgate Admin.
- Then click Settings in the menu and select Shipping.
- In the drop-down menu "+Add a rate", select Shopgate Plugin.
- Enter the name, descriptions, taxes and delivery countries in the form. When you click Save, your settings are saved and transferred directly to your app.
- You can find more details about your configuration options in the text below.
Configuring shipping options
Name and description

| Shipping Title | This name is shown in the app at checkout under "Shipping costs". |
| Internal name | The name of your shipping method is only visible to you. This information is not shown in your app. |
| Description | The description is shown to your customers in the app during checkout. |
Taxes

| Tax |
Select "Gross" if taxes are included in the shipping costs. Select "Net" to charge additional taxes on the shipping costs. |
Delivery countries

| Delivery countries | Check every country for which your delivery terms should apply. You can select different continents via the tabs (see above). |
When you click Save, the settings for your delivery terms are complete and are transferred to your app.
Checking the shipping costs
To make sure that shipping works smoothly in your app, we recommend placing a test order. Settings may get lost or be changed incorrectly when the data is transferred.
Open your app, add any products to your cart and complete the purchase. Compare the delivery terms with those in your online shop. Repeat this a few times with different products and/or delivery countries to make sure your data is correct.
Frequently Asked Questions
Why do I not get any shipping costs when I use the "PayPal Express" button on the product detail page?
Remove the "PayPal Express" button from your product detail page and place it on the checkout page instead. The shipping data is only retrieved from your online shop during checkout. If customers try to order a product on the product detail page, the shipping settings are not transferred.
Why do I get the error "Unable to deliver to the shipping address"?
- Make sure that the country is enabled in the settings of your shipping options.
- Check whether you entered your data correctly when installing the Shopgate plugin.
Why are shipping options not shown?
If your shop uses a plugin or an extension that calculates the shipping options, the Shopgate plugin cannot reliably take over your shipping options. In some shop systems, the shipping settings may not work 100% reliably when they are taken over from your online shop. If this is the case for you as well, deactivate the Shopgate plugin for shipping and add your terms manually.