> For the complete documentation index, see [llms.txt](https://payvance-innovation.gitbook.io/finlyticz-help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://payvance-innovation.gitbook.io/finlyticz-help-center/troubleshooting.md).

# Troubleshooting

## Troubleshooting

Common issues and their solutions when using FinlyticZ.

***

### Tally Not Connected

**Symptom:** The FinlyticZ Connector shows "Connection failed" when testing the Tally connection.

**Solutions:**

1. **Ensure Tally is running** — Tally must be open with a company loaded
2. **Check the port:**
   * In Tally: Press **F12** > Advanced Configuration > Verify port is `9000`
   * In Connector: Go to **Tally Setup** > Verify Host is `localhost` and Port is `9000`
3. **Enable Server mode in Tally:**
   * Tally ERP 9: **F12** > Advanced Configuration > **Act as Server: Yes**
   * Tally Prime: **F12** > Connectivity > **Act as Server: Yes**
4. **Check Firewall:** Ensure port 9000 is not blocked by Windows Firewall
   * Open **Windows Defender Firewall** > **Allow an app through firewall**
   * Add Tally and FinlyticZ Connect if not listed
5. **Restart Tally** after changing port/server configuration

***

### Company Not Showing in Connector

**Symptom:** No companies appear under "Tally Companies (Available for Sync)".

**Solutions:**

1. Ensure Tally is running with a company **open**
2. Click the **Refresh** button on the Companies screen
3. Verify the Tally connection is successful (test from Tally Setup)
4. If using network setup, ensure both PCs are on the same network

***

### Sync Not Working / Sync Errors

**Symptom:** Data is not syncing or sync shows errors.

**Solutions:**

1. Go to **Sync Jobs** in the Connector to view error logs
2. Ensure Tally is running and the company hasn't changed
3. Check internet connection — the Connector needs internet to push data to the cloud
4. Verify your **subscription/license** is active (check Dashboard)
5. Try clicking **Run Sync Now** manually
6. Increase **Tally Retry Attempts** in Tally Setup > Sync tab

***

### Login Issues

**Symptom:** Unable to log in to the mobile app or Connector.

**Solutions:**

1. Verify your **email and password** are correct
2. Check internet connection
3. If you forgot your password, tap **Forgot Password** on the login screen
4. If you get a **device conflict** error, it means another device is registered. You'll be prompted to switch devices via OTP verification
5. Clear app cache and try again

***

### Mobile App Not Showing Data

**Symptom:** Dashboard or reports are empty after login.

**Solutions:**

1. Ensure the **Connector is running** and syncing on the desktop
2. Pull down to **refresh** on the Dashboard
3. Check if the correct **company** is selected (side menu > Companies)
4. Verify sync status in the Connector's Sync Jobs screen
5. Check internet connection on your phone

***

### OTP Not Received

**Symptom:** OTP for verification is not arriving.

**Solutions:**

1. Check your **spam/junk folder** in email
2. Wait up to 2 minutes for delivery
3. Tap **Resend OTP** if the timer has expired
4. Ensure the email/phone number on your account is correct
5. Contact support if issue persists

***

### Connector Crashes or Won't Open

**Symptom:** FinlyticZ Connect crashes on startup or doesn't open.

**Solutions:**

1. Ensure only **one instance** of the Connector is running (check system tray)
2. **Restart your PC** and try again
3. Reinstall the Connector:
   * Uninstall from **Control Panel** > Programs
   * Download and install the latest version
4. Check that **Java** is properly installed (the Connector bundles its own runtime, but system conflicts can occur)

***

### Slow Sync Performance

**Symptom:** Sync takes a very long time.

**Solutions:**

1. Large Tally companies with many vouchers will take longer on the first sync
2. Subsequent syncs are **incremental** — only new/changed data is synced
3. Ensure a **stable internet connection** (wired preferred over WiFi)
4. Close unnecessary applications on the Tally PC to free up resources
5. Increase sync interval if real-time data isn't critical (Tally Setup > Sync tab)

***

### Biometric Lock Issues

**Symptom:** Biometric authentication fails or doesn't work.

**Solutions:**

1. Ensure your device supports **fingerprint or face ID**
2. Re-register your biometric in **phone Settings** > Security
3. Disable and re-enable biometric lock in **FinlyticZ Settings**
4. Use PIN/password as fallback

***

### Still Need Help?

If your issue isn't listed above:

* **Email:** <support@finlyticz.com>
* **Phone:** +91 7304471349
* **Website:** [finlyticz.com](https://finlyticz.com)

Please include:

* Your registered email
* Description of the issue
* Screenshots (if applicable)
* Connector version and Tally version


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://payvance-innovation.gitbook.io/finlyticz-help-center/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
