Xledger Connect - API token and permissions

This article explains the required configuration and access needed to set up the Xledger integration in SEMINE.

General information

The integration between SEMINE and Xledger uses the GraphQL API to synchronize data between the systems.

Xledger is typically structured with one owner (domain) entity and multiple client entities under it. When an API token is created on the owner entity, it provides access to all underlying client entities.

During synchronization:

• All data accessible by the API token is retrieved.
• The data is filtered based on the Entity Owner ID configured in SEMINE.

This means:

• Data created on the owner entity is available across all clients.
• Data created on a specific client entity is only available for that client.

If multiple owner entities exist in Xledger, separate integrations must be configured for each.

API token

An API token is required for the integration to authenticate and access data from Xledger.

In Xledger, navigate to Administration → Access Control → GraphQL → API Tokens to create or manage API tokens.

• The token is linked to the user who generates it.
• It is recommended to use a dedicated system or service user for this purpose.

Entity Owner ID

The Entity Owner ID is used to identify which entity SEMINE should synchronize data for.

In Xledger:

• Go to Administration → Entity
• Copy the value from the Owner ID field
• Use this value in the integration setup in SEMINE

The Owner ID can be found as shown below:

Note: The API token must have access to the entities being connected to SEMINE.

Permissions

When generating the API token in Xledger, you must select the required scopes (permissions) to allow SEMINE to access relevant data.

Example of selecting scopes (permissions) in Xledger:

The API token must have sufficient permissions to access relevant data such as:

• Suppliers
• Dimensions
• Accounts

Note: If project manager sync is enabled, the API token must also include access to the employee table.

Project manager sync

If project manager sync is enabled in the integration:

• The project manager from Xledger will be used in SEMINE workflows.
• The system retrieves the user’s email from the employee table.

Data synchronization

Xledger is the master system. This means all changes should be made in Xledger and will be synchronized to SEMINE.

SEMINE sends data to Xledger at regular intervals, while master data is synchronized from Xledger to SEMINE.

Note: The default sync intervals can be adjusted if needed. Contact your SEMINE project manager for changes.

Default sync intervals

Data type	Frequency
Suppliers	Every 30 minutes
Chart of accounts	Every 24 hours
Dimensions	Every hour
Currencies	Every 24 hours
VAT codes	Every 24 hours
Invoices to Xledger	Every 5 minutes
Fixed assets	Every 6 hours (if applicable)