# Revolut Business

:::caution Coming Soon
This integration is under development. The backend is implemented, pending adaptation of the authentication flow to an API key per user. Estimated availability: Q2 2026.
:::

Connect your Revolut Business account to Frihet. Bank transactions are automatically synchronized and reconciled with invoices and expenses.

## What does it do?

With Revolut integrated:

- **Automatic Transactions** — Your bank transactions arrive in Frihet
- **Automatic Reconciliation** — Payments are matched with invoices
- **Categorization** — Expenses are automatically categorized
- **Cash View** — Always know how much you have
- **Synchronized Reports** — Real vs. projected cash flow

## Requirements

- **Revolut Business Account** — Does not work with personal Revolut
- **Revolut API Key** — To connect
- **Transaction Access** — Permissions in Revolut
- **Frihet Pro or higher**

## Get Revolut API Key

### Step 1: Open Revolut Business

1. Go to [business.revolut.com](https://business.revolut.com)
2. Log in
3. In the main menu, go to **Settings** → **API**

### Step 2: Generate Token

1. Click on **"Create new token"**
2. Give it a name: "Frihet Integration"
3. Choose **permissions**:
   - ✅ Read transactions
   - ✅ Read account data
   - ❌ Send money (not needed)
   - ❌ Create payments (not needed)
4. Click on **"Create"**
5. **Copy the token** (you will need it immediately)

⚠️ **Important:** Revolut only displays the token once. Copy it and store it in a safe place.

## Connect Revolut to Frihet

### Step 1: Open Frihet

1. Go to **Settings** → **Integrations**
2. Find **Revolut Business**
3. Click on **"Connect"**

### Step 2: Enter API Key

1. Paste the Revolut token
2. Click on **"Verify connection"**
3. If correct: "✅ Connected"

### Step 3: Configure Synchronization

1. Choose **which accounts to synchronize**:
   - All accounts ✅
   - Only main account ⚪
   - Specific accounts ⚪

2. Choose **frequency**:
   - Real-time (every 5 minutes)
   - Hourly
   - Daily

3. Activate **"Categorize expenses automatically"**

4. Save

## How Synchronization Works

### Automatic Flow

```
1. Someone pays an invoice in Revolut
   ↓
2. Frihet detects the transaction (within 5 minutes)
   ↓
3. Searches for a matching invoice (amount + client)
   ↓
4. If found: marks invoice as "Paid"
   ↓
5. If not found: creates "Pending bank transaction"
   ↓
6. You manually confirm the match
```

### Example: Client Pays

**In Revolut:**
```
Feb 10, 2025, 14:30
Transfer received
Juan Garcia
€1,200.00
Reference: Invoice #1042
```

**In Frihet automatically:**
```
Invoice #1042 - Juan Garcia
Status: Paid ✅
Paid by: Revolut Transfer
Amount: €1,200.00
Date: Feb 10, 2025, 14:30
```

### Example: Expense from Revolut

**In Revolut:**
```
Feb 11, 2025, 09:15
Card payment
Amazon
€45.99
```

**In Frihet:**
```
New transaction:
- Category: Electronics (automatically detected)
- Amount: €45.99
- Vendor: Amazon
- Date: Feb 11, 2025
- Status: Review required
```

You edit it if necessary or confirm it.

## Bank Transactions

### View Transactions

1. Go to **Finance** → **Bank Transactions**
2. You see all Revolut transactions
3. Filter by:
   - Status (Reconciled, Pending, Rejected)
   - Date
   - Type (Income, Expense)
   - Category

### Transaction Statuses

| Status | Meaning |
|--------|------------|
| **Reconciled** | ✅ Matches invoice/expense |
| **Pending** | ⏳ Awaiting your review |
| **Rejected** | ❌ Does not match any document |
| **Manual** | 📝 You recorded it yourself |

### Reconcile Transactions

If a payment is not automatically reconciled:

1. Go to **Bank Transactions**
2. Open the pending transaction
3. Click on **"Reconcile"**
4. Choose:
   - ✅ **Paid invoice** → select the invoice
   - ✅ **Expense** → create or select expense
   - ✅ **Transfer to another account** → ignore
   - ✅ **Other** → custom comment
5. Confirm

The invoice is automatically marked as paid.

## Automatic Categorization

Revolut / Frihet automatically detects:

| Transaction | Detected Category |
|------------|-------------------|
| Amazon, eBay | Electronics |
| Gasoline, Parking | Transportation |
| Restaurant, Cafes | Meals |
| Office Depot | Office Supplies |
| Telecom, Internet | Services |
| Deposit | Money In |

You can change the category when reconciling.

## Cash Flow and Projections

### View Current Balance

1. Go to **Dashboard** → **Cash**
2. You see:
   - Current balance in Revolut
   - Expected income (uncollected invoices)
   - Expected expenses (unpaid invoices)
   - Month-end projection

**Example:**
```
Current balance: €5,340
+ Pending invoices: €8,500 (within 15 days)
- Expenses to pay: €2,100 (next 7 days)
= Monthly projection: €11,740
```

### Low Balance Alerts

You can configure:

1. **Settings** → **Revolut** → **Alerts**
2. **"Alert me if balance < €X"**
3. You will receive a notification when it drops below that limit

Useful for avoiding running out of money.

## Multiple Accounts

If you have multiple Revolut accounts:

1. In Frihet, you can synchronize all of them
2. Each account has its code
3. Transactions are grouped by account
4. You see the total balance of all accounts

**In reports, distinguish between:**
- Main account (EUR)
- Savings account (EUR)
- Account in another currency (GBP, USD, etc.)

## Multiple Currencies

If you have accounts in other currencies (USD, GBP, etc.):

1. Frihet automatically detects
2. Converts to your primary currency (EUR)
3. Transactions appear with exchange rate
4. In reports, you see both the original currency and EUR

**Example:**
```
Transaction: $500 USD (Payment from USA client)
Conversion: €460.75 EUR (at exchange rate Feb 11, 2025)
Appears in reports as: €460.75
```

## Historical Synchronization

The first time you connect:

1. Frihet imports transactions from the **last 90 days**
2. Attempts to reconcile with existing invoices/expenses
3. What doesn't match remains "Pending"
4. You confirm manually if desired

This process takes **2-5 minutes**.

## Taxes and Reports

With Revolut synchronized:

1. **Income Reports** → Show actual money collected
2. **Expense Reports** → Show actual expenses recorded
3. **VAT calculated** → More accurate (not estimated)
4. **Tax declaration** → Real data from Revolut

Example:
```
In Frihet you invoiced: €50,000
In Revolut you collected: €48,500 (2 invoices still unpaid)
Reports show reality: €48,500 collected
```

## Disconnect Revolut

1. Go to **Settings** → **Integrations** → **Revolut**
2. Click on **"Disconnect"**
3. The transactions you already imported remain in Frihet

Afterwards:
- No new transactions are synchronized
- You can reconnect later
- In Revolut, go to **Settings** → **API** and revoke the token if desired

## Token Revocation

If you lose the token or want to reset:

1. In Revolut, go to **Settings** → **API**
2. Find the "Frihet Integration" token
3. Click on **"Revoke"**
4. Generate a new one
5. In Frihet, update the token

## Privacy and Security

- **We do not see your money** — We only read transactions
- **Encrypted tokens** — They are stored encrypted in Frihet
- **No access to future transactions** — Only authorized data
- **Immediately revocable** — Delete access whenever you want

## Troubleshooting

### "My transactions are not appearing"

- Verify that Revolut is connected ✅
- Transactions must be from the last 90 days
- Wait 5-10 minutes for initial synchronization
- Reload Frihet (F5)

### "Why isn't it reconciling automatically?"

- The amount must match exactly
- The reference helps (if you include invoice number)
- Different currencies may not match
- The collection date must be close to the invoice date

**Solution:** Reconcile manually by clicking on **"Reconcile"**.

### "I have accounts in multiple currencies"

Everything works:

1. Revolut supports GBP, USD, EUR, JPY, etc.
2. Frihet automatically converts to your primary currency
3. In reports, you see both (original currency + EUR)

### "Does changing my Revolut password affect the token?"

No. The token remains valid. It is only revoked if:

- You do it manually
- Your Revolut account is closed
- Token permissions are revoked

### "What happens with payments between my own accounts?"

If you make an internal transfer (Revolut → another account):

1. Frihet detects it as an "Internal transaction"
2. Does not reconcile it with an invoice
3. Does not count it as an expense/income
4. You can ignore it or mark it as "Transfer"

## Next Steps

- [Automate everything with n8n](./n8n)
- [Also synchronize Google Calendar](./google-calendar)

---

**Previous:** [Google Calendar](./google-calendar)