📒 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
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.
Reseller Invoices Are Not Generated
InvoiceXpress only issues invoices for direct sales. If a reseller is not configured as a direct seller, no inovices will be created for their bookings.
InvoiceXpress only issues invoices for direct sales. If a reseller is not configured as a direct seller, no inovices will be created for their bookings.
Problem
Resellers in Ventrata can operate in two ways:
Direct sales – the reseller sells directly to the end customer, and an invoice must be generated.
Indirect sales – the reseller acts as an agent, and the invoice responsibility remains with the supplier.
If a reseller is not marked as 'Direct', InvoiceXpress will not generate invoices for their transactions.
Solution
In your Ventrata dashboard, go to Resellers > Resellers.
Resellers - Resellers
Locate the affected reseller.
On the reseller detail, check the 'Direct' box.
Reseller Settings
Press the Update Reseller button to save your changes.
Update Reseller