Use the REST push import interface to import balance sheet and P&L values from external systems into the Income Taxes module. The interface provides a secure and standardized way to provide data from external systems via the Tax Data Hub and then transfer it into the tax calculation.

The Rest (Push) interface is connected to the REST interface in the Tax Data Hub. The external system first transfers the balance sheet and P&L data to a buffer table in the Tax Data Hub via a REST interface. From there, the values are imported into the calculation in the Import Suite workspace.

Before you can use the REST push import interface, the following prerequisites must be met:

  • You have import permissions for the company data you want to import (Import: Transaction Data - Execute right).
  • An external system is available that can send HTTP requests and transfer the data to the buffer table in the Tax Data Hub.

Setting up the interface involves two steps: generating an API token and creating the interface structure.

The external system authenticates itself against the Tax Data Hub with an API token. You generate the token in the Tax Administration module, which provides it for all Tax Compliance & Reporting modules. For instructions, see API Tokens.

For the interface to be available in Income Taxes, create it in the Master Data | Interfaces | Structure workspace.

1

Navigate to Master Data | Interfaces | Structure and click Create.

2

Configure the structure as described below and click Save.

Configuring an interface structure for the REST push import
Configuring an interface structure for the REST push import
FieldConfiguration
NameAny name for the interface
DirectionImport (enhanced)
Interface Type / SourceTax Data Hub - REST Service
DestinationIFRS

The remaining settings depend on your requirements.

Which ledgers are imported depends on the values provided in the buffer table. The possible ledgers are IFRS, HGB, and TAX.

Once the external system has transferred data to the buffer table in the Tax Data Hub, you can import the values into the tax calculation in the Import Suite workspace.

1

Switch to the Company | Import Suite workspace.

2

In the Interface field, select the Rest (Push) entry and then the interface structure you created earlier.

3

Click Import to start loading the data.

For a detailed description of the options in the Import Suite workspace, including the further options for the Rest (Push) interface, see Import Suite.

This content was generated using AI and reviewed by Lucanet subject matter experts before publication.