Troubleshooting and questions

#Installing

Messages from the Windows Setup program or the macOS DMG, the first time you set the app up.

#"Windows protected your PC"

Windows shows this the first time for a program without a paid signing certificate. It does not mean a virus was found.

1. Click More info, then Run anyway.
2. If it still will not open, right-click the downloaded .exe, choose Properties, tick Unblock and click OK, then run it again.

See "Windows protected your PC".

#The install stopped with an error

The Setup window shows a message and an error code. Fix it, then run the installer again; your books are never touched by an install.

• "This app requires Windows 10 or later": Vyapzio needs Windows 10 or 11 (64-bit).
• "Error opening file for writing" or "Access is denied": antivirus is holding a file, or an old copy of Vyapzio is still open. Close Vyapzio, pause the antivirus for a minute, and run the installer again.
• "There is a problem with this Windows Installer package": the download was cut short. Delete it, download the installer again, and run it.
• "Drive C:\ is almost full": the install needs about 250 MB. See The disk is full.
• The download stops at "Verifying": Windows is checking every new file. Wait a minute, or see The app is not allowed to write.

Never delete the books folder to fix an install.

#"The disk is full"

You may see: "The disk is full", ENOSPC, "no space left on device", "Drive C:\ is almost full" (install), or "the disk is full" in an update message.

The drive has no free space, so the app could not write. The app writes each file in full or not at all, so nothing already saved is lost or half-written.

1. Free some space: empty the Recycle Bin (Mac: Bin), delete old downloads and videos you do not need.
2. Backups you have already copied somewhere else can be deleted.
3. Try again.

#"The app is not allowed to write to its data folder"

You may see: "The app is not allowed to write to its data folder", EACCES, EPERM, "permission denied" or "operation not permitted".

Windows, macOS or antivirus is stopping Vyapzio from changing its files. The usual cause is antivirus Controlled folder access.

1. Close Vyapzio.
2. In Windows Security → Virus & threat protection → Ransomware protection, use Allow an app through Controlled folder access and add Vyapzio.exe, or add the books folder to your antivirus's exclusions.
3. Open Vyapzio and try again.

#Starting the app

The window cannot reach the app, or the app asks for a PIN.

#"Failed to fetch", "App Not Running" or "Needs a Quick Start"

You may see: "Failed to fetch" in a red message, often after words like Restore failed: or Export failed:; "Could not check the PIN. Is the app still running?"; or a window saying "Vyapzio Needs a Quick Start".

The app's built-in server is not running: the window was left open after the app closed, or the server stopped. Nothing already saved is lost.

1. Close the window and open Vyapzio again from the Desktop, Start menu or Applications.
2. Wait up to a minute. The "Needs a Quick Start" page carries on by itself once the app is running; otherwise press F5 to reload.
3. Try what failed again.

If it keeps stopping, see the Problem log and send us the details.

#"Node.js is too old" or "npm ERR!"

You may see: "The Node.js v... on this PC is too old for this app", "Unsupported engine" or npm ERR!.

Vyapzio's installer includes the engine it runs on, so you never install Node.js yourself. This message comes only from a very old ZIP copy that started the app with the computer's own Node.js.

1. Install the current Vyapzio from vyapzio.in/download. It replaces the old copy and keeps your books.
2. Activate it with your licence key if it asks.

#"Still starting..."

The first start after an install or update is slow, because antivirus checks every new file.

1. Wait a minute. If the window stays blank, close it and open Vyapzio again.
2. Still nothing? Open the Problem log, choose Server log, and email the last lines to contact@vyapzio.in.

#"Port 47371 is busy" or "address already in use"

You may see: "Port 47371 is busy, trying 47372...", EADDRINUSE or "address already in use".

