🚀 Getting Started

How to create your account and log in for the first time

1
Go to app.cafirmhq.com

Open the app in your browser. You will see the login screen with two options: Google Sign-In and Magic Link.

2
Choose your login method

Google Sign-In: Click "Continue with Google" and select your Google account. You will be logged in immediately.
Magic Link: Enter your email address and click "Send Login Link". Check your inbox for an email from noreply@mail.cafirmhq.com and click the link inside. Check your spam folder if it does not arrive within 2 minutes.

3
You are in — your 90-day trial starts now

First-time users land on the Dashboard. Your trial begins from the moment you log in. No credit card is required.

How to add your first company (GSTIN)

1
Click "+ Add Company" on the Dashboard

The button is in the top-right of the company list on your Dashboard.

2
Enter the company details

Fill in the GSTIN (15-character format), company name, state, and optionally an address, mobile, and email. The GSTIN is validated for format — make sure it is correct before saving.

3
Click "Save Company"

The company appears on your Dashboard. Click on it to start adding reconciliation data.

Tip: Each GSTIN is a separate company. If a client has multiple GSTINs (e.g. different states), add each one separately.
📊 Running a Reconciliation

How to prepare your upload files

1
Export the Inwards Register from Tally

In TallyPrime, go to Gateway of Tally → Display More Reports → GST Reports → GSTR-2A Reconciliation. Export the Inwards sheet as Excel (.xlsx or .xls). This is the "Inwards Register" file you will upload to CAFirmHQ.

2
Download GSTR-2B from the GST Portal

Log in to the GST portal → Returns → GSTR-2B. Select the period and click "Download". Choose the Excel format (not JSON). Save the file to your computer.

Common mistake: Do not confuse GSTR-2A and GSTR-2B. CAFirmHQ reconciles against GSTR-2B (the auto-drafted ITC statement). GSTR-2A is dynamic and changes as suppliers file — GSTR-2B is the finalized month-end snapshot used for ITC claims.

How to upload files and run reconciliation

1
Open the company and navigate to the correct month

From the Dashboard, click the company. Select the financial year, then click the month you want to reconcile (e.g. January 2026).

2
Upload your two files

You will see two upload zones side by side — "Inwards Register" and "GSTR-2B". Drag and drop or click to browse. Both files must be uploaded before you can run reconciliation.

3
Click "Run Reconciliation"

The engine processes your files. For a typical month with 100–200 invoices, this takes a few seconds. Results appear immediately in the Inwards grid below.

4
Review the results

The grid shows every invoice with its reconciliation status colour-coded. Green = Matched. Amber = Timing Difference. Red = Not Reflecting. Filter by status, add remarks inline, and resolve exceptions. Check the 2B Reco tab for the summary, and the Pending ITC tab for carry-forward items.

5
Export to Excel

Click the download icon in the Month View to export the full reconciliation output as a formatted Excel file — ready for filing reference or client review.

How to add and edit 2B Remarks

1
Click on the 2B Remarks cell for any invoice row

The cell becomes editable inline. Type your remark directly in the grid.

2
Press Enter or click away to save

The remark is saved immediately. Remarks are keyed to the company + period + invoice number, so they survive if you re-upload and re-run the reconciliation for the same month.

Tip: Remarks are shared across your whole CA team. Any team member with access to this company can see and edit remarks — useful when Articles do first-pass review before the CA signs off.
📁 Using the Document Vault

How to activate the Document Vault

1
Click "Activate File Vault" in the sidebar

The button appears in the left sidebar above Settings, but only if the Vault is not yet activated on your account. Click it to see the Vault plans and pricing.

2
Choose a Vault plan

Three tiers are available: Vault Starter (10 GB, ₹499/month), Vault Growth (25 GB, ₹999/month), Vault Pro (100 GB, ₹2,499/month). Select the one that fits your document volume.

3
Complete activation

Once activated, the Vault becomes available for every company in your account. Clicking on a company will now show a Company Home Screen with two options: GST Reconciliation and File Exchange (the Vault).

How to upload a file to the Vault

1
Open the company and click "File Exchange"

From the Company Home Screen, click the File Exchange card to open the Vault panel.

2
Select Inward or Outward tab, then open a folder

The Inward tab is for documents coming from the company to the CA (invoices, bank statements, Tally exports). The Outward tab is for documents going from the CA to the company (reports, notices). Click a folder to open it.

3
Click "Upload File"

Select your file. An upload form appears asking for: File Name (pre-filled from the file, editable), Description (optional — e.g. "March 2026 bank statement"), and Period (optional — e.g. "March 2026").

4
Click "Upload" and wait for confirmation

A progress bar shows the upload status. Once complete, the file appears in the folder list with its size, period, and the uploader's name. The upload goes directly to secure cloud storage — the file never passes through our servers.

Supported file types: PDF, DOC, DOCX, XLS, XLSX, XLSM, JPG, JPEG, PNG, GIF, TXT, CSV, XML, ZIP. Maximum size: 100 MB per file.

How to download a file from the Vault

1
Navigate to the file in the folder

