[Intum Help](https://intum.com/help.md) / [Commerce](https://intum.com/help/commerce.md)

# [Fakturownia.pl Integration](https://intum.com/help/commerce/fakturownia-pl-integration.md)

Intum lets you connect with Fakturownia.pl - import invoices, import clients, and set up automatic notifications about new invoices.

You can connect multiple Fakturownia accounts at once.

## How to Install

Go to **Account > Integrations & Add-ons** (`/account/apps`). Find "Fakturownia.pl Integration" and click **Install**.

After installation, an **Open** button will appear in the same place - click it to go to the app.

Alternatively, you can reach the same place from **Sales > Settings** - at the bottom there's an **Integrations & Add-ons** section with an "Add integration" link.

## Connecting a Fakturownia Account

After opening the app, click **Add Account**. You'll need two things:

- **Account URL** - your Fakturownia address, e.g., `https://mycompany.fakturownia.pl`
- **API Token** - find it in Fakturownia: Settings > Integration > API Authorization Code

After adding, click "Test" to make sure the connection works.

### Shortcut: Activation via Fakturownia

If you previously activated Intum from within Fakturownia itself (e.g., by enabling **Settings > Account Settings** - the **Other** section at the bottom of the page), the API Token is usually already set in Intum automatically - you don't need to copy it anywhere.

Additionally, after enabling the CRM Module (or other Intum modules) in Fakturownia, a link to CRM and other active Intum modules will appear in Fakturownia's top menu. Click the link and go straight to Intum in the context of that account.

## What You Can Do

### Importing Invoices

Click on the Fakturownia account, then **Run** next to "Invoice Import". Invoices will appear in the Sales module along with line items and counterparty data. Each imported invoice has a link to the original in Fakturownia.

### Importing Clients

**Run** next to "Client Import" - clients from Fakturownia will appear in CRM. If a client already exists, only empty fields are filled in (nothing will be overwritten).

Both imports show live progress - how many invoices/clients have been created, updated, or skipped.

### Automatic Invoices (Webhooks)

In the account details, click **Register** in the Webhooks section. From that moment on, new and changed invoices in Fakturownia will automatically appear in Intum.

Webhooks only work in production (Fakturownia needs access to your address).

## Quick Access to Fakturownia from Intum

Next to each imported invoice in Sales > Invoices there's a "View in Fakturownia" link - it takes you directly to that invoice in the Fakturownia panel. Similarly for clients - if they were imported from Fakturownia, you'll see a link to their profile.

## Automatic Invoice Issuing from Intum

If you want to be able to issue invoices from within Intum (opening in Fakturownia with pre-filled client data) - see [Issuing Invoices in Intum via Fakturownia.pl](../faktury/wystawianie-faktur-w-intum-przez-fakturownia-pl).

## Where to Find It

- Installation and integration list: **Account > Integrations & Add-ons** (`/account/apps`)
- Shortcut in the sales module: Sales > Settings > "Integrations & Add-ons" section
- Direct link to the app after installation: `/a/fakturownia-integration`
- Activation from the Fakturownia side: Fakturownia > Settings > Account Settings > Other section (at the bottom of the page) - this is where you enable the CRM Module and other Intum modules

## Manual Integration (Advanced)

Standard installation via **Account > Integrations & Add-ons** sets everything up automatically - including webhooks. Read this section only if for some reason you want to configure the integration manually, via the Connectors module.

### Fakturownia Connector and Webhook URL

Instead of the app from the integration store, you can add a **Fakturownia** type connector in the Connectors module. Each connector has its own code (e.g., `fakturownia1`) - you'll find it in the connector settings.

The webhook URL for invoice synchronization has the format:

```
https://your-domain.intum.com/connect/connector/CONNECTOR_CODE/receive_invoice_webhook
```

If you have multiple Fakturownia connectors, each has its own URL.

### Webhooks in Fakturownia

1. Log in to Fakturownia
2. Go to **Settings > API > Webhooks** (or visit `/webhooks`)
3. Add two webhooks pointing to the same connector URL:
   - event type `invoice:create` - for new invoices
   - event type `invoice:update` - for changes (e.g., status changed to "paid")

Each invoice from Fakturownia will arrive in Intum along with line items and party data. The invoice will be automatically linked to a CRM client by Tax ID.

### Syncing Historical Invoices

Webhooks handle only new and changed invoices. Invoices from before the webhooks were enabled can be imported via bulk synchronization in the connector settings.