SAF-T Report Portugal
The SAF-T Report (Standard Audit File for Tax Purposes) is a mandatory accounting and billing compliance requirement for accommodation providers operating in Portugal. It is used to export standardized tax data to the Portuguese Tax and Customs Authority (Autoridade Tributária e Aduaneira) to ensure transparency in invoicing and financial reporting.
1. Report Overview
Once activated, the system monitors all finalized invoices and credit notes to ensure they meet strict legal requirements, including the digital signing (hashing) of documents and the inclusion of the ATCUD (unique document code). A validation check runs regularly to verify that contact data associated with an invoice—specifically NIF numbers and complete addresses—is valid. If errors are found, they are displayed in the invoice or contact overview, allowing for corrections before the monthly SAF-T file is generated.
2. Required Database Fields
Activating the SAF-T report ensures that specific administrative and invoicing fields are active in your database. These fields are essential for the integrity of the auditing file.
Administration Fields (Campsite Data)
Field Label | Technical ID | Description |
|---|---|---|
Campsite SAFT Company ID | fld_administrations.tx_saft_company_id | The official ID assigned to the company for SAF-T reporting. |
Campsite VAT Registration | fld_administrations.tx_vat_registration | The property's official VAT (NIPC) number. |
Contact & Invoice Fields
Field Label | Technical ID | Description |
|---|---|---|
Contact NIF | fld_contacts.tx_nif | The guest's Tax Identification Number. |
Contact Zipcode | fld_contacts.zipcode | Postal code of the guest's billing address. |
Contact Address | fld_contacts.street / .street_number | Required billing address for the invoice. |
Invoice Hash | fld_invoices.tx_hash | The digital signature generated for the document. |
Invoice ATCUD | fld_invoices.tx_pt_atcud | The unique validation code required by the tax authority. |
3. Setup Instructions (Action Required)
To ensure guests provide the necessary tax data during booking or via the guest portal, you must manually add these fields to your form configuration. Activating the report does not automatically add fields to guest-facing forms.
Navigate to Settings > Form Setup.
Select the Online Booking or Guest Page tab.
Add the following fields to the visible fields list:
Field | Description | Required |
|---|---|---|
Contact NIF | The Tax Identification Number (mandatory for PT guests). | Yes |
Address & Zipcode | The full billing address of the guest. | Yes |
City & Country | Essential for the SAF-T audit address structure. | Yes |
4. Troubleshooting
Validation errors will appear in the Invoice Overview or Contact Profile if the hourly check fails.
Error Message | Meaning | Fix |
|---|---|---|
Not a valid zipcode provided... | The postal code is empty or incorrectly formatted for a Portuguese address. | Update the zipcode field in the contact profile. |
Not a valid country provided... | The country field is empty or contains an invalid code. | Select a valid ISO country from the dropdown menu. |