Open the company → File Exchange → correct tab and folder.

2
Click the ↓ download icon on the file row

The file opens in a new browser tab and downloads automatically with the original filename. Alternatively, click the "..." menu on the file row and choose "Download".

👥 Managing Your Team

How to invite a team member (Article / Assistant)

1
Open the Admin Panel

Click "Admin" in the left sidebar. This is available to CA Admins only.

2
Click "Invite User" and enter their email

The invited person receives an email with a one-click login link. They do not need to set a password.

3
Assign companies to the new team member

Once they accept the invite and appear in the Admin Panel user list, click "Assign Companies" next to their name and tick the companies they should have access to. They will only see the companies you assign — not your full client list.

How to give a company accountant access to their own company's data

1
Enable "Company Login Access" on the company

From the Dashboard, click the company, then click "Edit Company". Toggle on "Company Login Access" and save. This step must be done before the accountant can log in and see data.

2
Invite the company accountant by email

From Admin Panel → Invite User, enter the accountant's email. They receive a login link.

3
Assign them to the correct company

In the Admin Panel, click "Assign Companies" for that user and select their company. They will see only that company when they log in — no other CA clients are visible to them.

Important: If Company Login Access is off, the company accountant will be unable to view any data even after logging in. The amber warning in the Admin Panel will flag this — enable it on the company before assigning.
🔧 Troubleshooting
I did not receive my magic link login email

Check your spam / junk folder first. Magic link emails come from noreply@mail.cafirmhq.com and are sometimes filtered by spam systems, especially on corporate email domains.

If it is not in spam:

  • Make sure you entered the correct email address on the login page.
  • The link is valid for 24 hours — if more than 24 hours have passed, request a new one.
  • Try the login page again to request a fresh link.

If you still cannot receive the email, try Google Sign-In instead (if your email is a Gmail / Google Workspace account). Or contact support.

Reconciliation shows too many "Missing in 2B" entries

Most common cause: wrong file uploaded.

  • Check that your Tally export is the GSTR-2A Reconciliation format — not a plain purchase report or ledger export. The column headers must include Supplier Invoice No., GSTIN, Taxable Value, etc.
  • Check that your GSTR-2B is for the same month as your Tally export. Uploading the wrong month is a common source of mass mismatches.

If the period matches and the files are correct: Some suppliers are simply late filers. Invoices they have not yet filed in GSTR-1 will not appear in your 2B. These will auto-resolve in a future month when the supplier files. They are correctly placed in the Pending ITC Register.

Journal entry invoices are showing as "Missing in 2B" even though they exist in 2B

This is a known Tally behavior that CAFirmHQ's engine handles automatically. When a purchase is entered in Tally as a Journal entry (rather than a Purchase voucher), Tally stores its own sequential number (e.g. "52") in the invoice number field — not the supplier's actual invoice number.

CAFirmHQ uses a fallback matching strategy (Strategy 2: supplier name + taxable amount) to resolve Journal entries correctly. If you are still seeing Journal entries as Missing in 2B, verify that:

  • The supplier's GSTIN in your Tally export exactly matches the GSTIN in GSTR-2B (formatting matters — no spaces).
  • The taxable value in both files matches within ₹1.

If the issue persists, submit a ticket with the invoice details and we will investigate.

I invited a user but they say they cannot see any companies

Two things to check in order:

  • For Company Accountants: Confirm that "Company Login Access" is enabled on the relevant company. Go to Edit Company and check the toggle. If it is off, the accountant can log in but will see no data.
  • For all invited users: Confirm that you have assigned at least one company to them. Open Admin Panel → find the user → click "Assign Companies" → make sure the correct companies are ticked.

After assigning companies, the user may need to refresh their browser for the assignment to appear.

A file uploaded to the Vault is not appearing in the folder

If the upload progress bar completed without an error: Refresh the page — the file list may not have auto-refreshed.

If the upload appeared to complete but the file is not there: The upload may not have been confirmed. This can happen if the browser tab was closed before the upload finished, or if there was a network interruption. Try uploading again.

If you get a file type error: Only the following extensions are accepted: PDF, DOC, DOCX, XLS, XLSX, XLSM, JPG, JPEG, PNG, GIF, TXT, CSV, XML, ZIP. Files outside this list will be rejected before upload starts.

If you get a size error: The maximum file size is 100 MB. Compress or split the file if needed.

The GSTIN I entered is showing as invalid

CAFirmHQ validates GSTINs against the standard 15-character format: 2-digit state code + 10-character PAN + 1-digit entity number + "Z" + 1 check digit.

Common issues:

  • Spaces before, after, or within the GSTIN — remove all spaces.
  • Incorrect state code — the first two digits must match the state of registration.
  • Lowercase letters — GSTINs use uppercase letters only.
  • Copying from a PDF that introduced invisible characters — retype the GSTIN manually.

If your GSTIN is definitely correct but CAFirmHQ still rejects it, submit a support ticket.

Couldn't find what you need?

Our team responds to every ticket within 1 business day. Or browse the FAQ for common questions about reconciliation, the Vault, and billing.