Skip to main content

Navigation and interface

HUB menu​

The HUB’s menu is displayed in a compact navigation panel on the left, organized into categories. At the top, you can always see the organization you are currently viewing. Below you can access user and organization management or return to the organization selector. At the bottom, you will find a quick access to fiskaly’s SIGN products, organized by country, along with additional services such as fiskaly RECEIPT and SAFE.

Organization management​

When you log in again, if you have already created an Account or have been invited to existing ones, a list of all organizations you are authorized to access will appear.

HUB uses a clear three-level hierarchy: Accounts, Groups, and Units. An Account represents your main organization, while a Unit represents a managed organization. If your organization structure requires more flexibility, you can add an optional intermediate layer called Group, which allows you to organize multiple Units into logical groupings based on your preferred structure.

A Unit is always dependent on its Account and cannot contain other Units, and an Account cannot be a sub-organization of another organization.

Create organizations​

Creating organizations is free, and both Groups and Units can be created through HUB.

To create a Group within your Account structure, proceed as follows:

  1. While in the organization Selector, click “+ Create group”

  2. Fill in the fields with the group name, display name, and address.

  3. Click "Save".

  4. The newly created group is automatically displayed for you.

To create a new Unit via HUB (for example, for testing purposes) within your Account structure, proceed as follows:

  1. While in the organization Selector, click “+ Create unit”

  2. Fill in the fields with the unit name, display name, and address.

  3. Click "Save".

  4. The newly created Unit is automatically displayed for you.

Best practice

We recommend creating Units via SIGN IT / SIGN FR or via the Management API, as this is the most reliable and scalable way to manage your customers programmatically.

While creating new organizations, their position within your organizational hierarchy is shown on the left. After creation, each organization can be edited as needed.

info

If no LIVE environment has been activated, all initial organizations are created in the TEST environment, which allows you to safely experiment, test integrations, and configure your setup without affecting real data or triggering fiscal actions. This helps you identify and fix errors early, so you can validate your structure before switching to the LIVE environment.

The LIVE environment is separate from TEST, and fiscalization-relevant resources created within a Unit in TEST cannot be transferred to LIVE. To create LIVE resources, you need to enable the LIVE environment and use a LIVE API Key with the relevant fiskaly APIs.

When creating an organization from the LIVE environment, it will be available in both the LIVE and TEST environments. However, if you create it from within the TEST environment, it will only exist in TEST. You can find more information on enabling the LIVE environment further below.

Switch organizations​

Your currently selected organization will be displayed on the HUB’s header and in the compact navigation panel on the left. Click it to return to the organization selector in order to switch organizations.

Organization selector​

Each organization comes with dedicated options and provides an overview with further details and services. Those options can be accessed by clicking “Select”:

Within Accounts, you can activate the fiskaly SAFE service, and access archived files.

In Groups, you can manage the existing Units as well as quickly create new ones, invite new users and generate API Keys to integrate services into your system. The “What’s New” Section will provide you with service maintenance notices, API release updates, and product news, tailored to you based on the information you provided earlier.

Within Units you’ll get an at-a-glance view of all API Keys and users belonging to the Unit, as well as the administrator details and additional available services. The overview of activated solutions is customizable, enabling you to display solutions across multiple countries.

API Keys management​

The API Key section is accessible from the compact navigation menu. It displays all existing API Keys and provides the option to create new ones by selecting “Create API Key” and assigning a name, as well as to remove existing Keys.

Each API Key is linked to a specific organization (Account or Unit) and to the selected environment. An API Key created in the TEST environment can only be used to create resources for testing, while an API Key created in the LIVE environment can only be used to create LIVE resources.

User management​

The user management section, accessible from the compact navigation menu, shows all invited users and provides the option to invite new ones by clicking “invite user” and entering an email address.

If the email address you enter is already stored in our system, the user will only be informed that it has been added to your organization.

If it is a new user, the registration process must be activated by the owner of the e-mail address within 48 hours.