Skip to main content

Agency Overview

Written by Sven Gerlach

Overview

The Overview tab is the landing screen for an associated agency. It gives licensing managers, compliance teams, and onboarding leads a single read-only summary of who the agency is, how far along they are in onboarding, whether the producer agreement is signed, where they are licensed and appointed today, and which agents and contacts sit underneath them.

What is the Agency Overview?

The Agency Overview consolidates information that is otherwise spread across the Agency, Agents, Contacts, Documents, Agreements, Payment Details, and licensing tabs into one scannable view. It also exposes the small set of actions you take while an agency is being onboarded, such as approving the pre-contract review, sending an Agency App invitation, or attaching the executed producer agreement.

Who uses it. Licensing managers, compliance and legal reviewers, and onboarding owners at MGAs and carriers. Compliance and legal use the Pending Your Review banner to make the approve-or-decline call; onboarding owners watch the timeline and chase missing data; licensing managers read the maps to see where the agency is appointed and where authority is missing.

Capabilities you will reach for here:

  • Confirm the agency's identity (legal name, NPN, FEIN, producer code, category, entity type, DBA, phone, fax, website, and legal address) without leaving the page

  • See the producer agreement's effective date and both the agency and MGA signature dates

  • Track onboarding progress (for invited agencies) or data completeness (for added or bulk-uploaded agencies) step by step

  • Approve or decline a pending Pre-Contract Review once the agency has finished their steps

  • Understand why an agency was routed to review when a custom-question answer triggered a gating rule

  • Request online signing of the producer agreement, or upload an already-signed agreement directly

  • See whether the agency has logged into the Agency App, when they first signed in, and when they were last active

  • Generate the Agency App invitation link or send a branded invitation email

  • See the bank account on file for commission payments, with the account number masked until you choose to reveal it

  • Read state-by-state license and appointment coverage for each product from two interactive US maps

  • See the contacts on file for the agency grouped by business role, and the roster of agents under the agency

Accessing the Agency Overview

  1. From the left sidebar, click Agencies.

  2. Click any row in the table to open the agency detail page. The Overview tab opens by default.

  3. If the record has been soft-deleted, a Deleted indicator appears in the page header next to the agency name.

The tab is organized as a vertical stack of sections, in this order:

Section

What it shows

Firm Overview

The agency's legal name, a Producer Agreement effective-date tile, and an Invited By tile (member name, email, and the date the agency was invited or created). Below those sit four cards: Agreement Signatures (Agency Signed and MGA Signed dates), Agency Information (NPN, FEIN, Producer Code, Category, Entity Type, NPN Required, DBA, Phone Number, Fax Number, Website, Address), Banking Details, and User Contacts grouped by business role.

Onboarding Progress / Data Completeness

A vertical step timeline. For invited agencies the title is Onboarding Progress and one step is marked In Progress. For added or bulk-uploaded agencies the title is Data Completeness and each step is evaluated independently from the underlying data.

App Activity

Has Accessed App pill, First Login date, Last Active date, and (for non-customer agencies) the Invite to App controls.

Agency Licenses Overview

Domiciled States, Total State Licenses, the NIPR Data Sync Status badge, and a per-product License Status by State map with a five-bucket compliance summary.

Agency Appointments Overview

A per-product Appointments by State map with a three-bucket summary. Visible only when the Appointment Management feature is enabled for your organization.

Agents Overview

Total Agents count and a per-agent accordion that exposes NIPR details when expanded.

Note: The Licenses Overview and Appointments Overview section titles use the agency's Category (for example "Carrier Licenses Overview" or "Wholesaler Appointments Overview"). The structure of each section is the same regardless of category.

Reviewing Onboarding Progress

