Invoice DocsTroubleshooting

Troubleshooting

This section helps resolve common issues that users may encounter while using DeskoInvoice. Review the topics below for solutions to frequently reported problems related to account access, invoices, payments, templates, and system settings.

Business profile not found

Reason: User has not created/saved Business Profile.

Fix: Open Business Profile and save business details before creating invoices.

Invoice number not generated

Possible reasons:

  • Document sequence missing
  • Business profile missing
  • Database permission issue
  • Duplicate sequence conflict

Fix:

  1. Check Business Profile > Documents.
  2. Confirm invoice prefix/last number.
  3. Save Business Profile again.
  4. Try New Invoice again.

Invoice saves but reminders fail

Reason: Reminder scheduling error, duplicate active reminder, or missing reminder table/constraint.

Fix:

  • Check invoice_reminders table.
  • Check due date.
  • Check customer email/phone.
  • Retry saving after correcting data.

Payment cannot be recorded

Possible reasons:

  • Invoice is cancelled
  • Invoice is already fully paid
  • Amount is missing/invalid
  • Amount exceeds outstanding balance
  • Payment date is missing
  • Method is missing
  • Reference required for selected method

Payment status wrong

Fix:

  • Check payment history.
  • Delete wrong payment and re-enter.
  • Confirm invoice total amount.
  • Confirm invoice is not cancelled.

PDF generation failed

Possible reasons:

  • Missing business ID/profile ID
  • Invalid template
  • Custom template HTML issue
  • Server PDF/chromium issue
  • Missing logo or broken image URL

Fix:

  1. Save Business Profile.
  2. Try Template 1.
  3. Remove custom template override.
  4. Regenerate preview.
  5. Check server logs for PDF generation errors.

Share not supported

Reason: Browser/device does not support file sharing through Web Share API.

Fix: Download the PDF and manually share it.

GST OTP request failed

Possible reasons:

  • Business GSTIN missing
  • PAN missing
  • Phone/email missing
  • Provider credentials missing
  • Provider returned error

Fix: Complete Business Profile and GST Filing Details, then retry.

ZATCA status SIGNING_REQUIRED

Reason: ZATCA signing material is missing.

Fix: Complete ZATCA onboarding and ensure private key/certificate reference are available.

Public invoice link blocked

Reason: ZATCA STANDARD invoice is not CLEARED.

Fix: Wait for clearance or resolve ZATCA provider issue before enabling public link.

ZATCAFAQ