Another program, or a second copy of Vyapzio, is using the port (the "door" the app's server listens on). The app picks the next free one by itself and saves it in the books folder.

1. Close any other copy of Vyapzio running on this computer, then open the app again.
2. If it keeps happening, restart the computer and open Vyapzio once.
3. Never open an old bookmark of localhost:47371: use the Vyapzio window.

#PIN problems: "Wrong PIN" or a forgotten PIN

You may see: "Wrong PIN. Try again.", "Too many wrong tries. Wait 30 seconds and try again." (after 5 wrong PINs in a row), "Could not check the PIN. Is the app still running?", or in Settings "Current PIN is wrong", "The two PINs do not match", "The PIN must be 6 digits" (or 8).

The app lock asks for the PIN when the app opens. "Could not check the PIN" means the app is not running: see Failed to fetch.

Forgot the PIN? It can be removed on this computer without losing anything:

1. In Vyapzio, choose File → Open Books Folder from the menu (on Windows also in the window's menu bar).
2. Make a new empty file there named RESET-PIN. On Windows: right-click an empty space, New → Text Document, and name it RESET-PIN (RESET-PIN.txt also works).
3. Reload the app window. The PIN is removed and the file deleted by itself. Your invoices are not touched.
4. Set a new PIN in Settings if you want one.

#Licence

Activation, moving computers and the offline pass.

#The licence key is not accepted

You may see: "That does not look like a licence key (VYPZ-XXXX-XXXX-XXXX-XXXX).", "This licence is already active on another computer.", "This licence has been revoked." or "Could not reach the licence server. Check your internet connection."

1. Typing: copy the key from your account or the email and paste it. It has four groups of four characters after VYPZ; dashes are not case-sensitive but the letters are.
2. Already active elsewhere: move the licence from the old computer first, in your account or on the old app. Each licence covers one computer, with three moves in a rolling year. See Moving the licence.
3. Revoked: contact contact@vyapzio.in with the key. Do not share a key you do not own.
4. Cannot reach the server: activation needs the internet once. Check the connection and turn off Offline mode while you activate, then try again.

#"You have no moves left this year"

A licence can move to a new computer three times in a rolling 365 days. If the limit is reached, the counter frees up as the oldest move becomes a year old. Contact contact@vyapzio.in if a computer was replaced unexpectedly; do not buy a second licence for the same person.

#"Connect to the internet to confirm your licence"

The app works offline for 30 days after the last successful licence check. After that it asks for a connection once; your invoices and settings stay on the computer and are never deleted. Connect to the internet for a few seconds, then carry on. See Offline use.

#Updating

Problems during or right after an update. An update never changes your books, and backs them up first.

#An update went wrong

You may see: "Could not check for updates", "The update could not be downloaded", or "The update could not be installed".

Your books are not changed by an update, and a backup was saved before it started.

1. Check the internet, then click Check for Updates in Settings and try again. This fixes most problems.
2. If the message mentions the disk, see The disk is full; if it mentions permission, see The app is not allowed to write.
3. Still failing? Download the current installer from vyapzio.in/download and run it over the old copy. Your books are kept.

See Updating the app.

#"Update complete", but the old version is still there

The new files are in place but the old window is still open.

1. Close Vyapzio completely and open it again.
2. The version is at the bottom of the Dashboard and in Settings → App updates.

#"Failed to fetch dynamically imported module"

You may see: "Failed to fetch dynamically imported module", "error loading dynamically imported module" or "Loading chunk ... failed", or a screen that will not open after an update.

The window still has parts of the old version in memory.

1. Close Vyapzio completely and open it again.
2. If it comes back, reinstall from vyapzio.in/download; your books are kept.

#Saving and working in the app

Messages while making invoices, saving settings or importing.

#"This screen ran into a problem. Your data is safe."

One screen hit an error and was stopped, so the rest of the app keeps working. Nothing that was already saved is lost.

1. Click Try again.
2. If the panel comes back, click Go to Dashboard and carry on with other work.
3. Click Copy details and email them to contact@vyapzio.in so it gets fixed. Private details (GSTIN, PAN, phone, email, UPI ID and bank account numbers) are removed first. See Reporting a problem.

#"Invoice number ... already exists"

Two invoices cannot share a number, and the app never overwrites the other one. A new invoice moves on to the next free number by itself.

1. For an invoice you are editing, change the number to one that is not used, and save again.
2. To find the other invoice, search its number with Ctrl + K.
3. "Could not find a free invoice number after 1000 attempts": type a number yourself, or set Start numbering from in Settings past your last invoice.

#"Request body too large"

Something you saved was bigger than the app accepts in one go. The usual cause is a very large logo, signature or stamp picture, because every invoice keeps a copy of your business details with their pictures.

1. Make the picture smaller, ideally under 500 KB: crop it to just the logo or signature, or save it as a JPG.
2. Upload the smaller picture in Settings and save.
3. Try what failed again.

#A CSV import did not work

You may see: "CSV file is empty or has no data rows", "Failed to parse CSV file", or "Could not parse this CSV".

The file is not a plain CSV, or its first row is not the column headings.

1. In Excel, use File → Save As → CSV (Comma delimited). An .xlsx file renamed to .csv does not work.
2. Keep the column headings in the first row and the data from the second row down.
3. For bank statements, use the CSV straight from your bank's download, not one edited by hand.

See clients, products, purchases and bank statements.

#Reading a bill photo failed

You may see: "OCR failed: ...", "Please upload an image (PNG, JPG, WebP)." or "Image is over 8MB".

1. Use a sharp, straight, well-lit JPG or PNG under 8 MB, cropped to the bill.
2. If the message mentions fetch, network or worker, close and reopen Vyapzio and try again; if it persists, see Failed to fetch.
3. If it still fails, enter the bill by hand.

#Printing and PDFs

Print does nothing, or the PDF is not right.

#Print does nothing, or "Print failed"

You may see: "Print failed — try Download PDF instead", "Failed to generate PDF." or "Could not generate any PDFs".

1. Use Download PDF and print the PDF instead.
2. Check the printer is on and chosen in the print window.
3. Close and reopen Vyapzio and try again.

For receipt printers, see Receipt printer problems.

#"Its PDF in Saved Invoices could not be updated"

The invoice itself is saved. Only its PDF copy could not be replaced, usually because that PDF is open in a PDF reader.

1. Close the PDF in Adobe Reader, Edge or Preview.
2. Click Save & Download again, or repeat the cancel or undo.

#Something is missing from the PDF

• Logo, signature or stamp: check it is uploaded and saved in Settings, and ticked under Customize.
• UPI QR code: needs a UPI ID on the account, a rupee invoice, and UPI QR ticked under Customize.
• Bank details or PAN: tick Bank details under Customize; the account needs a bank name.
• Anything on a receipt printer: receipts leave some things out on purpose. See What a receipt leaves out.

#A logo or signature picture will not upload

You may see: "This doesn't look like an image", "Image is ... MB — over the 5MB cap", "Image must be under 500KB", or "Could not decode this image".

1. Use a PNG or JPG. An iPhone photo (HEIC) must be turned into a JPEG first.
2. Make it smaller, ideally under 500 KB: crop it or shrink it in any photo app.
3. Upload it again.

#GST, tax and returns

Wrong tax on an invoice, and messages from GST Returns.

#The invoice has the wrong tax split

1. Check your own state in Settings.
2. Check the client's state, or their GSTIN, which fills the state in.
3. If goods go to a different state from the client's address, set Place of Supply on the invoice.
4. For a client abroad, set their country: it is then an export, charged as IGST. For an SEZ unit, tick SEZ on the client.

See How GST is worked out.

#"Set your business State in Settings"

You may see: "Set your business State in Settings — required for correct CGST/SGST vs IGST split." or "Set your GSTIN in Settings first" (E-Way Bill).

1. Open Settings, Company Details.
2. Fill in State (and GSTIN, which fills the state in), and save.
3. Go back to the invoice; the tax is worked out again.

#No GST is charged at all

Charge GST on this invoice (group Tax) is probably turned off under Customize. Turning it off removes GST from the invoice, and your choice carries over to new invoices. Tick it again. Bills of supply and delivery challans never charge GST.

#"GSTR-1 export blocked — fix these first"

An invoice number is too long or has characters the portal refuses, or an item has a GST rate the portal does not accept. The message names the first ones.

1. Open the invoice the message names and fix its number or rate.
2. Export again.

See Checks before the file is made.

#"That doesn't look like a GSTR-2B JSON"

The file chosen is not the GSTR-2B JSON from the GST portal: often the Excel or PDF version, or a different return.

1. On the GST portal, download GSTR-2B for the month as a JSON file.
2. If it comes as a ZIP, extract it first.
3. Choose that .json file. See GSTR-2B.

#"No data to export for this period"

The chosen period has nothing of that kind for this business.

1. Check the period at the top.
2. Check the business at the top of the sidebar: each business has its own invoices. See Switching business.

#It says VAT instead of GST, or the other way round

Change Region in Settings, and check your country in Company Details. Tax names follow the seller's country.

#Backups, restore and Google Drive

Daily backups, backup files and restoring.

#A backup or restore failed

You may see: "This file doesn't look like a Vyapzio backup.", "Could not read the file", "Restore failed: ...", "Backup failed: ..." or "No data folder found - nothing to back up."

A restore saves what you have now first, so a failed one changes nothing.

1. Read the end of the message: Failed to fetch, Request body too large, disk full and permission each have their own entry.
2. For Import Backup, choose the vyapzio-backup-date.json file saved by Export Backup.
3. Try another day from Settings, Backup Management.

See Backups, updates and moving PC.

#"Cannot write to that folder" (backup copy folder)

You may see: "Give the full folder path, for example D:\Backups", "Choose a folder outside the app's data folder.", "Cannot write to that folder: ...", or "Folder saved, but copying today's backup failed: ...".

1. Type the whole path, starting with the drive letter, such as D:\Vyapzio Backups; on a Mac, a path starting with /.
2. Choose a folder outside the app's own books folder.
3. For a USB disk, plug it in first. Settings says when a copy fails.
4. For a permission code such as EACCES, choose a folder in your own Documents or another drive.

See Keeping a copy somewhere else.

#Google Drive upload failed

You may see: "Google Drive access was revoked. Connect it again.", "Drive auth failed — backup downloaded locally only", "Google Drive: Please reconnect in Settings" or "Google Drive upload failed: ...".

The file was still saved on this computer. Only the copy to Drive did not happen.

1. Check the internet.
2. In Settings, Cloud Backup, click Sign in with Google again.
3. Save or export again.

#"Skipped damaged file" in the log

One saved file was damaged, by a power cut, a disk error or editing it by hand. The app skips it so everything else still opens.

1. Note the file name in the line (for example bills/INV_0007.json).
2. Open the books folder: File → Open Books Folder.
3. Open backups, then the newest date folder, then the same subfolder (bills). Copy that file.
4. Paste it into the same subfolder of the books folder, replacing the damaged one, and close and reopen Vyapzio.
5. No good copy there? Restore a whole day from Settings, Backup Management instead (it puts all your data back to that day), or move the damaged file to your Desktop and email it to contact@vyapzio.in.

#Mac

Messages macOS shows before the app starts.

#The Mac will not open Vyapzio

• "cannot be opened because Apple cannot check it for malicious software" or "unidentified developer": the app is not signed by Apple yet. In System Settings → Privacy & Security, click Open Anyway next to the Vyapzio message, then confirm. Only the first time.
• "Vyapzio is damaged and should be moved to the Trash": usually the DMG was opened from inside another archive. Copy Vyapzio to Applications first, then open it from there.
• It opens then closes at once: check the Problem log in Help & About, then open it again. If it closes again, email contact@vyapzio.in with what the Problem log says.

See Opening Vyapzio on a Mac.

#Problem log and reporting a problem

Vyapzio keeps a list of recent problems on this computer: a save that failed, a screen that went wrong, the update check failing. Open Help & About in the sidebar and scroll to the Problem log card.

Private details are removed before anything is kept: GSTIN, PAN, phone numbers, email addresses, UPI IDs and bank account numbers. Nothing is sent anywhere unless you click Report.

#Reporting a problem

1. In the Problem log, click Report next to the problem.
2. An email opens, addressed to contact@vyapzio.in, with the version, your computer and the error details already filled in. Private details (GSTIN, PAN, phone, email, UPI ID, bank account) are removed first.
3. Add what you did just before it happened and any screenshot (hide your GSTIN and bank details), then send it.

Reporting without the Problem log: email the version (bottom of the Dashboard, or Settings → App updates), your computer, what you did and what you saw. Problems are fixed in the next update; anything urgent, such as the app not opening, straight away.

#Sending the details another way

Click Copy details (or Copy in the Problem log), paste it into an email to contact@vyapzio.in or a WhatsApp message, and add what you did just before it happened. Read it before sending; it is plain text.

#Questions

Things people ask that are not errors.

#Can I use it on another computer, or my phone?

Vyapzio is a Windows and macOS desktop app. It does not run on a phone or tablet. Each licence covers one computer; to work on another computer, move the licence there and move your data. Several people can use the same computer with their own local sign-in; see Several people on one computer.

#Does it need the internet?

Only to buy, install, activate and update, and for the daily licence check. Invoices, reports, GST returns and even reading bills from photos all work offline. Google Drive upload uses the internet too.

#Is my data sent anywhere?

No business data is sent to us. The only automatic connection is the licence check to our server, which sends the licence, install ID and version. Your books stay in the app's folder unless you choose Google Drive, which copies files into your own Drive, or you send a problem report yourself. The full answer, with every address the app connects to, is in Is it safe?