Clients: guide
Help release c4e6d48f22a45602 · Generated 22 November 2026. Online at docs.mycadesk.in/modules/clients/.
Help explains how the software works and is not professional advice; refer to the statute or notification.
Clients and engagements
The client register holds each client of the firm with its identifiers (PAN, GSTIN, TAN, CIN, LLPIN), compliance profile and engagements. Everything else in the app (calendar, tasks, documents, billing) hangs on these records.
A client is a person or organisation the firm works for, added from their PAN. Each client has a type (individual, HUF, partnership firm, LLP, company, trust and so on), a partner in charge, a branch, and a status (active or closed). You see only the clients you are assigned to or that your branch and role let you see; the others are not listed anywhere.
What a client holds
- Identifiers: one PAN, and any GSTINs, TANs, CIN or LLPIN. The app checks each one as you type and refuses an identifier that another client of the firm already holds. See Client identifiers (PAN, GSTIN, TAN, CIN, LLPIN).
- Compliance profile: facts per period (for example GST filing frequency or turnover) that the compliance calendar needs to work out which filings apply. See The compliance profile.
- Engagements: a piece of work for one period, such as an income-tax return or a GST annual return, with the people assigned and the prepare, review, sign-off and close steps. See Work on an engagement.
- Establishments: places of business per state, with their state registrations (professional tax, labour welfare fund, shops and establishments). See Places of business and state registrations.
- History: every change is kept with the date it applies from and the reason given.
Where to start
- Find a client: find a client, filter by branch or partner, save a view, export.
- Add a client: add a client from their PAN.
- The client page (Client 360): the client page (Client 360), identifiers, profile, engagements and closure.
- Changes waiting for approval (maker-checker): when your firm sends your edits to a manager for approval.
- Client settings for your firm (sign in to read): firm settings for client codes, change requests and document checklists.
Features your firm may not have yet
Some parts are switched on firm by firm while they are introduced. When one is off, the page says so in place.
| Feature | What it adds |
|---|---|
Client 360 (ff.clients.client360) | The overview of compliance, documents, billing and more on the client page, and related clients |
Client export (ff.clients.grid_csv) | Export CSV on the clients list |
Document checklists (ff.clients.packs) | The document checklist on an engagement, sent to the client portal |
Profile suggestions (ff.clients.suggestions) | Suggested profile facts to accept or dismiss |
Messages you may see
Error messages about clients and engagements start with CLIENT.; each one has its own help
article with what to do, linked from the message. Common ones:
The PAN's 4th character does not fit the type of client (sign in to read), This identifier already belongs to another client of the firm (sign in to read),
This client already has that engagement for the period (sign in to read) and Linked filings are still open (sign in to read).
Changes waiting for approval (maker-checker)
Your firm can send the client changes of some roles (articles, by default) to a manager or partner. The change is saved as a request and applied only when someone else approves it.
The firm setting clients.change_request.required_for lists the roles whose client changes need
approval (by default, articles). For those roles, adding a client, editing details, adding an
identifier or recording a profile fact creates a change request; the client is not changed
yet, and the page says so.
Deciding a request
Requests for a client are listed on its page under Changes waiting for approval, with who asked and when.
- A manager, partner or the owner chooses Approve (the change is applied as if they made it) or Reject with a reason.
- The person who asked can Withdraw it.
- Nobody can approve or reject their own request. In a firm set up as a solo practice, the owner may approve their own, and this is logged. See Someone else has to decide your own change request (sign in to read).
The approver needs the right to make the change themselves (for example, edit rights on the client or, for a new client, on its branch). A request that has already been decided or withdrawn cannot be decided again.
Places of business and state registrations
For state compliance (professional tax, labour welfare fund, shops and establishments), record each client's places of business per state, their registrations and monthly headcount. The calendar adds the state filings for states the app covers.
When your firm uses state compliance, the client page has an Establishments section. It lists
the client's places of business by state, with their registrations, the last 12 months of
headcount, and a coverage chip per law (for example PT · MH).
Add a place of business
Steps
- Under Establishments, choose Add place of business.
- Give a Name, the State and, where professional tax is levied by the local body, the Local body (only the listed ones are covered).
- Choose the Kind of place (shop, commercial establishment, office, factory, warehouse or other) and the date it Opened on.
- Tick Principal place of business in this state for the one place whose registrations and dates count for the state. Each state can have only one principal place at a time.
Registrations
For each place, add its registrations: PT employer registration (PTRC), PT enrolment (PTEC), labour welfare fund, or shops and establishments. Give the Registration number, the date it was Registered on and, if it expires, Valid until. A chip shows when a registration has expired or expires soon. Adding a registration also closes the matching "get registered" reminder in the calendar once the app has processed it.
A registration number can be active on only one place; cancel it on the old place first. To change a registration, record a new version of it rather than adding a second one.
Headcount
Enter the number of employees per month. Some state filings depend on it.
Coverage
Each state and law shows as covered, covered (beta), partly covered, not covered, or not applicable (the state does not levy that law). For a state that is not covered, the calendar adds no dates; the app says so instead of staying silent. Firm-wide, see State registrations and coverage.
The compliance profile
The compliance profile holds facts about a client per period (such as GST filing frequency or turnover). The compliance calendar uses them to decide which filings apply and when; a missing fact is never guessed.
The compliance calendar works out a client's filings from its type, identifiers and profile facts. When a fact it needs is missing, the filing is listed as Needs profile facts and has no date until someone records the fact. The app never fills in a default.
On the client page
Under Compliance profile you see:
- Missing facts: what the calendar needs and nobody has recorded yet, for the current periods.
- Recorded facts: each fact with its period and value.
- Suggestions (when your firm has them): facts the app suggests from other data, for example the types a PAN fits. A suggestion is never used until someone accepts it; Dismiss removes it.
- Filings waiting for a fact: obligations held back by a missing fact.
Record a fact
Steps
- Under Record a fact, choose the Fact.
- Choose the Period, and the GSTIN when the fact belongs to one registration.
- Enter the value (amounts in whole rupees) and, if you like, a note for the history.
- Choose Record fact. The calendar recalculates that client's filings.
Periods
Income-tax facts use financial years up to 2025-26 and tax years from 2026-27 (for example "Tax year 2026-27"). GST and quarterly facts always use financial years. The form offers only the periods that fit the fact. See Use FY years up to 2025-26 and tax years from 2026-27 (sign in to read).
If your firm sends your role's changes for approval, a recorded fact becomes a change request first. See Changes waiting for approval (maker-checker).
Add a client
Add a client from their PAN. The app checks the PAN and the type of client as you type, gives the next client code, and can add the client's GSTIN in the same step.
Steps
- On the clients list choose Add client.
- Under Identity, enter the PAN. The app checks its shape and suggests the types of client its 4th character fits.
- Enter the Legal name and choose the Type of client. Add a trade name and the date of birth or incorporation if you have them.
- Under Profile, give the residential status (for individuals and HUFs), whether the client has business or professional income, and a group if you use groups.
- Leave Client code blank to use your firm's numbering, or type one.
- Optionally, under GST registration, enter a GSTIN with its registration date and type.
- Choose Add client. The client page opens.
When the PAN does not fit the type
The 4th character of a PAN shows the kind of holder (for example P for an individual and C for a company). If the type you chose does not fit, the app refuses it: check both against the PAN card. In the rare case where the type is right, a partner can enter a Partner override reason of at least 20 characters; it is kept in the audit log. See The PAN's 4th character does not fit the type of client (sign in to read).
When your firm reviews new clients
If your firm sends your role's changes for approval, Add client creates a change request instead of the client, and the page says so. A manager or partner approves it; the GSTIN can be added once the client exists. See Changes waiting for approval (maker-checker).
When the GSTIN is refused
The client is still added, and the message says why the GSTIN was not. Add it again from Identifiers on the client page once you have checked it. See Client identifiers (PAN, GSTIN, TAN, CIN, LLPIN).
Example
A synthetic client, "Sample Traders", PAN ABCFS••••K: the 4th character F fits a partnership firm or an LLP, so the app suggests those types.
Change a client's details
Edit a client's name, type, profile answers, group or client code. Each change is recorded from the date you give, with your reason; under maker-checker it goes to a manager or partner first.
Steps
- On the client page choose Edit details.
- Change what you need: legal or trade name, type of client, date of birth or incorporation, residential status, business or professional income, group, client code.
- Set Applies from: the date from which the change is true. Earlier dates keep the old value in the client's history.
- Give a Reason for the change and choose Save changes.
Only the fields you changed are sent. If nothing changed, the page says so.
Things to know
- Type of client: a type that does not fit the PAN's 4th character is refused unless a partner overrides it with a reason. See The PAN's 4th character does not fit the type of client (sign in to read).
- Identifiers (PAN, GSTIN and others) are not edited here; use Identifiers on the client page. See Client identifiers (PAN, GSTIN, TAN, CIN, LLPIN).
- Someone else saved first: if a colleague changed the client while you were editing, the app asks you to reload and make your change again, so neither change is lost.
- Maker-checker: if your firm sends your role's changes for approval, the page says your change was sent and nothing has changed yet. See Changes waiting for approval (maker-checker).
- Closed clients cannot be edited until the owner or a partner reopens them. See This client is closed (sign in to read).
Find a client
The clients list shows the clients you may see. Search by name or client code, filter by status, type, group, branch, partner in charge or manager, find a client by PAN or GSTIN, and save the filters as a view.
The list shows only the clients you are assigned to or that your branch and role let you see. A client you cannot see is not listed, even when you search for it by name.
Search and filter
Steps
- Type part of the client's name or its client code in Name or client code and choose Search.
- Narrow the list with Status, Type of client, Group, Branch, Partner in charge or Manager (the clients of the branches that person manages).
- Choose Clear filters to start again.
Filters are kept in the address, so you can bookmark a filtered list or go back to it.
Find a client by identifier
Under Find by identifier, choose the kind (PAN, GSTIN, TAN, CIN or LLPIN), enter it in full and choose Find. The match must be exact. The identifier you type is not kept in the address bar or the browser history.
Saved views
Choose Save these filters to keep the current filters under a name; open it again from Open a saved view. A view keeps filters only: whoever opens it sees only the clients they may see. The owner or a partner can tick Share with the whole firm. Only the person who saved a view can delete it.
Export
When your firm has it, Export CSV downloads the clients you may see (with the status filter applied). The file contains PANs, so the app asks you to confirm it's you (Step-up) and does not keep a copy. At most 20,000 clients are exported at once; filter by status if you have more. Export for Excel round trip appears when your firm uses bulk editing in Excel.
Warning
An exported file holds client identifiers. Store it only where your firm's policy allows, and delete it when you are done.
The client page (Client 360)
One page for a client, with its details and partner in charge, an overview of compliance, documents, billing and more, identifiers, the compliance profile, engagements, places of business, pending change requests and closure.
Details
The top of the page shows the legal and trade name, type, status, client since, group, partner in charge, branch and the branch's manager. Edit details opens Change a client's details.
Members who manage client assignments can choose Change next to the partner in charge, pick a partner and give a reason. The change is recorded in the audit log.
Overview
When your firm has Client 360, the Overview shows a short section from each part of the app (compliance calendar, documents, data, billing and others), each with its latest items. A section says No access when your role does not include it, and Unavailable when it could not be loaded just now; the rest of the page still works.
Sections further down
- Identifiers: add and check PAN, GSTIN, TAN, CIN and LLPIN. See Client identifiers (PAN, GSTIN, TAN, CIN, LLPIN).
- Compliance profile: missing facts, recorded facts, suggestions and filings waiting for a fact. See The compliance profile.
- Engagements: the client's engagements and New engagement. See Work on an engagement.
- Establishments (when your firm uses state compliance): places of business, registrations and headcount. See Places of business and state registrations.
- Changes waiting for approval: change requests for this client. See Changes waiting for approval (maker-checker).
- Related clients: other clients linked to this one.
Close a client
When the firm stops working for a client, the owner or a partner chooses Close client, gives the date and a reason (ceased, disengaged or merged) and confirms. A closed client stays in the register with its history; new engagements, identifiers and places of business are refused until the owner or a partner reopens it. See Closing a client needs a date and a reason (sign in to read) and This client is closed (sign in to read).
When you cannot open a client
If the page says you have no access, the client is outside your branch or assignments, or behind an ethical wall. If you need it urgently, Ask for emergency access opens a request for temporary access, which must be approved before you can open the client.
Work on an engagement
An engagement is one piece of work for a client and period. Its page shows who is assigned, the prepare, review, sign-off and close steps, the history, and the document checklist sent to the client.
Create an engagement
Steps
- On the client page, under Engagements, open New engagement.
- Choose the Type of engagement and the Period. The periods offered fit the type: financial years up to 2025-26 and tax years from 2026-27 for income tax; years, quarters or months for GST.
- If the type is for one registration, choose which of the client's identifiers (for example which GSTIN) it is for.
- For a return, you may give the ITR form; it chooses the matching document checklist.
- Save. A client can have only one engagement of a type for a period.
People
Under People, assign a person to a role (assignee, preparer, reviewer, signer or external reviewer) with a reason; the reason is kept in the audit log. If your firm's separation-of-duties policy would block the choice later (for example the same person as preparer and reviewer), the page shows a Conflict next to the people concerned. Remove takes a person off with a reason.
Progress
The steps depend on the type of engagement:
- Mark preparation complete (from planned or in preparation).
- Approve review or Return to preparer with a note (when the type has a review).
- Sign off (when the type has a sign-off). The app asks you to confirm it's you, and the review must be approved first.
- Close engagement. If linked filings in the compliance calendar are still open, only a partner can close, with a reason of at least 20 characters.
Cancel engagement stops it at any step; a cancelled engagement cannot be reopened. Once work has started, the type of an engagement can no longer change. The History lists every step with who did it and when.
Document checklist
When your firm has document checklists, the engagement gets a checklist from the firm's published template for its type (and ITR form). Items asked for because a profile fact is missing are marked so.
- Send to client sends the items not yet requested to the client portal, with a date for the client to reply by (the firm's default is set in Client settings for your firm (sign in to read)); Send again re-sends what is still missing.
- Waive stops asking for an item: waived (not needed this time) or not applicable to this client, with an optional note.
- Items show as not requested yet, requested, received, declined by client, waived or not applicable.
If there is no checklist, your firm has no published template for that type of engagement yet.
Client identifiers (PAN, GSTIN, TAN, CIN, LLPIN)
How the app checks and stores a client's PAN, GSTINs, TANs, CIN and LLPIN, why an identifier can belong to only one client of the firm, and how to add one.
Every client has exactly one PAN, added with the client. Other identifiers are added on the client page under Identifiers: choose Add identifier, pick the kind, enter it and choose Add. For a GSTIN also give the date of registration and the registration type.
What the app checks
The app checks the shape of each identifier as you type and again when you save. It does not look the identifier up on a government portal.
| Identifier | Checked |
|---|---|
| PAN | 10 characters: 5 letters, 4 digits, 1 letter; the 4th character must fit the type of client |
| GSTIN | 15 characters; a known GST state code; the PAN inside it is this client's PAN (or one of its TANs for a tax-deductor registration); the last character matches the others |
| TAN | 10 characters: 4 letters, 5 digits, 1 letter |
| CIN | 21 characters, with a known company class (such as PLC, PTC or OPC) and a year of incorporation not in the future; only for a domestic company |
| LLPIN | 3 letters, a hyphen and 4 digits (for example AAB-1234); only for an LLP |
| DIN (directors and other people) | 8 digits |
Letters are turned into capitals and spaces are removed before the check.
One client per identifier
An identifier can belong to only one client of the firm at a time. If you enter one that another client already holds (even a client you cannot see), it is refused and that client's partner in charge is told. See This identifier already belongs to another client of the firm (sign in to read).
Where identifiers are shown
Identifiers are shown in full to everyone who can see the client. The clients list can find a client by an exact identifier without keeping it in the browser history. Task titles and thread titles must not contain identifiers; the client is linked instead.
Example
Synthetic GSTIN 27ABCFS••••K1Z•: 27 is the state code, the next ten characters are the client's PAN, and the last character is the check character.
State registrations and coverage
A firm-wide register of the professional tax, labour welfare fund and shops and establishments registrations of your clients' places of business, with expiry filters, and the table of states and laws the app covers.
Open it from the compliance calendar (State registrations and coverage) when your firm uses state compliance. It lists only the clients you may see.
Filter the register
- State and Registration (PT employer, PT enrolment, labour welfare fund, shops and establishments).
- Status: active or cancelled.
- Expiring: within 30, 60 or 90 days, to plan renewals.
Each row shows the client, state, registration, number, the date registered and a validity chip. Registration numbers are shown in full to anyone who can see the client.
State coverage
Below the register, a table shows for each state and law whether the app covers it: covered, covered (beta), partly covered, not covered, or not applicable. Filings are generated only where the state's content is published. Where a state is not covered, track those filings yourself.
To add or change a registration, open the client and use Establishments; see Places of business and state registrations.