When you'd do this. You need to know exactly where the agency is in onboarding, which data points are still missing, and whether anything is waiting on your team.

  1. Scan the timeline top to bottom. The steps that apply to this agency are filtered by your onboarding settings, so settings-gated steps such as Custom Questions, Product & State Selection, Payment Details, and Pre-Contract Review only appear when those steps are enabled. The full ordered set of step labels is: Identity, Agency Details, Contacts, Custom Questions, Upload Documents, Product & State Selection, Payment Details, Licensed Agents, Pre-Contract Review, Contract Signing.

  2. Each step has a colored icon and a status pill next to its label:

State

Color

Icon

Pill

Meaning

What to do

Complete

Green

Check-circle

Complete

All required data points exist.

Nothing required.

In Progress (invited agencies)

Blue

Clock

In Progress

This is the step the agency is currently working on.

Wait for the agency, or open the popover to see which data points are still missing.

Partial (added/bulk-uploaded agencies)

Blue

Clock

Partial

Some, but not all, required data points exist for this step.

Click the step label to see exactly which points are missing, then collect them.

Pending

Gray

Dotted circle

Pending

The step has not started. For invited agencies, every step after the current one is pending.

Wait for the prior step to complete (invited flow), or add the data (non-invited flow).

Declined

Red

X-circle

(no pill)

The agency record was declined or soft-deleted.

Restore the record from Agencies if this was a mistake.

  1. Click any step label to open a popover that lists every data point for that step. Each data point is marked collected (green check), missing (red X), or optional (gray minus), and a collected / required data points collected count appears at the bottom.

  2. When the agreement is signed, a banner appears at the bottom of the section. It reads Onboarding Complete or All Data Collected (green) when every applicable step is also done, or Agreement Signed (blue) when the agreement is in but some steps are still outstanding.

Tip: The popover is the fastest way to verify a step. Use it instead of opening the corresponding tab when you just want to check which fields are still empty.

Approving or Declining a Pre-Contract Review

When you'd do this. An invited agency has finished every onboarding step that comes before the producer agreement, and is waiting for your team to either approve them and request signing, or decline their application.

  1. When the agency reaches the Pre-Contract Review step, a yellow Pending Your Review banner appears at the top of the Onboarding Progress section explaining that the agency has completed their steps and is waiting on you.

  2. If you have the Admin, Compliance, or Legal role, the banner shows two buttons. If you do not, the banner shows: "Only users with Admin, Compliance, or Legal roles can approve or decline applications."

  3. To approve, click Approve & Request Signing. The Approve & Request Signing slide-over opens. Fill in:

Field

Required

Description

Select a contract template

Yes

The contract template to send. The dropdown lists the active templates configured under Settings, in the Contract Signing area. The default template is labeled (Default). Templates that are not active still appear but are disabled, with their status appended in parentheses (for example (Re-wire in progress)).

Custom field inputs

Conditional

If the selected template defines custom fields, they appear under Additional Agreement Information. Required fields show no (optional) tag; optional fields are labeled. Number fields respect the min and max defined on the template.

  1. Click Approve & Request Signing at the bottom of the slide-over. The agency's contract signatory contact receives an email invitation to sign the selected producer agreement online.

  2. To decline, click Decline Application. A Decline Agency Application confirmation modal asks "Are you sure you want to decline this agency application?" Confirming soft-deletes the agency record and sends the invitee an email saying their application was not approved.

Warning: Both decisions trigger emails to the agency immediately, and declining also soft-deletes the record. Open the step popovers and review what the agency submitted before clicking either button.

When a Custom Question Triggered the Review

Sometimes an agency is routed to Pre-Contract Review because one of their custom-question answers tripped a gating rule you configured, not just because the review step is part of the standard flow. When that happens:

  1. The Pending Your Review banner shows a Triggered by custom question rule pill, and the primary button reads Review application instead of Approve & Request Signing.

  2. Click Review application to open the same approve slide-over. At the top, a Triggered by panel lists each rule that fired, written in plain language: the question label, the comparison (for example "is at least", "is one of", "contains any of"), the threshold value, and the agency's actual answer.

  3. Review the flagged answers, then either approve (select a contract template and click Approve & Request Signing) or close the slide-over and click Decline Application.

