---
title: "Integrating Moloni"
slug: "integrating-moloni"
updated: 2025-01-21T17:24:35Z
published: 2025-01-21T17:24:35Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating Moloni

## What you need to integrate Moloni

You need the following elements before you can start integrating Moloni with Nexudus.

- [**A Moloni account**](/v3/docs/integrating-moloni#a-variablemoloni-account)
- [**A document set in Moloni**](/v3/docs/integrating-moloni#a-document-set-in-variablemoloni)
- [**Matching tax rates in Moloni and Nexudus**](/v3/docs/integrating-moloni#matching-tax-rates-in-variablemoloni-and-variablenexudus)

### A Moloni account

If you haven't opened an account yet, get in touch with their sales team via their [contact form](https://www.moloni.pt/contactos/). Once you're signed up, make sure you set up your Moloni account including your tax and bank details.

          To get things working, make sure you are on a Flex or Pro plan in Moloni.

          

Moloni’s *Basic* plan doesn’t support API access which is required for this integration.

### A document set in Moloni

You can use any document set you already have or create one for Nexudus invoice. Just remember, all invoices you transfer from Nexudus to Moloni will be part of that document set and transferred as **Finalized** invoices.

### Matching tax rates in Moloni and Nexudus

Your Nexudus and Moloni accounts must have matching tax rates. Properly matching tax rates in both accounts ensures smooth invoice transfers and minimizes transfer errors.

Create your [tax rates](/docs/tax-rates) in Nexudus to be identical matches to the ones you have in Moloni.

          Tax rates must be an exact match (spelling and case).

          

*For example, if your tax rate is named **IVA** and a **20%** rate, the tax rate must be named **IVA** and have a **20%** value in Moloni. Naming the rate **iva** or **Iva** in Moloni will result in transfer errors.*

---

## Integrating Moloni

1. Log in to [dashboard.nexudus.com](https://dashboard.nexudus.com/) if you aren't already.
2. Click [**Settings > Integrations > Moloni**](https://dashboard.nexudus.com/settings/integrations/moloni).
3. Click **Connect**.
4. Log in using your Moloni credentials.
5. Click **Sim!**.
6. Select your company from the **Moloni company** drop-down list.
7. Select your document set from the **Location Document Set** drop-down list.
8. Click the **Save Changes** button.

---

You've successfully enabled the Moloni integration and you can start transferring your invoices.

          You are automatically disconnected if you don't transfer any invoice for more than 14 days.

          

The connection with Moloni expires after 14 days without any activity. If you don't transfer any invoice for more than 2 weeks, you'll need to reconnect the two platforms by going to **[Settings > Integrations> Moloni](https://dashboard.nexudus.com/settings/integrations/moloni)** on the Admin Panel and then clicking **Reconnect**.