For the complete documentation index, see llms.txt. This page is also available as Markdown.

Installation and Permissions

Install the app, check the version and assign the appropriate GLS permission sets for setup, shipping and tariffs.

This page describes how to install the app and assign the permissions for setup, shipping and tariff administration.

Install the app

  1. Install the GLS Connector by solutioo from Microsoft AppSource or from the Extension Marketplace in Business Central. Start with your sandbox.

  2. After installation, open Extension Management and check which version is installed.

  3. Select the GLS Connector in Extension Management and open Configure. In the extension settings, turn on Allow HttpClient Requests, which permits outbound HTTP requests. Without this permission, the app cannot call GLS. Microsoft describes this setting here.

  4. Once testing has succeeded, repeat the installation and the HTTP permission in the production environment.

This documentation describes version 26.13.40.0. The app has no version display of its own; Extension Management is the authoritative source.

HTTP permission for the GLS Connector

GLS extension settings in the German user interface, showing version 26.13.40.1015 and the „HttpClient-Anfragen zulassen“ (Allow HttpClient Requests) toggle switched on.
Check the installed version of the GLS Connector in the extension settings. The screenshot shows the German user interface; „HttpClient-Anfragen zulassen“ (Allow HttpClient Requests) is switched on.

What the installation creates

For each company, the app creates a default configuration if none exists yet: Environment Sandbox, Template Set NONE, Label Format PNG. Credentials, shipper data and shipments are not set up at this point. You complete these steps in the Setup.

Permission sets

Permission set
Intended for
Scope

GLS Super User

Administrators and key users

Setup and shipping

GLS Integration User

Day-to-day shipping

Shipping and reading the configuration

GLS Base Access

Foundation

Not a complete shipping role; not sufficient on its own for shipping

GLS Tariff Calculation User

People who calculate shipping costs

Use of the local tariff calculation

GLS Tariff Administrator

People who maintain tariffs

Import, validation and activation of tariffs

Assign these sets only in combination with your usual Business Central permissions, for example for sales orders. Other GLS permissions that are used only internally are not intended to be assigned to users directly.

Typical assignment

Role
Recommended GLS sets

Setup and support

GLS Super User

Shipping and warehouse

GLS Integration User

Checking shipping costs

GLS Integration User + GLS Tariff Calculation User

Maintaining tariffs

GLS Tariff Administrator (in addition to the respective role)

Assign permissions

  1. Search for Users and open the user card.

  2. In the User Permission Sets section, add the required GLS set. Alternatively, use the security groups of your environment.

  3. Have the person sign in again and check whether they can open GLS Packages and GLS Configuration.

Verification

  • The person with GLS Super User can edit the configuration and run the wizard.

  • The person with GLS Integration User sees the GLS actions on the sales order and can transmit packages.

  • If an action is missing or a permission message appears, check the license and permission set first. See Monitoring and Troubleshooting.