Prospects
The Prospects screen is the starting point for all business development activity in JobNext. It presents a Kanban-style pipeline board where each prospect card moves through four defined stages as the relationship progresses. This visual layout gives sales teams and management an immediate picture of the entire pipeline — how many leads exist, which are in active engagement, which have proposals out, and which have been won.
Prospect Lifecycle
A prospect moves through four pipeline stages from initial identification to customer conversion. The diagram below shows the stages and the activities available at each one.
Pipeline Board Layout
The board is organized into four stage columns displayed side by side. Each column header shows a stage number, stage name, and a count badge (the total prospects in that stage).
| Stage | Name | Description | Badge Values |
|---|---|---|---|
| 1 | Lead / Qualify | New prospects that have been identified but not yet met. Initial qualification happens here — is this a real opportunity? Do they have budget? | LEAD |
| 2 | Meeting / Visit | Active engagement is underway. Meetings have been scheduled or site visits conducted. Follow-ups and notes are recorded. | MEETING or SITE VISIT |
| 3 | Proposal | A formal enquiry has been created and a quote/proposal is being prepared or has been submitted to the prospect. | PROPOSAL |
| 4 | Converted | The deal has been won. The prospect has been converted to a customer, a contract has been created, and the enquiry is now an execution job. | CONVERTED |
Column Filters
Each pipeline column has its own set of dropdown filters directly below the header. These let you narrow the cards shown within that specific stage:
- Zone — Filter by geographic zone (e.g., North, South, East, West)
- Type — Filter by prospect type classification (e.g., Construction, Facilities, Catering)
- Category — Filter by prospect category (e.g., Government, Private, Semi-government)
These filters operate independently per column, so you can apply different filter combinations to different stages simultaneously.
Pagination
Each column shows 4 prospect cards per page. At the bottom of each column, pagination controls show the range (e.g., "1 - 4 of 361") with Previous/Next buttons to navigate through pages within that column.
Prospect Cards
Each prospect is displayed as a card within its stage column. The card shows:
| Card Element | Description |
|---|---|
| Prospect Name | The name of the prospect (person or company), displayed as a clickable blue link at the top of the card. |
| Phone Number | Primary contact phone number, shown directly below the name (if available). |
| Address | Full address: street line, city + state, country + postal code. Multi-line display. |
| Status Badge | A color-coded badge at the bottom-left: LEAD (blue), MEETING / SITE VISIT (yellow), PROPOSAL (orange), or CONVERTED (green). |
| Action Buttons | Icon buttons at the bottom-right of the card (see below). |
Card Action Buttons
Each prospect card has up to three action buttons along the bottom-right:
| Button | Icon | Action |
|---|---|---|
| Edit | Pencil icon (blue circle) | Opens the Edit Prospect form where you can update the prospect’s name, company, address, phone, and other details. From the edit form you can also manage enquiries, contacts, follow-ups, and documents. |
| Next Stage | Arrow icon (blue circle) | Advances the prospect to the next pipeline stage. The card moves to the next column and the badge updates. This action is immediate — no confirmation dialog. |
| Contacts | Person icon (blue circle) | Opens the contact list for this prospect where you can view and manage the people associated with the prospect company. (Not shown on Converted-stage cards.) |
Top Action Bar
Above the pipeline board, a toolbar provides these controls:
| Control | Description |
|---|---|
| Add + (green button) | Opens the Add Prospect form to create a new prospect. The new prospect will appear in the Lead / Qualify column. |
| Upload (blue button) | Opens the bulk upload screen to import multiple prospects from a spreadsheet file (CSV/Excel). |
| Search Bar | Type a prospect name, phone number, or address keyword and click the search icon. This filters prospect cards across all columns simultaneously. |
Creating a New Prospect
Follow these steps to add a new prospect to the system:
- Navigate to Preconstruction → Prospects.
- Click the Add + button (green) at the top-left of the page.
- The Add Prospect form opens. Fill in the fields described in the table below.
- Click Save to create the prospect.
Add Prospect Form Fields
| Field | Required | Description | Constraints |
|---|---|---|---|
| Name | Yes * | The name of the prospect (person or company name). This is the primary identifier shown on the pipeline card. | Free text, must not be empty |
| Company (dropdown) | Yes * | The tenant company this prospect belongs to. Auto-populated based on your login. | Dropdown from omni_company_master |
| Account Manager | No | The sales person or account manager responsible for this prospect. | Searchable dropdown (staff directory) |
| Company (text) | No | The organization name the prospect belongs to (the prospect’s own company). | Free text |
| Lead Source | No | Where this lead came from. Dropdown options include sources like Referral, Website, Trade Show, Cold Call, etc. | Dropdown (configurable list) |
| Address | No | Street address or location details. Multi-line text area. | Free text (multi-line) |
| City | No | City name. | Free text |
| Country | Yes * | Country. Defaults to India but can be changed. | Dropdown (country list) |
| State | Yes * | State/Province. The dropdown values change based on the selected Country. | Dependent dropdown (filtered by Country) |
| Postal Code | No | ZIP or postal code. | Free text |
| VATIN | No | VAT Identification Number or Tax ID of the prospect’s company. | Free text |
| Phone | Yes * | Primary phone number. Shown on the prospect card in the pipeline. | Free text (numeric recommended) |
| No | Primary email address for communication. | Valid email format | |
| Website | No | Company website URL. | Free text (URL recommended) |
After saving, the new prospect card appears in the Lead / Qualify column with a LEAD status badge.
Advancing a Prospect Through Stages
To move a prospect to the next stage in the pipeline:
- Locate the prospect card in its current column.
- Click the Next Stage button (arrow icon) on the card.
- The card immediately moves to the next column and its status badge updates.
The progression is one-directional via the button. To move a prospect backward to a previous stage, open the Edit form and change the stage manually.
Editing a Prospect
Click the Edit (pencil icon) button on any prospect card. This opens a detailed form with multiple tabs:
- Prospect Details — All the fields from the Add form plus additional fields like Type, Category, Zone, Deal Size, Deal Probability, and Deal Close Date.
- Enquiries — List of all enquiries (jobs in tender stage) linked to this prospect. You can create new enquiries from here.
- Contacts — Manage the people associated with this prospect: name, designation, phone, email.
- Follow-ups — Schedule and record meetings, calls, and other follow-up activities with dates, notes, and completion status.
- Documents — Attach files to the prospect record (proposals, NDAs, presentations, etc.).
Bulk Uploading Prospects
For importing large numbers of prospects at once:
- Click the Upload button (blue) in the top action bar.
- Download the template file to see the required column format.
- Fill in the spreadsheet with prospect data (Name, Company, Phone, Address, City, State, Country, etc.).
- Upload the completed file and click Import.
- All imported prospects appear in the Lead / Qualify column.
Searching for Prospects
Use the Search Bar above the pipeline board to find specific prospects:
- Type a prospect name, phone number, or address keyword in the search box.
- Click the Search icon (magnifying glass) or press Enter.
- The pipeline board filters to show only matching prospects across all columns.
To clear the search and show all prospects again, clear the search box and click Search again.
Best Practices
- Fill in all details upfront — Complete the phone, email, address, and company fields when creating a prospect. This data appears on the pipeline card and is searchable.
- Assign an Account Manager — Always assign a salesperson so pipeline reports accurately reflect team performance.
- Progress systematically — Use the Next Stage button to advance prospects: Lead → Meeting → Proposal → Converted. Don’t skip stages.
- Add contacts early — Record the key contacts at the prospect company so the team knows who to reach out to.
- Log every follow-up — Record all meetings, calls, and site visits as follow-ups. This creates an audit trail and feeds the "Meetings Completed" KPI on the dashboard.
- Use filters — Use Zone, Type, and Category filters per column to focus on specific segments during pipeline reviews.
- Bulk upload for large lists — When onboarding large lead lists from trade shows or purchased data, use the Upload feature instead of creating prospects one by one.
- Review stalled prospects — Regularly check the Lead/Qualify column for prospects that have been sitting there too long without advancement.
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Cannot save prospect — validation error | One or more required fields (Name, Company, Country, State, Phone) are empty. | Fill in all fields marked with a red asterisk (*) and try again. |
| State dropdown is empty | No Country has been selected, or the selected Country has no states configured. | Select a Country first. The State dropdown populates based on the Country selection. |
| Prospect card not showing in pipeline | Column filters (Zone, Type, Category) may be hiding the card. | Clear all column filters and use the Search bar to locate the prospect. |
| Accidentally advanced a prospect | Clicked Next Stage by mistake (no confirmation prompt). | Click Edit on the prospect card and manually change the stage back to the correct value. |
| Upload fails with errors | Spreadsheet has missing required columns or invalid data formats. | Download the template, ensure all required columns are present, and that Country/State values match the system’s master lists. |