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

Prerequisites and Compatibility

What you need before installation: Business Central version, GLS credentials, master data and compatibility notes.

Check these points before installation. This prevents the setup from failing because of missing credentials or incomplete master data.

Business Central

Requirement
Value

Product

Microsoft Dynamics 365 Business Central

Minimum application version

25.0

App version described

26.13.40.0

Dependencies on other apps

none

The app requires at least Business Central 25.0. Business Central shows you during installation whether a specific version can be installed in your environment.

For the rollout, we recommend a Business Central sandbox. There you can complete the setup and a test shipment without changing your production company.

GLS

You need the following from GLS:

  • a business customer contract that is enabled for your GLS shipping API,

  • access to the GLS shipping API with a Client ID, Client Secret and Contact ID,

  • separate credentials for sandbox and production,

  • the products and services approved in your contract, for example for international shipping, hazardous goods, ShopReturn or Pick&Return.

Master data in Business Central

  • Company Information or an alternative shipper address with a complete address.

  • Countries/Regions with a maintained EU Country/Region Code. The connector uses it to determine whether a shipment crosses a customs border.

  • Items with weights and, ideally, dimensions on the item units of measure.

  • At least one GLS box or a reasonable default maximum weight in the configuration.

  • Customers with complete ship-to addresses.

For details, see Prepare Boxes and Items.

Printing

The app provides labels as PDF, PNG or Zebra. Use PNG for integrated batch printing from Business Central. Zebra data requires a suitable label printer and a way to send the file to it. For more information, see Labels, Printing and Tracking.

People and permissions

  • A person with administrator rights installs the app and assigns permission sets.

  • Anyone who maintains the setup needs GLS Super User.

  • Anyone who ships needs at least GLS Integration User.