ZippCRM
Training Manual
A complete, step-by-step guide for backend operators, compliance managers, and client portal users of ZippCRM — India's BFSI regulatory compliance CRM.
Login & Navigation
Use this section when a user is signing in for the first time, is not sure what to enter, or gets lost after login. ZippCRM runs in the browser, so there is nothing to install.
Logging In
Open the ZippCRM URL shared by your Admin
Open the exact address your team uses for ZippCRM. Many teams use an internal URL or a local server address. Use Chrome or Edge if possible.
Enter your full email address
Type the same email address that Admin used when your user was created. Do not use a short username or nickname.
Enter your password and click Sign In
If this is your first login, use the temporary password given by Admin. If the password is wrong, check case, spacing, and Caps Lock before assuming the account is broken.
Enter the 6-digit code if two-factor authentication is enabled
Open your authenticator app and type the current code. If the code is rejected, wait for the next code to appear and try again.
Navigation Overview
ZippCRM uses the left sidebar for navigation. Users do not need to memorize every item. They only need to know which modules belong to their job.
Where Different Users Should Start
| User Type | Start Here | Why |
|---|---|---|
| Project Manager | Mission Control, Projects | To see urgent work and then move into active client matters. |
| Associate | My Assignments or Projects | To work on assigned items and update real records while working. |
| Compliance Manager | Mission Control, Return Tracker | To watch deadlines, filings, and regulator-specific work. |
| Reviewer | Maker-Checker | To approve or reject controlled actions. |
| Client User | My Compliance Portal | To upload documents, track status, and raise queries. |
User Roles
ZippCRM has five internal roles and one client portal role. Each role controls what a user can see and do.
| Role | Who Uses It | Key Permissions |
|---|---|---|
| Admin | System administrator, managing partner | Full access: users, settings, license, billing, all data |
| Project Manager | Engagement lead, senior manager | Create/edit projects, assign work, approve timesheets, manage deals |
| Compliance Manager | Regulatory specialist | Manage regulatory library, deadlines, compliance returns, create content |
| Associate | Consultant, analyst, team member | View assigned tasks, log time, upload documents, update task status |
| Viewer | Senior partner, auditor | Read-only access to all data — cannot create or modify |
| Client (Portal) | The client company contact | Portal-only: view projects, upload docs, track filings, view deal status |
Mission Control Dashboard
Mission Control is the first screen you see after login. It gives you a real-time snapshot of your firm's operational health.
Reading the Dashboard
Lead Management
Every new client engagement starts as a Lead. Leads let you qualify interest, attach initial notes, and convert to a full client record when you win the business.
Creating a New Lead
Click "Leads" in the left sidebar
This opens the Leads list view.
Click "+ New Lead"
A slide-in form opens on the right side of the screen.
Fill in the lead details
Enter: Company Name, Contact Name, Email, Phone, Enquiry Type (RBI / SEBI / IRDAI / Other), Estimated Value, and a brief description of the requirement.
Set the Lead Stage
Choose from New → Contacted → Qualified → Proposal Sent → Won / Lost. Start with New.
Click "Create Lead"
The lead is saved and appears in the Leads list. You will receive a confirmation.
Converting a Lead to a Client
Open the lead record
Click on the lead name in the list to open its detail panel.
Change stage to "Won"
Use the Stage dropdown and select Won. Add a note about what was agreed.
Click "Convert to Client"
This creates a new Client record and pre-fills it with the lead information. You will be taken directly to the new client record.
Client Management
Client records are the central hub for everything related to a firm you work with — contacts, projects, documents, invoices, and portal access.
Client Record Overview
Giving a Client Portal Access
Open the Client record → Portal Access tab
Click the "Portal Access" tab in the client detail view.
Click "+ Create Portal User"
Select a contact from the dropdown (contacts must be added first) and set a temporary password.
Share credentials with the client
Use the "Send Welcome Email" button to automatically email the portal URL and login details. Or share them manually.
Projects & Workflows
A project is the main working record for a client engagement. Use it for stages, tasks, evidence, liaison notes, billing, and audit history. If the work belongs to a client matter, it should usually live here.
Creating a New Project
Open Mission Control and find "Launch a regulatory project"
Project creation starts from the launch panel on Mission Control. This is where the system asks for client, workflow, owner, billing, and due date.
Select Client and Workflow Template
Choose the legal entity first, then the workflow template. The workflow template controls the project type, stage structure, and task logic.
Check the auto-generated Project Name and link the lead if applicable
The project name is built from the client and workflow. If the project came from a lead, select it in Linked lead. Otherwise leave it blank.
Select the Project Manager and fill billing details
Choose the accountable owner. Then select the billing model tiles and complete the billing breakdown so the total contract value calculates correctly.
Set Due Date, add Internal Summary, and click Create Project
Use the summary to record scope notes, risk notes, or important context for the team.
Project Creation Checklist
Understanding Project Stages
Stages vary by workflow template. The active stage is shown near the top of the project detail view. Each stage also shows checklist readiness, so users can see whether the project is actually ready to move.
Advancing a Project Stage
Open the project and review the current stage
Check the stage pills, current task lines, and the mandatory evidence checklist before trying to move the project.
Complete or verify the required checklist items
If the current stage is not ready, the advance button may stay blocked. Reviewers can verify checklist items from the project detail screen.
Click Advance to next stage or Request stage advance
The exact button depends on whether maker-checker is enabled. Some teams move stages directly; others require checker approval first.
Wait for the result message and refresh if needed
If the move is immediate, the project advances. If maker-checker is enabled, the request waits for a checker to approve or reject it.
Service Desk & Assignments
The Service Desk is where work gets routed to team members and tracked through completion.
Creating an Assignment
Open a project task
Navigate to the project, find the task you want to assign, and click it to open the detail panel.
Click "Assign To"
Select the team member or team from the dropdown. You can also assign to a team slug (e.g., compliance-team) for shared ownership.
Set due date and priority
Choose the due date and priority (Low / Medium / High / Critical). Critical tasks trigger immediate notifications.
Add instructions
Write clear instructions in the Notes field. The assignee can see this in their Service Desk queue.
Click "Save Assignment"
The assignee receives an in-app notification and (if configured) an email alert.
Completing an Assignment (Associate view)
Go to Service Desk → "My Tasks"
Your assigned tasks appear here sorted by due date. Overdue tasks show in red.
Click the task and update status to "In Progress"
This logs your start time and notifies the project manager.
Upload evidence or add notes
Attach supporting documents (PDFs, Excel, scanned certificates) directly to the task. Add a completion note summarising what was done.
Mark as "Completed"
The project manager is notified. If maker-checker is enabled, they must approve before the task is officially closed.
Deal Flow — NBFC Takeover
The Deal Flow module manages complex M&A and NBFC Takeover transactions through a strict RBI-compliant state machine. Each stage has business rule enforcement so you cannot skip mandatory steps.
The NBFC Takeover State Machine
1. SLA Signed
Engagement letter executed and advance fee received. NDA document attached here.
2. Target Identified
Target NBFC shortlisted and profile prepared (NOF, CRAR, business lines, geographic presence).
3. Inventory Checked
CERSAI search, FIR check, litigation check, and secured debt inventory verified.
4. Token Received
Refundable token amount received from buyer and placed in custody (track in Escrow tab).
5. Seller Meeting
Formal meeting between buyer and seller. Cheque exchange protocol documented.
6. Due Diligence
Full DD: financials, books of accounts, RBI inspection records, CIBIL default analysis. Record result as Passed or Failed.
↳ DD Failed: Token Returned → Closed Failed
Token returned to buyer (100% refund). Deal closes. Logs in deal audit trail.
7. 25% Premium Paid · RBI Filed
Premium paid per agreed valuation. RBI application for change in management filed via PRAVAAH portal. Log application date here.
8. Pending RBI Approval
RBI reviews the application (typically 90–180 days). Track all RBI queries in the RBI Comms tab. Alerts fire at 60 days and 120 days.
↳ RBI Rejected → Closed Rejected
Deal terminates. Fees retained per SLA terms. Log rejection reason.
9. Post-Approval Setup
Director appointment, fund infusion, CKYC for new directors, update COSMOS portal. Lending operations commence.
10. Share Purchase
Actual share transfer from old shareholders. File RBI intimation within 30 days of transfer.
11. Completed
Deal closed. Use "Create Post-Acquisition Compliance Project" to automatically seed 12 standard RBI obligations.
Creating a New Deal
Go to Deal Pipeline → "+ New Deal"
Click the Deal Pipeline item in the left sidebar, then "+ New Deal".
Fill in deal details
Enter: Deal Name, Deal Type (NBFC Takeover / M&A Advisory / etc.), linked Client, Assigned Manager, and Deal Value (₹ Cr). The system auto-seeds activity templates for your deal type.
Click "Create Deal"
The deal appears in the Kanban swimlane view at the "SLA Signed" stage with all activities pre-populated.
The Deal Detail Panel — 7 Tabs
Deal Document Vault
Every deal has a full document vault organised by deal stage. Documents are tagged so you can quickly find the SLA, DD report, or RBI application for any deal.
Attaching a Document
Open the deal → Documents tab
Click the deal card in the pipeline, then click the Documents tab (📁) in the detail panel.
Fill in document details
Select the Stage (e.g., due_diligence), Document Type (e.g., DD Report), enter the File Name, and paste the file URL or storage path.
Click "+ Attach"
The document appears in the vault grouped by stage. If you mark a document as type SLA or NDA, the deal's SLA/NDA shortcut URL is automatically updated.
RBI Communication Log
RBI approvals take 90–180 days and often involve multiple rounds of queries, clarifications, and hearings. The RBI Comms tab captures the complete communication record with follow-up tracking.
Logging an RBI Communication
Open the deal → RBI Comms tab (🏛)
Switch to the RBI Comms tab in the deal detail panel.
Select the Communication Type
Choose from: RBI Query, Our Response, RBI Letter/Notice, Hearing/Meeting, Approval Document, Rejection/Objection, or Internal Note.
Enter date, subject, and details
Set the communication date, subject line, and a summary of the content. Paste the document URL if you have a scanned letter.
Set a follow-up date (if required)
If RBI has given a deadline for response, set the follow-up date. A reminder will appear in Risk Alerts when the date approaches.
Click "+ Log" and mark done when resolved
Once the follow-up is actioned, click "Mark Done" on the comm entry. Green = resolved, amber = pending follow-up.
RBI Timeline Alerts (Automated)
| Condition | Alert Level | Action Required |
|---|---|---|
| Application filed > 120 days ago, no decision | Critical 🚨 | Escalate immediately. Call RBI relationship officer. Log escalation in RBI Comms. |
| Application filed 60–120 days ago | High 🏛 | Send follow-up letter. Check PRAVAAH portal for status. Log in RBI Comms. |
| Stage stuck > 30 days with no update | Medium | Review internally. Add a note or advance the stage. |
Fit & Proper, Shareholding, Valuation & Escrow
Fit & Proper Criteria (RBI requirement)
RBI requires all proposed directors and significant shareholders to meet Fit & Proper criteria before approving a change in management. Track this per-person in ZippCRM.
Open the deal → Fit & Proper tab (✅)
Click "+ Add Person" for each director/shareholder
Select the person type (Proposed Director / Existing Director / Buyer Shareholder / Seller Shareholder / KMP). Enter Name, DIN, PAN, and Net Worth (₹ Cr).
Update Fit & Proper status as it progresses
Use the status dropdown: Pending → Under Review → Cleared / Flagged. Tick CKYC Submitted and Board Resolution checkboxes as they are completed.
All persons cleared = green confirmation banner
Once every person shows "Cleared", a green banner confirms you can proceed with the RBI application.
Shareholding Pattern
Open the Shareholding tab (📈) to record pre-acquisition and post-acquisition shareholding. The system calculates running totals — the percentage column turns green at 100%, amber below, and red above. This data feeds directly into the RBI application.
Valuation & Escrow
The Valuation & Escrow tab (💰) captures:
| Field | What to Enter |
|---|---|
| Net Worth (₹ Cr) | As per last audited balance sheet |
| Book Value (₹ Cr) | Net assets / total shares |
| Agreed Valuation (₹ Cr) | Final negotiated deal value |
| Valuation Methodology | e.g., "Net Asset Value (NAV) method" |
| Premium Basis | e.g., "25% above book value per RBI guidelines" |
Add escrow entries for the token and premium — record bank name, custodian, amount, release condition, and status (Held / Released / Returned). Update status as funds move.
Regulatory Library
The Regulatory Library stores all official compliance documents, circulars, and internal policy notes. Documents go through a Draft → Review → Approved → Published workflow with maker-checker controls.
Publishing a New Regulatory Document
Go to Regulatory Library → "+ New Document"
Select the category: RBI Circular / SEBI SCORES / IRDAI Guideline / Internal Policy / Compliance Checklist.
Fill in document metadata
Enter: Title, Regulator, Effective Date, Summary, and either paste the content or attach a PDF link.
Submit for Review
Save as Draft, then click "Submit for Review". A Compliance Manager receives a notification to review.
Compliance Manager approves and publishes
After review, the document is Approved then Published. Published documents are visible to all users and client portal users (if marked as client-visible).
AI Copilot
AI Copilot uses Anthropic Claude or OpenAI GPT (configured by your Admin) to help draft communications, summarise documents, and generate compliance checklists — all within ZippCRM.
Common Use Cases
| Task | How to Use |
|---|---|
| Draft a client email | Go to AI Copilot → Chat, describe the email purpose, click Generate. Review and copy to your email client. |
| Summarise an RBI circular | Paste the circular text into the chat box and ask "Summarise the key compliance obligations". |
| Generate a compliance checklist | Ask: "List all mandatory filings for an NBFC under RBI guidelines for FY2025-26". |
| Draft a DD findings summary | Paste your DD notes and ask "Draft a professional due diligence summary for the board". |
Ops Center
The Ops Center is the backend team's operational follow-up console. It covers email tracking, upload review queues, scheduled reports, and WhatsApp notifications.
Key Ops Center Features
| Feature | Purpose |
|---|---|
| Inbound Email Log | See all emails received from clients. Link them to projects or tasks with one click. |
| Upload Review Queue | When clients upload documents through the portal, they appear here for your team to review and approve. |
| Scheduled Reports | Set up weekly or monthly reports emailed automatically to clients (Compliance Health Summary, SLA Breach Report, etc.). |
| WhatsApp Notifications | If your BSP is configured, send WhatsApp alerts to clients for deadline reminders and stage updates. |
Setting Up a Scheduled Report
Go to Ops Center → Scheduled Reports → "+ New Report"
Choose report type and frequency
Options: Compliance Health Summary, SLA Breach Report, Upcoming Deadlines, Project Status Dashboard. Frequency: Weekly (Mondays 9 AM) or Monthly (1st of month).
Set recipients
Enter comma-separated email addresses. You can include internal staff and client contacts.
Click Save and use "Send Now" to test
The "Send Now" button delivers the report immediately so you can verify the format before the first scheduled run.
Risk Alerts & Intelligence
Risk Alerts gives your team a proactive early-warning panel. It runs automatically and surfaces issues that need attention before they become critical.
Alert Types
| Icon | Alert Type | Trigger Condition |
|---|---|---|
| ⏰ | Overdue Task | A task has passed its due date without being completed |
| 📅 | Filing Imminent | A regulatory deadline is due within 7 days |
| 🚨 | RBI Overdue | NBFC Takeover RBI application pending for >120 days |
| 🏛 | RBI Follow-up | NBFC Takeover RBI application pending for 60–120 days |
| 🏦 | Deal Stalled | Deal has had no update for >30 days |
| 💸 | Pending Challans | Client has 2+ unpaid government fees |
| ⛔ | BOM On Hold | A billable activity has been on hold for >5 days |
Navigate to Risk Alerts in the sidebar and click "↺ Refresh" to get the latest view. Severity: Critical (red) > High (amber) > Medium (blue).
Client Portal — User Guide
This section is for client users and for internal team members who train clients. The goal is to show clients how to respond correctly without relying on email for everything.
Logging into the Portal
Open the portal URL in your browser
Your consulting firm will provide the URL (e.g., https://portal.yourfirm.com). Use Chrome or Edge.
Enter your email and password
Use the credentials sent to you by your consulting firm. If you haven't received them, contact your relationship manager.
Portal Tabs Overview
| Tab | What You Can Do |
|---|---|
| ⬡ Overview | Summary of active projects, recent activity, upcoming deadlines |
| 🗂 My Projects | View live project progress, timelines, and document requests linked to each project. |
| 📎 Documents | Upload requested documents and respond to document requests from your consulting team. |
| 📋 Filings | See scheduled filings and whether they are due, in progress, overdue, or filed. |
| ₹ Invoices | View and download fee invoices |
| 💬 Messages | Send and receive messages with your consulting team |
| 🏥 Compliance Health | Colour-coded compliance health dashboard across all regulators |
| 🏦 Deal Status | Track your NBFC Takeover or M&A deal stage in real time (if your firm has enabled deal visibility for your account) |
Uploading a Document
Open Documents or the relevant project
If the request is tied to a project, the easiest path is often My Projects → open project → review pending document requests.
Read the request title and notes carefully
Clients should confirm the exact document name, period, and format before uploading anything. If the request is unclear, they should raise a query instead of guessing.
Select the file and add notes only if needed
Use the notes field to explain gaps, versions, or special context. Do not use notes to replace the actual file.
Submit the upload and check status
Once submitted, the internal team sees the document for review. Clients should wait for review instead of sending the same file by email as well.
Deal Status View (Client Portal)
If your consulting firm is handling an NBFC Takeover or M&A advisory deal for you, and they have enabled portal visibility for the deal, you will see a Deal Status tab in your portal.
The Deal Status view shows: the current deal stage, DD result, RBI decision (if available), and the last update date. Detailed financial or confidential information is not shown to clients — only the stage and key milestones.
Admin & Settings
The Admin panel is available only to Admin users. In the current ZippCRM layout, Admin is organized into tabs such as Users, Roles & Permissions, Teams, Project Types, and Email Config.
Key Settings Areas
| Setting | Where to Find It | Description |
|---|---|---|
| Users | Admin → Users | Create backend users, set status, assign team, and decide whether a user is a team manager. |
| Roles & Permissions | Admin → Roles & Permissions | Create custom roles and control module-level access. |
| Teams | Admin → Teams | Create routing teams, descriptions, manager assignments, and team colors. |
| Project Types | Admin → Project Types | Create workflow templates, stage order, and default task masters for new projects. |
| Email Config | Admin → Email Config | Configure SMTP host, port, security mode, and sender settings for outbound email. |
| License | Admin → License | Review current license details and update the key when required. |
| Integrations / Other Tabs | Admin → Other admin tabs | Configure supporting platform settings depending on what your deployment has enabled. |
User Management
Adding a New Internal User
Open Admin and stay on the Users tab
Click + Create User to open the backend user form.
Fill Full name, Email, Role, and Team
The email must be unique. Choose the real working role, not the easiest role. Add a team if the user belongs to an operating team.
Set password, status, and team-manager flag if needed
You can provide a temporary password or leave it blank if the system should generate one. Set the user to active only when they should be allowed to log in.
Click Create Backend User and record the result
If ZippCRM generates a temporary password, copy it and share it securely with the user.
Enabling Two-Factor Authentication (2FA)
Open My MFA Settings
From Admin, users can use the My MFA Settings panel and click Enrol / Re-enrol.
Scan the QR code using an authenticator app
Use Google Authenticator, Microsoft Authenticator, Authy, or another TOTP app.
Enter the current code to confirm enrolment
Type the 6-digit code shown in the app to complete setup.
Test the next login if your firm enforces MFA
If MFA enforcement is enabled in company settings, the user will need a code on every login.
Common Tasks — At a Glance
Keyboard Shortcuts
Most Common Tasks — Step Count
| Task | Steps | Min. Role |
|---|---|---|
| Create a new lead | 5 steps | Associate |
| Convert lead to client | 3 steps | Project Manager |
| Create a project | 5 steps | Project Manager |
| Assign a task | 5 steps | Project Manager |
| Advance a project stage | 4 steps | Project Manager |
| Create an NBFC Takeover deal | 3 steps | Project Manager |
| Record DD result | 2 clicks | Project Manager |
| Log an RBI communication | 5 steps | Associate |
| Add a director for Fit & Proper | 3 steps | Associate |
| Create post-acquisition project | 1 click | Project Manager |
| Enable client portal visibility for a deal | 1 toggle | Project Manager |
| Add a new team member | 4 steps | Admin |
Troubleshooting
| Problem | Solution |
|---|---|
| Cannot log in | Check you are using your email address (not username). Check Caps Lock. Ask Admin to reset password. |
| Cannot advance a project stage | Check checklist readiness and mandatory evidence first. Also confirm the user has the right role and whether maker-checker approval is required. |
| Deal advance button not appearing | Check that DD status is set (for the DD stage) or RBI application date is entered (for RBI pending). Business rules block some transitions until fields are filled. |
| Client cannot see their deal in portal | Go to the deal → Overview tab → enable "👁 Client Portal Visibility". Also confirm the client's portal user is linked to the correct client record. |
| Client uploaded the wrong file | Reject or follow up through the document request and tell the client exactly what file, period, or format is still missing. |
| License error on login | Contact your Admin. Review the license tab and deployment configuration used for the environment. |
| Email notifications not sending | Go to Admin → Email Config and verify SMTP host, port, security mode, and sender credentials. |