Moloni

Moloni is a certified billing and accounting platform widely used in Portugal. FaturaSync connects to it via API to create draft documents.

Setup

You need four credentials:

Field	What it is
Client ID	App identifier from Moloni Developer Portal
Client Secret	App secret from Moloni Developer Portal
Email	Your Moloni login email
Password	Your Moloni login password

Get your Client ID and Secret

1. Go to moloni.pt/developers and log in with your Moloni account
2. Click Criar aplicação (Create application) — or select an existing one
3. Fill in a name (e.g. "FaturaSync") and a redirect URL (can be https://faturasync.app)
4. After creating, your Client ID and Client Secret are displayed — copy both

Developer Portal access

Any Moloni account can access the Developer Portal at no extra cost. You don't need a special plan.

Connect to FaturaSync

1. Go to Settings in FaturaSync
2. Select Moloni as your invoicing provider
3. Enter your Client ID, Client Secret, Email, and Password
4. Click Save

FaturaSync will authenticate and confirm the connection.

How drafts are created

When you click Create Draft in FaturaSync:

1. FaturaSync authenticates with Moloni using your credentials
2. A draft document is created in your Moloni account
3. The document includes guest name, service description, amount, and IVA

Document types

Moloni supports multiple document types. FaturaSync creates the appropriate type based on your settings — typically an invoice (fatura) or simplified invoice (fatura simplificada).

Finding your drafts in Moloni

1. Log in to Moloni
2. Go to Documents (Documentos)
3. Filter by draft status
4. Review and finalize your FaturaSync-generated documents

Troubleshooting

• "Authentication failed" — Verify all four credentials are correct, especially the email and password
• "Client not found" — Check your Client ID and Secret from the Developer Portal
• Document type errors — Ensure your Moloni account has the required document types configured