Note: The Triggered by panel reads a snapshot captured when the agency submitted their answers, so it reflects what they entered at that moment even if the underlying questions later change.

Requesting Online Signing or Uploading an Executed Agreement

When you'd do this. The agency has reached the Contract Signing step but no fully executed producer agreement is on file yet. You either want to send a fresh online-signing invitation, or skip the online flow because the agreement was signed offline.

  1. Click the Contract Signing step label to open its popover. If your role allows it, two action buttons appear at the bottom of the popover: Request Online Signing and Upload Executed Agreement.

  2. To request online signing:

    • Click Request Online Signing. A confirmation modal warns: "Requesting online signing will send the contract signatory an email to sign the producer agreement on a dedicated signing page. If a new agreement is selected, any existing contract and pending signing process will be replaced. For invited agencies, the onboarding flow will be terminated and bypassed."

    • Click Continue. The Request Online Signing slide-over opens with the same Select a contract template picker (and custom fields) described above.

    • Click Request Online Signing at the bottom of the slide-over to send the signing invitation.

  3. To upload an executed agreement:

    • Click Upload Executed Agreement. A confirmation modal warns: "Uploading an executed agreement will replace any existing contract and cancel any pending online signing process. The agency will no longer be able to sign online and will instead see the uploaded agreement. We highly recommend uploading only after all onboarding data has been collected."

    • Click Continue. The Upload Executed Producer Agreement slide-over opens.

    • In the file picker, select the signed PDF.

    • Click Upload Agreement. The document is parsed and the Contract Signing step is marked complete based on the extracted signature data.

Note: Requesting online signing requires a contact on the Contacts tab with the Contract Signatory business role. If none is assigned, a "Contract Signatory Required" modal appears and offers a Go to Contacts shortcut.

Inviting an Agency to the Agency App

When you'd do this. The agency you are onboarding is not yet a customer of the Agency App, and you want them to sign in so they can complete onboarding, manage their licenses, and respond to action items themselves.

The Invite to App controls appear in the App Activity section only when the agency's platform subscription shows them as a non-customer.

  1. In the Invite to App row, click the link input (it reads "Click to generate app link..." until you do) or the copy icon on its right. The Agency App invite URL is generated, displayed in the field, and copied to your clipboard. A green check briefly replaces the copy icon to confirm.

  2. Alternatively, click the Send Invitation button to the right of the input. Turris sends a branded invitation email directly to the agency's primary contact.

Tip: Send the URL through your own channel when the primary contact is not the right recipient (for example, you want to route the invitation through an internal escalation). Use Send Invitation when the contact on file is the right person.

Reading the Banking Details

When you'd do this. You need to confirm where commissions will land before approving an agency, or you are troubleshooting a payment that bounced.

The Banking Details card sits inside Firm Overview and shows the Financial Institution name, the Account Number, and the Routing Number. The account number is masked by default: every digit except the last four is replaced with an asterisk. Click the eye icon to the right of Account Number to reveal the full value; click it again to re-mask. If no payment details exist yet, the card displays "No banking details available."

Reading the Maps

When you'd do this. You need a fast read on where the agency is licensed (or appointed) for a given product, or you want to spot states that are licensed but not authorized to sell that product.

  1. Pick a product from the Product dropdown above the map. The dropdown lists every product configured on this agency.

  2. Hover any state to see a tooltip with that state's detail. The license tooltip shows License Status and Authority Status; the appointment tooltip shows License Status, Authorization Status, and Appointment Status.

  3. Read the colored summary bar below the map.

License Status by State summary buckets:

Color / Bucket

What it means

What to do

Licensed / Authorized (green)

The agency holds the required license and is authorized to sell the product in this state.

Nothing required.

Licensed / Unauthorized (yellow)

The agency is licensed in this state but you have not granted authorization for this product.

Grant authority from the Authority page if the agency should sell this product here.

Not Licensed / Authorized (red)

You authorized the product, but the agency is not licensed in this state.

