Repository navigation
Partners
Home › Using Granary › Sell › Partners
On this page: AI in this module · Partner accounts · Deal registrations · Partner leads · Commissions · Marketing development funds (MDF) · Resources · Training and certification · The partner portal · Settings that affect this module · Permissions
The Partners module runs your channel program: the resellers, distributors and referral partners who sell for you. Your partner team uses it to manage partner accounts, review the deals partners register, hand warm leads to partners, record commissions, review marketing development fund (MDF) requests and claims, and publish sales resources and training. Partners use their own partner portal to register deals, follow their leads, request MDF, read resources and documents, take training and see their commissions.

When Nary runs on its own, it helps keep partner work fair. See AI Across Granary.
-
Lead routing: a new lead in a partner's territory (country and vertical) or matching a rule in
nary.partners.routinggets a card proposing that partner. -
Protection warnings: you are warned before a deal registration's protection ends (
nary.partners.warn_days). - Conflicts: for a conflicting registration, Nary gathers the evidence, ERP timestamps first.
- Partner documents: Nary offers partner documents only to the contacts of a partner account.
Open Partners > Partner Accounts. The list shows each partner's type, tier, contact, deal value, portal access and status. Use the saved view tabs (All, Active, Gold, Platinum) and Search partners to narrow the list.
- Click Add partner.
- Fill in Company name, Partner type (reseller, system integrator, distributor, referral, technology, training or OEM), Tier, Contact name, Contact email and Country.
- Click Add partner. The account is created as active.
Tiers rank from lowest to highest: authorized (shown as Registered), Silver, Gold, Platinum. The tier decides which resources and training modules the partner sees (see below).
- In the Portal column, click Invite to portal.
- Granary creates a portal sign-in for the partner's contact email and emails a temporary password through the system SMTP. The partner must change the password at first sign-in.
The column then shows Invite sent. If the partner has no contact email, it shows No email on file. If the partner already has an active portal user, it shows Has access and no second user is created. Inviting a partner whose access was revoked reactivates the old user with a fresh temporary password.
Click the bin icon on the row, then Yes to confirm. Deleting a partner also deactivates its portal users.
Companies can apply on the public page /partner/register ("Apply to the partner program"). Applications land in
Portal users (open it with Ctrl K, page /admin/portal-users) under Pending registrations. A system admin
reviews each one and clicks Approve & send credentials or Reject (a rejection reason is required).
Approving creates the partner account (tier authorized, status pending agreement) and its portal user. Only the
superadmin and users with system:admin may approve or reject.
A deal registration is a partner's claim on an opportunity. While it is protected, the deal counts as the partner's. Every registration gets 90 days of protection from the day it is submitted.
Open Partners > Deal Registrations. The stats show Total, Pending, Approved and the Pipeline (approved and extended registrations, grouped by currency and never added across currencies). Saved views: All, Pending review, Approved, Won.

- Click Register deal.
- Pick the Partner, enter the Opportunity name, End customer, Est. value, Currency and Expected close.
- Click Submit. The registration starts as Pending.
Partners can also register deals themselves from the portal (see below).
- On a pending row, click Review.
- Choose the Decision: Approve or Reject.
- When you approve, pick Our deal: an existing CRM deal to link, or leave it on Create a new deal from this registration. A new deal is created at stage "new", owned by you, with a note naming the registration.
- Add Review notes if you like. On a rejection the notes are saved as the rejection reason, which the partner sees.
- Click Submit.
Rules the server enforces:
- Only a pending registration can be reviewed.
- A CRM deal can belong to only one partner registration. Linking a deal that is already linked to another registration is refused.
- Only pending registrations can be deleted.
On an Approved or Extended row, click Won or Lost and confirm. A win adds the deal value to the partner's revenue (this year and cumulative), converted into the partner's commitment currency at the exchange rate of the closing date. If that rate is missing, the close is refused (see Finance). A registration with no value cannot be closed as won. Registrations in any other status cannot be closed.

Use partner leads to hand a warm lead to a partner to follow up. Open the page with Ctrl K, Partner leads
(/partner-mgmt/leads). Saved views: All, New, Contacted, Qualified, Converted.
- Click Assign lead.
- Pick Assign to partner (active partners only) and fill in Customer name, Company, Email, Country, Product interest (comma-separated), Lead expiry date and Notes for partner.
- Click Assign lead. The lead starts as New.
Change a lead's status with the status menu on its row: New, Contacted, Qualified, Converted or Dead. The partner sees the lead, its expiry date and your notes in the portal.
Nary can also propose routing a new CRM lead to a partner whose territory (country and vertical) or routing rule matches it. See Nary AI Assistant.
Open Partners > Commissions. The page lists partner commissions with partner, rate, created date, paid date, amount and status. The stats show Total, Pending, Paid out (grouped by currency) and the number of Partners. Saved views: All, Pending, Approved, Paid.
A commission's amount is its base amount times its rate, rounded to the currency's decimals. When a commission is tied to a deal registration, the base defaults to the registration's value and currency.
A commission moves through these statuses:
| From | To | Who |
|---|---|---|
| Pending | Approved or Cancelled | partner_mgmt:approve_commission |
| Approved | Paid or Cancelled | Paid needs partner_mgmt:pay_commission; Cancelled needs partner_mgmt:approve_commission
|
Paid and cancelled are final. The commissions page is read-only: commissions are created and moved through these
statuses through the API (/api/v1/partner/commissions), for example by an integration or an MCP client.
Partners request MDF for a marketing activity, then claim the money they spent against the approved budget. Open
the review page with Ctrl K, Partner MDF (/partner-mgmt/mdf). It has two tabs, MDF requests and
Claims, with stats for Pending review, Total approved and Pending claims.
- On the MDF requests tab, click Review on a submitted request.
- Click Approve or Reject.
- For an approval, enter the Approved amount. For a rejection, enter the Rejection reason (required).
- Click Confirm approval or Confirm rejection.
Rules: an approved amount must be above zero, cannot exceed the requested amount, and cannot be lower than what the partner has already claimed.
- On the Claims tab, click Review on a claim. Open View proof document to check the evidence.
- Click Approve, Reject or Mark paid. For Mark paid, you can add a Payment reference.
- Confirm.
A submitted claim can be approved or rejected; an approved claim can be marked paid. Partners cannot claim more, in total, than the approved amount of the request (rejected claims do not count).

