Custom Integration

If your software isn't directly supported by FiscoBridge, you can use a Custom Integration to get API credentials and integrate directly. This lets your system call the FiscoBridge API to create, retrieve, and manage fiscal invoices.

Setting Up a Custom Integration

1. Go to Integrations → Integrations in the sidebar

2. Click Create Integration

3. Select the Custom Integration card (marked with an API Keys badge)

4. An Upload Certificate dialog opens — select your PFX certificate file and enter its password, then click Upload

5. After the certificate is uploaded, the Custom Integration dialog opens

6. Complete the setup — the integration is created and linked to the uploaded certificate

The integration appears in your integrations list with status Active.

Managing API Keys

1. In the Integrations list, find your Custom Integration

2. Click the API Keys button

3. You'll be taken to the API Keys page for that integration

Creating a key:

1. Click Create API Key

2. Enter a label/name for the key

3. The system generates a Client ID and Client Secret

Important: The client secret is shown only once. Copy and store it securely — you cannot retrieve it later.

Using the API

Authenticate your requests with the X-Api-Key header:

The API key is bound to a specific certificate, which is used automatically for invoice signing.

Revoking an API Key

1. Go to the API Keys page for your integration

2. Click Revoke next to the key

3. Confirm the action

Revoked keys immediately stop working. Create a new key if you need to restore access.

Requirements

• An active integration license

• At least one PFX certificate (uploaded during integration setup)

Next Steps

• Manage integrations — View and manage all your connections

• Integrations Overview — Learn about other supported platforms