📒 NOTE
The following list of errors are always shown in the All Logs tab of individual bookings.
All Logs
Error: Fiscal number is invalid (Fiscal não é válido)
If customers want a certified invoice in their name, they can provide their NIF at checkout in the 'Tax ID' field. However, an incorrect NIF can trigger this error message.
If customers want a certified invoice in their name, they can provide their NIF at checkout in the 'Tax ID' field. However, an incorrect NIF can trigger this error message.
Problem
InvoiceXpress runs country-specific validation rules for tax IDs. If the booking country is set to Portugal, the number in the Tax ID field must pass Portuguese NIF validation.
The Ventrata checkout form does not validate the Tax ID for accuracy.
If:
the 'Country' field is set to Portugal, and
the NIF is incorrect,
the invoice creation will result in the following error:
Failed to create InvoiceXpress invoice because: {“errors”:[{“error”:”Cliente não é válido”},{“error”:”Fiscal não é válido”}]}Solution
The simplest solution is to change the country field to anything other than Portugal. In that case, the tax ID is not validated and will not trigger an error—even if incorrect.
Once the correction is made, a permalink appears next to the log entry. Click it to view the created invoice.
All Logs - Created InvoiceXpress invoice
Anonymous customer - No customer name or customer already used
A NIF is a unique identifier for each tax resident. InvoiceXpress requires a name+NIF combination to correctly identify the end customer.
A NIF is a unique identifier for each tax resident. InvoiceXpress requires a name+NIF combination to correctly identify the end customer.
Problem
The customer provided their NIF but did not enter their name. As a result, InvoiceXpress generates the invoice under the name 'Anonymous'.
Although your business generated the invoice, it is not associated with the customer's identity. This can be frustrating, especially for tax residents who rely on invoices for tax benefits.
📗 TIP
A NIF is essential for many everyday activities in Portugal—opening a bank account, signing contracts, accessing healthcare, or filing taxes. Including the NIF on invoices, allows customers to
Claim tax deductions
Enter the Fatura da Sorte state lottery
Improve transparency in tax reporting
Failing to include the NIF on an invoice when it was provided leads to poor customer experience.
Reason
InvoiceXpress only creates a new contact if a name is provided. A NIF alone is not enough. If no name is submitted, the system assigns the invoice to an 'Anonymous' contact and the NIF will not be displayed—because it is not linked to a unique identity.
Solution
To force InvoiceXpress to include the NIF on the invoice:
In the Ventrata dashboard, open the affected booking.
Edit the customer information.
Edit Customer
Copy the tax ID into the 'First Name' field.
Tax ID
First Name
Press the Update Customer button.
Update Customer
This creates a new contact in InvoiceXpress with the NIF as the 'name' with the associated NIF, ensuring it is correctly displayed on the invoice.
InvoiceXpress Re-Issued an Invoice
Invoices can be issued even from API-connected accounts. However, product settings must be consistent across all accounts to avoid any issues.
Invoices can be issued even from API-connected accounts. However, product settings must be consistent across all accounts to avoid any issues.
Problem
After a booking is created in Ventrata, InvoiceXpress issues an invoice. Then, without any visible changes to the booking or the customer's details, the system voids the first invoice and creates a second one.
Logs are read from the bottom up
Reason
This often happens when you operate with two accounts in Ventrata—where one account resells products from the other:
The first invoice is created on the reseller account (where the booking originated).
Once the booking is passed to the supplier account via API, the system void the first invoice.
A second invoice is generated on the supplier account, pulling product and unit names, which may be in a different language.
This issue can occur across different sales channels due to language mismatches.
InvoiceXpress considers the second account the final issuer. Matching language, product names, and tax settings across accounts prevents unnecessary voiding and re-issuing.
First Invoice - Unit Description in Portuguese
Second Invoice - Unit Description in English
Solution
We recommend you:
Cross-check the language setting in all connected channels and accounts
Contact your Ventrata Customer Success Representative for help adjusting your configuration to prevent repeated invoice generation.