- This integration is in the limited release phase.
- You need to have Fiscal Documents and Receipts enabled for your property to use this integration.
Configure Guest Information
- Start by ensuring that the existing fields in the guest profile correspond to the country where the property is located.
- Access Account
->Settings
-
Access the Guests tab
Select Portugal in all tabs found in this area (Guests and Groups)
Access Fiscal settings in Cloudbeds
To start the billing configuration, navigate to the financial settings in your Cloudbeds configuration panel.
Account->Settings
and Select the Fiscalization
tab
Register with the Invoicing Provider (Invopop)
Cloudbeds uses external providers, such as Invopop, to ensure compliance with the Tax Authority (‘Autoridade Tributária’) in Portugal.
- In the Registration tab, review Invopop terms & conditions.
- Click Agree and Continue.
- Fill in the following fields with your company information:
- Business Name (Company name)
- NIF (Tax identification)
- Share Capital
- Registry Office
- Company Address
- Email Address (Company email) - Click Validate to check the validity of the entered data. A text message will show that your data has been validated correctly.
- Next, click Save.
Create a New User in the Tax Authority Website (Autoridade Tributária)
You must create a specific secondary user in the Tax Authority website (Portal das Finanças) so that it can be connected to Cloudbeds and, in this way, communicate your invoices directly to AT.
- Log in to portaldasfinancas.gov.pt
- On the Portal das Finanças homepage, click the option Todos os Serviços (All Services).
- Locate the option Gestão de Utilizadores (User Management)..
- Then, click the button Criar Novo Utilizador (Create A New User).
- Enter the username. This field is only informative, allowing you to identify one or more authorized users in your Portal das Finanças.
- Enter a password for this user following the Tax Authority requirements:
- Minimum 8 characters
- Maximum 16 characters
- At least one character from each of the groups below:
- Uppercase letters - A to Z
- Lowercase letters - a to z
- Digits - 0 to 9
- A special character (/, *, #, %)
- Assign the following Perfis Atribuídos (Authorized permissions) to the new user:
After clicking Submit, the user is created.
User Permissions: Issuing invoices will fail if any of the credential/persmission types are not selected when creating the new user, as the system will not be able to carry out the electronic communication of invoices correctly.
Enter Credentials in Cloudbeds
Connect the secondary user created in the previous step to your Cloudbeds system.
Access: Account->Settings
and Select the Fiscalization
tab
- Click + Credentials.
- Enter the Username (as shown in the AT website).
- Enter the Password and click Save.
- Authentication Error: The password associated with the secondary user is different from your main password used to access the Portal das Finanças. Ensure you are using the specific password created for the secondary user.
- Incorrect Format: Ensure that the password you created for the secondary user meets all the requirements specified in the previous section.
Configure Document Series
This step ensures that all issued documents follow a legal sequential order and use the correct internal codes.
- In the menu Fiscalization
, access the Series tab.
- Click Add Series.
- Assign a Base Name to your series. This name will be included in the series denomination.
- Select the following document types to be communicated to the AT:
- FT - Fatura (Standard Invoice)
- NC - Nota de Crédito (Credit Note)
- RG - Recibo (Receipt)
- FR - Fatura-Recibo (Invoice-Receipt)
- Set the Series Type as Normal.
- Click Save.
- Ensure that all document types have a validation code associated.
-
Incorrect Series Type: If the incorrect series type is selected when adding the series, it will not be possible to edit them. In this case, we must deactivate each individual series (using the button
) and activate it again using the correct series type.
- Independent Document Sequence: Documents issued through the Invopop integration do not use the sequence defined in the Invoices and Documents menu. Numbering is defined solely through the series entered in the Fiscalization menu.
Tax Mapping (VAT/IVA)
In this step, you must associate the taxes created in Cloudbeds with the official government tax codes.
- In the menu Fiscalization
, access the Taxes tab.
- Click the Update button.
- Map each tax created in Cloudbeds with the corresponding Government Tax.
- Below you can find the applicable rates for each region in Portugal:
| Rate | Mainland | Madeira | Azores |
| General Rate | 23% | 22% | 16% |
| Intermediate Rate | 13% | 12% | 9% |
| Reduced Rate | 6% | 4% | 4% |
Click Save.
- Unmapped Taxes Error: It is not possible to issue invoices if a tax reflected in the reservation folio is not mapped in this area. Please ensure that all your active taxes are linked to the corresponding government codes.
- Incorrect Percentage: Ensure that the percentage in Cloudbeds matches the corresponding government code (e.g., do not map a 6% tax to the code "VAT - General Rate (23.0%)”.
Map Payment Methods
You must now map each of the existing payment methods in Cloudbeds to the corresponding payment method available for the invoicing system.
- In the menu Fiscalization
, access the Payments tab.
- Click the menu on the right of each payment method and select Edit.
- Map each payment method in Cloudbeds to the corresponding payment method in the invocing system.
- Unmapped Payment Methods: It is not possible to issue invoices if any payment method on the reservation folio is not mapped in this area. Ensure all your active payment methods are linked to the corresponding payment methods.
- Incorrect Mapping: Ensure each payment method is mapped correctly; otherwise, a payment in Cloudbeds will appear with a different denomination on the guest's final invoice, which could lead to compliance issues with the Tax Authority.
Customize Documents
Configure the options for issued documents according to your preferences.
- In the menu Fiscalization
, access the Customization tab.
- Upload the Invoice logo, which will be visible on all the issued documents.
- Define the Logo Height (pixels).
- Select Portugal in the Locale selection field.
- Choose your preferred Date Format.
- Choose the Layout (size) of the issued documents. A4 is the most commonly used format in Europe.
- Click Save.
Final Verification
After completing all the steps above, ensure that the status in the top right corner of the menu Fiscalization changed to Consented.
Comments
Please sign in to leave a comment.