Either pursue licensure or revoke the authorization. Selling without a license is a compliance risk.

Not Licensed / Unauthorized (red surface)

The agency is neither licensed nor authorized.

Nothing to do unless the agency should be selling here.

Product Not Sold (gray)

The product is not offered in this state by anyone in your organization.

No action.

Appointments by State summary buckets:

Color / Bucket

What it means

What to do

Appointed (green)

The agency is appointed for the product in this state.

Nothing required.

Not Appointed (red)

The product is offered in this state but the agency is not appointed.

Request an appointment from the Appointments page if the agency should write business here.

Product Not Sold (gray)

The product is not offered in this state.

No action.

Note: If the agency has not yet synced with NIPR, both maps are replaced with a Data Synchronization Required message. Once the NIPR Data Sync Status badge reads Success, the maps populate. If no products are assigned to the agency, the maps are replaced with a No Products Available message until you add products on Product and State Selection.

Visual and Status Elements

NIPR Data Sync Status badge (Agency Licenses Overview):

Color

Label

Meaning

What to do

Green

Success

The most recent NIPR sync for this agency completed successfully.

Nothing required.

Yellow

Queued or Processing

A sync is in flight.

Wait a few minutes and refresh. The map populates once the sync finishes.

Red

NIPR error / Processing error / No data

NIPR returned an error or has no data for this NPN.

Verify the agency's NPN on the Agency tab, then re-trigger the sync from the agency record.

Has Accessed App pill (App Activity):

Color

Label

Meaning

Green

Yes

At least one member of the agency has signed into the Agency App.

Gray

No

No one at the agency has signed in yet.

Frequently Asked Questions

Why does the section read "Data Completeness" instead of "Onboarding Progress"?

This agency was added directly or bulk-uploaded rather than invited through the onboarding flow. For non-invited agencies, each step is evaluated independently against the data on file; there is no concept of a "current" step.

Why is the Producer Agreement effective date blank?

Either no agreement has been signed yet, or no effective date is recorded. Once both parties sign, the effective date uses the explicit effective date on the agreement; if that is empty, Turris falls back to the latest of the agency and MGA signature dates.

Why is the Appointments section missing?

The Appointment Management feature is not enabled for your organization. Contact your account manager to upgrade.

The license or appointment map shows "Data Synchronization Required." What does that mean?

The agency has not yet completed a successful NIPR data subscription. Once the NIPR Data Sync Status badge reads Success, the map populates.

The license or appointment map shows "No Products Available." What does that mean?

The agency has no products assigned. Open Product and State Selection to assign products, and the maps will populate.

Why does the review banner say "Review application" with a "Triggered by custom question rule" pill?

A custom-question answer this agency submitted tripped a gating rule you configured, which forced them into pre-contract review. Click Review application to see exactly which rule fired and what the agency answered before you approve or decline.

Who can approve or decline a pending pre-contract review?

Only members with the Admin, Compliance, or Legal role. Members in other roles see the Pending Your Review banner but no action buttons; instead a one-line note explains who has the permission.

What happens if I upload an executed agreement after requesting online signing?

The pending online signing invitation is cancelled and the agency can no longer sign online. The uploaded PDF becomes the agency's executed contract.

The Send Invitation button is missing. Why?

The agency is already a customer of the Agency App. The Invite to App row only appears for non-customer agencies.

The Agents Overview shows "No Agents." How do I add one?

No agents have been added to this agency yet. The empty state includes a link to the Agents tab, where you add and manage the agency's licensed producers.

Why can't I see banking details?

No payment details exist for this agency yet. The card shows "No banking details available." Banking details are entered through the Payment Details tab or as part of onboarding.

