SuperFaktúra

SuperFaktúra is a Slovak online invoicing and accounting system. This integration imports your clients from SuperFaktúra directly into Deratix.

Configuration

The connection must be configured before the first import. If the SuperFaktúra card shows Requires configuration or the import is not available, ask your administrator or Deratix support to set up the connection.

Required Data

Three values from your SuperFaktúra account are needed:

Getting the API Key

1. Sign in to SuperFaktúra.
2. Open Tools in the main menu.
3. Select API access.
4. Copy:
   • API Token (long text string)
   • Company ID (number)

Note: Share access data only with the person who manages your Deratix installation. Do not store it in protocol notes or public documents.

Connection Test

After configuration, test the connection:

1. Open Integrations in the app.
2. Click Test on the SuperFaktúra card.
3. Wait for the result:
   • ✅ Connection works - configuration is correct
   • ❌ Error - check the entered data

Common Errors

Importing Clients

Starting the Import

1. Open Integrations.
2. Click Import on the SuperFaktúra card.
3. Wait until clients are loaded and analyzed.

Client importDesktop

Import Preparation

The system automatically:

1. Downloads all clients from SuperFaktúra.
2. Consolidates clients by company ID (clients with the same company ID become one client with multiple addresses).
3. Compares them with the existing client database.
4. Shows a review screen for approval.

Client States

After analysis, clients are split into three categories. The overview is shown in the statistics panel:

Import statisticsDesktop

Import Table

The table shows all clients from SuperFaktúra:

Import tableDesktop

Selecting an Action

You can choose an action for each client:

• Import - creates a new client in Deratix
• Update - updates data for an existing client
• Skip - does not import the client

Comparing Data

For clients with the Exists or Duplicate state, you can compare data:

1. Click the 👁 icon in the client row.
2. A comparison dialog opens:
   • Left: data from SuperFaktúra
   • Right: current data in Deratix
   • Differences are highlighted
3. Decide which action to use.

Bulk Selection

To speed up review, use bulk actions:

• Select all - selects all clients on the page
• Clear selection - clears selected clients

Running the Import

1. Review selected clients and their actions.
2. Click Import (count).
3. Wait until the import finishes.

During import, Deratix shows:

• Completion percentage
• Number of imported clients
• Number of updated clients
• Number of skipped clients

Import Result

After completion, a summary is shown:

Click View clients to open the client database.

Imported Data

The following data is imported from SuperFaktúra:

Basic Client Data

• Company name / person name
• Company ID, tax ID, VAT ID
• Contact email
• Phone number
• Contact person

Addresses

• Billing address - street, city, postal code
• Delivery addresses - imported as client sites

Consolidation by Company ID

SuperFaktúra can contain several records with the same company ID, for example different branches. Deratix consolidates them automatically:

• Clients with the same company ID are merged into one client.
• Different addresses are imported as sites.
• All available contact data is preserved.

Pagination and Sorting

Sorting

Sort the table by clicking column headers:

• Name (A-Z, Z-A)
• Company ID
• Email
• Number of addresses
• State

Pagination

For a large number of clients, pagination appears. Use « and » to navigate.

Repeating the Import

You can repeat the import at any time:

• New clients from SuperFaktúra are added.
• Existing clients can be updated.
• Already imported clients are skipped unless you change the action.

Tip: Regular imports keep the client database aligned with SuperFaktúra.

Troubleshooting

Import Is Slow

• The first import downloads all clients.
• Waiting time depends on the number of clients in SuperFaktúra.
• Be patient with accounts containing thousands of clients.

Client Is Missing

• Check that the client has basic data filled in SuperFaktúra.
• Clients without a name cannot be imported.

Duplicate Records

• Clients are matched by company ID.
• Clients without a company ID are always created as new.
• After import, check duplicates in the client database.

Connection Error During Import

• The import stops automatically.
• Check the internet connection.
• Run the import again - already imported clients are skipped.

Tips for Efficient Import

Tip: Clean duplicate clients in SuperFaktúra before the first import.

Tip: For the first import, start with a smaller sample and check the result.

Tip: Clients are matched by company ID. Make sure company IDs are filled correctly.

Tip: After import, check addresses and contacts in the client detail.

Tip: Use the Update action to synchronize changes from SuperFaktúra.