Troubleshooting failed fiscalizations

Failed fiscalizations janë revenue e fituar por e padeklaruar. Zgjidhja e shpejtë mban compliance dhe librat të pastra. Mbulon gabimet me rregullimet dhe flow-in e retry.

Queue-i

Hap Failed Fiscalizations nga menu kryesor. Tabela liston çdo faturë që sistemi provoi por s'mundi, me datën, klientin, totalin, dhe mesazhin specifik të gabimit. Badge te menu shfaq numrin — duhet të jetë zero.

Gabimet e zakonshme dhe rregullimet

missing_fiscal_business / nipt_missing_at_fiscal_business

Fiscal business s'është konfiguruar ose mungon NIPT. Settings → Integrations → Fiscal Business → plotëso NIPT, business name, businessUnitCode. Ruaj dhe retry.

businessUnitCode_missing_at_fiscal_business

Tatimet caktojnë çdo property një kod unik. Merre nga portali ose kontabilisti, ngjite te konfigurimi.

seller_missing_Name / seller_missing_Country

Property mungon fusha të nevojshme. Settings → Property → sigurohu që Name dhe Country janë plotësuar.

item_missing_name

Një line item s'ka emër — zakonisht produkt i fshirë ose linjë manuale e paplotësuar. Hap faturën, kontrollo çdo linjë, plotëso, retry. Mos fshij produktet që janë faturuar; deaktivoj.

invoice_period_missing_date / dueDate

Fatura s'ka datë ose due date. Plotëso. Çdo faturë fiskale i kërkon të dyja.

missing_bank_account / accountId_missing / name_missing / bank_missing

Llogaria bankare e konfiguruar është e paplotësuar. Settings → Payment Accounts → hap llogarinë → plotëso accountId (IBAN), name, bank. Retry.

corrective_invoice_fiscalData_missing / missing_IICRef / missing_IssueDateTime

Anulim/korrigjim i një fature ekzistuese por të dhënat fiskale të origjinalit s'arrihen — corrective i duhen IIC dhe issue date. Lidh me origjinalin sipas ID, retry. Nëse origjinali është humbur, kontakto support.

Gabime rrjeti / timeout

API-të e tatimeve ndonjëherë kanë outages të shkurtra. Retry; nëse hera tjetër kalon, ishte kalimtare. Tre dështime rresht = kontrollo statusin e tatimeve ose kontakto provider.

Flow-i i retry

1. Hap queue-in. Lexo gabimet.
2. Grupo gabimet e ngjashme — një rregullim te fiscal business shpesh zgjidh një batch.
3. Rregullo të dhënat (settings, fields, bank account).
4. Trigger retry — nga queue ose duke ri-aprovuar faturën.
5. Refresh queue. Të zgjidhurat zhduken; persistente mbeten me mesazhe (ndoshta të ndryshme).