Troubleshooting failed fiscalizations

Failed fiscalizations are revenue you've earned but haven't declared. Resolving them quickly keeps you compliant and your books clean. This article maps the common errors to fixes and explains the retry flow.

The queue

Open Failed Fiscalizations from the main menu. The table lists every invoice the system tried but couldn't submit, with the date, customer, total, and the specific error message returned. The badge in the menu shows the count — should be zero on a clean property.

Common errors and fixes

missing_fiscal_business / nipt_missing_at_fiscal_business

Your fiscal business isn't configured or is missing the tax-payer number (NIPT in Albania, equivalent elsewhere). Settings → Integrations → Fiscal Business → fill in NIPT, business name, and businessUnitCode. Save and retry the failed invoices.

businessUnitCode_missing_at_fiscal_business

The tax authority assigns each property a unique business unit code (the location identifier). Get yours from the tax authority portal or your accountant, paste into the fiscal business config.

seller_missing_Name / seller_missing_Country

The seller record (your property) is missing required fields. Settings → Property → ensure Name and Country are filled in. The tax authority requires both on every fiscal submission.

item_missing_name

An invoice line item has no name — usually a product that was deleted or a manual line that wasn't filled in. Open the invoice, check each line for a missing name, fill it in, retry. To prevent recurrence, never delete products that have been billed; deactivate them instead so historical references stay valid.

invoice_period_missing_date / dueDate

The invoice doesn't have a date or due date. Open the invoice and fill them in — every fiscal invoice needs both. Most often happens when an invoice is created via API or import without these fields populated.

missing_bank_account / accountId_missing / name_missing / bank_missing

For invoices that include bank-transfer payment details, the configured bank account is incomplete. Settings → Payment Accounts → open the bank account → fill in accountId (IBAN or local format), name (account holder), and bank name. Retry the invoice.

corrective_invoice_fiscalData_missing / missing_IICRef / missing_IssueDateTime

Cancellation or correction of an existing fiscal invoice but the original's fiscal data isn't accessible — the corrective submission needs the original's IIC and issue date to reference. Usually means the original invoice's fiscal data was wiped or the system can't find it. Open the failed correction, link it back to the original by ID, retry. If the original is genuinely lost, contact support.

Network / timeout errors

Tax authority APIs sometimes have brief outages. Retry the invoice; if the next attempt succeeds, the issue was transient. If it fails three times in a row, check the tax authority's status page or contact your fiscal integration provider.

The retry workflow

1. Open the failed-fiscalizations queue. Read each error.
2. Group similar errors — fixing one missing fiscal business setup typically resolves a batch of failures. Don't fix one-by-one if 20 share the same root cause.
3. Fix the underlying data (settings, invoice fields, bank account, etc.).
4. Trigger retry on the failed invoices — either from the queue's retry action or by re-opening each invoice and re-approving.
5. Refresh the queue. Resolved invoices disappear; persistent failures stay with their (possibly different) error messages.