Best Practices

  1. Start every agency review on the Overview tab. It surfaces the items that need action (pending review, missing data points, NIPR sync errors) without forcing you to open every other tab.

  2. Use the step popovers before you open another tab. The data-point indicators tell you exactly which fields are missing, so opening the corresponding tab afterwards becomes a one-step fix instead of a hunt.

  3. Read the Triggered by panel before approving a gated review. When a custom-question rule routed the agency to review, the panel tells you which answer raised the flag. Resolve that concern before you click approve.

  4. Confirm a Contract Signatory exists before clicking Request Online Signing. The system will block you with a "Contract Signatory Required" modal otherwise; assigning one upfront avoids the round trip.

  5. Wait until onboarding data is collected before uploading an executed agreement. Uploading early cancels the agency's online signing process and bypasses the remaining onboarding steps for invited agencies.

  6. Treat the approve and decline buttons as final. Both actions trigger emails to the agency immediately, and declining also soft-deletes the record. Open every step popover first.

  7. Send the Agency App invitation in the same email you use to introduce yourself. The agency is more likely to act on a personal email than on a system-generated one, and the link is good to share alongside the welcome message.

  8. Check the NIPR Data Sync Status before relying on the maps. A red status means the data behind the map is stale or missing. Fix the sync first, then read the map.

Related Pages

  • Agencies - The list page where your team tracks every downstream agency you distribute through, onboards new ones, and drills into any agency's agents, licenses, policies, appointments, and regulatory history.

  • Agency Tab (Agency Detail) - View and maintain an agency's core profile: identifying details, contact info, legal and mailing addresses, NPN and EIN, and resident-state license footprint.

  • Agency Contacts - The roster of every person you work with at an agency, including the contract signatory, compliance lead, and onboarding contacts, that drives invitations and signatory routing.

  • Agency Detail: Agents Tab - The licensed-producer roster for the agency, with on-demand NIPR sync and per-agent compliance drill-down.

  • Agency Documents - Every supporting document collected during onboarding, including E&O, Cyber, and Crime & Fidelity policies and W9s, scanned automatically on upload.

  • Agency Agreements - Every contract papering the relationship: the producer agreement, supporting folders, and any addendums or side letters you upload.

  • Agency Notes - A shared, auto-saving rich-text notebook for call summaries, escalation history, and internal reminders about the agency.

  • Payment Details - The bank account you remit commission payments to, captured from a voided cheque (read automatically) or entered by hand.

  • Agency Detail: Question Responses Tab - Read-only view of how the agency answered your custom onboarding questions, including which answers flagged it for extra review.

  • Product and State Selection - Where you record which products an agency is requesting authority for and in which states.

  • Requested Authority - Per-product map comparing the states an agency was promised authority in against the states it is already authorized to write in.

  • AML/OFAC Watchlist Screening - Screen the agency against AML, sanctions, and watchlist databases, point-in-time or continuous.

  • Agency NIPR Addresses - Every address NIPR has on file for the agency, one row per state and address type.

  • Agency NIPR Contacts - The business email, phone, and fax NIPR has on file for the agency, one row per state.

  • Agency Detail: NIPR Continuing Education Tab - NIPR-reported continuing-education status, renewal dates, and outstanding credits per license and line of authority.

  • Agency Detail: PDB Report Tab - A Producer Database style compliance summary assembled from the latest NIPR data synchronization.

  • Agency Licenses - Product-by-product, state-by-state confirmation that the agency holds the licenses and appointments it needs to write your business.

  • Agency Detail: E&O/Cyber Policies Tab - Confirm professional liability, cyber, and crime coverage is in force; request replacements and upload new policy documents.

  • Regulatory Actions - Every disciplinary, enforcement, or restrictive action filed against the agency and the agents you have associated with it.

  • Agency Appointments: Agency Tab - State-by-state command center for managing carrier appointments at the firm level from an interactive US map.

  • Agent Appointments by State - Per-agent, state-by-state carrier appointment management from each agent's interactive US map.

  • Agency Authority: Agency Tab - Grant, revoke, and audit the agency's state-level permission to sell each of your products.

  • Agency Authority: Agents Tab - Per-agent product authority, aligned with each producer's actual license footprint.

Need Help?

If you have questions about the Agency Overview or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?