Should our customers upload their SAF-T files manually?
Should our customers upload their SAF-T files manually?
In Portugal, fiscally relevant documents issued through invoicing software must be reported to the Tax Authority (AT). There are two possible reporting models:
- SAF-T monthly export – a single XML file including all documents for the month. This file is generated by the invoicing software and then uploaded manually to the AT portal, as there is no API available for submitting it automatically.
- Real-time transmission – instead of a monthly file, each invoice is sent individually to the AT at the time of issuance, using the authority’s API.
What is supplier registration information in invoices and other documents?
What is supplier registration information in invoices and other documents?
Supplier registration information includes the company’s share capital, the commercial registry office, and optionally the NIF used during registration. Portuguese law requires this information to appear on all printed fiscal documents, including PDFs.When is it mandatory?Registration information is mandatory for companies and legal entities. However, self-employed individuals and freelancers (whose NIF starts with 1, 2, or 3) are exempt from this requirement, as they typically do not have formal registration details.What about the “other” field?The
other field is optional and can be used to specify the NIF of the company when it was registered if different from the current one.Why does recording fail with 'payable: too high according to Artigo 40.º do CIVA'?
Why does recording fail with 'payable: too high according to Artigo 40.º do CIVA'?
When issuing in Portugal you may see an error similar to:
recording envelope: totals: (payable: too high according to Artigo 40.º do CIVA.)
What it means: Article 40 of the Portuguese VAT Code (Código do IVA) sets limits and rules for simplified invoices (faturas simplificadas). If the payable amount exceeds what is allowed for a simplified invoice in your situation, the rules effectively require a full invoice (fatura completa) with proper buyer identification—not an anonymous or minimal customer.What to do:- Treat the document as a full invoice and supply real customer tax data when you have it.
- If you do not have the buyer’s tax information, Portuguese practice allows the generic retail customer: set the customer name to
Consumidor finaland the tax ID to999999990. - For transactions above €1,000, the law also expects name and address on the document. The AT may not always reject submissions that omit some of that detail, but you should follow the rule for full compliance.
InvoiceXpress
Error: 'An account for the provided tax ID code and name already exists…'
Error: 'An account for the provided tax ID code and name already exists…'
When you run the supplier registration workflow for a new supplier, you may get the following KO error:
An account for the provided tax ID code and name already exists under a different supplier UUID. The same tax code ID can be used with multiple suppliers as long as they have different names.
What does this mean?
InvoiceXpress allows you to register the same tax ID (Número de Identificação Fiscal) for multiple suppliers. This is useful if, for example, a single invoice issuer wants to segregate invoices by branch or location. In these cases, you can create multiple suppliers with the same tax ID but different names.However, there is a limitation in InvoiceXpress: you must provide a unique name for each supplier when registering a new account with the same tax ID. If InvoiceXpress detects that both the tax ID and the name match an existing account, it assumes you want to use the existing account instead of creating a new one. To prevent confusion, our system checks for this scenario and displays the error above if it occurs.How to resolve this issue:- Make sure the
nameyou provide for the new supplier is different from any existing supplier with the same tax ID in InvoiceXpress. - The
supplierUUID must also be unique for each supplier you register.
Participate in our community
Ask and answer questions about Portugal’s regulation →