Moloni Fiscal Integration for Portugal: A Complete Invoicing Guide

The Moloni integration allows Cloudbeds to generate documents that are fully compliant with Portuguese tax regulations. Every document generated through this module includes a mandatory QR code and is submitted directly to the tax authority.

Key Document Types

Workflow: Taking a Payment (Fatura-Recibo)

Use this when you are collecting money and want to issue a legal document in one step.

1. Open the reservation and click Add Payment.
   
2. Select Specific Charges: You no longer have to enter a generic amount. Check the boxes for the individual nights, taxes, or fees you are collecting for.
   
3. Override Amounts (Optional): If a guest is only paying for part of a charge (e.g., a "half-day" late checkout), you can manually override the amount. The system will recalculate the total for you.
4. Select the Payment Method and click Save.
5. The Fatura-Recibo is generated instantly. You can view it in the Documents tab to see the transaction list, VAT table, and the official QR code.
6. Navigate to the Documents tab to view the generated document.
   
7. Click the document to open it. You will see:
   - List of transactions selected to pay for
   - VAT table
   - QR code returned from Moloni
   

Workflow: Invoice First, Pay Later

1. Use this workflow when you want to issue an invoice to a guest for payment at a later time.
2. From the reservation folio, click Create Invoice.
   
3. Select the transactions you want to include on the invoice.
   
4. Click to Create Invoice. The invoice (Fatura) will appear on the Documents tab.
   
   

Paying Against an Existing Invoice

Once a Fatura has been issued, you can record a payment against it in one of two ways:

1 Option: From the invoice document itself

1. Open the invoice from the Documents tab.
2. Click Add Payment directly on the invoice.

2 Option: From the reservation folio

1. Click Add Payment on the folio.
2. When prompted, choose Select by Invoice.
3. Select the invoice you want to pay against.
   
4. Select your payment method and confirm.

A Recibo (Receipt) will be generated and automatically linked to the original Fatura.

Both documents will display their association with one another, and the invoice will be marked as paid.

Handling Errors: Voiding and Credit Notes

In the world of fiscal software, you can't just "delete" a mistake. If a document was created in error, you must void it legally.

1. Navigate to the Documents tab and open the incorrect document.
2. Click Void and Issue Credit Note.
   
3. The system will automatically generate two items:
   - Nota de Crédito (Credit Note): The official government-linked voidance document.
   - Recibo de Reembolso (Refund Receipt): The supporting refund documentation required by Moloni.
4. Once voided, the original transactions are "released" and can be added to a new, corrected document.

Generating Documents from a House Account

The invoicing features are also available on House Accounts.

1. From the House Account, add the item(s) - for example, a champagne purchase.
2. Click Add Payment.
3. Select the guest type for whom you are creating the document.
4. Enter a tax ID if applicable.
5. Select the charges to include.
6. Select the payment method and confirm.
7. Navigate to the Documents tab of the House Account to find the generated document.

All the same document actions are available here - including the ability to void and issue a Credit Note.