Table of Contents

Installation and Registration

This article describes the prerequisites and installation and registration steps for Advanced Intercompany in Business Central online and on-premises.

Requirements

  1. Additional requirements for an on-premises installation:

    • BC Instance with NavUserPassword authentication must exist.

    • There must be a service account for the NavUserPassword instance (can be the same as for other instances). It must have the Log on as a Service permission.

    • There must be SSL certificate installed on and trusted by each communicating server. It can be either an external CA certificate, or a self-signed added as trusted on each server.

    • The service account must have permissions to the certificate private key.

    See more at Authentication and Credential Types for Dynamics 365 Business Central.

  2. User account with password or Web Service Access Key, that has permissions to both companies, or multiple users.

Installing the Application for Business Central Online

To install Advanced Intercompany for Business Central online:

  1. On the AppSource offer page, select Free Trial.
  2. Choose the environment on which you would like to install the app (sandbox/ or production).
  3. Press the Install button.

Installing the Application for Business Central On-Premises

To install Advanced Intercompany for Business Central on-premises:

  1. Download the installation file from the IT.integro Product Portal. Add the Advanced Intercompany functionality for NAV and D365BC application for the client license.
Important

The IT.integro Product Portal can be accessed only by authorized IT.integro partners.

Caution

When installing the application, you have to be assisted by an authorized IT.integro partner.

  1. Run Dynamics NAV Administration Shell as an administrator.

  2. To publish Advanced Intercompany run the command:

Publish-NAVApp -ServerInstance YourDynamicsNAVServer -Path ".\\IT.integro sp. z o.o._Advanced Intercompany.app"
  1. To synchronize Advanced Intercompany run the command:
Sync-NAVApp -ServerInstance YourDynamicsNAVServer -Name "App Name" -Version VersionNo. -Tenant [Tenant1, Tenant 2, default]
Tip

The Tenant parameter can be skipped for a single-tenant instance or set as default. For multi-tenant instances, each tenant to be synchronized has to be listed.

  1. To install Advanced Intercompany run the command:
Install-NAVApp -ServerInstance YourDynamicsNAVServer -Name "App Name" -Tenant [Tenant1, Tenant2, default]
Tip

It is recommended to install the latest application version available.

Important

In BC 28 (backported to BC 27 and 26), the AL HttpClient was enhanced with anti‑SSRF validation. By default, HTTP requests to internal IP addresses are blocked. If access to internal addresses is required, this can be configured via server settings (NavHttpClientAntiSSRFEnabled and NavHttpClientAntiSSRFAllowedAddresses). For more information, see Server-side certificate validation

Installing the Preview Version for Business Central Online

This section describes how to install the preview version of the Advanced Intercompany for Business Central online. The preview version provides new features that are not yet available in the officially released version and is only possible to install as a trial version (Sandbox) in an online environment.

To install the preview version of Advanced Intercompany for Business Central online:

  1. Create a special installation link containing a unique key. The link consists of the following elements: https://businesscentral.dynamics.com/[TenantID]/?noSignUpCheck=1&filter='ID' IS '[AppID]' AND 'PreviewKey' IS '[PreviewKey]'&page=2503
    where
    • TenantID - The ID of the tenant on which the preview version of the application is to be installed.
    • AppId - application ID, i.e. application ID Advanced Intercompany.
    • PreviewKey - A unique identifier for the preview. Usually, it is one key for a given functionality. The unique key will be available on the functionality documentation page, which will be made available as a preview version.

Sample link:

https://businesscentral.dynamics.com/[TenantID]/?noSignUpCheck=1&filter=%27ID%27%20IS%20%277ff6448a-6455-4d50-b731-5a0ecf4f1004%27%20AND%20%27PreviewKey%27%20IS%20%27[PreviewKey]%27&page=2503

  1. By selecting the prepared installation link in the browser, you will open a page with sandbox environments available for the selected tenant. Select the specific instance on which the preview app should be installed.
  2. Read the preview installation message carefully, and then select the Install.

On AppSource, multiple preview versions can be maintained at the same time. However, this means that a specific version (along with specific functionality) can be installed on one "sandbox". Because that subsequent versions that are released receive a specific version number, the last part of the version number means the build number and is automatically incremented. It will not always be possible to overwrite an existing application with a different preview version. In the event of a version conflict or simultaneous testing of different functionalities, a new instance of the sandbox environment should be created.

See Also

Technical Support for the App - Contact IT.integro or your Business Central partner

System Requirements

Publishing and Installing an Extension

Sync-NAVApp