Requirements

Tax Balance requires the Portal application at least for authentication purposes. See section Portal application for more details.

The configuration will refer to <your-portal-url> with the URL that you host your Portal application on and <your-taxbalance-url> with the URL that you host the Tax Balance Server on.

Activate Tax Balance license

Open the Portal Web Application located at <your-portal-url>.

1. Select Administration → Activations from the main navigation

2. Enter Key that was provided by AMANA 

3. Click Add activation

Register Tax Balance as a module

Open the Portal Web Application located at <your-portal-url>.

1. Select Administration → Modules from the main navigation and click Create

2. Select Module name Tax Balance

3. Set Root URL to <your-taxbalance-url>

4. Set Login URL to <your-taxbalance-url>

5. Set Api URL to <your-taxbalance-url>/api

6. Select Id token JWS algorithm RS265

7. Click Save and remember the Client ID and Secret for later configuration steps

Tax Balance configuration

Perform the following configuration instructions on the machine that hosts the Tax Balance Server.

...

1. Set "backendUrl" to <your-taxbalance-url>/api

2. Set "hubsUrl" to <your-taxbalance-url>/hubs

3. Set "openIdIssuer" to <your-portal-url>

4. Set "openIdClientId" to the Client ID from the previous registration process

5. Set "openIdDummyClientSecret" to the Secret from the previous registration process

XBRL taxonomy functionality

Tax Balance heavily relies on the so called XBRL taxonomies provided by "XBRL Deutschland e.V.".

...