Documents and client portal: guide
Help release c4e6d48f22a45602 · Generated 22 November 2026. Online at docs.mycadesk.in/modules/docs/.
Help explains how the software works and is not professional advice; refer to the statute or notification.
Documents, the client portal and privacy
Documents keeps every client's files with a retention date, locks engagement files, shares chosen documents through the client portal, and runs the firm's privacy (DPDP) work.
Documents is where the firm files what it receives from clients and what it prepares for them. Each document belongs to a client (its permanent file, a period, or unfiled) or to an engagement, and you see it only if you can see that client or engagement (ethical walls apply).
What happens to a document
- Filed. Every upload is scanned for viruses first; only a clean file becomes a document. Uploading again adds a new version. See Find, file and search client documents and Work with a document.
- Kept. Every version gets a retention date within a minute of filing. Dates only ever move later. See How long documents are kept.
- Protected. Aadhaar originals are stored apart; staff and clients see the masked copy. See Aadhaar originals and masked copies.
- Locked. When an engagement is signed or closed, its file is locked write-once with a fingerprint of its contents. See Lock an engagement file.
- Held. A legal hold keeps records past their retention date and blocks erasure. See Legal holds.
Working with clients
- Requests: the document checklist of an engagement goes to the client's portal contacts as requests. See Requests to clients.
- Sharing: staff choose which documents the client's contacts can see. Nothing is shared by default.
- Approvals: contacts approve a draft with a one-time code; the app keeps the evidence. See Client approvals.
- Health reports: an optional monthly summary for clients. See Monthly client health reports.
Privacy (DPDP)
The firm's privacy notice, consents, rights requests, retain-and-restrict and erasure are under Privacy (DPDP). The app records the firm's decisions; it does not make them. See Privacy (DPDP) work (sign in to read) and Rights requests, retain-and-restrict and erasure (sign in to read).
Parts switched on separately
The client portal, the privacy toolkit and health reports are switched on for a firm separately during roll-out. While one is off, its pages say so and its screens in the portal do not appear.
Settings
- Document sharing and engagement file lock settings: who may share, when engagement files lock.
- Client portal request and upload settings: requests, uploads and the client calendar.
- Privacy (DPDP) settings (sign in to read): the rights request time and who is reminded.
- Health report settings: monthly health reports.
Aadhaar originals and masked copies
A file that shows an Aadhaar number is stored as a restricted original. Everyone sees its masked copy; opening the original needs a manager, a reason and a fresh identity check.
When a file is treated as an Aadhaar original
- its kind is an Aadhaar kind;
- the person uploading ticks This file shows an Aadhaar number; or
- the app finds a valid Aadhaar number in the file's text.
Once marked, a document stays marked.
What people see
- Staff and the client's contacts get the masked copy, which shows only the last 4 digits.
- Until a masked copy is attached, the document shows Masked copy pending and has no preview.
- Aadhaar numbers are never added to the search index.
- An Aadhaar original is never shared with the client; only its masked copy is.
Attach a masked copy
Steps
- Make a copy of the file in which the Aadhaar number shows only its last 4 digits.
- On the document page, choose Attach a masked copy and pick the file.
- Wait while it is scanned for viruses and checked: a copy in which a full Aadhaar number can still be read is refused.
Open the original
Only managers and above can choose Open with a reason. Give a reason of at least 10 characters and confirm it's you (Step-up). The reason and the download are recorded in the audit log, and the download link lasts 60 seconds.
How long documents are kept
Each document version gets a kept-until date from the platform's published retention rules and the firm's own extensions. The date counts from a start event and never moves earlier.
Every document version, every imported data file and every record another module registers gets a retention within a minute of being filed. You see it in the Retention section of a document.
What the app shows
| Field | Means |
|---|---|
| Governing class | The class whose rule gives the longest date (a record can fall under several). |
| Starts from | The event the period counts from, for example the end of the period, the date a report was signed or the date a relationship ended. Not known yet until that event is on record. |
| Kept until | The date the record may be disposed of, or Permanently. |
How the date is worked out
For each class that applies, the app takes the longest of the platform's published period for that class, the firm's own extension and the firm's default, and adds it to the start date. The longest result wins.
- The periods come from the platform's published retention content, not from this page. When the content changes, dates are worked out again.
- Dates only move later. If a new calculation gives an earlier date, the stored date stays and the record is marked Kept to the longer earlier date.
- A record whose start date is not known yet has no date. It is kept, and it blocks both the lock of its engagement file and the erasure of the client.
- A legal hold keeps records whatever their date. When the hold is released, the date is worked out again with any period that must follow a hold.
Warning
The app keeps records at least as long as the published rules say. Whether a longer period is needed for a particular client is the firm's decision.
Your client portal
The client portal is where you send documents your CA team asks for, approve drafts and returns, see dates, pay invoices and manage how your data is used. Ask your CA team about anything it means for you.
The portal is your direct line to your CA team. It works on a phone as well as a computer. You sign in with a link and a one-time code; there is no password. See Sign in to your client portal.
If you are the contact for more than one client (for example yourself and your business), choose the client at the top of the screen.
What you can do
| Screen | What it is for |
|---|---|
| Requests and Documents | Send what your CA team asked for, and see what they shared: Send documents your CA team asked for |
| Approvals | Approve or reject drafts: Approve a document in the portal |
| Tax returns | Approve returns and enter the codes needed to file and verify them: Approve and verify your tax returns |
| Calendar | Dates for your work this month: Your compliance calendar |
| Invoices | Your CA firm's invoices and how to pay: See and pay your CA firm's invoices |
| Your books | Let your CA team read your Zoho Books: Connect your Zoho Books |
| Privacy | The privacy notice, your consents and your rights: Your privacy, consents and rights |
Some screens appear only if your CA firm uses them.
Ask your CA team
The portal shows what your CA team has asked for and prepared. It does not explain what a figure or a rule means for you. For any question about your taxes or your documents, ask your CA team, for example with a message from the portal.
Choose Sign out when you finish on a shared device.
Accept an engagement letter
Open the link the CA firm sent you, confirm it is you with a one-time code, read the letter and the proposal, then accept or decline.
A CA firm may send you a link to accept its engagement letter. You do not need an account.
Steps
- Open the link from the firm.
- Under Confirm it is you, ask for a code. It goes to the e-mail or mobile the firm has for you.
- Enter the one-time code.
- Under Read and decide, read the letter and the proposal.
- Accept, or decline (you may give a reason).
Your answer is recorded with evidence that it was you; it is not a digital signature. Tax shown in a proposal is an estimate; the tax invoice is what counts.
- If the page says the link is not valid any more, ask the firm for a new one.
- If no code can be sent to you, the firm will collect your answer another way.
- After too many attempts, wait a minute and try again.
Questions about the letter or the fees: ask the firm.
Approve a document in the portal
Your CA team may ask you to approve a draft. Read it, choose Approve or Reject, and confirm with a one-time code sent to your phone.
Approvals lists the drafts your CA team asks you to approve.
Steps
- Open Approvals and choose the document.
- Read it.
- Choose Approve or Reject. You may add a comment.
- Enter the 6-digit code sent to your registered number to confirm.
Your decision is recorded with the time and the code you used. If you reject, your CA team will be in touch.
- If your CA team uploads a newer version, the old approval cannot be used; wait for the new request.
- An approval sent to another person can be decided only by them.
Not sure whether to approve? Ask your CA team before you decide.
Approve and verify your tax returns
See the returns your CA team prepares for you, approve them, enter the codes they need to file and verify, and follow the filing status.
Tax returns has two parts: To approve and authorise (what needs you now) and Filing status (all your returns).
Approve a return
Open the return to see its summary: the main figures, as they will be filed, with account numbers masked. To approve it, follow the link to Approvals and confirm with your one-time code.
Enter a code
Some steps need a code that you receive on your own phone, for example to file a GST return, to link your income-tax account to your CA firm, or to verify your income-tax return.
Steps
- Open the return that is Waiting for your OTP.
- Confirm with the portal's one-time code first.
- Enter the code you received by SMS and send it.
The code is used once, straight away, and is not stored. If a code is not accepted, check the SMS and try again. After too many attempts your CA team starts again.
Filing status
Each return shows where it is: in preparation, waiting for your approval, being filed, filed and verified, and so on. The acknowledgement is shown by its last four characters only; your CA team has the full copy.
Questions about the figures or about what a return means for you: ask your CA team.
Client approvals
Follow every draft sent to client contacts for approval with a one-time code, filter by status and open the document to withdraw a pending request.
This page lists drafts sent to client contacts for approval, across the clients you can see. Filter by Status and open a row to go to its document.
How an approval works
- Seniors and above ask for an approval from the document page (Ask the client to approve).
- Only an addressed contact decides, in the portal, with a fresh one-time code.
- If a newer version is uploaded before the contact decides, the old request can no longer be approved; ask again for the new version.
- The decision is stored with evidence: the contact, the time, how the code was sent and the fingerprint of the approved version. It is recorded as an approval, never presented as an electronic signature.
To cancel a request still pending, open the document and choose Withdraw.
Connect your Zoho Books
Your CA team may ask to read your Zoho Books. Read what they will see, agree, sign in to Zoho to allow it, and disconnect at any time.
Your books shows requests from your CA team to read your Zoho Books, and the books you have connected.
Steps
- Open the request under Requests from your CA team.
- Read Your CA team will be able to read: - the list of what they will see.
- Agree, then sign in on Zoho's own page and allow access.
Back in the portal you see "Your Zoho Books is connected". It then appears under Connected books.
To stop your CA team reading your books, disconnect them under Connected books. It takes effect at once.
If the connection did not complete, open the request and try again. Questions: ask your CA team.
Find, file and search client documents
Find a client's file, search inside documents you can see, upload a document, and manage the client's folders, holds, engagement files, requests and portal contacts.
Documents home
- Client files: type a client's name or code and open its file.
- Search inside documents: type at least 2 characters. The search covers titles and the text of documents you can see; Aadhaar numbers are never indexed.
- Recently filed: the latest documents across the clients you can see.
A client's file
The page lists the client's Folders (they appear as documents are filed) and its documents, which you can filter by Shared with the client and Status. From here you can also open the client's Legal holds, its Engagement files and the Requests to this client.
Upload a document
Steps
- On the client's file, choose Upload a document.
- Choose the file and the Kind of document. Add a title, a period (for example
Y:FY2025-26for a financial year,Q:FY2026-27:2for a quarter orM:2026-04for a month) and an engagement if it belongs to one. - Tick This file shows an Aadhaar number if it does (see Aadhaar originals and masked copies).
- Choose Upload. The file is scanned for viruses first and filed only when the scan is clean. If the scan is still running, use Check the scan again after a minute.
A file the scan blocks is not filed. Upload a clean copy instead.
Client portal contacts
The Client portal contacts panel lists the people at the client who can sign in to the portal.
- Invite a contact: the owner, partners and firm admins can invite a new contact by e-mail. An Indian mobile number is needed for the one-time sign-in code.
- Link an existing contact: for a family or group, one person can be the contact of several clients. Managers can link a person who is already a contact of another client.
- Remove access: the contact no longer sees this client; links they hold stop working within 60 seconds. A reason is recorded.
- Mark as verified NRI (partners only): such a contact may use an international mobile; codes then go by WhatsApp with e-mail as the fallback.
Legal holds
A legal hold keeps a client's records past their retention date and blocks erasure until it is released. Place a hold on everything, some periods or chosen documents, and release it now or on a date.
The list shows every hold you can see, with its client, scope and status. Filter by Status.
Holds placed by the notice register
When a proceeding opens in the notice register, a hold is placed for its client, period and law by itself. Such a hold shows Placed through the notice register and is released there when the proceeding ends (see Proceedings and their legal holds).
Place a hold
Managers and above can place a hold from the client's file:
Steps
- Choose Place a legal hold.
- Choose What to hold: Everything for this client, Some periods (for example
Y:FY2023-24, Y:FY2024-25) or Chosen documents. - Give a reason and choose Place hold.
Records filed later that fall in the scope join an active hold. Locked files also get a hold on the stored file itself; Records held shows each record and whether its stored file is held.
Release a hold
On the hold's page, choose Release the hold, now or On a later date, with a reason. The retention date of each record that no other hold covers is then worked out again.
Lock an engagement file
When an engagement is signed or closed, its documents are locked write-once with a fingerprint of the whole file. The app schedules the lock; managers can lock now.
The engagement file page shows the client, the engagement, when it was signed, when it Locks on, and its lock status: Not locked, Lock scheduled, Locking…, Locked (WORM) or Lock failed. Below are the documents filed to the engagement.
When the lock happens
- A tax-audit engagement is scheduled to lock a set number of days after it is signed (the firm's setting; see Document sharing and engagement file lock settings).
- A certificate engagement locks on the day it is signed.
- Other engagements lock when they close, unless the firm switched that off.
A daily job locks the files whose lock date has come. If a file cannot lock yet (for example a document has no retention start date), the job leaves it scheduled and tries again on a later day.
Lock now
Managers and above can choose Lock now once the engagement is signed or closed. Every current version (and masked copy) is locked write-once until its retention ends, and a SHA-256 manifest of the file is recorded and stored. After that the documents cannot get new versions, move or change kind.
Warning
Locking cannot be undone. Make sure every final document is filed to the engagement first.
Monthly client health reports
Review the monthly compliance summaries prepared for clients, approve them in bulk to file, share and notify, or skip a client for the month.
Health reports are off by default. They need the feature switched on for the firm and the firm's own setting (see Health report settings).
What a report contains
Facts from the firm's records only: returns of the month and whether they were filed, what comes up in the next 45 days (provisional dates labelled), requests awaiting documents, approvals awaiting the client and, if the firm chooses, outstanding invoices and returns filed late. There is no score or ranking. The footer says the firm prepared it from its records as at a date.
Review and send
Steps
- Choose the Month. Drafts are prepared on the firm's chosen day of the month; you can also choose Prepare drafts for this month.
- Read the drafts. Tick the ones to send, or Select every draft.
- Choose Approve selected. Approved reports are filed as documents, shared with the client and the contacts are notified with a link.
- Choose Skip for a client who should get no report this month.
In review mode, managers and above approve before anything is sent. In automatic mode reports are approved at once, except a report that lists a late return, which always waits for a person. Restricted clients get no report.
Requests to clients
Track what clients were asked to send through the portal, accept or return their answers, send reminders, record answers given outside the portal and comment with the client.
Requests are created when an engagement's document checklist is sent to the client: one request per item. The client's portal contacts are notified with a link and answer with files or, for an information item, by typing the answer.
The list
Filter by Status. Answers that wait for the firm's review appear here when the firm does not accept them automatically (see Client portal request and upload settings).
A request
The page shows the client, the engagement, whether the answer is a file or information, whether it is required, its date, when it was sent and the help shown to the client.
- What the client sent: files from the portal are filed as documents only after a clean virus scan.
- Accept: marks the checklist item received.
- Return to the client: the client sees your reason in the portal and can answer again; any document already filed stays.
- Send a reminder: reminds the contacts (a link only).
- Record an offline receipt: for an answer given outside the portal, by e-mail or in person. Upload the file you received (it is scanned) or type the answer.
- Comments with the client: the client sees these; staff are shown as "Your CA team".
A request of a restricted client gets no reminders (see The client is restricted under retain-and-restrict (sign in to read)).
See and pay your CA firm's invoices
Invoices lists what your CA firm has billed you, with the amount and balance. Pay opens your CA firm's own payment page.
Invoices lists your CA firm's invoices with the date issued, the amount and the balance.
To pay, choose Pay on an invoice. Your CA firm's payment page opens in a new tab; the portal itself does not take payments. The balance changes once your CA firm records the payment.
If the screen says invoices are not available in the portal yet, your CA firm sends them another way. For questions about an invoice, ask your CA team.
Send documents your CA team asked for
Open a request from your CA team, add the files it lists and send them. You can see what you have sent under Documents.
Your CA team asks for documents through Requests. Each request lists what is needed.
Steps
- Open Requests and choose the request.
- For each item, choose Add file and pick the file from your device (PDF, image or spreadsheet).
- Check the list and choose Send.
Files you send appear under Documents. If something is missing or unclear, your CA team will ask again in the same request.
Example
A request "Bank statements for the year" lists two accounts. Add one statement file for each account, then send.
Questions about what a document means for your taxes: ask your CA team.
Sign in to your client portal
Ask for a sign-in link with the e-mail address your CA team has on record, open it in the same browser, then enter the one-time code sent to your mobile.
You do not need a password for the client portal. You sign in with a link and a one-time code.
Steps
- Open the client portal and enter the e-mail address your CA team has for you.
- Open the link we send you, in the same browser on the same device. The link works once and expires after a short time.
- Enter the 6-digit code sent by WhatsApp or SMS to the mobile number your CA team has for you.
- Read and accept the privacy notice the first time (and again when your CA firm updates it).
If the link or code does not work
- The link has expired or was used already: ask for a new one.
- You opened the link in another browser: ask for a new link from the browser you want to use.
- You did not receive a link or code: ask your CA team to check your e-mail address and mobile number.
Warning
Sign out when you finish, above all on a shared device. The portal also signs you out after 15 minutes without activity.
Take the portal tour
A short tour shows you around the client portal the first time you sign in. You can take it again from Help.
The tour
The first time you sign in, a short tour shows the portal menu, help and how to sign out. Choose Next to move on, or press Escape or Close tour to stop at any time.
Take it again
Open Help and choose Take the welcome tour.
Turn it off
In Help, clear Offer tours to me automatically. Your choice is kept for you on every device.
Work with a document
Download a document, upload a new version, edit its details, share it with the client, ask the client to approve it, attach a masked copy, check its retention, or void it.
The page shows the document's client, engagement, kind, period, folder, origin (from the client or the firm), its Versions and its Retention.
Versions and details
- Upload a new version keeps the earlier versions; each can be downloaded from Versions.
- Edit details changes the title, kind or period; the document is refiled if its kind or period changes.
- A document locked with its engagement file cannot be changed (see The document is locked with its engagement file (sign in to read)).
Share with the client
Nothing is shared until someone shares it. Share with the client asks for a purpose and a reason; every active portal contact of the client then sees the current version. Stop sharing ends their access at once; a download link already issued lapses within 60 seconds.
Who may share depends on the firm's setting (see Document sharing and engagement file lock settings); articles never share. Some kinds are never shared, and an Aadhaar original is shared only as its masked copy.
Ask the client to approve
Choose Ask the client to approve, pick who decides, and add a message and a date if you wish. The contacts are notified with a link (no attachment) and approve with a one-time code. The approval is recorded with evidence (who, when, the channel and the version's fingerprint); it is not an electronic signature. Withdraw cancels a request still pending. See Client approvals.
Aadhaar originals
A document holding an Aadhaar original shows whether its masked copy is attached. Use Attach a masked copy to add it; managers and above can Open with a reason. See Aadhaar originals and masked copies.
Retention
The Retention section shows the governing class, the start date and the kept-until date. See How long documents are kept and, for records under a hold, See the legal holds.
Void the document
Managers and above can Void this document with a reason of at least 10 characters. Voiding keeps the record for its retention period but takes it out of use.
Your compliance calendar
The calendar shows the dates of the work your CA team does for you, month by month, and what has been done.
Compliance calendar shows, for each month, the work your CA team tracks for you and its state. Use Previous month and Next month to move.
- A date marked Provisional is expected to change but the change is not yet official.
- Date to be confirmed means the date is not fixed yet.
- Work your CA team has not finished is shown as pending, unless your CA firm chose to show it as overdue.
The calendar helps you see what is coming. For what a date means for you, or what you need to send, ask your CA team.
Your privacy, consents and rights
Read your CA firm's privacy notice, see how your data is used, withdraw a consent you gave, and ask for a copy, correction or erasure of your data.
Privacy has three parts.
Privacy notice
Your CA firm's notice explains why your data is used. You acknowledge it before using the portal, and again when it changes. Choose Read the notice to read it at any time.
How your data is used
Each use of your data is listed with whether you agreed. Where a use rests on your consent you can choose Withdraw my consent. Some uses rest on the law or on the service you asked for and cannot be withdrawn; the screen says so. You also see how your sign-in codes reach you.
Your rights
Choose what you are asking for (for example a copy of your data, a correction, erasure, a complaint, or nominating someone) and send it. Your requests are listed with their state. Records your CA firm has to keep are restricted, not erased, until they may be erased.
For questions about a request, ask your CA team.
Client portal request and upload settings
Firm settings for how client answers are accepted, when clients are reminded, how large a portal upload may be, what the client calendar shows and how long contacts keep access after closure.
Only the owner or a partner changes these settings, with a reason and a fresh identity check (Step-up). An invalid stored value falls back to the default.
| Setting | Default | What it does |
|---|---|---|
docs.request.auto_accept | on | A clean upload or a typed answer fulfils the request at once; the checklist item shows "received", not "verified". Off: staff accept each answer. |
docs.request.reminder_offsets_days | −3, 0, 3 | Days before (negative) or after the request's date on which open requests are reminded (−14 to 14). |
docs.upload.max_mb | 50 | Largest portal upload in MB (1 to 200). A larger file is refused. |
docs.portal.calendar.categories | return, payment, statement | The kinds of obligation shown on the client's calendar. |
docs.portal.calendar.show_overdue | off | On: overdue items show as overdue on the client's calendar. Off: they show as pending. |
docs.portal.closure_access_days | 90 | Days after a client is closed during which its contacts keep portal access (0 to 365). |
Document sharing and engagement file lock settings
Firm settings for who may share documents with clients and when engagement files are locked.
Only the owner or a partner changes these settings. The app asks for a reason and for you to confirm it's you (Step-up); every change is recorded in the audit log. An invalid stored value falls back to the default.
| Setting | Default | What it does |
|---|---|---|
docs.share.min_role | staff | The lowest role that may share documents with clients: staff, senior or manager. Articles never share. |
docs.lock.assembly_days.tax_audit | 60 | Days after a tax-audit engagement is signed before its file is locked (1 to 60). |
docs.lock.on_close | on | Other engagement files are locked when the engagement closes. |
See Lock an engagement file for the lock itself.
Health report settings
Firm settings that switch monthly client health reports on, choose review or automatic sending, the day drafts are prepared and what the report includes.
Only the owner or a partner changes these settings, with a reason and a fresh identity check (Step-up). Health reports also need the feature to be switched on for the firm.
| Setting | Default | What it does |
|---|---|---|
docs.health_report.enabled | off | Prepare monthly health reports for the clients signed up for them. |
docs.health_report.mode | review | review: a manager or above approves before anything is sent. auto: reports are approved at once (a report with a late return still waits for a person). |
docs.health_report.day_of_month | 5 | Day of the month (India time, 1 to 28) on which drafts for the previous month are prepared. |
docs.health_report.include_invoices | off | Add the number of the client's outstanding invoices. |
docs.health_report.show_late | off | Add the returns filed in the month after their date. |