Invoice Docs
Troubleshooting

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.

ZATCAIntroduction