Resources are sales kits, datasheets, presentations and other files you share with partners. Open Partners > Resources.
- Click Add resource.
- Fill in Title, Description, Type (for example Datasheet, Presentation, Case Study, Price List, Training, Branding, API Doc), File URL, Version and Min tier.
- Click Add resource.
Use Deactivate and Activate to hide or show a resource without deleting it. A partner sees an active resource only when the resource's Min tier is at or below the partner's tier and the resource is open to every partner type or to the partner's own type.
Company documents (brochures, datasheets) with the partner audience come from the document library and appear on the portal's Documents page; each download is stamped with the partner's company. See Knowledge and Documents.
Open the training admin page with Ctrl K, Partner training (/partner-mgmt/training).
- Click New module.
- Under Module info, enter Title, Description, Min tier and Pass score (%) (70 by default). Tick Publish now to make it visible at once.
- Click Add chapter for each chapter: a title, the content (Markdown) and an optional video URL.
- In a chapter, click Add quiz question, type the question and four options, and select the correct one ("The selected option is the correct answer.").
- Click Create module.
Use Publish and Unpublish on the list to control visibility. Partners see only published modules at or below their tier.
The partner reads each chapter (Mark read or Mark complete), then takes the Final quiz. A score at or above the pass score passes the module and issues a certification. Before a pass, the partner sees only "Not quite there yet" and the number of attempts left, never the score, so answers cannot be found by trial and error.
Each partner user gets a limited number of quiz attempts per module (setting Training quiz attempts). When they are used up, the quiz is refused with "Contact your partner manager to try again."
Partners sign in at /partner/login. The portal menu has Dashboard, Deals, Leads, MDF, Commissions, Resources, Documents and Training. A portal user sees only their own company's data.

- Dashboard: the deal pipeline, Commission this year, New leads, MDF approved and modules certified, with shortcuts to Register deal, View leads and Request MDF.
- Deals: click Register deal, fill in Opportunity name, End customer name, Estimated value, Currency and Expected close date, then Submit registration. Rejected registrations show Notes from the partnership team.
- Leads: the leads assigned to the partner, with Notes from us and the expiry date. Register as deal opens the deal registration page.
- MDF: click New request and fill in Activity title, Activity type, Description, Requested amount, Currency, Planned date, Location and Expected outcome. Once a request is approved, the partner submits claims with a Claim amount, a description and an optional proof file (Upload proof: invoice, receipt or campaign report).
- Commissions: the partner's commissions with type, rate, amount and status.
- Resources and Documents: the files the partner may access.
- Training: modules with status (Not started, In progress, Passed, Failed) and certifications.

Under Settings > Sales & CRM > Partners (or search for the label):
-
Partner routing rules (
nary.partners.routing): rules that propose a new lead to a partner by region and industry. -
Warn before protection ends (
nary.partners.warn_days, default 14): days before a deal registration's protection ends that Nary warns you. -
Training quiz attempts (
partner.training.max_attempts, default 5): quiz submissions a partner user gets per training module.
Closing a won registration in another currency also needs an exchange rate for the closing date (see Finance).
| Permission | Allows |
|---|---|
partner_mgmt:view |
See partner accounts, deal registrations, commissions and training modules |
partner_mgmt:manage |
Add and delete partners, send portal invites, register deals, manage leads, resources, training and MDF review |
partner_mgmt:approve_deals |
Review, close and delete deal registrations |
partner_mgmt:manage_commissions |
Create commissions |
partner_mgmt:approve_commission |
Approve or cancel commissions |
partner_mgmt:pay_commission |
Mark commissions paid |
system:admin |
Approve or reject partner applications in Portal users |
The superadmin passes every check. Portal routes accept only partner portal users and only show their own partner's records.
- CRM: the deals that approved registrations link to
- Sales
- Knowledge and Documents: documents shared with partners
- Finance: exchange rates
- Nary AI Assistant: partner routing and protection warnings
← Previous: Marketing | Next: Approvals and Signing →
Getting started
AI in Granary
Using Granary
- Sell
- Approve and sign
- Money
- Buy and make
- People
- Work together
Administration
Developers